🤖 AI Agent Templates

Production-ready, YAML-configurable AI agent templates powered by CrewAI. Clone, customize, deploy — no ML expertise required.

Why?

AI agent frameworks are powerful — but going from "hello world" to production takes hours of boilerplate. These templates give you:

• Multi-agent architecture out of the box (classifier → specialists)
• YAML configuration for agents & tasks (no code changes to customize)
• Multiple LLM support (OpenAI, Azure OpenAI, Anthropic, Ollama)
• CLI with 3 modes (interactive, single query, batch)
• Comprehensive test suites (684 tests, all mocked — no API keys needed)
• Setup scripts for instant onboarding

Templates

| Template | Description | Agents | Tests | | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------- | ----- | | 🤖 Customer Support | Classify inquiries, answer FAQs (RAG), create tickets, escalate urgent issues | 4 (Classifier → FAQ / Ticket / Escalation) | 47 | | 💼 Subsidy Consultant | Match Japanese SME grants, draft applications, score proposals, summarize guidelines | 4 (Matcher / Writer / Scorer / Summarizer) | 29 | | 🛒 E-commerce Assistant | Search products, track orders, handle returns, recommend items | 5 (Classifier → Search / Order / Return / Recommend) | 62 | | ⚖️ Legal Document Analyzer | Extract clauses, analyze risks, summarize contracts, compare documents | 5 (Classifier → Clause / Risk / Summary / Compare) | 66 | | 📊 Sales Lead Qualifier | Score leads (BANT), research companies, compose outreach emails, handle objections | 5 (Classifier → Scorer / Researcher / Email / Objection) | 73 | | 🖥️ IT Helpdesk | Reset passwords, troubleshoot software, diagnose network, handle hardware issues | 5 (Classifier → Password / Software / Network / Hardware) | 92 | | 👥 HR Onboarding | Collect documents, set up IT accounts, schedule training, match buddies | 5 (Classifier → Document / IT Setup / Training / Buddy) | 104 | | 📝 Content Marketing | Plan content strategy, write blogs, create social media, analyze SEO | 5 (Classifier → Strategist / Writer / Social / SEO) | 112 | | 🔄 Data Pipeline Monitor | Monitor pipeline health, analyze data quality, manage alerts, advise recovery | 5 (Classifier → Health / Quality / Alert / Recovery) | 99 |

Quick Start

# 1. Clone
git clone https://github.com/your-username/ai-agent-templates.git
cd ai-agent-templates/templates/customer-support

# 2. Setup (auto: venv + deps + .env)
bash setup.sh        # Linux / macOS
.\setup.ps1          # Windows

# 3. Run
python -m customer_support --query "How do I reset my password?"

Architecture

Each template follows the same pattern:

template/
├── pyproject.toml          # Dependencies & metadata
├── setup.sh / setup.ps1    # One-command setup
├── .env.example            # LLM config template
├── src/
│   └── <package>/
│       ├── main.py         # CLI entry point
│       ├── crew.py         # Agent & task definitions
│       ├── config/
│       │   ├── agents.yaml # Agent roles, goals, backstories
│       │   └── tasks.yaml  # Task descriptions & expected outputs
│       ├── tools/          # Custom CrewAI tools
│       └── knowledge/      # RAG data (Markdown / YAML)
└── tests/
    └── test_*.py           # Comprehensive test suite

Key design principle: All agent behavior is defined in YAML. Users customize agents.yaml and tasks.yaml — no Python changes needed.

Testing

Each template has its own test suite that runs without API keys (all LLM calls are mocked):

cd templates/customer-support
pip install -e ".[dev]"
pytest -v  # 47 tests

cd ../subsidy-consultant
pip install -e ".[dev]"
pytest -v  # 29 tests

cd ../hr-onboarding
pip install -e ".[dev]"
pytest -v  # 104 tests

Contributing

See CONTRIBUTING.md for guidelines.

License

This repository is dual-licensed:

• Root (framework, docs, CI): CC BY-NC-SA 4.0
• Individual templates (templates/*/): Apache 2.0 — see each template's LICENSE file

Built with CrewAI | Star ⭐ if useful!