教程

CrewAI 快速上手教程:30 分钟搭建第一个多 Agent 协作系统(含完整代码)

CrewAI 完整入门教程:Agent/Task/Crew 三大构建块详解,30 分钟实现技术资讯自动生成的多 Agent 系统,含并行执行配置、内存设置、成本分级控制,以及 Agent 忽略工具、输出不稳定等常见问题解决。

2026/4/172分钟 阅读ClaudeEagle

在三大 AI Agent 框架里,CrewAI 是原型速度最快的——定义几个有角色的 Agent,分配任务,几十行代码,一个能协作的多 Agent 系统就跑起来了。这篇文章带你 30 分钟完成第一个真实可用的 CrewAI 项目。


环境准备

bash
pip install crewai crewai-tools

需要一个 LLM API Key,推荐 OpenRouter:

bash
export OPENROUTER_API_KEY="sk-or-your-key"
# 或者 Anthropic 直连
export ANTHROPIC_API_KEY="sk-ant-your-key"

核心概念:三个构建块

1. Agent(智能体)

有角色、目标、工具和背景故事的执行者:

python
from crewai import Agent
from crewai_tools import SerperDevTool

search_tool = SerperDevTool()

researcher = Agent(
    role="Senior Research Analyst",
    goal="找到关于 {topic} 的全面、最新信息",
    backstory="你是技术研究领域的资深专家,擅长从大量信息中提炼关键洞察。",
    tools=[search_tool],
    llm="anthropic/claude-sonnet-4-5",
    verbose=True
)

writer = Agent(
    role="Technical Writer",
    goal="把研究结果转化为清晰易读的技术文章",
    backstory="你有丰富的技术写作经验,能把复杂概念解释得简单明了。",
    llm="anthropic/claude-haiku-4-5",  # 写作用轻量模型节省成本
    verbose=True
)

2. Task(任务)

分配给 Agent 的具体工作,有描述、期望输出和执行者:

python
from crewai import Task

research_task = Task(
    description=

相关文章推荐

教程Claude Agent SDK 官方指南:用 TypeScript 与 Python 构建生产级 AI AgentClaude Agent SDK 官方文档中文整理:SDK 与 CLI 的关系、适用场景、TypeScript/Python 基础用法、query API、流式消息、工具权限控制、MCP 集成、会话管理、生产部署边界和安全建议。2026/5/20教程LangGraph 2026 完全解析:从零到生产的确定性 AI 工作流引擎实战指南LangGraph 2026 版完整教程:状态机 + LLM 的核心心智模型、State/Node/Edge/Loop/Checkpoint 五大概念详解、生产级 Code Review Agent 完整代码、Human-in-the-Loop 实现、LangGraph Platform 部署,以及与 LangChain 的本质差异。2026/4/19教程AutoGen 实战入门:用微软多 Agent 对话框架构建协作推理系统(含完整代码)AutoGen 完整入门教程:AssistantAgent + UserProxyAgent 基础模式、多 Agent 群聊辩论(代码审查场景)、研究报告三 Agent 协作系统、人在回路配置、终止条件设置,以及 AutoGen vs CrewAI 的实际选择建议,含所有可运行 Python 代码。2026/4/18教程OpenClaw 多 Agent 架构入门:用 Telegram Bot 控制你的 AI Agent 集群OpenClaw 多 Agent 架构入门指南:通过 Telegram 控制 AI Agent 集群,支持子 Agent 编排、MCP 集成和多节点部署。含快速开始教程。2026/4/7教程Claude Code 托管 Code Review 完整指南:多 Agent PR 审查、REVIEW.md 和严重性解析Claude Code 托管 Code Review 官方文档中文整理:功能定位、适用版本、工作原理、严重性等级、GitHub check run 输出、手动触发命令、Review Behavior 三种模式、CLAUDE.md 与 REVIEW.md 的区别、成本与排障。2026/5/20教程Claude Code Sub-agents 官方完整指南:内置 Agent、自定义配置、并行模式和 Fork 会话Claude Code Sub-agents 官方文档完整整理:解决的核心问题(保护上下文/成本控制);三个内置 Sub-agent(Explore/Plan/General-purpose 及各自模型和工具);/agents 创建流程(界面/描述生成/工具选择/持久内存配置);完整 Frontmatter 字段参考;模型选择策略(Haiku 探索→Sonnet 审查→Opus 复杂任务);MCP 服务器限定到 Sub-agent;自动委托 vs 显式调用;前台/后台运行;隔离高容量/并行调研/链式 Sub-agent 三种模式;Fork 会话(与命名 Sub-agent 的区别);以及 4 个官方示例配置。2026/5/8