nmpAgents/demo/README.md

Demo NMP: agentes y herramientas en AWS

Empieza por el guion de 15 minutos. Este proyecto reúne los dos componentes originales en una estructura autocontenida. El código de los agentes y Lambdas conserva su comportamiento.

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:

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:

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.

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.