Gestión del contexto

Gestión del contexto

Los archivos de contexto contienen información que desea que Amazon Q tenga en cuenta durante sus conversaciones. Estos pueden incluir los requisitos del proyecto, los estándares de codificación, las reglas de desarrollo o cualquier otra información que ayude a Amazon Q a ofrecer respuestas más relevantes.

Hay dos formas de configurar el contexto:

• Recursos del agente (recomendado): contexto persistente definido en el archivo de configuración del agente

• Contexto de sesión: contexto temporal agregado durante una sesión de chat mediante /context comandos

Configuración del contexto persistente con los recursos del agente

La forma recomendada de configurar el contexto es a través del resources campo del archivo de configuración del agente. Esto crea un contexto persistente que está disponible cada vez que se utiliza el agente.

Añada rutas de archivos o patrones globales a la resources matriz en la configuración de su agente:

{
  "name": "my-agent",
  "description": "My development agent",
  "resources": [
    "file://README.md",
    "file://.amazonq/rules/**/*.md",
    "file://docs/**/*.md",
    "file://src/config.py"
  ]
}

Los recursos deben ir precedidos de un prefijo file:// para poder incluirlos como archivos de contexto. Estos archivos estarán disponibles automáticamente en todas las sesiones de chat que utilicen este agente.

Añadir un contexto de sesión temporal

Puede añadir archivos temporalmente a su sesión de chat actual mediante el /context add comando. Estas adiciones solo están disponibles para la sesión actual y no se mantendrán al iniciar una nueva sesión de chat.

q chat
> /context add README.md
Added 1 path(s) to context.
Note: Context modifications via slash command is temporary.

También puedes añadir varios archivos a la vez utilizando patrones globales:

q chat
> /context add docs/*.md
Added 3 path(s) to context.
Note: Context modifications via slash command is temporary.

Para que los cambios de contexto sean permanentes, añada los archivos al resources campo de su agente.

Visualización del contexto

Para ver el contexto actual, utilice el /context show comando:

q chat
> /context show
👤 Agent (my-agent):
    README.md (1 match)
    .amazonq/rules/**/*.md (3 matches)
    docs/**/*.md (5 matches)

💬 Session (temporary):
    <none>

5 matched files in use:
👤 README.md (~250 tkns)
👤 .amazonq/rules/security.md (~180 tkns)
👤 .amazonq/rules/coding-standards.md (~320 tkns)
👤 docs/architecture.md (~150 tkns)
👤 docs/best-practices.md (~200 tkns)

Total: ~1100 tokens

El resultado muestra:

• 👤 Agente: contexto persistente del resources campo de su agente

• 💬 Sesión: contexto temporal agregado durante la sesión actual

Eliminar el contexto

Para eliminar archivos del contexto de la sesión actual, utilice el /context rm comando:

q chat
> /context rm src/temp-file.py
Removed 1 path(s) from context.
Note: Context modifications via slash command is temporary.

Para borrar todo el contexto de la sesión, utilice el /context clear comando:

q chat
> /context clear
Cleared context
Note: Context modifications via slash command is temporary.

Nota: No se puede eliminar el contexto definido por el agente mediante /context comandos. Para eliminar el contexto de forma permanente, edite el campo de resources su agente.

Casos de uso comunes

Estos son algunos casos de uso comunes para la administración del contexto:

Uso de las reglas del proyecto

Amazon Q admite reglas a nivel de proyecto que pueden definir pautas y restricciones de seguridad. Estas reglas se definen en los archivos Markdown del .amazonq/rules directorio de su proyecto.

Por ejemplo, puede crear reglas que especifiquen:

• A qué directorios debería evitar acceder Amazon Q

• Requisitos de seguridad para el código generado

• Estándares de codificación y mejores prácticas

La forma recomendada de incluir las reglas del proyecto es mediante la configuración del agente:

{
  "name": "my-project-agent",
  "resources": [
    "file://.amazonq/rules/**/*.md",
    "file://README.md",
    "file://docs/architecture.md"
  ]
}

También puedes añadir temporalmente las reglas del proyecto a tu sesión actual:

q chat
> /context add .amazonq/rules/*.md
Added 3 path(s) to context.
Note: Context modifications via slash command is temporary.

Para obtener más información sobre la creación y el uso de reglas de proyecto, consulte Creación de reglas de proyecto para su uso con el chat para desarrolladores de Amazon Q en la documentación del IDE.

Migración del contexto de la sesión a los recursos de los agentes

Si se da cuenta de que agrega repetidamente los mismos archivos de contexto mediante /context add comandos, considere moverlos al resources campo de su agente para que persistan:

1. Anote los archivos que añade con frecuencia con /context add

2. Edite el archivo de configuración del agente

3. Añada las rutas de los archivos a la resources matriz con el file:// prefijo

4. Guarde la configuración del agente

Ejemplo de migración:

# Instead of running these commands every session:
> /context add README.md
> /context add docs/*.md
> /context add .amazonq/rules/*.md

# Add them to your agent config once:
{
  "resources": [
    "file://README.md",
    "file://docs/**/*.md", 
    "file://.amazonq/rules/**/*.md"
  ]
}