63 lines
2.8 KiB
Markdown
63 lines
2.8 KiB
Markdown
# 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
|
|
|
|
1. Instalar `requirements-demo.txt` en el entorno Python elegido.
|
|
2. Configurar las credenciales AWS con acceso a `InvokeAgentRuntime` y conocer el
|
|
ARN del runtime de cada escenario. El cliente toma la región del ARN.
|
|
3. Verificar que los runtimes y gateways están desplegados y que las Lambdas
|
|
referenciadas existen. El escenario de onboarding requiere un cliente válido.
|
|
4. 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/`:
|
|
|
|
```powershell
|
|
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`.
|