Tutorial/multi agent agentcore deployment

[manoj-selvakumar5]

Summary

• Adds a new deployment tutorial that walks through building and deploying a multi-agent system on AgentCore using A2A
• Implements an e-commerce shopping assistant with three agents: a Product Agent, an Order Agent, and an Orchestrator
• Each agent is deployed to its own AgentCore runtime, discovers peers via agent cards, and communicates through standardized A2A JSON-RPC messages

What's included

3 Jupyter notebooks (run in order):

1. Product Agent — A2A server that query the DummyJSON product catalog API
2. Order Agent — A2A server with MCP integration for DynamoDB order lookup, using an async lifespan pattern to load tools after the server binds to port
3. Orchestrator — HTTP endpoint that uses A2AClientToolProvider to discover specialist agents and route user queries via SigV4-authenticated A2A calls

Agent source files (product_agent/, order_agent/, orchestrator/):

• Self-contained server code generated/referenced by each notebook
• Per-agent requirements.txt for container builds

Shared utilities (utils/):

• config.py — SSM paths and agent name constants
• iam.py — IAM execution role creation with cross-account protection and scoped permissions
• sigv4_auth.py — httpx.Auth implementation for SigV4-signed inter-agent requests
• dynamodb_setup.py — Table creation and sample data seeding
• ssm_helpers.py — Parameter Store read/write helpers
• streaming.py — Streaming display with in-place status updates and A2A event handling
• callbacks.py — Tool logging callback handlers with deduplication

Sample data (sample_data/orders.json):

• 6 orders across 3 customers with product IDs that reference the DummyJSON catalog, enabling combined multi-agent queries

Test plan

• Run Notebook 1: Product Agent deploys and responds to A2A test queries
• Run Notebook 2: Order Agent deploys, DynamoDB seeded, MCP tools load successfully
• Run Notebook 3: Orchestrator deploys and routes queries to both specialist agents

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[github-actions]

Latest scan for commit: d42bbf7 | Updated: 2026-02-13 03:25:24 UTC

✅ Security Scan Report (PR Files Only)

Scanned Files

• 01-tutorials/03-deployment/04-multi-agent-agentcore-deployment/01-a2a-orchestration/01-a2a-server-product-agent.ipynb
• 01-tutorials/03-deployment/04-multi-agent-agentcore-deployment/01-a2a-orchestration/02-a2a-server-order-agent.ipynb
• 01-tutorials/03-deployment/04-multi-agent-agentcore-deployment/01-a2a-orchestration/03-a2a-client-orchestrator-agent.ipynb
• 01-tutorials/03-deployment/04-multi-agent-agentcore-deployment/01-a2a-orchestration/README.md
• 01-tutorials/03-deployment/04-multi-agent-agentcore-deployment/01-a2a-orchestration/images/architecture.png
• 01-tutorials/03-deployment/04-multi-agent-agentcore-deployment/01-a2a-orchestration/orchestrator/agent.py
• 01-tutorials/03-deployment/04-multi-agent-agentcore-deployment/01-a2a-orchestration/orchestrator/app.py
• 01-tutorials/03-deployment/04-multi-agent-agentcore-deployment/01-a2a-orchestration/orchestrator/requirements.txt
• 01-tutorials/03-deployment/04-multi-agent-agentcore-deployment/01-a2a-orchestration/order_agent/a2a_server.py
• 01-tutorials/03-deployment/04-multi-agent-agentcore-deployment/01-a2a-orchestration/order_agent/requirements.txt
• ... and 12 more files

---

Security Scan Results

Critical	High	Medium	Low	Info
0	0	0	0	0

Threshold: High

No security issues detected in your changes. Great job!

This scan only covers files changed in this PR.