Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configurar los ajustes de Amazon Q

Amazon Q ofrece varias formas de personalizar su comportamiento a través de la configuración. Puede acceder a estos ajustes a través de una interfaz gráfica y las opciones de línea de comandos.

Configuración de acceso

Puede acceder a la configuración de Amazon Q de dos maneras:

Administre la configuración desde la línea de comandos

Puede administrar la configuración de Amazon Q directamente desde la línea de comando mediante los siguientes comandos:

Al utilizar los comandos q settings, puede especificar el formato de salida:

q settings --format [FORMAT]

Formatos disponibles:

Referencia de ajustes disponibles

En las siguientes secciones se describen todas las configuraciones de CLI de Amazon Q disponibles, organizadas por categoría. Cada configuración incluye su nombre clave, descripción, tipo de valor esperado y ejemplos.

Configuración de telemetría y privacidad

Configuración de la interfaz de chat

Configuración de la base de conocimientos

Combinaciones de teclas

Conmuta funciones

Configuración de API y servicio

Configuración del protocolo de contexto del modelo

Ejemplos de configuraciones comunes

Estos son algunos escenarios de configuración comunes:

Configuración básica

# 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

Configuración de la base de conocimientos

# 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

Configuración de funciones

# 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"

Visualización y administración de la configuración

# 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

Configuración de solución de problemas

Problemas y soluciones habituales al trabajar con la configuración:

Valores de configuración no válidos

Si encuentra errores al configurar los valores:

Restablecer la configuración

Para restablecer la configuración a sus valores predeterminados:

# 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

Problemas con el archivo de configuración

Si el archivo de configuración se daña:

Otros comandos de la CLI de Amazon Q

Amazon Q ofrece muchas otras características de línea de comandos, además de la administración de la configuración. Para obtener una referencia completa de todos los comandos disponibles y sus argumentos, consulte Referencia de comandos de la CLI de Amazon Q.

Para obtener ayuda con cualquier comando, utilice el indicador --help:

q [COMMAND] --help