01WHAT IT SOLVES
这个项目解决什么问题？
crewAI 位于应用开发框架层，面向超出单次提示或聊天机器人范围的多智能体自动化。Crews 以角色、目标、任务和工具组织自主协作，适合需要动态分工与灵活决策的环节；Flows 以事件触发、状态管理、路由和条件分支控制执行路径，适合承载生产逻辑。两者可以组合，在 Python 代码中保留业务规则，同时加入智能体推理、异步执行、检查点、人工输入和结构化输出。相较仅调用模型接口或自行搭建编排层，它提供了智能体、任务、团队、流程、工具与运行管理的一套原生抽象。
02CORE CAPABILITIES
核心能力
角色化智能体协作
通过角色、目标、任务、工具和委派机制组织多个智能体共同完成复杂任务。
事件驱动流程编排
使用启动、监听、路由、状态和条件分支控制任务执行顺序及业务逻辑。
Crews 与 Flows 组合
将自主智能体作为流程步骤，在保留 Python 控制逻辑的同时接入业务系统。
面向生产的能力扩展
支持工具、记忆、知识、检查点、异步执行、结构化输出及人工输入。
模型与外部连接
支持多种大语言模型连接方式，并提供本地模型、MCP 与 A2A 等接入能力。
03适合谁
- 需要构建多智能体协作应用的 Python 开发者
- 需要将智能体接入显式业务流程的 AI 应用团队
- 需要工具调用、结构化输出或人工审核机制的自动化项目团队
04典型使用场景
- 由研究、分析和报告等不同角色协作完成的复杂任务
- 将智能体步骤嵌入带条件分支、状态管理和人工审核的业务流程
- 需要工具调用、结构化结果或可恢复执行状态的 Python 自动化
- 将多个独立智能体任务组合成端到端应用
05为什么值得关注
- 同时提供自主协作与显式工作流抽象，定位比单纯智能体封装更完整
- Python 原生抽象允许开发者继续控制提示词、工具、状态、执行路径和集成
- 近期版本持续覆盖评测、文件处理、独立智能体项目、命令行运行与提供商兼容
- 开源框架与商业控制平面并存，为从开发试验到企业治理提供不同路径
06采用前要注意
- 要求 Python 3.10 或更高版本，并依赖用户自行配置模型提供商及相关密钥
- 默认启用匿名遥测；启用 share_crew 后会收集更详细的智能体与任务执行数据
- 企业级托管、可观测性、治理、安全和本地部署属于商业 AMP Suite，不是开源核心默认能力
- 多智能体角色、任务依赖和流程状态仍需开发者设计，无法替代业务流程建模
07RELEASE INTELLIGENCE
近期版本变化
crewAI 1.15.40：中文解读生成中
正在根据官方 Release 说明生成中文变化摘要，请暂时以来源页面为准。
crewAI 1.15.39：补充应用未连接错误文档
本次发布仅更新文档，说明 /kickoff 和 /status 接口出现 apps_not_connected 错误时的相关背景。使用这些接口且遇到应用连接问题的开发者可关注；官方说明未提供更多细节。
- 补充 /kickoff 接口的 apps_not_connected 错误说明
- 补充 /status 接口的 apps_not_connected 错误说明
crewAI 1.15.38：统一默认模型并增强评测运行
本次发布将 gpt-6-luna 设为全局默认模型，扩展智能体逐行读取表格链接及评测追踪标记能力，并为无界面评测和失败运行处理加入改进。使用默认模型、crewai eval 或相关提供商的开发者需要关注兼容性变化。
- gpt-6-luna 成为所有场景的默认模型
- 智能体可借助工具逐行读取表格 URL
- crewai eval 新增 --no-open，支持无界面运行
- 修正失败评测计数、追踪上传、API 密钥检查及项目脚本退出码
crewAI 1.15.37：加入表格读取与独立智能体脚手架
本次发布为 crewai-files 增加供智能体读取表格的功能，并支持创建和加载独立智能体项目。使用表格资料处理或希望采用单智能体项目结构的开发者可关注；官方说明未提供更多细节。
- crewai-files 新增供智能体读取表格的功能
- 支持生成并加载独立智能体项目
- 更新 RagTool 描述以改善文档解析效果
crewAI 1.15.36：实验会话与运行配置增强
本次发布加入实验性对话式智能体会话，并改进运行时的密钥提示、项目加载错误和提供商信息。同步工具、OpenAI 兼容提供商、ChromaDB 及 JSON 项目用户需关注相关修复，尤其是默认模型与 Responses API 的变化。
- 新增实验性对话式 Agent 会话
- 启动项目时主动询问缺失的 API 密钥
- 修复同步工具异步调用上下文与空值优先级问题
- 改进 OpenAI 工具调用、ChromaDB 元数据和新项目提供商依赖配置
crewAI 1.15.35：同步模型目录与版本快照
本次发布主要更新 v1.15.35 的 LiteLLM 模型目录，并补充 v1.15.34 的快照和变更日志。依赖特定模型映射或需要核对版本记录的用户可关注；官方说明未提供更多细节。
- 更新 v1.15.35 的 LiteLLM 模型目录
- 增加 v1.15.34 项目快照
- 补充 v1.15.34 变更日志
crewAI 1.15.34：扩展流程命令并调整执行器
本版本扩展运行与部署能力，可记录运行中止位置、搜索组织技能、把输入传给 Python Flow、创建部署压缩包，并补充代理规划文档。同时修复结构化输出、工具调用、令牌统计、导入兼容、登录与恢复等问题，并记录移除 1.15.29 代理执行器的破坏性变化，现有项目升级前应重点核对迁移说明。
- 新增组织技能搜索、运行中止位置记录及 Python Flow 输入传递。
- deploy create 支持 --zip，并输出构建压缩包所对应的提交。
- 改进结构化输出、工具调用、令牌统计及导入兼容性。
- 移除 1.15.29 代理执行器，并提供迁移说明。
crewAI 1.15.33：补充技能搜索与部署打包
本版本加入组织技能搜索、Python Flow 输入传递和部署压缩包创建能力，同时修复令牌统计、兼容导入、JSON 会话加载、检查点恢复、登录及终端提示等问题。旧版 JSON Crew、AMP 部署和技能管理用户需要重点回归相关流程；官方未说明更多发布细节。
- crewai skill search 可列出组织中的技能。
- crewai run --inputs 可把输入传给 Python Flow。
- deploy create 支持 --zip 部署压缩包。
- 修复令牌统计、检查点恢复、登录和 JSON Crew 加载问题。
crewAI 1.15.32：修复测试稳定性并同步文档
本次发布主要修复不稳定的测试，并更新前一版本的快照与变更日志。没有披露新的用户功能或接口变化，普通用户是否需要关注升级影响有限；官方说明未提供更多细节。
- 修复若干不稳定的测试
- 更新 v1.15.31 的版本快照与变更日志
crewAI 1.15.31：加入对话上下文压缩并修补漏洞
1.15.31 新增对话式 Flow 上下文压缩，并修复反序列化、SQL 注入和路径穿越等漏洞，同时调整新模型停止指令、护栏事件和检查点复制行为。生产环境用户应优先评估并验证相关修复。
- 支持对话式 Flow 上下文压缩
- 修补反序列化、SQL 注入和路径穿越漏洞
- 修复输出文件路径插值导致的路径穿越问题
- 调整 GPT-6 及更新模型的停止指令行为