How aws-samples/sample-amazon-bedrock-for-beginners works
This repository is a tutorial series of runnable Amazon Bedrock examples, culminating in an interactive university FAQ agent. In the capstone flow, a student asks a question in the terminal; the Strands agent uses a Bedrock model, retrieves FAQ material from a Knowledge Base, or looks up a course, then returns an answer. The README also documents uploading FAQ files to S3 and syncing them into the Knowledge Base. The graph preserves standalone Converse, multi-turn, tool-use, guarded RAG, and managed-KB examples. Agent wiring is based on the sampled capstone source; Knowledge Base provisioning and ingestion are documented rather than implemented here.
Main entry points: strands_agent.py University agent · tool_use.py Tool-use demo · guardrails.py Guarded KB demo · converse_api.py Converse demo
Components 19
Bedrock examples
- Converse demo
bedrock-examples/converse_api.py - Multi-turn demo
bedrock-examples/multi_turn.py - Tool-use demo
bedrock-examples/tool_use.py - KB query demo
bedrock-examples/knowledge_base_query.py - Guarded KB demo
bedrock-examples/guardrails.py - Managed KB demo
bedrock-examples/managed_knowledge_base_query.py - Bedrock runtime
University agent
- University agent
bedrock-examples/strands_agent.py - Course lookup
bedrock-examples/strands_agent.py - Retrieve tool
bedrock-examples/strands_agent.py - Bedrock model
bedrock-examples/strands_agent.py
Knowledge Base
- Agent runtime
- Guardrail
- University FAQs
knowledge_base_docs - Amazon S3
- Knowledge Base
- Managed Knowledge Base
Other components
- Student
- Terminal
Connections 21
- Student → Terminal: asks
- Terminal → University agent: submits prompt
- University agent → Terminal: prints answer
- University agent → Bedrock model: invokes
- Bedrock model → Bedrock runtime: requests inference
- Bedrock model → Guardrail: applies safety
- University agent → Retrieve tool: dispatches retrieval
- Retrieve tool → Knowledge Base: retrieves FAQ
- University agent → Course lookup: dispatches lookup
- University FAQs → Amazon S3: uploaded to
- Amazon S3 → Knowledge Base: synced into
- Converse demo → Bedrock runtime: calls Converse
- Multi-turn demo → Bedrock runtime: calls Converse
- Tool-use demo → Bedrock runtime: calls Converse
- Tool-use demo → Bedrock runtime: sends tool result
- KB query demo → Agent runtime: calls retrieval
- Agent runtime → Knowledge Base: queries
- Guarded KB demo → Agent runtime: calls retrieval
- Guarded KB demo → Guardrail: configures safety
- Managed KB demo → Agent runtime: calls retrieval
- Agent runtime → Managed Knowledge Base: queries