CrewAI 使用教程，手把手教你用打造 AI 协作团队

CrewAI 是一个 AI 智能体协作框架，就像组建一个 AI 团队。你可以给每个 AI 分配不同职位（如研究员、分析师），它们会像真实团队一样分工合作完成任务。适合自动化客服、数据分析、市场调研等场景。

准备工作

1、安装 Python 前往 Python 官网下载 3.10-3.12 版本，安装时务必勾选"Add to PATH"

2、安装 CrewAI 打开命令提示符（Windows 搜索 cmd）输入：

pip install crewai[tools]

3、获取 API 密钥

三分钟创建 AI 团队

步骤 1：创建项目

crewai create crew my_team
cd my_team

会生成项目文件夹，结构如下：

my_team/
├── .env         # 存放API密钥
├── src/
│   └── my_team/
│       ├── config/
│       │   ├── agents.yaml  # 员工档案
│       │   └── tasks.yaml   # 工作任务
│       ├── crew.py          # 团队配置
│       └── main.py          # 启动脚本

步骤 2：配置员工档案用记事本打开 `src/my_team/config/agents.yaml`，修改为：

researcher:
  role: "{topic}研究员"       # {topic}会自动替换为输入的主题
  goal: "收集{topic}的最新信息"
  backstory: 你是一个资深行业研究员，擅长通过多渠道获取最新行业动态

reporting_analyst:
  role: "数据分析师"
  goal: "将数据转化为易读的报告"
  backstory: 作为专业分析师，你擅长将复杂数据整理成可视化图表和结构化报告

步骤 3：设置工作任务打开 `src/my_team/config/tasks.yaml`：

research_task:
  description: 调研{topic}领域，找到10个最新趋势（当前是2024年）
  expected_output: 10条带数据来源的要点列表
  agent: researcher      # 指定由研究员执行

reporting_task:
  description: 将调研结果整理成图文报告
  expected_output: 包含图表和案例的Markdown格式报告
  agent: reporting_analyst
  output_file: report.md # 自动保存为文件

步骤 4：配置 API 密钥在`.env`文件中添加：

OPENAI_API_KEY=你的OpenAI密钥
SERPER_API_KEY=你的Serper密钥

步骤 5：运行 AI 团队在项目文件夹中执行：

crewai run

当提示输入主题时，输入你想调研的内容，比如："智能家居"

查看成果

控制台会显示完整执行过程
生成的报告会保存在report.md中
每次运行都会自动保存最新报告

进阶技巧

1、修改工作流程在crew.py中可调整流程模式：

process = Process.sequential  # 顺序执行
# 改为 Process.hierarchical 层级管理

2、添加新工具在tools/文件夹创建custom_tool.py，例如添加网页爬虫工具：

from crewai_tools import BaseTool

class WebScraper(BaseTool):
    name = "网页抓取器"
    description = "自动抓取网页内容"

    def _run(self, url: str) -> str:
        import requests
        return requests.get(url).text

3、多团队协作创建多个 crew 文件夹，用 main.py 调度：

# 先运行市场调研团队
market_crew.kickoff(inputs={"topic": "智能家居"})

# 再运行产品设计团队
design_crew.kickoff(inputs=market_output)

常见问题

1、安装报错尝试：

pip install --upgrade crewai
python -m pip install tiktoken

2、报告不完整检查.env中的 API 密钥是否正确，或尝试更明确的指令如："包含 3 个案例和 5 条数据图表"

3、运行速度慢在agents.yaml中添加：

llm:
  model: gpt-3.5-turbo # 默认使用更快模型

现在你已经拥有一个 24 小时工作的 AI 团队了！试着让它们帮你完成下一个市场分析或论文写作任务吧～

开发必备：API 全流程管理神器 Apifox

介绍完上文的工具，我想额外介绍一个对开发者同样重要的效率工具 —— Apifox。作为一个集 API 文档、API 调试、API 设计、API 测试、API Mock、自动化测试等功能于一体的 API 管理工具，Apifox 可以说是开发者提升效率的必备工具之一。

如果你正在开发项目需要进行接口调试，不妨试试 Apifox。注册过程非常简单，你可以直接在这里注册使用。

立即体验 Apifox

注册成功后可以先看看官方提供的示例项目，这些案例都是经过精心设计的，能帮助你快速了解 Apifox 的主要功能。

使用 Apifox 的一大优势是它完全兼容 Postman 和 Swagger 数据格式，如果你之前使用过这些工具，数据导入会非常方便。而且它的界面设计非常友好，即使是第一次接触的新手也能很快上手，快去试试吧！

免费使用 Apifox

了解更多：

CrewAI 使用教程，手把手教你用打造 AI 协作团队