73 lines
3.3 KiB
Markdown
73 lines
3.3 KiB
Markdown
# 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.
|