# Demo NMP: agentes y herramientas en AWS

Empieza por [el guion de 15 minutos](docs/01-guion-demo.md).
Este proyecto reúne los dos componentes originales en una estructura autocontenida.
El código de los agentes y Lambdas conserva su comportamiento.

```text
demo/
├── README.md                       # Punto de entrada
├── docs/
│   ├── 01-guion-demo.md             # Orden de presentación
│   ├── 02-arquitectura.md           # Flujo y mapa del código
│   └── 03-preparacion.md            # Requisitos y resolución de problemas
├── scenarios/
│   ├── 01-onboarding/scenario.json  # Prompt y criterios de revisión
│   └── 02-infraestructura/scenario.json
├── src/
│   ├── agents/
│   │   ├── onboarding/              # Runtime Strands de onboarding
│   │   └── aws_infrastructure/      # Runtime Strands de infraestructura
│   └── lambdas/
│       ├── agentcore_proxy/         # Adaptación HTTP → AgentCore
│       └── aws_infrastructure/      # Consultas EC2 y Lambda
├── contracts/tools/                # Una ubicación para los contratos MCP
├── harnesses/                      # Variantes declarativas de infraestructura
├── infra/iam/                      # Políticas y confianza IAM
├── agentcore/                      # Configuración declarativa y CDK
├── scripts/demo.py                 # Validar, empaquetar e invocar
├── tests/                          # Pruebas locales del cliente de demo
├── requirements-demo.txt           # Dependencia del cliente de invocación
└── artifacts/                      # ZIPs generados por package; no versionar
```

## Inicio rápido

Desde `demo/`, con Python 3.10 o posterior:

```powershell
python scripts/demo.py validate
python scripts/demo.py package
```

Estos comandos son locales y no requieren credenciales ni dependencias adicionales.
`validate` comprueba sintaxis y referencias; no sustituye `agentcore validate`.

Pruebas locales del cliente: `python -m unittest discover -s tests -v`.

Para invocar un runtime ya desplegado:

```powershell
python -m pip install -r requirements-demo.txt
python scripts/demo.py invoke --scenario onboarding --runtime-arn <ARN_DEL_RUNTIME_ONBOARDING>
python scripts/demo.py invoke --scenario infraestructura --runtime-arn <ARN_DEL_RUNTIME_INFRAESTRUCTURA>
```

Sustituye los marcadores por los ARN reales. Las invocaciones usan las credenciales
AWS configuradas y pueden consumir servicios facturables. Imprimen la respuesta
real y el ID de sesión; no guardan resultados automáticamente.

## Alcance

La configuración conserva los nombres, ARN y cuenta del proyecto original. Esta
carpeta no representa un entorno AWS aislado y no se ha desplegado. Los scripts
no despliegan ni cambian permisos. Para preparar otro entorno, revisar primero
las referencias descritas en [preparación](docs/03-preparacion.md).

Las implementaciones de clientes, KYC, PLD y documentos dependen de Lambdas
externas que no están incluidas. No hay un modo simulado: sin esos servicios se
puede recorrer el código y validar el scaffold, pero no completar la demo online.

Las carpetas originales del workspace quedan como referencia. Para continuar
esta demo, trabajar en `demo/`; las copias no se sincronizan automáticamente.