Python 版本要求

CrewAI 需要 Python >=3.10 and <3.13。以下是检查您版本的方法：

python3 --version

如果您需要更新Python，请访问python.org/downloads

​
安装CrewAI

CrewAI 是一个灵活且强大的 AI 框架，使您能够高效地创建和管理 AI 代理、工具和任务。 让我们开始设置吧！🚀

1

安装CrewAI

使用以下任一方法安装CrewAI及其所有推荐工具：

Terminal
pip install 'crewai[tools]'

或

Terminal
pip install crewai crewai-tools

两种方法都安装了核心包和大多数用例所需的额外工具。

2

升级CrewAI（仅限现有安装）

如果您安装了旧版本的CrewAI，您可以升级它：

Terminal
pip install --upgrade crewai crewai-tools

如果你看到一个与Poetry相关的警告，你需要迁移到我们的新依赖管理器：

Terminal
crewai update

这将更新您的项目以使用UV，这是我们新的更快的依赖管理器。

如果您正在进行全新安装，请跳过此步骤。

3

验证安装

检查您安装的版本：

Terminal
pip freeze | grep crewai

你应该看到类似的内容：

Output
crewai==X.X.X
crewai-tools==X.X.X
Installation successful! You’re ready to create your first crew.

​
创建一个新项目

我们建议使用YAML模板脚手架，以结构化的方式定义代理和任务。

1

生成项目结构

运行CrewAI CLI命令：

Terminal
crewai create crew <project_name>

这将创建一个具有以下结构的新项目：

my_project/
├── .gitignore
├── 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/自定义代理工具的目录

首先编辑agents.yaml和tasks.yaml来定义你的团队行为。 将敏感信息如API密钥保存在.env中。

​
下一步

构建您的第一个代理

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

加入社区

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

这个页面有帮助吗？

IntroductionQuickstart