CrewAI 的文档结构主要分为项目文件结构和核心概念结构两个层面。前者是你在本地创建项目时的目录布局后者是框架本身的逻辑架构。一、 项目文件结构目录布局当你使用crewai create命令创建新项目时会生成一个标准化的目录结构。根据项目类型YAML配置型或Python代码型结构略有不同。1. 标准项目结构推荐这是官方 CLI 工具生成的标准结构适用于大多数场景my_crew_project/ ├── .env # 环境变量文件存放 API Key ├── pyproject.toml # 项目依赖管理 ├── README.md └── src/ └── my_crew_project/ ├── __init__.py ├── main.py # 主程序入口负责启动 Crew ├── crew.py # Crew 定义文件核心逻辑 ├── tools/ # 自定义工具目录 │ ├── __init__.py │ └── custom_tool.py └── config/ # 配置目录YAML 文件 ├── agents.yaml # 定义所有 Agent 的角色、目标 └── tasks.yaml # 定义所有 Task 的描述、输出2. 纯代码结构高级如果你不使用 YAML 配置而是完全用 Python 代码定义结构会更像传统的 Python 包crewai_project/ ├── agents/ # 存放 Agent 定义类 │ ├── __init__.py │ ├── researcher.py │ └── writer.py ├── tasks/ # 存放 Task 定义类 │ ├── __init__.py │ ├── research_task.py │ └── writing_task.py ├── tools/ # 自定义工具 ├── models/ # Pydantic 模型用于结构化输出 ├── utils/ # 工具函数 ├── config.py # 配置类 └── main.py # 入口文件二、 核心概念结构逻辑架构CrewAI 的逻辑架构遵循“Agent - Task - Crew”的层级关系这是理解其文档内容的关键。1. Agent智能体Agent 是执行具体工作的“员工”每个 Agent 都有明确的角色定义。Role角色如“研究员”、“作家”。Goal目标如“发现最新的 AI 趋势”。Backstory背景故事提供上下文影响 Agent 的行为风格。Tools工具Agent 可以调用的外部函数如搜索、文件读写。2. Task任务Task 是具体的工作单元分配给 Agent 执行。Description描述详细的指令。Expected Output预期输出任务完成后的交付物。Agent Assignment分配指定由哪个 Agent 执行。3. Crew团队Crew 是最高层的组织者负责将 Agents 和 Tasks 组合起来并定义执行流程。Process流程定义任务执行顺序Sequential 顺序执行Hierarchical 分层执行。Memory记忆是否允许 Agent 记住之前的对话历史。Verbose详细模式是否打印详细的执行日志。总结CrewAI 的文档结构强调模块化和角色驱动。建议先从config/agents.yaml和config/tasks.yaml入手理解如何定义角色和任务再通过main.py和crew.py学习如何将它们组装成团队。