Configurer les paramètres Amazon Q - Amazon Q Developer

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configurer les paramètres Amazon Q

Amazon Q offre différentes possibilités de personnaliser son comportement au moyen de paramètres. Vous pouvez accéder à ces paramètres via une interface graphique et des options de ligne de commande.

Paramètres d'accès

Vous pouvez accéder aux paramètres d’Amazon Q de deux façons :

  • Interface graphique utilisateur des paramètres : exécutez q settings pour ouvrir l’interface graphique des paramètres

  • Ligne de commande : utilisez différentes commandes pour afficher et modifier directement les paramètres

Gérer les paramètres depuis la ligne de commande

Vous pouvez gérer les paramètres d’Amazon Q directement à partir de la ligne de commande en utilisant les commandes suivantes :

Commandes de base des paramètres
Commande Description
q settings open Ouvre le fichier de paramètres dans votre éditeur par défaut
q settings list Liste tous les paramètres configurés
q settings list --all Répertorie tous les paramètres disponibles avec des descriptions
q settings list --format json-pretty Répertorie les paramètres au format JSON
q settings [KEY] Affiche la valeur d'un paramètre spécifique
q settings [KEY] [VALUE] Définit un paramètre spécifique à la valeur donnée
q settings --delete [KEY] Supprime un paramètre spécifique

Lorsque vous utilisez les commandes q settings, vous pouvez préciser le format de sortie :

q settings --format [FORMAT]

Formats disponibles :

  • plain: affiche les résultats sous forme de texte brut (par défaut)

  • json : affiche les résultats au format JSON

  • json-pretty : affiche les résultats au format JSON Pretty

Référence des paramètres disponibles

Les sections suivantes décrivent tous les paramètres de la CLI Amazon Q disponibles, organisés par catégorie. Chaque paramètre inclut son nom de clé, sa description, le type de valeur attendu et des exemples.

Paramètres de télémétrie et de confidentialité

Paramètres de télémétrie et de confidentialité
Clé de réglage Description Type Exemple
telemetry.enabled Activer/désactiver la collecte de données télémétriques boolean q settings telemetry.enabled true
telemetryClientId Identifiant client existant pour la télémétrie chaîne q settings telemetryClientId "client-123"
codeWhisperer.shareCodeWhispererContentWithAWS Partager du contenu avec le CodeWhisperer service boolean q settings codeWhisperer.shareCodeWhispererContentWithAWS false

Paramètres de l'interface de chat

Paramètres de l'interface de chat
Clé de réglage Description Type Exemple
chat.enableThinking Activer l'outil de réflexion pour un raisonnement complexe boolean q settings chat.enableThinking true
chat.greeting.enabled Afficher le message d'accueil au début du chat boolean q settings chat.greeting.enabled false
chat.editMode Activer le mode d'édition pour l'interface de chat boolean q settings chat.editMode true
chat.enableNotifications Activer les notifications sur le bureau boolean q settings chat.enableNotifications true
chat.defaultModel Modèle d'IA par défaut pour les conversations chaîne q settings chat.defaultModel "claude-3-sonnet"
chat.disableMarkdownRendering Désactiver le formatage du markdown dans le chat boolean q settings chat.disableMarkdownRendering false
chat.defaultAgent Configuration de l'agent par défaut chaîne q settings chat.defaultAgent "my-agent"
chat.disableAutoCompaction Désactiver le résumé automatique des conversations boolean q settings chat.disableAutoCompaction true
chat.enableHistoryHints Afficher les indices relatifs à l'historique des conversations boolean q settings chat.enableHistoryHints true
chat.uiMode Spécifier la variante d'interface utilisateur à utiliser chaîne q settings chat.uiMode "compact"
chat.enableContextUsageIndicator Afficher le pourcentage d'utilisation du contexte dans l'invite boolean q settings chat.enableContextUsageIndicator true

Paramètres de la base de connaissances

Paramètres de la base de connaissances
Clé de réglage Description Type Exemple
chat.enableKnowledge Activer les fonctionnalités de la base de connaissances boolean q settings chat.enableKnowledge true
knowledge.defaultIncludePatterns Modèles de fichiers par défaut à inclure dans la base de connaissances array q settings knowledge.defaultIncludePatterns '["*.py", "*.js"]'
knowledge.defaultExcludePatterns Modèles de fichiers par défaut à exclure de la base de connaissances array q settings knowledge.defaultExcludePatterns '["*.log", "node_modules"]'
knowledge.maxFiles Nombre maximum de fichiers pour l'indexation des connaissances nombre q settings knowledge.maxFiles 1000
knowledge.chunkSize Taille des blocs de texte pour le traitement des connaissances nombre q settings knowledge.chunkSize 512
knowledge.chunkOverlap Superposition entre les blocs de texte nombre q settings knowledge.chunkOverlap 50
knowledge.indexType Type d'indice de connaissances à utiliser chaîne q settings knowledge.indexType "fast"

Reliures à touches

Paramètres de reliure des touches
Clé de réglage Description Type Exemple
chat.skimCommandKey Reliure de touches pour la commande de recherche floue char q settings chat.skimCommandKey "f"
chat.autocompletionKey Reliure de touches pour l'acceptation des indices d'autocomplétion char q settings chat.autocompletionKey "Tab"
chat.tangentModeKey Raccordement des touches pour basculer en mode tangent char q settings chat.tangentModeKey "t"
chat.delegateModeKey Reliure de touches pour la commande déléguée char q settings chat.delegateModeKey "d"

Fonctionnalités et boutons

Fonctionnalité : basculer entre les paramètres
Clé de réglage Description Type Exemple
chat.enableTangentMode Activer la fonctionnalité du mode tangent boolean q settings chat.enableTangentMode true
introspect.tangentMode Entrée automatique en mode tangente pour les questions d'introspection boolean q settings introspect.tangentMode true
chat.enableTodoList Activer la fonctionnalité de liste de tâches boolean q settings chat.enableTodoList true
chat.enableCheckpoint Activer la fonction de point de contrôle boolean q settings chat.enableCheckpoint true
chat.enableDelegate Activer l'outil de délégation pour la gestion des sous-agents boolean q settings chat.enableDelegate true

Paramètres de l'API et du service

Paramètres de l'API et du service
Clé de réglage Description Type Exemple
api.timeout Délai d'expiration des demandes d'API en secondes nombre q settings api.timeout 30
api.codewhisperer.service CodeWhisperer URL du terminal de service chaîne q settings api.codewhisperer.service "https://codewhisperer.us-east-1.amazonaws.com"
api.q.service URL du point de terminaison d'un service chaîne q settings api.q.service "https://q.us-east-1.amazonaws.com"

Paramètres du protocole de contexte du modèle

Réglages MCP
Clé de réglage Description Type Exemple
mcp.initTimeout Délai d'initialisation du serveur MCP nombre q settings mcp.initTimeout 10
mcp.noInteractiveTimeout Délai d'expiration MCP non interactif nombre q settings mcp.noInteractiveTimeout 5
mcp.loadedBefore Suivez les serveurs MCP précédemment chargés boolean q settings mcp.loadedBefore true

Exemples de paramètres courants

Voici quelques scénarios de configuration courants :

Configuration de base

# Enable telemetry
q settings telemetry.enabled true

# Set default chat model
q settings chat.defaultModel "claude-3-sonnet"

# Disable greeting message
q settings chat.greeting.enabled false

Configuration de la base de connaissances

# Enable knowledge base
q settings chat.enableKnowledge true

# Set file patterns to include
q settings knowledge.defaultIncludePatterns '["*.py", "*.js", "*.md", "*.txt"]'

# Set file patterns to exclude
q settings knowledge.defaultExcludePatterns '["*.log", "node_modules", ".git", "*.pyc"]'

# Set maximum files to index
q settings knowledge.maxFiles 2000

Configuration des fonctionnalités

# Enable experimental features
q settings chat.enableThinking true
q settings chat.enableTangentMode true
q settings chat.enableTodoList true
q settings chat.enableCheckpoint true

# Configure key bindings
q settings chat.tangentModeKey "t"
q settings chat.delegateModeKey "d"

Affichage et gestion des paramètres

# View all configured settings
q settings list

# View all available settings with descriptions
q settings list --all

# View specific setting
q settings chat.defaultModel

# Export settings as JSON
q settings list --format json-pretty > my-settings.json

# Delete a setting
q settings --delete chat.defaultModel

Paramètres de résolution des problèmes

Problèmes courants et solutions liés à l'utilisation des paramètres :

Valeurs de réglage non valides

Si vous rencontrez des erreurs lors de la définition des valeurs :

  • Valeurs booléennes : utilisez true ou false (minuscules)

  • Valeurs du tableau : utilisez le format JSON avec des guillemets simples : '["item1", "item2"]'

  • Valeurs de chaîne : utilisez des guillemets pour les chaînes contenant des espaces : "my value"

Réinitialisation des paramètres

Pour rétablir les paramètres par défaut :

# Delete individual settings
q settings --delete setting.name

# Open settings file for manual editing
q settings open

# View current settings to identify issues
q settings list --all

Problèmes liés aux fichiers de paramètres

Si le fichier de paramètres est endommagé :

  1. Sauvegardez les paramètres actuels : q settings list --format json > backup.json

  2. Ouvrez le fichier de paramètres : q settings open

  3. Vérifiez la syntaxe JSON ou restaurez à partir d'une sauvegarde

Autres commandes de l’interface de ligne de commande d’Amazon Q

Amazon Q propose de nombreuses autres fonctionnalités de ligne de commande en dehors de la gestion des paramètres. Pour une référence exhaustive de toutes les commandes disponibles et de leurs arguments, consultez Référence de commande Amazon Q CLI.

Pour obtenir de l’aide sur une commande, utilisez l’indicateur --help :

q [COMMAND] --help