How aws-samples/sample-voice-ai-agent-studio works
Conversational AI Agent Studio guides users from agent setup—template, speech pipeline, voice, prompt, workflow, and integrations—to browser testing and deployment on Bedrock AgentCore; agents can also be reached by PSTN or SIP relays. Separate product branches manage RAG and tools, agent history, and evaluation suites, including simulated conversations and judge scoring. The graph combines documented capabilities with evidenced source references; several API routes and frontend flows are represented at subsystem level because their implementation excerpts were not provided.
Main entry points: agent/main.py AgentCore voice runtime · App.tsx Studio UI · nova-sonic-eval-harness/main.py Conversation evaluator · apiClient.ts Authenticated API client
Components 25
Agent Studio
- Studio UI
source/frontend/src/App.tsx - Agent wizard
source/frontend/src/context/WizardContext.tsx - Pipeline selection
source/frontend/src/pages/PipelineSelection.tsx - Agent management
source/frontend/src/pages/AgentDetail.tsx - Authenticated API client
source/frontend/src/services/apiClient.ts - Studio API handlers
source/api - Agent configuration API
deployment/demos_stack/demos_stack.py
Voice Runtime
- AgentCore voice runtime
source/agent/main.py - Strands BidiAgent
source/agent/strands_agent.py - Call history
source/agent/call_history_logger.py
Agent Integrations
- Tool integrations
source/agent/tools/registry.py - RAG runtime
source/agent/rag_tools.py - RAG management API
source/api/rag_handler.py
Evaluation
- Evaluation suite UI
source/frontend/src/pages/EvalSuiteDetail.tsx - Evaluation APIs
source/api/eval_handler.py - Conversation evaluator
source/eval-runner/nova-sonic-eval-harness/main.py - Nova Sonic streaming
source/eval-runner/nova-sonic-eval-harness/core/sonic_stream_manager.py - LLM judge
source/eval-runner/nova-sonic-eval-harness/evaluation/llm_judge_binary.py - Evaluation results
source/eval-runner/nova-sonic-eval-harness/logging_/results_manager.py
Voice Channels
- PSTN relay
telephony/pstn/tac_server.py - SIP relay
telephony/sip/bridge/index.js
Other components
- Studio user
- Voice caller
- AWS Bedrock
- Phone network
Connections 27
- Studio user → Studio UI: configures agents
README.md - Studio UI → Pipeline selection: routes wizard
source/frontend/src/App.tsx - Pipeline selection → Agent wizard: updates pipeline
source/frontend/src/pages/PipelineSelection.tsx - Studio UI → Agent management: routes management
source/frontend/src/App.tsx - Agent management → Authenticated API client: requests API
- Authenticated API client → Studio API handlers: sends authenticated requests
README.md - Authenticated API client → Agent configuration API: loads agent configurations
- Studio UI → RAG management API: configures knowledge sources
- RAG management API → Authenticated API client: uses requests
- Studio API handlers → AgentCore voice runtime: provides agent configuration
- AgentCore voice runtime → Strands BidiAgent: creates agent
source/agent/main.py - AgentCore voice runtime → Call history: logs conversations
source/agent/main.py - AgentCore voice runtime → Tool integrations: loads tools
source/agent/main.py - AgentCore voice runtime → RAG runtime: loads RAG tools
source/agent/main.py - AgentCore voice runtime → AWS Bedrock: runs on AgentCore
README.md - Studio user → Evaluation suite UI: defines evaluation suites
README.md - Evaluation suite UI → Evaluation APIs: manages evaluations
- Evaluation APIs → Conversation evaluator: starts evaluations
- Conversation evaluator → Nova Sonic streaming: streams test sessions
source/eval-runner/nova-sonic-eval-harness/main.py - Conversation evaluator → LLM judge: scores conversations
source/eval-runner/nova-sonic-eval-harness/main.py - Conversation evaluator → Evaluation results: records results
source/eval-runner/nova-sonic-eval-harness/main.py - Voice caller → PSTN relay: calls phone number
README.md - PSTN relay → AgentCore voice runtime: bridges voice session
- Voice caller → SIP relay: starts SIP call
README.md - SIP relay → AgentCore voice runtime: bridges voice session
- Phone network → PSTN relay: carries calls
README.md - Phone network → SIP relay: carries SIP media
README.md