Referencia de la configuración - Amazon Q Developer
Referencia de la configuraciónConceptos de configuraciónPatrones de configuración comunes

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.

Referencia de la configuración

Los archivos de configuración de agentes personalizados son documentos JSON que definen cómo se comporta un agente personalizado. En esta sección se proporciona una descripción general de los conceptos de configuración y los patrones comunes.

Referencia de la configuración

Para obtener información completa sobre el formato del archivo de configuración del agente personalizado, los campos disponibles y la sintaxis, consulte la documentación complementaria de la CLI para desarrolladores de Amazon Q:

También puede ver el esquema JSON de los archivos de configuración de los agentes personalizados ejecutando:

/agent schema

Conceptos de configuración

Los archivos de configuración de los agentes personalizados contienen varias secciones clave que controlan distintos aspectos del comportamiento de los agentes personalizados:

Metadatos básicos

Cada agente personalizado puede incluir metadatos básicos para la identificación y la documentación:

  • Nombre: el identificador del agente personalizado (derivado del nombre del archivo si no se especifica)

  • Descripción: explicación legible por humanos del propósito del agente personalizado

Configuración de herramientas

La configuración de las herramientas controla qué herramientas están disponibles para el agente personalizado y cómo se comportan:

herramientas

Enumera todas las herramientas que el agente personalizado puede utilizar, incluidas las herramientas integradas y las herramientas del servidor MCP

Herramientas permitidas

Especifica qué herramientas se pueden ejecutar sin la confirmación del usuario, lo que mejora la eficiencia del flujo de trabajo

Alias de herramientas

Proporciona nombres alternativos para las herramientas, útiles para resolver conflictos de nomenclatura o crear atajos

Configuración de herramientas

Configura el comportamiento específico de las herramientas individuales, como las rutas de archivo permitidas o los permisos de servicio

Configuración de servidores MCP

La mcpServers sección define a qué servidores del Model Context Protocol puede acceder el agente personalizado. La configuración de cada servidor incluye:

  • Comando: el comando ejecutable para iniciar el servidor MCP

  • Argumentos: argumentos de la línea de comandos para el servidor

  • Variables de entorno: configuración de entorno para el proceso del servidor

  • Configuración del tiempo de espera: solicite la configuración del tiempo de espera

Para obtener más información sobre la integración de MCP, consulte Uso de MCP con Amazon Q Developer.

Recursos y contexto

Los agentes personalizados pueden incluir automáticamente el contexto relevante a través de dos mecanismos:

recursos

Archivos y directorios para incluirlos en el contexto del agente personalizado, que admiten patrones globales para una selección de archivos flexible

enlaces

Los comandos se ejecutan en puntos de activación específicos (como el inicio del agente personalizado o los datos introducidos por el usuario) y los resultados se incluyen en el contexto

Patrones de configuración comunes

Configuración mínima de agentes personalizados

Un agente personalizado simple que proporciona operaciones básicas de archivos con un acceso de lectura previamente aprobado:

{
"name": "basic-ops",
  "description": "Basic file operations custom agent",
  "tools": [
    "fs_read",
    "fs_write",
    "execute_bash"
  ],
  "allowedTools": [
    "fs_read"
  ]
}

Agente personalizado de flujo de trabajo especializado

Un agente personalizado configurado para la administración de la infraestructura de AWS con permisos de herramientas específicos:

{
"name": "infra-manage",
  "description": "AWS infrastructure management custom agent",
  "tools": [
    "fs_read",
    "fs_write",
    "execute_bash",
    "use_aws"
  ],
  "allowedTools": [
    "fs_read",
    "use_aws"
  ],
  "toolsSettings": {
    "use_aws": {
      "allowedServices": ["s3", "lambda", "cloudformation"]
    }
  },
  "resources": [
    "file://README.md",
    "file://infrastructure/**/*.yaml",
    "file://docs/deployment.md"
  ]
}

Agente personalizado específico para cada proyecto con ganchos

Un agente personalizado que incluye el contexto del proyecto a través de archivos estáticos y comandos dinámicos:

{
  "name": "project-dev",
  "description": "Project development custom agent with git context",
  "tools": [
    "fs_read",
    "fs_write",
    "execute_bash",
    "@git"
  ],
  "allowedTools": [
    "fs_read",
    "@git/git_status"
  ],
  "resources": [
    "file://README.md",
    "file://CONTRIBUTING.md",
    "file://src/**/*.md"
  ],
  "hooks": {
    "agentSpawn": [
      {
        "command": "git status --porcelain",
        "timeout_ms": 10000
      }
    ]
  }
}

Agente personalizado con integración de servidor MCP

Un agente personalizado que integra herramientas externas a través de servidores MCP:

{
"name": "custom-dev",
  "description": "Development custom agent with external tool integration",
  "mcpServers": {
    "git": {
      "command": "git-mcp-server",
      "args": [],
      "timeout": 30000
    },
    "fetch": {
      "command": "fetch-mcp-server",
      "args": ["--timeout", "10"]
    }
  },
  "tools": [
    "fs_read",
    "fs_write",
    "@git",
    "@fetch/fetch_url"
  ],
  "allowedTools": [
    "fs_read",
    "@git/git_status",
    "@fetch/fetch_url"
  ],
  "toolAliases": {
    "@git/git_status": "status",
    "@fetch/fetch_url": "get"
  }
}