01WHAT IT SOLVES
这个项目解决什么问题?
CrewAI 定位为生产可用的多智能体编排框架,通过 Crews 提供角色化自主协作,通过 Flows 提供精确事件驱动工作流,二者可混合使用。框架强调轻量 Python 内核与底层可定制,覆盖从提示词、工具到执行路径的完整控制链。相较于通用 LLM 工具链,CrewAI 聚焦于多智能体角色协作与生产部署模式,并配套 AMP 商业套件提供企业级可观测与治理。
02CORE CAPABILITIES
核心能力
Crews 多智能体自主协作
以角色、目标、工具和任务建模一组智能体,支持动态委派与协作
Flows 事件驱动工作流
通过装饰器与状态管理实现条件分支、路由与确定性执行路径
Python 原生深度定制
允许改写提示词、工具、执行逻辑与系统架构而不被框架约束
智能体就绪能力集
内置工具、记忆、知识库、检查点、异步执行与 MCP/A2A 支持
生产级模式扩展
支持结构化输出、人工介入、检查点回放等向生产过渡所需机制
03适合谁
- 需要编排多个 AI 智能体协同完成多步任务的 Python 开发者
- 探索 Agent 化自动化的产品团队与解决方案架构师
- 希望从原型快速过渡到生产部署的 AI 应用工程师
- 企业中负责业务流程智能化改造的技术负责人
04典型使用场景
- 自动化生成招聘岗位描述与初筛评估
- 多步骤旅行规划与行程信息整合
- 股票分析与多维度研报撰写
- 在业务流程中嵌入 LLM 调用并保留确定执行段
05为什么值得关注
- 社区规模较大,提供官方学习认证课程与配套示例仓库
- 同时提供自主协作与确定性控制两种互补抽象,平衡灵活性与可控性
- 官方 AMP 套件覆盖企业级可观测、安全与部署需求
- 持续迭代智能体协议、结构化输出与文档站点
06采用前要注意
- 要求 Python 3.10 及以上环境,版本门槛较新
- 默认依赖 OpenAI 等外部大模型,使用本地模型需额外部署 Ollama 等
- 使用网页搜索等工具时需自行配置 Serper 等第三方服务密钥
- 框架默认开启匿名遥测,敏感场景需手动通过环境变量关闭
07RELEASE INTELLIGENCE
近期版本变化
crewAI 1.15.21:补齐网关与外部集成修复并新增检查点遥测
本版本聚焦稳定性与可观测性,新增检查点运行时间与 CLI 使用情况的遥测;修复网关在 HTTP 200 内部报错、AMP 部署源推送、Oxylabs 抓取失败、DashScope 路由、JSON 检查点 UTF-8 编码、BrightData URL 解析、gpt-4o-mini 上下文窗口、流式工具调用参数以及 Windows 上 pre-commit 兼容等多项问题;同时澄清遥测与追踪文档差异。影响依赖相关集成与部署能力的开发者,建议升级。
- 新增检查点运行时与 CLI 使用遥测
- 修复网关 200 内部报错及多项外部集成缺陷
- 修正 gpt-4o-mini 上下文窗口与流式工具调用参数
- 完善 Windows pre-commit 兼容性与文档链接
crewAI 1.15.20:修复旧平台工具别名发现并同步文档
本版本修复旧版平台工具别名解析问题,并同步发布 v1.15.19 的文档快照与更新日志。影响仍使用旧平台工具命名或依赖历史集成的用户,升级后可恢复工具发现能力。
- 修复旧平台工具别名解析
- 同步 v1.15.19 文档快照与更新日志
crewAI 1.15.19:新增 Clipper 集成与可注入客户端并修复多项依赖安全
本版本新增 Clipper 集成客户端、可注入的平台工具客户端、CEL 环境下的 now() 函数以及机器规格粗粒度上报;同时修复 urlread 工具读取 octet-stream 与 xlsx、Ollama URL 规范化、记忆可复用作用域保留等问题,并升级 pypdf 与 nltk 修复安全漏洞。Claude 原生结构化输出与 Snowflake CVE 基线、模型调用钩子链路也得到修正,文档同步刷新已废弃 Gemini 模型 ID。影响集成生态、安全合规与多模型接入,升级价值较高。
- 新增 Clipper 集成客户端与可注入工具客户端
- 升级 pypdf 与 nltk 修复安全漏洞
- 修复 Claude 原生结构化输出与多处集成异常
- 同步刷新文档与已废弃 Gemini 模型 ID
crewAI 1.15.18:对话式 Flow 升级稳定并完善多项记录与路由能力
本版本将对话式 Flow 提升为稳定能力并补齐文档与 API;新增路由响应格式声明、Chat Flow 状态形状、Crew 风格 LLM 配置在对话模式下的支持,以及项目创建与部署 UUID 记录、项目 ID 回填。同时修复空最终答案下工具结果保留、Claude Sonnet 4.6 映射到 1M 上下文、Anthropic 默认 max_tokens 提升、内部流程跳过拦截钩子、任务失败正确记录等问题。影响对话型多智能体应用与可观测体系,建议关注。
- 对话式 Flow 正式转为稳定并扩展 API 与文档
- 补齐路由响应格式、Chat Flow 状态与对话 LLM 配置
- 修复 Claude Sonnet 4.6 上下文与 Anthropic 默认 token 限制
- 完善部署与项目 ID 记录以及 Arize Phoenix 观测文档
crewAI 1.15.17:推出声明式对话 Flow 与多项工具链路修复
本版本引入声明式对话 Flow 文档与内置方法合成能力,使声明可驱动对话模式并明确为显式启用;新增按 slug 解析工具时携带 AMP slug、处理分块时超大单条消息。同时修复 MCP HTTP 与 SSE 的 server_name 取自 URL 主机名、失败时关闭智能体作用域、工具错误归因到具体工具、SSRF 检查绑定到每个重定向跳以及 OpenAI Responses API 上原生工具调用失效等问题。影响对话型智能体、声明式用法与安全调用链路的用户,建议升级。
- 新增声明式对话 Flow 文档与内置方法合成
- 修复 MCP server_name 与 OpenAI Responses 工具调用链路
- 加强 SSRF 重定向逐跳检查与工具错误归因
- 同步 v1.15.16 文档快照与更新日志
crewAI 1.15.16:引入UUID执行上下文与多源部署可观测性
该版本引入带UUID的执行上下文,记录流程异常类型与追踪批次是否共享给AMP,并支持任意来源的部署计数;修复运行版本未在Span中记录、MySQL搜索表名校验等Bug,并新增CopilotKit与AG-UI前端指南。影响关注追踪完整性、企业部署审计与前端集成的用户。
- 引入UUID执行上下文与流程异常类型记录
- 新增追踪批次共享AMP标记与多源部署计数
- 修复MySQL搜索表名校验与失败标记传播
- 新增CopilotKit与AG-UI前端集成指南
crewAI 1.15.15:流程结果上报与安全依赖升级
本版本新增流程结果、耗时与人机协同信号的上报能力;修复边界钩子中止流程时未触发 FlowStartedEvent、span 导出作用域过宽等问题。出于安全考虑将 torch 升级至 2.13.0、crewai-tools[github] 中的 gitpython 升级至 3.1.58。重构智能体中的日期注入功能,并将 CLI 标志统一为 kebab-case。影响使用 Flow 可观测性、人机协同与 GitHub 工具集成的开发者,建议升级。
- 上报流程结果、耗时与人机协同信号
- 升级 torch 2.13.0 与 gitpython 3.1.58 修复安全漏洞
- 统一 CLI 标志为 kebab-case 并重构日期注入
- 修复 FlowStartedEvent 与 span 导出作用域问题
crewAI 1.15.14:运行时上下文与项目 ID 拆分
本版本将运行时上下文与编程代理拆分,并引入项目 ID 机制;文档同步发布 v1.15.13 快照与变更日志。本次发布条目较为简短,官方说明未提供更多细节。影响关注项目隔离、运行时与编程代理解耦以及可观测性字段扩展的开发者,建议结合后续版本说明评估影响。
- 将运行时上下文与编程代理拆分
- 引入项目 ID 机制
- 官方说明未提供更多细节
crewAI 1.15.13:修复LiteLLM路由与依赖安全
本次更新修复LiteLLM路由模型Provider丢失、Anthropic缓存Token少报以及h2库安全漏洞,加固LLM事件总线模拟测试,并新增文档翻译工作流与修复失效README链接,使用LiteLLM、Anthropic或h2的项目应尽快升级。
- 修复LiteLLM路由Provider保留问题
- 修复Anthropic缓存Token少报与h2安全漏洞
- 加固LLM事件总线模拟测试
- 新增文档翻译工作流并修复失效README链接
crewAI 1.15.12:统一脚手架并新增 URL 读取工具
本版本围绕脚手架与工具能力做了整合。Feature 方面,新增 URLReadTool 用于直接抓取任意网页内容,为研究类 Agent 提供更轻的接入方式;将脚手架命令统一为 crewai create ,替代先前分散的创建路径;并在发布时自动 bump Flow 的 canary 版本。平台工具侧补充了应用元数据,便于在控制面区分调用来源。Bug 修复集中于对话路由与处理器命名冲突时的报错信息,使其更易理解。文档侧同步更新了统一 CLI 下的 AGENTS.md。影响正在搭建 Agent 项目或构建网页内容获取工作流的用户。
- 新增 URLReadTool,可直接读取任意 URL
- 脚手架统一为 crewai create 命令
- 平台工具补充应用元数据
- 优化对话路由命名冲突的报错信息