什么是 CrewAI？

CrewAI 是一个 Python 框架，让你能组建一个由多个 AI 智能体（即专门负责某类任务的 AI 程序）组成的团队，各司其职、协作完成任务。例如，一个智能体负责搜索资料，另一个负责验证，第三个负责写报告。避免让一个模型同时做所有事，效果更好。

安装前的准备

你需要：

• Python 3.10 到 3.13：打开终端（Windows 用命令提示符或 PowerShell），输入 python --version 检查版本。如果版本不符，请先去 python.org 下载安装。
• 虚拟环境（推荐）：在项目目录下运行 python -m venv venv 创建，然后激活：
  • Windows：venv\Scripts\activate
  • Mac/Linux：source venv/bin/activate

安装 CrewAI

在虚拟环境激活状态下，运行：

• pip install crewai crewai-tools

这会安装核心框架、Google Gemini 支持，以及网页抓取等预置工具。注意：不要用 Python 3.14 或更高版本，否则会安装旧版并报错。

获取 Gemini API 密钥

CrewAI 支持多种大模型，本教程使用 Google 的 Gemini（免费）。

1. 访问 Google AI Studio，用 Google 账号登录。
2. 点击「Get API key」生成一个密钥，复制下来。
3. 在终端设置环境变量：
   • Windows（命令提示符）：set GEMINI_API_KEY=你的密钥
   • Windows（PowerShell）：$env:GEMINI_API_KEY='你的密钥'
   • Mac/Linux：export GEMINI_API_KEY='你的密钥'

跑通第一个例子

新建一个 Python 文件（比如 travel_advisor.py），粘贴以下代码：

from crewai import Agent, Task, Crew, LLM

llm = LLM(model='gemini/gemini-2.0-flash-exp')

agent = Agent(
    role='旅行顾问',
    goal='推荐最佳旅行目的地',
    backstory='你是一位经验丰富的旅行规划师，擅长根据用户偏好推荐目的地。',
    llm=llm,
    verbose=True
)

task = Task(
    description='推荐一个适合春季家庭出游的国内目的地，并说明理由。',
    agent=agent
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

运行脚本：python travel_advisor.py。如果一切正常，你会看到智能体的思考过程（因为 verbose=True）和最终推荐结果。

常见问题：

• 如果报错 ModuleNotFoundError，检查是否在虚拟环境中。
• 如果提示 API 密钥无效，重新设置环境变量并重启终端。

下一步可以做什么

你可以创建多个智能体，让他们协作完成更复杂的任务。例如：一个搜索景点，一个写行程，一个做预算。CrewAI 还支持工具（如网页搜索），让智能体拥有更多能力。更多内容请查看 CrewAI 官方文档。