2.8 KiB
Preparación
Recorrido local
Python 3.10 o posterior basta para validar y crear los ZIPs. No se requieren credenciales. No se copian cachés, entornos virtuales, secretos, dependencias instaladas, estado de despliegue ni respuestas históricas a este scaffold.
Demo online
- Instalar
requirements-demo.txten el entorno Python elegido. - Configurar las credenciales AWS con acceso a
InvokeAgentRuntimey conocer el ARN del runtime de cada escenario. El cliente toma la región del ARN. - Verificar que los runtimes y gateways están desplegados y que las Lambdas referenciadas existen. El escenario de onboarding requiere un cliente válido.
- Ensayar cada escenario y revisar trazas antes de la presentación.
El cliente permite --profile <PERFIL_AWS>, --session-id <ID> y
--prompt "texto". El timeout de lectura es de 180 segundos.
Desarrollo y configuración
AgentCore CLI, Node.js y uv se necesitan para el flujo de desarrollo/despliegue
original. Ejecutar desde demo/:
agentcore validate
agentcore dev
No modificar el CDK generado para cambiar el comportamiento: usar los JSON y el
código en src/. Los nombres de los recursos determinan su identidad en AWS.
La configuración conserva referencias del entorno original en:
agentcore/aws-targets.json: cuenta y región.agentcore/agentcore.json: ARN de las Lambdas de herramientas.harnesses/*/harness.json: ARN del gateway.src/agents/onboarding/mcp_client/client.py: URL del gateway de onboarding.src/lambdas/agentcore_proxy/agentcore-proxy.py: ARN del runtime de onboarding.infra/iam/: recursos de las políticas existentes.
El agente de infraestructura obtiene su gateway de
AGENTCORE_GATEWAY_AWSINFRASTRUCTURETOOLS_URL. Su código espera la variable de
memoria MEMORY_MYAGENTAWSINFRASTRUCTUREAGENTMEMORY_ID, mientras que la configuración
declara una memoria llamada AwsInfraMemory. Revisar esa asociación antes de
demostrar persistencia de infraestructura; el scaffold conserva esta diferencia
del código original y no garantiza que la memoria esté conectada.
Diagnóstico durante la demo
| Síntoma | Revisar |
|---|---|
| Falta boto3 | Instalar requirements-demo.txt con el mismo Python |
| Acceso denegado | Perfil, cuenta y permisos sobre el ARN elegido |
| Herramientas no disponibles | URL del gateway, variables de entorno y Lambdas |
| Respuesta vacía o error SSE | El cliente imprime los eventos recibidos si no encuentra texto |
| Cliente inexistente | Cambiar el prompt por un ID válido del entorno |
agentcore no reconocido |
Instalar/configurar el CLI antes de validar el esquema oficial |
Los ZIPs de artifacts/ contienen únicamente las dos Lambdas. Los agentes se
empaquetan mediante AgentCore con sus propios pyproject.toml y uv.lock.