Definición de un agente personalizado - Amazon Q Developer
Cómo crear su primer agente personalizadoComandos de agente personalizadosMigración desde perfiles antiguosUso del agente predeterminado en lugar de agentes personalizados

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.

Definición de un agente personalizado

En esta sección se explica cómo crear y usar agentes personalizados en el flujo de trabajo de la CLI para desarrolladores de Amazon Q.

Cómo crear su primer agente personalizado

Aquí tienes un step-by-step tutorial para crear tu primer agente personalizado:

  1. Inicie una sesión de chat de CLI para desarrolladores de Amazon Q:

    $ q chat

  2. Enumere los agentes existentes para ver los que están disponibles:

    /agent list

  3. Crea un agente nuevo (my-agentsustitúyelo por el nombre que prefieras):

    /agent create --name my-agent

    Esto crea un nuevo archivo de configuración del agente y lo abre en el editor predeterminado (establecido mediante la variable de EDITOR entorno).

  4. Personalice la configuración personalizada del agente según sea necesario. Para empezar de forma sencilla, es posible que desee:

    • Agrega una descripción que explique el propósito del agente de aduanas

    • Especifique qué herramientas deberían estar disponibles

    • Apruebe previamente las herramientas que utiliza con frecuencia

  5. Guarde el archivo de configuración y salga del editor para volver a la sesión de chat.

  6. Inicie una nueva sesión de chat con su agente personalizado:

    $ q chat --agent my-agent

    Nota: No puedes cambiar de agente personalizado dentro de una sesión de chat existente. Los cambios en los agentes personalizados requieren iniciar una nueva sesión.

  7. Pruebe su agente personalizado pidiéndole que realice tareas con las herramientas que ha configurado.

Para obtener información detallada sobre las opciones de configuración del agente personalizado, consulte la referencia de configuración.

Comandos de agente personalizados

La CLI para desarrolladores de Amazon Q proporciona varios comandos para administrar agentes personalizados. Estos comandos están disponibles durante una sesión de chat y comienzan con/agent.

Comandos de agente personalizados
Comando Descripción Disponibilidad
/agent list Muestra todos los agentes personalizados disponibles en su entorno Sesión de chat
/agent schema Muestra el esquema JSON para crear archivos de configuración de agentes personalizados Sesión de chat
/agent create --name [name] Crea un nuevo archivo de configuración de agente personalizado y lo abre en el editor predeterminado Sesión de chat

Nota: Algunas operaciones de administración de agentes personalizadas requieren la edición manual de los archivos en lugar de comandos interactivos. Los cambios personalizados en los agentes se aplican al iniciar una nueva sesión de chat.

Migración desde perfiles antiguos

Cuando actualiza a una versión de la CLI para desarrolladores de Amazon Q que admite agentes e inicia sesión, es posible que se le pida que migre sus perfiles antiguos a agentes si:

  • Ya tiene configuraciones de perfil heredadas

  • Estás ejecutando el modo interactivo (se omite la migración) --no-interactive

  • No has completado previamente el proceso de migración

El proceso de migración:

  • Convierte las configuraciones de perfil existentes al nuevo formato de agente

  • Conserva los permisos de la herramienta y la configuración de contexto existentes

  • Crea archivos de configuración del agente en su directorio principal

  • Mantiene la compatibilidad con versiones anteriores de sus flujos de trabajo existentes

La migración es opcional y se puede rechazar. Si decide no migrar, puede seguir utilizando el agente predeterminado o crear nuevos agentes manualmente. Para controlar el comportamiento de la migración, utilice la --no-interactive marca para omitir por completo las solicitudes de migración.

Uso del agente predeterminado en lugar de agentes personalizados

La CLI para desarrolladores de Amazon Q incluye un agente predeterminado integrado que proporciona acceso a todas las herramientas con un mínimo de permisos aprobados previamente. Este agente predeterminado:

  • Incluye todas las herramientas disponibles (integradas y MCP)

  • Aprueba previamente solo la herramienta por motivos de seguridad fs_read

  • Incluye automáticamente archivos de proyectos comunes, como y README.md AmazonQ.md

  • Utiliza la configuración MCP antigua, si está disponible

Los agentes personalizados le permiten:

  • Limite el acceso a las herramientas solo a lo que necesita

  • Apruebe previamente las herramientas adicionales para reducir las interrupciones

  • Incluya documentación específica del proyecto y archivos de contexto

  • Configure el comportamiento de la herramienta para su caso de uso específico