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 settingspour 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 :
| 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é
| 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
| 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
| 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
| 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
| 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
| 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
| 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
trueoufalse(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é :
-
Sauvegardez les paramètres actuels :
q settings list --format json > backup.json -
Ouvrez le fichier de paramètres :
q settings open -
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