Agent Guides
🤖 Agent Guides
Section titled “🤖 Agent Guides”Comprehensive, production-ready documentation for building AI agents across 16+ frameworks.
Welcome to the Agent Guides collection—your complete resource for mastering AI agent development. Whether you’re building your first chatbot or deploying enterprise-scale multi-agent systems, you’ll find detailed guides, practical recipes, and production patterns here.
🎯 Featured Frameworks
Section titled “🎯 Featured Frameworks”⭐ New & Recommended
Section titled “⭐ New & Recommended”Multi-agent systems with lightweight primitives and powerful abstractions.
Quick Links:
Install: pip install openai-agents
Lightweight Python framework where agents write code instead of JSON.
Quick Links:
Install: pip install smolagents
🔍 Quick Navigation
Section titled “🔍 Quick Navigation”By Use Case
Section titled “By Use Case”- Chatbots & Assistants: OpenAI Agents SDK, SmolAgents, CrewAI
- Data & Retrieval: LlamaIndex, Haystack
- Complex Workflows: LangGraph, AG2
- Cloud Native: Amazon Bedrock, Microsoft Agent Framework
- Type Safety: PydanticAI
By Language
Section titled “By Language”- Python: All frameworks
- TypeScript: LangGraph, Claude SDK, OpenAI SDK
- C#: Semantic Kernel
By Skill Level
Section titled “By Skill Level”- Beginner: SmolAgents, PydanticAI, CrewAI
- Intermediate: LangGraph, LlamaIndex, OpenAI Agents SDK
- Advanced: AG2, Haystack, Custom multi-agent systems
📚 All Frameworks
Section titled “📚 All Frameworks”Core Multi-Agent Orchestration
Section titled “Core Multi-Agent Orchestration”- CrewAI - Role-based agent teams
- AG2 - Research & experimentation
- LangGraph - Graph-based workflows
- LangGraph TypeScript - TypeScript workflows
Data & Knowledge Retrieval
Section titled “Data & Knowledge Retrieval”- LlamaIndex - RAG and data indexing
- Haystack - Production search systems
Type-Safe Development
Section titled “Type-Safe Development”- PydanticAI - Structured validation
- Semantic Kernel - Microsoft patterns
Cloud & Hosted Models
Section titled “Cloud & Hosted Models”- Amazon Bedrock Agents - AWS integration
- Microsoft Agent Framework - Azure integration
- Google ADK - Google integration
- Mistral Agents API - Mistral platform
Model-Specific
Section titled “Model-Specific”- Anthropic Claude - Python
- Anthropic Claude TypeScript - TypeScript
- OpenAI Agents TypeScript - TypeScript
📖 Each Guide Includes
Section titled “📖 Each Guide Includes”Every framework guide contains:
- README - Quick start & overview
- Comprehensive Guide - Complete feature reference (~50-100 pages)
- Production Guide - Deployment & scaling
- Diagrams Guide - Architecture visualisations
- Recipes - Copy-paste ready code examples
🚀 Getting Started
Section titled “🚀 Getting Started”Step 1: Choose Your Framework
Section titled “Step 1: Choose Your Framework”Use the table below or browse above:
| Framework | Best For | Complexity | Time to Learn |
|---|---|---|---|
| SmolAgents | Simple agents | Low | 1 hour |
| PydanticAI | Type safety | Low-Medium | 2 hours |
| OpenAI Agents SDK | Multi-agent | Medium | 4 hours |
| CrewAI | Role-based teams | Medium | 4 hours |
| LangGraph | Complex workflows | High | 8 hours |
| LlamaIndex | RAG systems | Medium | 6 hours |
Step 2: Read the Framework’s README
Section titled “Step 2: Read the Framework’s README”Each guide folder contains a README with:
- Installation instructions
- Basic example
- Key concepts
- Links to deeper documentation
Step 3: Explore Practical Recipes
Section titled “Step 3: Explore Practical Recipes”The Recipes guide contains copy-paste ready examples:
- Common use cases
- Integration patterns
- Best practices in action
Step 4: Study Production Deployment
Section titled “Step 4: Study Production Deployment”For production systems, read:
- Production Guide
- Diagrams Guide for architecture
- Security & monitoring sections
💡 Key Concepts Explained
Section titled “💡 Key Concepts Explained”Agents
Section titled “Agents”Autonomous systems with instructions, tools, and decision-making.
Tools/Functions
Section titled “Tools/Functions”Executable actions agents can call to interact with external systems.
Multi-Agent Systems
Section titled “Multi-Agent Systems”Coordination of multiple specialised agents:
- Sequential handoffs
- Parallel execution
- Hierarchical delegation
Guardrails
Section titled “Guardrails”Safety constraints:
- Input validation
- Output filtering
- Rate limiting
- Access control
Sessions & Memory
Section titled “Sessions & Memory”State management:
- Conversation history
- Long-term storage
- Context management
📊 Framework Comparison
Section titled “📊 Framework Comparison”Want to compare features across frameworks? Check out our Comparison Guide.
🆘 Need Help?
Section titled “🆘 Need Help?”Questions?
Section titled “Questions?”- Check the framework’s README
- Search the Comprehensive Guide
- Look for examples in Recipes
- Review the Production Guide for deployment issues
Found an Issue?
Section titled “Found an Issue?”- Report documentation errors
- Suggest improvements
- Contribute examples
🤝 Contributing
Section titled “🤝 Contributing”Help make this resource better:
- Fix errors or typos
- Add new examples
- Improve diagrams
- Update for new versions
- Share your patterns
📄 Documentation Standards
Section titled “📄 Documentation Standards”All guides follow consistent standards:
- ✅ British English spelling (optimisation, favour, analyse)
- ✅ Tested code examples
- ✅ Production-ready patterns
- ✅ Clear structure from basic to advanced
- ✅ Visual diagrams for architecture
📅 Last Updated
Section titled “📅 Last Updated”April 2026
🙏 Acknowledgments
Section titled “🙏 Acknowledgments”This collection is maintained by the community for the community. Thank you to all contributors!
Start exploring: Browse All Guides →