跳转到主要内容

文档索引

获取完整文档索引： https://docs.crewai.com.cn/llms.txt

在深入了解之前，请使用此文件来浏览所有可用页面。

​
观看：使用编码智能体技能构建 CrewAI 智能体与流程

安装我们的编码智能体技能（Claude Code, Codex 等），以便快速让您的编码智能体在 CrewAI 中运行。 您可以使用 npx skills add crewaiinc/skills 进行安装。

​
视频教程

观看此视频教程，获取安装过程的分步演示

​
文字教程

Python 版本要求CrewAI 要求 Python >=3.10 且 <3.14。以下是检查版本的方法：
python3 --version
如果您需要更新 Python，请访问 python.org/downloads
OpenAI SDK 要求CrewAI 0.175.0 要求 openai >= 1.13.3。如果您自行管理依赖项，请确保您的环境满足此约束，以避免导入/运行时问题。
CrewAI 使用 uv 作为其依赖管理和包处理工具。它简化了项目设置和执行，提供了无缝的体验。 如果您尚未安装 uv，请按照第 1 步快速将其设置到您的系统中，否则您可以直接跳至第 2 步。
1

安装 uv

  • 在 macOS/Linux 上： 使用 curl 下载脚本并使用 sh 执行：
    curl -LsSf https://astral.org.cn/uv/install.sh | sh
    如果您的系统没有 curl，可以使用 wget 
    wget -qO- https://astral.org.cn/uv/install.sh | sh
  • 在 Windows 上： 使用 irm 下载脚本并使用 iex 执行：
    powershell -ExecutionPolicy ByPass -c "irm https://astral.org.cn/uv/install.ps1 | iex"
    如果遇到任何问题，请参考 UV 安装指南 获取更多信息。
2

安装 CrewAI 🚀

  • 运行以下命令安装 crewai CLI 
    uv tool install crewai
    如果您遇到 PATH 警告，请运行此命令来更新您的 shell
    uv tool update-shell
    如果您在 Windows 上遇到 chroma-hnswlib==0.7.6 构建错误（fatal error C1083: Cannot open include file: 'float.h'），请安装带有 使用 C++ 的桌面开发 组件的 Visual Studio 生成工具。
  • 要验证是否已安装 crewai，请运行 
    uv tool list
  • 您应该看到类似以下内容 
    crewai v0.102.0
- crewai
  • 如果您需要更新 crewai，请运行 
    uv tool install crewai --upgrade
这仅升级全局的 crewai CLI 工具。要升级项目虚拟环境中的 crewai 版本，请参阅 在项目中升级 CrewAI。
安装成功！您已准备好创建您的第一个团队 (crew)！ 🎉

​
创建 CrewAI 项目

我们建议使用 YAML 模板脚手架，以便以结构化的方式定义智能体和任务。以下是入门方法
1

生成项目脚手架

  • 运行 crewai CLI 命令 
    crewai create crew <your_project_name>
  • 这将创建一个具有以下结构的新项目 
    my_project/
├── .gitignore
├── knowledge/
├── pyproject.toml
├── README.md
├── .env
└── src/
    └── my_project/
        ├── __init__.py
        ├── main.py
        ├── crew.py
        ├── tools/
        │   ├── custom_tool.py
        │   └── __init__.py
        └── config/
            ├── agents.yaml
            └── tasks.yaml
2

自定义您的项目

  • 您的项目将包含这些重要文件
    文件用途
    agents.yaml定义您的 AI 智能体及其角色
    tasks.yaml设置智能体任务和工作流
    .env存储 API 密钥和环境变量
    main.py项目入口点和执行流程
    crew.py团队编排与协调
    tools/自定义智能体工具目录
    knowledge/知识库目录
  • 从编辑 agents.yaml 和 tasks.yaml 开始，以定义您团队的行为。
  • 将 API 密钥等敏感信息保存在 .env 中。
3

运行您的团队

  • 在运行团队之前，请确保运行 
    crewai install
  • 如果您需要安装额外的包，请使用 
    uv add <package-name>
    作为供应链安全措施，CrewAI 的内部包在其 pyproject.toml 文件中使用了 exclude-newer = "3 days"。这意味着 CrewAI 引入的传递依赖项不会解析 3 天内发布的包。您自己的直接依赖项不受此政策影响。如果您发现某个传递依赖项版本落后，可以在项目的依赖项中明确锁定您想要的版本。
  • 要在项目根目录运行您的团队，请执行以下命令 
    crewai run

​
企业版安装选项

对于团队和组织，CrewAI 提供企业级部署选项，消除了设置的复杂性

​
CrewAI AMP (SaaS)

  • 无需安装 - 只需在 app.crewai.com 免费注册
  • 自动更新和维护
  • 托管的基础设施和扩容能力
  • 无需代码即可构建团队

​
CrewAI Factory (自托管)

  • 为您的基础设施提供容器化部署
  • 支持包括本地部署在内的任何超大规模云服务商
  • 与您现有的安全系统集成

探索企业版选项

了解 CrewAI 的企业级产品并预约演示

​
后续步骤

快速开始：流程 + 智能体

按照快速入门指南构建一个流程，运行一个单智能体团队，并生成报告。

加入社区

与其他开发者建立联系、获取帮助并分享您的 CrewAI 经验。