How aws-solutions-library-samples/guidance-for-multi-agent-orchestration-on-aws works
This is a customer-support chatbot demo built around a Bedrock supervisor and specialized agents, with a React chat and agent-trace interface. The principal workflow is a customer inquiry, streamed through the web app and backend to the supervisor for specialist handling, then rendered as an answer. The README documents the agents’ Athena and knowledge-base capabilities; sampled backend files show agent construction and storage setup, but not the full runtime resolver or action execution. Those connections are therefore limited to documented relationships.
Main entry points: multi-agent/index.ts Supervisor Agent · product_recommendation/index.ts Recommendation Agent · personalization/index.ts Personalization Agent · index.tsx Chat Interface
Components 19
Customer Web App
- Chat Interface
src/frontend/src/pages/Home/Chat/index.tsx - Chat API Client
src/frontend/src/pages/Home/Chat/api.ts - Trace Parser
src/frontend/src/utilities/traceParser.ts - Trace Storage
src/frontend/src/utilities/agentTraceStorage.ts - Agent Flow View
src/frontend/src/common/components/react_flow/AgentFlowPanel.tsx
Agent Backend
- Streaming API
src/backend/lib/stacks/backend/streaming-api/index.ts - Stream Resolver
src/backend/lib/stacks/backend/streaming-api/resolver-function/index.ts - Supervisor Agent
src/backend/lib/stacks/backend/multi-agent/index.ts - Order Agent
src/backend/lib/stacks/backend/multi-agent/order_management/index.ts - Recommendation Agent
src/backend/lib/stacks/backend/multi-agent/product_recommendation/index.ts - Troubleshooting Agent
src/backend/lib/stacks/backend/multi-agent/troubleshoot/index.ts - Personalization Agent
src/backend/lib/stacks/backend/multi-agent/personalization/index.ts - Action Executor
src/backend/lib/stacks/backend/multi-agent/action-group/executor-function/index.py
Data and Knowledge
- Athena and Glue Data
src/backend/lib/stacks/backend/storage/index.ts - Knowledge Bases
src/backend/lib/stacks/backend/multi-agent - S3 Data Services
src/frontend/src/pages/Home/Data/s3DataService.ts
Access and Hosting
- Cognito Auth
src/backend/lib/stacks/backend/auth.ts - Web Hosting
src/backend/lib/stacks/frontend/index.ts
Other components
- Customer
Connections 25
- Customer → Chat Interface: submits inquiry
- Chat Interface → Chat API Client: sends messages
- Chat API Client → Streaming API: opens stream
- Streaming API → Stream Resolver: routes requests
src/backend/lib/stacks/backend/streaming-api/index.ts - Stream Resolver → Supervisor Agent: invokes agent
- Supervisor Agent → Order Agent: delegates orders
src/backend/lib/stacks/backend/multi-agent/index.ts - Supervisor Agent → Recommendation Agent: delegates recommendations
src/backend/lib/stacks/backend/multi-agent/index.ts - Supervisor Agent → Troubleshooting Agent: delegates troubleshooting
src/backend/lib/stacks/backend/multi-agent/index.ts - Supervisor Agent → Personalization Agent: delegates personalization
src/backend/lib/stacks/backend/multi-agent/index.ts - Order Agent → Action Executor: uses action group
- Recommendation Agent → Action Executor: uses action group
- Personalization Agent → Action Executor: uses action group
- Order Agent → Athena and Glue Data: queries Athena
- Recommendation Agent → Athena and Glue Data: queries Athena
- Personalization Agent → Athena and Glue Data: queries Athena
- Recommendation Agent → Knowledge Bases: retrieves feedback
src/backend/lib/stacks/backend/multi-agent/product_recommendation/index.ts - Troubleshooting Agent → Knowledge Bases: searches guides
src/backend/lib/stacks/backend/multi-agent/troubleshoot/index.ts - Personalization Agent → Knowledge Bases: uses browsing history
src/backend/lib/stacks/backend/multi-agent/personalization/index.ts - Chat Interface → Trace Parser: parses agent traces
- Trace Parser → Trace Storage: updates traces
src/frontend/src/utilities/traceParser.ts - Agent Flow View → Trace Parser: renders parsed traces
src/frontend/src/common/components/react_flow/AgentFlowPanel.tsx - Agent Flow View → Trace Storage: reads trace state
src/frontend/src/common/components/react_flow/AgentFlowPanel.tsx - Customer → Cognito Auth: authenticates
- Web Hosting → Chat Interface: hosts app
- S3 Data Services → Athena and Glue Data: loads data