nmpAgents/README.md

52 lines
2.6 KiB
Markdown

# Agentes NMP
## Demo guiada
El nuevo scaffold está en **[demo/](demo/README.md)**. Reúne los agentes,
Lambdas, contratos y configuración en un solo proyecto, con un guion de 15
minutos, dos escenarios y comandos de validación, empaquetado e invocación.
Para continuar la demo, trabajar en esa carpeta. Las carpetas descritas abajo
se conservan como referencia del código original; no se sincronizan con `demo/`.
El workspace contiene dos componentes relacionados:
- [nmpOnboardingAgent](nmpOnboardingAgent/README.md): agentes Strands, configuración de Bedrock AgentCore, harnesses, contratos MCP y proxy HTTP.
- [nmpAWSInfraestructure](nmpAWSInfraestructure/README.md): implementación de la Lambda que consulta EC2 y Lambda.
## Flujo
El proxy invoca el runtime de onboarding. Este consulta las herramientas de clientes,
KYC, PLD y documentos mediante `nmpEnterpriseTools`.
El agente de infraestructura y los harnesses consultan `awsInfrastructureTools`,
que apunta a la Lambda implementada en `nmpAWSInfraestructure/src/`.
Las implementaciones de las Lambdas de clientes, KYC, PLD y documentos no están
incluidas en este workspace; sus contratos y referencias AWS sí lo están.
## Organización
```text
nmpAgents/
├── nmpOnboardingAgent/
│ ├── app/ # Runtimes Python; cada agente se empaqueta por separado
│ ├── harnesses/ # Configuración y prompts de los harnesses
│ ├── lambdas/ # Proxy de invocación de AgentCore
│ ├── schemas/tools/ # Contratos MCP usados por los gateways
│ ├── infra/iam/ # Políticas y relaciones de confianza IAM
│ ├── agentcore/ # Configuración declarativa y CDK generado
│ ├── examples/proxy/ # Solicitud y respuesta de referencia
│ └── artifacts/legacy/ # ZIPs anteriores a la reorganización
└── nmpAWSInfraestructure/
├── src/ # Código de la Lambda
├── schemas/ # Contrato de referencia del componente
├── examples/ # Solicitud y respuesta de referencia
└── artifacts/legacy/ # ZIPs anteriores a la reorganización
```
Los nombres de los recursos AWS y los entrypoints se conservan. Los cambios de
ubicación no constituyen un despliegue. `agentcore/agentcore.json` sigue siendo la
fuente de verdad y sus rutas se resuelven desde `nmpOnboardingAgent/`.
Las respuestas de `examples/` son capturas históricas, no pruebas del estado actual
de AWS. Los ZIPs en `artifacts/legacy/` se conservan como referencia; los nuevos
paquetes deben construirse desde el código fuente.