Gestión de agentes personalizados - Amazon Q Developer
Ubicaciones personalizadas de los archivos de los agentesMejores prácticas para organizar los agentes personalizadosCompartir agentes personalizados con los equipos

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.

Gestión de agentes personalizados

En esta sección se explica cómo organizar, gestionar y trabajar con agentes personalizados de forma eficaz en su flujo de trabajo de desarrollo.

Ubicaciones personalizadas de los archivos de los agentes

Los archivos de configuración de los agentes personalizados se almacenan como archivos JSON en directorios específicos:

Agentes personalizados globales

~/.aws/amazonq/cli-agents/{agent-name}.json

Disponible en todos los proyectos y directorios de su sistema.

Agentes personalizados a nivel de proyecto

.amazonq/cli-agents/{agent-name}.json

Disponible solo en el directorio del proyecto específico y sus subdirectorios.

Importante: El {agent-name} nombre del archivo es solo para referencia. El nombre real del agente viene determinado por el name campo del propio archivo de configuración JSON, que es obligatorio.

Prioridad personalizada de los agentes y resolución de conflictos

Cuando la CLI para desarrolladores de Amazon Q busca un agente personalizado, sigue un orden de prioridad específico:

  1. Primero los agentes personalizados locales: comprueba si hay agentes personalizados en el directorio de trabajo actual

  2. En segundo lugar, recurre a los agentes personalizados globales: recurre a los agentes personalizados de tu directorio principal

  3. Predeterminado integrado: utiliza el agente predeterminado si no se encuentra ningún agente personalizado

Si los directorios local y global contienen agentes personalizados con el mismo nombre, prevalece el agente personalizado local. La CLI para desarrolladores de Amazon Q mostrará un mensaje de advertencia cuando esto ocurra:

WARNING: Agent conflict for my-agent. Using workspace version.

Este sistema de prioridad le permite:

  • Reemplazar los agentes personalizados globales con versiones específicas del proyecto

  • Pruebe las modificaciones de los agentes personalizados a nivel local antes de convertirlas en globales

  • Mantenga diferentes configuraciones de agentes personalizadas para diferentes proyectos

Mejores prácticas para organizar los agentes personalizados

Cuándo utilizar agentes personalizados globales

Utilice agentes personalizados globales para:

  • Flujos de trabajo de uso general: agentes personalizados que se utilizan en varios proyectos

  • Productividad personal: agentes personalizados adaptados a tu estilo de trabajo individual

  • Tareas de desarrollo habituales: revisión de código, depuración, generación de documentación

  • Flujos de trabajo específicos para cada herramienta: administración de AWS, operaciones de Git, flujos de trabajo de Docker

¿Cuándo usar agentes personalizados locales

Utilice agentes personalizados locales para:

  • Configuraciones específicas del proyecto: agentes personalizados que necesitan acceder a archivos de proyectos específicos

  • Colaboración en equipo: agentes personalizados que se comparten mediante el control de versiones

  • Entornos de desarrollo: agentes personalizados con requisitos únicos para proyectos específicos

  • Pruebas y experimentación: modificaciones temporales de los agentes personalizados sin afectar a la configuración global

Convenciones de nomenclatura de agentes personalizadas

Tenga en cuenta estas convenciones de nomenclatura para una mejor organización de los agentes personalizados:

  • Nombres basados en un propósito:aws-specialist.json,, code-reviewer.json documentation-writer.json

  • Nombres específicos de la tecnología:,, python-dev.json react-frontend.json terraform-ops.json

  • Nombres específicos del proyecto:,, project-alpha.json mobile-app.json api-backend.json

  • Nombres específicos del entorno:,, development.json staging.json production.json

Compartir agentes personalizados con los equipos

Los agentes personalizados locales se pueden compartir con los miembros del equipo a través de los sistemas de control de versiones. Este enfoque permite a los equipos:

  • Estandarice los entornos de desarrollo: asegúrese de que todos los miembros del equipo tengan acceso a las mismas herramientas y configuraciones

  • Comparta el contexto específico del proyecto: incluya la documentación del proyecto, los estándares de codificación y los scripts personalizados

  • Mantén la coherencia: utiliza la misma herramienta, permisos y ajustes en todo el equipo

  • Colabora en las mejoras: utiliza las solicitudes de cambios para revisar y mejorar las configuraciones personalizadas de los agentes

Mejores prácticas de control de versiones

Al compartir agentes personalizados mediante el control de versiones:

  • Incluya directorios de agentes personalizados: .aws/amazonq/agents/ agréguelos a su repositorio

  • Documente los propósitos de los agentes personalizados: utilice descripciones claras en los archivos de configuración de los agentes personalizados

  • Revise los cambios de los agentes personalizados: trate los cambios de configuración de los agentes personalizados como cambios de código

  • Pruebe las configuraciones de los agentes personalizados: compruebe que los agentes personalizados compartidos funcionan correctamente para todos los miembros del equipo

  • Evite la información confidencial: no incluya claves de API, contraseñas ni información personal en los agentes personalizados compartidos