CrewAI 文档 #

CrewAI 是一个轻量级、高性能的 Python 多智能体协作框架,用于编排角色扮演、自主 AI Agent。通过促进协作智能,CrewAI 让 Agent 能够无缝协作,解决复杂任务。

学习路径 #

text
入门阶段
├── 简介
├── 基础概念
│
核心阶段
├── Agent 详解
├── Task 详解
├── Crew 详解
│
工具阶段
├── 工具系统
│
高级阶段
├── 高级特性
├── 最佳实践

文档目录 #

入门指南 #

文档 描述
简介 了解 CrewAI 的历史、核心特点和基本概念
基础概念 安装配置、核心概念、第一个程序

核心组件 #

文档 描述
Agent 详解 深入学习 Agent 的创建、配置和高级用法
Task 详解 掌握任务的定义、执行和输出处理
Crew 详解 学习团队编排、流程控制和协作模式

工具系统 #

文档 描述
工具详解 使用和创建自定义工具,扩展 Agent 能力

高级主题 #

文档 描述
高级特性 记忆系统、流程编排、异步执行
最佳实践 生产级开发指南和优化技巧

快速开始 #

安装 #

bash
pip install crewai
pip install 'crewai[tools]'

第一个程序 #

python
from crewai import Agent, Task, Crew

researcher = Agent(
    role="研究分析师",
    goal="研究 AI 行业的最新趋势",
    backstory="你是一位经验丰富的分析师,擅长发现市场趋势",
    verbose=True
)

writer = Agent(
    role="技术作家",
    goal="撰写关于 AI 趋势的引人入胜的文章",
    backstory="你是一位擅长将复杂技术概念转化为易懂文章的作家",
    verbose=True
)

research_task = Task(
    description="研究 2025 年 AI 行业的最新趋势",
    expected_output="一份包含 3 个主要趋势的详细报告",
    agent=researcher
)

write_task = Task(
    description="根据研究结果撰写一篇博客文章",
    expected_output="一篇 4 段落的 Markdown 格式博客文章",
    agent=writer
)

crew = Crew(
    agents=[researcher, writer],
    tasks=[research_task, write_task],
    verbose=True
)

result = crew.kickoff()
print(result)

核心概念速览 #

Agent(智能体) #

python
agent = Agent(
    role="数据分析师",
    goal="分析数据并提供洞察",
    backstory="拥有 10 年数据分析经验的专家",
    tools=[search_tool, analysis_tool],
    verbose=True
)

Task(任务) #

python
task = Task(
    description="分析销售数据并生成报告",
    expected_output="一份包含关键指标和建议的报告",
    agent=analyst_agent,
    output_file="report.md"
)

Crew(团队) #

python
crew = Crew(
    agents=[researcher, writer, editor],
    tasks=[research_task, write_task, edit_task],
    process=Process.sequential,
    verbose=True
)

CrewAI 架构 #

text
┌─────────────────────────────────────────────────────────────┐
│                      CrewAI 架构                              │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌──────────────────────────────────────────────────────┐  │
│  │                    Crew(团队)                         │  │
│  │         协调多个 Agent 完成复杂任务                      │  │
│  └──────────────────────────────────────────────────────┘  │
│                           │                                  │
│                           ▼                                  │
│  ┌──────────────────────────────────────────────────────┐  │
│  │                    Task(任务)                         │  │
│  │         定义具体工作内容和预期输出                        │  │
│  └──────────────────────────────────────────────────────┘  │
│                           │                                  │
│                           ▼                                  │
│  ┌──────────────────────────────────────────────────────┐  │
│  │                    Agent(智能体)                      │  │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐    │  │
│  │  │  Role   │ │  Goal   │ │Backstory│ │  Tools  │    │  │
│  │  └─────────┘ └─────────┘ └─────────┘ └─────────┘    │  │
│  └──────────────────────────────────────────────────────┘  │
│                           │                                  │
│                           ▼                                  │
│  ┌──────────────────────────────────────────────────────┐  │
│  │                    Tools(工具)                        │  │
│  │  搜索 | 文件操作 | API调用 | 代码执行 | 自定义工具       │  │
│  └──────────────────────────────────────────────────────┘  │
│                                                              │
└─────────────────────────────────────────────────────────────┘

适用场景 #

  • 智能研究团队:自动化市场研究、竞品分析
  • 内容创作流水线:从研究到写作到编辑的完整流程
  • 代码开发团队:需求分析、编码、测试、审查
  • 客户服务系统:多 Agent 协作处理复杂客户请求
  • 数据分析管道:数据收集、清洗、分析、报告生成

CrewAI 的优势 #

text
✅ 轻量高效
   - 无外部依赖
   - 快速启动
   - 低资源占用

✅ 角色扮演
   - 定义 Agent 角色
   - 设置目标和背景
   - 模拟真实团队协作

✅ 灵活编排
   - 顺序执行
   - 层级管理
   - 自定义流程

✅ 工具丰富
   - 内置多种工具
   - 支持自定义工具
   - 无缝集成 LangChain

✅ 生产就绪
   - 内存管理
   - 错误处理
   - 缓存机制

CrewAI vs 其他框架 #

特性 CrewAI LangChain AutoGen
多 Agent 协作 ✅ 原生支持 ⚠️ 需要扩展 ✅ 原生支持
角色扮演 ✅ 核心特性 ❌ 不支持 ⚠️ 部分支持
学习曲线
外部依赖
任务编排 ✅ 强大 ⚠️ 链式 ⚠️ 对话式
工具生态 丰富 非常丰富 一般

资源推荐 #

开始学习 #

选择适合你的起点:

最后更新:2026-04-04