# 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`.