How aws-samples/sample-genai-aws-solutions-architect-agent works
This prototype is a Streamlit assistant that turns a user's business requirements into AWS architecture guidance and deliverables. The main workflow runs from chat through agent reasoning and the documented Discovery, Architecture, Cost, and Well-Architected stages; generated files are saved for download. The agent also connects to AWS knowledge, pricing, and diagram MCP servers. Major workflow stages and integrations are documented, but the excerpts do not show every stage's implementation or all UI-to-agent details.
Main entry points: aws_architect.py Architect Agent · app.py Streamlit App · file_writer.py File Writer · sample-prompts.json Sample Prompts
Components 17
User Interface
- Streamlit App
app.py - Sample Prompts
src/ui/sample-prompts.json - Generated Assets
app.py
Architecture Workflow
- Discovery
src/agent/config/prompts.py - AWS Architecture
src/agent/config/prompts.py - Cost Analysis
src/agent/config/prompts.py - Well-Architected Review
src/agent/config/prompts.py - Architect Agent
src/agent/aws_architect.py
Agent Internals
- Agent Configuration
src/agent/config/agent_config.py - System Instructions
src/agent/config/prompts.py - Rate Limiter
src/agent/rate_limiter.py - File Writer
src/utils/file_writer.py - Generated Files
AWS Integrations
- AWS Knowledge MCP
- AWS Pricing MCP
- AWS Diagram MCP
Other components
- User
Connections 16
- User → Streamlit App: submits requirements
README.md - Streamlit App → Architect Agent: initializes
app.py - Streamlit App → Sample Prompts: loads prompts
app.py - Streamlit App → Generated Assets: shows downloads
app.py - Architect Agent → Discovery: guides
README.md - Architect Agent → AWS Architecture: designs
README.md - Architect Agent → Cost Analysis: analyzes costs
README.md - Architect Agent → Well-Architected Review: reviews
README.md - Architect Agent → Agent Configuration: uses settings
src/agent/aws_architect.py - Architect Agent → System Instructions: loads instructions
src/agent/aws_architect.py - Architect Agent → Rate Limiter: uses limiter
src/agent/aws_architect.py - Architect Agent → File Writer: registers tool
src/agent/aws_architect.py - File Writer → Generated Files: writes files
src/utils/file_writer.py - Architect Agent → AWS Knowledge MCP: queries knowledge
README.md - Architect Agent → AWS Pricing MCP: requests pricing
README.md - Architect Agent → AWS Diagram MCP: generates diagrams
README.md