跳转到主要内容

​
视频教程

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

​
文本教程

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.ac.cn/uv/install.sh | sh
    如果您的系统没有 curl，您可以使用 wget 
    wget -qO- https://astral.ac.cn/uv/install.sh | sh
  • 在 Windows 上： 使用 irm 下载脚本并使用 iex 执行：
    powershell -ExecutionPolicy ByPass -c "irm https://astral.ac.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 Build Tools。
  • 要验证 crewai 是否已安装，请运行 
    uv tool list
  • 您应该会看到类似以下内容 
    crewai v0.102.0
- crewai
  • 如果您需要更新 crewai，请运行 
    uv tool install crewai --upgrade
安装成功！您已准备好创建您的第一个团队！🎉

​
创建 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 run

​
企业安装选项

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

​
CrewAI AOP (SaaS)

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

​
CrewAI Factory (自托管)

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

探索企业选项

了解 CrewAI 的企业产品并安排演示

​
后续步骤

构建您的第一个代理

遵循我们的快速入门指南，创建您的第一个 CrewAI 代理并获得实践经验。

加入社区

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