El Agent Toolkit para AWS fue lanzado el 6 de mayo con la promesa de dotar a agentes inteligentes —como Claude Code, Codex y Kiro— de un acceso sencillo a más de 300 APIs de AWS y un catálogo de más de 20 habilidades especializadas que cubren desde decisiones arquitectónicas hasta guías de despliegue y solución de problemas.
Esta herramienta consta de tres componentes fundamentales: el MCP Server que actúa como un punto único para acceder a las APIs de AWS con funciones añadidas como la ejecución segura de scripts en Python y búsqueda en la documentación en tiempo real; las habilidades o «skills», que se presentan como módulos de conocimiento especializado en dominios concretos de AWS; y un archivo de reglas que indica al agente cómo priorizar el uso de estos recursos antes de responder con su conocimiento general.
En una experiencia reciente, un usuario configuró correctamente el MCP Server y las habilidades, pero no incluyó este archivo de reglas en la configuración inicial. Como resultado, el agente respondía sólo a partir de su base de datos interna, sin aprovechar ni la documentación ni las habilidades especializadas que había instalado. Fue sólo tras añadir este archivo de reglas cuando el agente comenzó a utilizar proactivamente el MCP Server y cargar las habilidades relevantes para cada consulta, mejorando notablemente la precisión y especificidad de sus respuestas. 
¿Qué contiene el archivo de reglas?
Este archivo, ubicado en el repositorio del toolkit bajo el directorio rules/, es un pequeño pero crucial componente de 17 líneas que instruye al agente a:
- Preferir el servidor MCP para todas las interacciones con AWS.
- Verificar antes de iniciar una tarea si existe una habilidad AWS relevante disponible.
- Cargar dicha habilidad con el comando
retrieve_skilly basar sus respuestas en la guía de ese conocimiento especializado. - Confirmar detalles técnicos, como parámetros de API o límites, consultando la documentación en lugar de conjeturar.
Esta diferencia entre «tener acceso» y «usar activamente» las habilidades es la clave para aprovechar todo el potencial del toolkit.
Impacto en la arquitectura propuesta
En el caso práctico analizado, el agente inicialmente propuso una arquitectura común para una app CRUD serverless (API Gateway + Lambda + DynamoDB + Cognito) basada en datos generales entrenados. Sin embargo, una vez aplicadas las reglas y habilidades específicas, la sugerencia se refinó, explicitando:
- El tipo de API Gateway recomendado (HTTP API sobre REST API, y las razones para esto).
- El método de autenticación más adecuado (autorizador JWT integrado con Cognito).
- Patrones de funciones recomendados (una función Lambda por ruta).
- Restricciones técnicas detalladas, como límites de tiempo de ejecución o tamaño máximo de carga.
Todo ello aporta un nivel de detalle y rigor que supera las recomendaciones genéricas, ofreciendo además justificaciones concretas y tablas comparativas que enriquecen la toma de decisiones.
Lecciones para desarrolladores de agentes
Este caso demuestra que simplemente dotar a un agente con nuevas herramientas no garantiza que las utilice de manera eficaz. Es imprescindible definir reglas explícitas que le indiquen cuándo y cómo emplearlas. Así, el archivo de reglas pasa de ser un detalle menor a la columna vertebral que integra el conjunto de habilidades en el flujo del agente, transformando el acceso pasivo en un uso proactivo y sistematizado.
Seguridad y control
Otra preocupación habitual es la seguridad: ¿es seguro permitir que un agente interactúe con APIs de AWS? La respuesta es afirmativa, siempre que se configure adecuadamente. El agente puede operar con permisos muy limitados —por ejemplo, sólo lectura—, independientemente del nivel de acceso del usuario. Además, cada petición se registra para mantener un seguimiento transparente de sus acciones.
Las habilidades incluidas han sido probadas exhaustivamente en escenarios reales para asegurar que sigan flujos completos y producen resultados esperados, lo que garantiza una utilización fiable y segura.
En resumen, para aprovechar al máximo el Agent Toolkit de AWS y sus más de 20 habilidades especializadas, no basta con instalarlo: es fundamental añadir y configurar correctamente el archivo de reglas que guía al agente a usar los recursos adecuados en el momento preciso.
