Workshop Materials Index

Complete guide to all workshop materials and their purposes.

Workshop Overview

Duration: 90 minutes
Format: Hands-on coding workshop
Level: Intermediate
Topic: Building Multi-Agent Systems with Strands Framework

Materials Structure

workshop/
├── README.md                    # Main workshop overview and schedule
├── FACILITATOR_GUIDE.md         # For instructors running the workshop
├── QUICK_REFERENCE.md           # Printable quick reference card
├── TROUBLESHOOTING.md           # Comprehensive troubleshooting guide
├── WORKSHOP_INDEX.md            # This file - materials index
├── step1-script-agent.md        # Step 1: Building first agent
├── step2-social-agent.md        # Step 2: Adding built-in tools
├── step3-tts-agent.md           # Step 3: Creating custom tools
├── step4-research-agent.md      # Step 4: Complex workflows
├── step5-orchestrator.md        # Step 5: Multi-agent coordination
└── step6-complete-pipeline.md   # Step 6: Testing & production

File-by-File Guide

Core Workshop Materials

1. README.md

Purpose: Main entry point for workshop participants
Contains:

• Workshop overview and objectives
• 90-minute schedule breakdown
• Prerequisites and setup instructions
• Learning objectives
• Resource links

When to use: Start here! Read before beginning workshop.

Key sections:

• Workshop Structure (timing breakdown)
• Prerequisites (what you need)
• Workshop Setup (getting started)
• Workshop Steps (links to all steps)

2. step1-script-agent.md

Git Tag: v0.1.0
Duration: 15 minutes (00:00-15:00)
Purpose: Learn agent basics

What you’ll build:

• First Strands agent
• Script generation capability
• Basic prompt engineering

Key concepts:

• Agent initialization
• Model configuration
• System prompts
• Result handling

Files created:

• app/script_agent/agent.py
• app/script_agent/prompt.md
• Updated main.py

3. step2-social-agent.md

Git Tag: v0.3.0
Duration: 15 minutes (15:00-30:00)
Purpose: Add tools to agents

What you’ll build:

• Social media content agent
• Integration with built-in tools
• Multi-model support (OpenAI/Anthropic)

Key concepts:

• Tool integration
• Built-in vs custom tools
• Tool selection by agents
• fetch_url tool usage

Files created:

• app/social_agent/agent.py
• app/social_agent/prompt.md

4. step3-tts-agent.md

Git Tag: v0.4.0
Duration: 10 minutes (30:00-40:00)
Purpose: Create custom tools

What you’ll build:

• Text-to-speech agent
• Custom ElevenLabs tool
• Binary data handling

Key concepts:

• Custom tool creation
• External API integration
• Error handling in tools
• Tool documentation

Files created:

• app/tts_agent/agent.py
• app/tts_agent/prompt.md
• app/tts_agent/tools/elevenlabs_tool.py

5. step4-research-agent.md

Git Tag: v0.5.0
Duration: 15 minutes (40:00-55:00)
Purpose: Build complex workflows

What you’ll build:

• Research agent with iteration
• Tavily search integration
• Retry logic with backoff
• Token management

Key concepts:

• Multi-turn conversations
• Exponential backoff
• Conversation summarization
• External search APIs

Files created:

• app/research_agent/agent.py
• app/research_agent/prompt.md
• app/research_agent/tools/tavily_tool.py
• app/utils/retry_utils.py

6. step5-orchestrator.md

Git Tag: v0.7.0
Duration: 15 minutes (55:00-70:00)
Purpose: Coordinate multiple agents

What you’ll build:

• Orchestrator agent
• TODO-driven execution
• Structured I/O with Pydantic
• Dependency management

Key concepts:

• Multi-agent coordination
• Execution planning
• Dependency resolution
• Error recovery

Files created:

• app/orchestrator_agent/agent.py
• app/orchestrator_agent/prompt.md
• app/orchestrator_agent/TODO_TEMPLATE.md
• app/model/agent_input.py

7. step6-complete-pipeline.md

Git Tag: v0.7.0 (current)
Duration: 10 minutes (70:00-80:00)
Purpose: Test and prepare for production

What you’ll learn:

• Testing strategies
• Debugging techniques
• Performance optimization
• Production deployment
• Best practices

Topics covered:

• Integration testing
• Error monitoring
• Health checks
• Deployment options
• Performance benchmarks

Support Materials

FACILITATOR_GUIDE.md

Audience: Workshop instructors
Purpose: Guide for running workshop effectively

Contains:

• Pre-workshop preparation checklist
• Detailed timing for each section
• Live coding tips
• Common issues and solutions
• Student question responses
• Post-workshop follow-up

Key sections:

• Pre-Workshop Preparation
• Workshop Delivery (detailed timing)
• Handling Different Scenarios
• Engagement Techniques
• Common Participant Questions

When to use:

• Before workshop (preparation)
• During workshop (timing reference)
• After workshop (follow-up)

QUICK_REFERENCE.md

Audience: All participants
Purpose: Quick lookup during workshop

Contains:

• Git commands for workshop
• Environment setup
• Agent creation patterns
• Common code snippets
• Error messages and solutions
• Keyboard shortcuts

Format: Designed to be printed as reference card

When to use:

• During workshop (constant reference)
• While coding exercises
• When encountering errors

Tip: Print and keep beside computer!

TROUBLESHOOTING.md

Audience: All participants and instructors
Purpose: Comprehensive problem-solving guide

Contains:

• Setup issues and solutions
• API key problems
• Import errors
• Agent execution issues
• Tool problems
• Performance issues
• Platform-specific issues

Organization: By problem category with symptoms and solutions

When to use:

• When stuck on an issue
• Before asking for help (check here first!)
• For debugging production problems

Coverage:

• 7 major problem categories
• 50+ specific issues
• Step-by-step solutions
• Advanced debugging techniques

Git Tags Reference

Each workshop step corresponds to a git tag:

Usage:

git checkout v0.1.0  # Go to Step 1
git checkout v0.3.0  # Go to Step 2
# etc...
git checkout main    # Return to latest

Recommended Reading Order

For Participants (Before Workshop):

1. ✅ README.md - Overview and setup
2. ✅ QUICK_REFERENCE.md - Familiarize with commands
3. ✅ Complete Prerequisites section

During Workshop:

1. Follow step guides in order (step1 → step2 → … → step6)
2. Keep QUICK_REFERENCE.md handy
3. Consult TROUBLESHOOTING.md when stuck

For Instructors (Before Workshop):

1. ✅ README.md - Workshop overview
2. ✅ FACILITATOR_GUIDE.md - Delivery instructions
3. ✅ All step files - Know the content
4. ✅ TROUBLESHOOTING.md - Common issues
5. ✅ Practice run-through

After Workshop:

1. Review step files for concepts you want to revisit
2. Read advanced sections you skipped
3. Explore production deployment (step6)
4. Build your own agents!

Workshop Progression

Learning Path:

Step 1: Script Agent
  ↓
Learn: Agent basics, prompts, models
  ↓
Step 2: Social Agent
  ↓
Learn: Built-in tools, tool integration
  ↓
Step 3: TTS Agent
  ↓
Learn: Custom tools, external APIs
  ↓
Step 4: Research Agent
  ↓
Learn: Complex workflows, retries, token management
  ↓
Step 5: Orchestrator
  ↓
Learn: Multi-agent coordination, planning
  ↓
Step 6: Production
  ↓
Learn: Testing, deployment, best practices
  ↓
Complete Multi-Agent System! 🎉

Skill Building:

File Size and Reading Time

Estimated reading times (without coding):

Total Reading: ~2.5 hours
Total Coding: ~1.5 hours
Workshop Delivery: 1.5 hours (guided, faster)

Additional Resources

In Repository:

• /examples/ - Example code and usage
• /README.md - Project documentation
• /docs/ - Additional documentation

External:

• Strands Documentation
• Anthropic API Docs
• Workshop GitHub

Feedback and Improvements

Contributing:

Found an issue or have a suggestion?

1. Typos/Errors: Create GitHub issue
2. Content Improvements: Submit pull request
3. New Examples: Share in discussions
4. Questions: Ask in Discord

Version History:

• v1.0 (Oct 2024): Initial workshop release
• v1.1: Updates based on first workshop feedback
• v1.2: Additional troubleshooting content

Workshop Statistics

Complete Materials Include:

• 10 workshop files (87 pages total)
• 6 hands-on coding steps
• 5 specialized agents
• 3 custom tools
• 100+ code examples
• 50+ troubleshooting scenarios
• 90 minutes of instruction

Learning Outcomes:

• ✅ Understand agent architecture
• ✅ Build production-ready agents
• ✅ Integrate tools (built-in and custom)
• ✅ Orchestrate multi-agent workflows
• ✅ Deploy and monitor systems
• ✅ Apply best practices

Quick Start

Never done workshop before?

1. Read README.md
2. Complete setup (install, API keys)
3. Print QUICK_REFERENCE.md
4. Follow step guides in order
5. Refer to TROUBLESHOOTING.md when stuck
6. Ask for help when needed!

Instructor preparing workshop?

1. Read FACILITATOR_GUIDE.md
2. Review all step files
3. Practice each section
4. Test all code examples
5. Prepare backup demos
6. Set up demo environment

Questions?

• 📧 Email: [instructor-email]
• 💬 Discord: [discord-link]
• 🐛 Issues: [github-issues]
• 📖 Docs: [documentation-link]

Happy Learning! 🚀

This workshop is designed to take you from zero to production-ready multi-agent system in 90 minutes. Follow the materials, ask questions, and most importantly - have fun building!