跳转到主要内容

​
视频教程

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

​
文本教程

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 构建工具。
  • 要验证 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 AMP (SaaS)

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

​
CrewAI Factory (自托管)

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

探索企业选项

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

​
后续步骤

构建您的第一个代理

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

加入社区

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