crewAIInc/crewAI

CrewAI 是一个用于构建多智能体自动化的 Python 框架。它主要适合这样的开发者：不满足于单次提示，需要多个带工具的专用智能体相互协作，同时又要用确定性代码把流程框住。

两种组织方式

框架有两个互补的原语。Crews 把智能体建模成一个团队，每个智能体有角色、目标、背景和工具，让它们自主协作——例如研究员和报告分析师按顺序流程传递结果，或用层级流程让一个经理智能体负责分派。Flows 则是事件驱动的工作流，带有类型化的共享状态、分支和路由。一个 Flow 可以先启动，把 Crew 当作其中一步调用，再检查结果并路由到不同后续步骤（Flows 与 Crews 说明，组合示例）。这种组合是它的关键机制：需要判断的地方交给自主性，业务逻辑必须可靠的地方由 Python 显式控制。

一个典型流程

通常用 crewai create crew <name> 创建项目，生成 agents/*.jsonc 中的智能体定义、crew.jsonc 中的任务和流程配置，以及 tools/、knowledge/、skills/ 目录。生成的配置会把一个使用网络搜索的研究员和一个负责写 markdown 报告的分析师串起来，输出到 output/report.md。之后运行 crewai install 和 crewai run（快速开始，运行 Crew）。加 --classic 可使用旧的 Python/YAML 脚手架。模型可按智能体分别配置，文档覆盖了托管服务商以及 Ollama、LM Studio 等本地选项（LLM 连接）。

环境要求与实际限制

文档中的安装路径要求 Python 3.10 以上但不含 3.14，并使用 uv 包管理器安装 CLI；完整步骤见安装指南。运行智能体需要模型服务商的 API key，网络搜索示例还需要 Serper.dev 的 key。Windows 上已知的 chroma-hnswlib 编译错误，可通过安装含 C++ 桌面开发负载的 Visual Studio Build Tools 解决。README 还提供可选的 CrewAI Skills，供 Claude Code 等编程智能体使用——这是使用框架的辅助手段，不是运行时依赖（Build with AI）。

数据与许可

CrewAI 使用 MIT 许可证（许可证）。它会发送匿名遥测，包括版本、操作系统、智能体和任务数量、所用模型名称；除非用户显式开启 share_crew，否则不会收集提示词、任务文本、工具调用、响应和密钥。开启后则包含目标、背景、任务上下文和输出。遥测可通过 OTEL_SDK_DISABLED 关闭（遥测说明）。另有一套商业 AMP Suite 提供托管部署、追踪和企业支持；开源框架本身不依赖它。

一位 HN 评论者 称自己在生产环境运行智能体，并向核心仓库贡献了时间感知和 ID 生成工具，以缓解日期幻觉。这只是单个未经验证的说法，但说明生产级智能体系统仍需处理这类协调细节。