更新日志

变更内容

特性

添加 crewai eval 命令，用于报告停止的模型在何处中断。
使用 LiteLLM 目录作为上下文窗口来源。

缺陷修复

修复流程，使其能从恢复的人工反馈中学习，并保留已审查的输出类型。
当非空应用解析为零个平台工具时发出警告。
修复 flow add-crew，使其能从 pyproject 正确找到包。
显示部署失败的原因，并修复 deploy remove 和 lockfile 检查。
修复 trigger list 和 payload 请求，将超时设为 60 秒。
在 deploy push 期间读取 AMP 的 source_type，以确保 ZIP 部署使用新代码。
在 rag 中解码带 UTF-8 BOM 的本地 JSON 文件。
允许为 OpenAI GPT-6 Sol/Luna/Astra 使用图像 input_files。
为流式传输的 anthropic 工具调用发出调用完成事件。
阻止 JSON-schema 模型对遮蔽 BaseModel 的字段发出警告。
保留原生工具中止和 post-hook 缓存身份。
在版本号提升 PR 合并后刷新 LiteLLM 目录。
修复失效的评估器回归测试。

文档

整合 MongoDB 文档中的改进。
更正 AGENTS.md 中的部署和平台工具指南。
修复 README 中 RagTool 和 XMLSearchTool 的导入。

贡献者

@SIDDARTHAREDDY8, @Vidit-Ostwal, @joaomdmoura, @kimnamu, @lorenzejay, @norareidy, @shaikn6, @zouyonghe

v1.15.27

变更内容

特性

将 XPU 添加到 OpenCLIP 服务商的设备选项
将 deepinfra 添加为兼容 OpenAI 的服务商
记录评估在给出结论前停止的原因
记录运行应用的 Deploy 在一次尝试之前遇到的情况
在 crewai eval --models 中实现按运行统计成本和时间跟踪，且不重复输出进度行

缺陷修复

修复将 stopSequences 发送给 OpenAI GPT-6/GPT-5.6/gpt-oss 的问题
保留 GitHub 加载器的来源归属
修复 SQLite 流程初始化时的争用

文档

添加 v1.15.26 的快照和更新日志

贡献者

@StoyanD, @ats3v, @joaomdmoura, @kimnamu, @lorenzejay, @mhbuehler, @zouyonghe

v1.15.26

变更内容

缺陷修复

修复在获取被中断时 rwlock 的所有权保留问题。
解决文档站点源 URL 未被保留的问题。
修复 log-tasks-outputs 中的任务输出显示，使其显示实际输出。

文档

更新 v1.15.25 版本的快照和更新日志。

贡献者

@Velmet44, @Vidit-Ostwal, @joaomdmoura, @leilei3167, @lorenzejay, @lux-liang

v1.15.25

变更内容

文档

v1.15.24 的快照和更新日志

贡献者

@lorenzejay

v1.15.24

变更内容

特性

添加 crewai eval，使其在被智能体运行时打印 Markdown 简报
将相关的后台回复排队
添加实验性的轮次和回复身份
添加 Oracle 集成
添加实验性的作业生命周期和运行器
添加 crewai eval --models，以及用于替换模型和角色的 llm_overlay

缺陷修复

修复 CLI 中的 train 文件名错误消息
允许起始步骤基于其监听的事件重新运行
让 human_feedback 的发出步骤在输出中暴露审查内容
确保除非门禁通过，否则 crewai eval 以代码 1 退出；并在无人值守时未追踪到任何内容时提示登录
报告来自 grant exporter 的追踪发送用量
处理多个依赖安全公告并更新相关包

重构

将消息摘要移入 SummarizeMessages
集中管理并刷新上下文窗口

贡献者

@Velmet44, @Vidit-Ostwal, @dependabot[bot], @fileames, @gabemilani, @github-actions[bot], @joaomdmoura, @lorenzejay

v1.15.23

变更内容

特性

添加对原生 Gemini 3.8 Flash 的支持
在 crewai eval 中实现对通过 AMP 追踪的上一次运行进行评估
为 crewai eval 记录上一次追踪的运行，而不是打印它
改进平台集成设置的用户体验
优先展示流行的平台集成
增强追踪任务 span，使其包含声明的输出格式和结果

缺陷修复

修复用于查看追踪的面板的可见性
解决开启追踪的问题，并在 TUI 中添加 Evaluate 按钮
在 LLM 中重试被限流的服务商调用
在 Bedrock 中从 acall 回退到同步调用
在 CLI 中打印评估所评分的区域
确保在完成追踪后显示链接
保持 Selenium 驱动可复用
正确关闭 S3 响应体
使用共享辅助函数折叠多模态内容
匹配 LLM overlay 中仅因周围空白而不同的角色
在流程持久化和 SQLite 服务商中关闭 SQLite 连接
保留目录列表路径

文档

更新助手的平台工具相关指南

贡献者

@Copilot, @Mairaarshad19, @SharoonSharif, @Vidit-Ostwal, @gaoanze888, @joaomdmoura, @lorenzejay, @sclfcz, @stepchanges, @vinibrsl

v1.15.22

变更内容

特性

支持将别名作为连接标识符
记录部署创建失败的原因
在追踪中收集人工反馈和暂停事件
添加 llm_overlay 上下文变量，用于将智能体角色路由到模型
在智能体执行负载中携带 task_prompt 和输出
在团队设置期间验证平台集成
将平台工具添加到 JSON 团队向导
公开 CrewAI Platform 应用目录
添加 OpenRouter 作为受支持的嵌入服务商

缺陷修复

在内联技能定义中接受 CRLF
通过安全获取器加载文本文件 URL
在 kickoff 任务输出存储中关闭 SQLite 连接
在原生工具路径的 ToolUsageFinishedEvent 上携带 from_cache
在 uploader 中抛出 ValueError，而不是使用裸 raise
在 SQLiteFlowPersistence 中支持非原始类型
改进编码智能体指令
以 UTF-8 读取 JSON 检查点
在 Windows 上覆盖过期的 poetry.lock 备份
在 Azure 中按 wire index 为流式传输的工具调用建立键
在 Gemini 中保留文件数据内容部分
在 update() 和 recall() 的访问时间上遵循 read_only
向每个 OpenAI 推理模型发送 reasoning_effort
当流式输出包含字面量 [...] 时，防止运行 TUI 崩溃
当存储的任务不同时拒绝重放
在 Windows 上使用 sys.platform 防护以实现 mypy 兼容性
以用户轮次请求强制最终答案
在嵌入提示词的任务输出 schema 中保留 null
使 DOCXSearchTool 与标准 RAG 固定 schema 模式保持一致

文档

将 xpu 添加到嵌入设备选项
列出所有工作区包

贡献者

@ASTion24, @BlueX888, @HUAN2022A, @RaycarlLei, @Rohitkanithi, @SWAPI03, @SharoonSharif, @ShivangiRay, @Theater-ahyeon, @Vidit-Ostwal, @gamal1osama, @github-actions[bot], @joaomdmoura, @lorenzejay, @mhbuehler, @modusensus, @monkscode, @rohitkanithi, @roli-lpci, @vinibrsl, @wangtaotaotao95

v1.15.21

变更内容

特性

添加遥测以跟踪检查点运行时和 CLI 使用情况。

缺陷修复

修复在 HTTP 200 响应内报告的网关错误。
使 deploy push 保持在 AMP 创建来源上。
在 Oxylabs 集成中报告抓取失败，而不是抛出 IndexError。
将所有 DashScope 模型路由到原生服务商。
以 UTF-8 持久化 JSON 检查点。
移除 BrightData 的 f-string 搜索 URL 中多余的 $。
在 JSON schema 转换中支持列表形式的类型数组。
将 gpt-4o-mini 的上下文窗口从 200000 更正为 128000。
在 contentBlockStop 处保留流式工具调用参数。
使 pre-commit 钩子在 Windows 上可移植。

文档

明确追踪与遥测是分开管理的。
修复并行搜索参考链接。
从 handle_llm_stream_chunk 文档字符串中移除过时参数。
修复流式输出文档字符串示例。
在技能安装参考中使用组织 UUID。

贡献者

@Alphaxiaoteng, @DrewWhittleNZ, @Ghraven, @Shxiao101, @Vaishnavi220506, @Vidit-Ostwal, @danielfsbarreto, @georgeatparallel, @github-actions[bot], @jessemiller, @joaomdmoura, @kimnamu, @kiwoongyoon, @liang0417, @lorenzejay, @oxy-giedrius, @simpleqt, @uoparaji

v1.15.20

变更内容

缺陷修复

修复旧版平台工具别名发现

文档

更新 v1.15.19 的快照和更新日志

贡献者

@joaomdmoura, @vinibrsl

v1.15.19

变更内容

特性

添加 Clipper 集成客户端
将 now() 添加到 CEL 表达式环境
为每个用户记录团队运行如何结束
将机器规模报告为粗略区间，而不是核心数
为 CrewAI 平台工具添加可注入客户端

缺陷修复

修复 urlreadtool 中读取 octet-stream 和 xlsx URL 的问题
修复原生 Gemini 服务商中追加末尾用户轮次的问题
规范化 Ollama 基础 URL 中的 scheme 和端口
在记忆中保留可复用的作用域配置
因安全漏洞将 pypdf 升级到 6.16.2
因安全漏洞将 nltk 升级到 3.10.3
修复当前 Claude 模型和 Snowflake CVE 下限的原生结构化输出
在每条路径上运行模型调用钩子，并传播拒绝

文档

从 AI/ML 概览示例中移除 CodeInterpreterTool
将 prompt-template 链接指向其当前路径
将 channels 指南更新为当前 CopilotKit channels API
刷新已停用的 Gemini 模型 ID

贡献者

@Vidit-Ostwal, @a-yeyang, @github-actions[bot], @hvlcrs, @joaomdmoura, @kikifrost, @lorenzejay, @lucasgomide, @parthiban-sivakumar, @ranst91, @tandede, @thiagomoretto, @vinibrsl

v1.15.18

变更内容

特性

将对话式流程提升为稳定版
记录使用给定 UUID 创建的部署
增强对话式流程文档和 API
让声明指定路由的响应格式
让聊天流程声明自己的状态形状
在对话式声明中接受团队风格的 LLM 配置
使用生成的 ID 报告项目创建
记录运行是否有输入，而不记录输入内容
从每个用户调用的项目命令回填项目 ID

缺陷修复

当最终答案为空时保留工具结果
将默认 Claude Sonnet 4.6 映射到其 1M 上下文窗口
为大型工具调用提高 Anthropic 默认 max_tokens
将消息内容部分渲染为文本，而不是 Python repr
当 Agent.kickoff 接收到对话时保留消息角色
在 crewai 内部流程中跳过拦截钩子
将任务失败记录为失败，而不是成功
在受抑制的恢复中发出流程生命周期事件
为声明式聊天流程打开对话式 TUI
将 crew_memory 记录为字符串，而不是布尔值
始终发出 project_id，以便缺失和空值保持区别

文档

阐明 Arize Phoenix 可观测性文档

贡献者

@Vidit-Ostwal, @arizedatngo, @joaomdmoura, @lorenzejay, @lucasgomide

v1.15.17

变更内容

特性

新增声明式对话流程文档
为声明合成内置对话方法
让声明能够驱动对话模式
让对话功能的选择性启用一目了然
在通过 slug 引用解析出的工具上携带 AMP slug
在分块期间处理超大单条消息

缺陷修复

修复将 URL 主机名用作 MCP HTTP 和 SSE server_name 的问题
在每次失败的尝试后关闭智能体作用域
将工具错误归因到失败的那个工具
将 SSRF 检查固定到每一次重定向跳转和对端 IP
解决原生工具调用在 OpenAI Responses API 上失效的问题

文档

更新文档，加入 v1.15.16 的快照和变更日志

贡献者

@Copilot, @Vidit-Ostwal, @github-code-quality[bot], @joaomdmoura, @lorenzejay, @lucasgomide, @theCyberTech

v1.15.16

变更内容

特性

引入支持 UUID 的执行上下文管理
记录结束流程的异常类型
记录追踪批次与 AMP 共享的时机
统计来自任意来源的部署并记录其起始位置

缺陷修复

在每个发出的 span 上记录正在运行的发布版本
修复 MySQL 搜索表名校验
避免失败的轮次将下一轮标记为失败

文档

新增 CopilotKit 和 AG-UI 的前端指南

贡献者

@joaomdmoura, @lorenzejay, @ranst91, @theCyberTech

v1.15.15

变更内容

特性

上报流程结果、时长和人在回路信号。

缺陷修复

当边界钩子中止流程时发出 FlowStartedEvent。
将 span 导出限定在我们自己的 tracer provider 范围内。
将 torch 升级到 2.13.0 版本以修复安全漏洞。
将 crewai-tools[github] 中的 gitpython 升级到 3.1.58 版本。

重构

更新智能体中的日期注入功能。
将 CLI 标志统一为 kebab-case。

文档

v1.15.14 的快照和变更日志。

贡献者

@Vidit-Ostwal, @joaomdmoura, @lorenzejay, @lucasgomide, @theCyberTech

v1.15.14

变更内容

特性

将运行时上下文从编码智能体中拆分出来，并新增项目 ID

文档

更新 v1.15.13 的快照和变更日志

贡献者

@joaomdmoura

v1.15.13

变更内容

缺陷修复

修复 LiteLLM 路由模型上服务商信息的保留问题。
加固脆弱的 LLM 事件总线 mock。
修复 Anthropic 缓存 token 用量上报偏低的问题。
将 h2 升级到 4.4.1 版本以修复安全漏洞 GHSA-6hr6-w5qg-qmwg。

文档

新增 DOCS_TRANSLATIONS 工作流用于语言区域同步。
修复失效的 README 链接、目录和贡献指南。
1.15.12 版本的快照和变更日志。

贡献者

@Vidit-Ostwal, @joaomdmoura, @lucasgomide, @theCyberTech

v1.15.12

变更内容

特性

发布时升级 Flow canary
新增 URLReadTool 用于读取任意 URL
为平台操作工具新增应用元数据
将脚手架统一到 crewai create <resource> 下

缺陷修复

澄清对话路由/处理器名称冲突错误

文档

为统一的 create CLI 更新脚手架 AGENTS.md

破坏性变更

贡献者

@Vidit-Ostwal, @joaomdmoura, @lorenzejay, @lucasgomide, @theCyberTech

v1.15.11

变更内容

特性

在遥测中追踪拦截钩子的分发
新增 project_id，将 OSS 使用关联到企业版账户
在 AGENTS.md 中展示 AMP，并在遥测中检测编码智能体
新增 IBM Db2 搜索工具

缺陷修复

清除 CodeQL 的 URL 子字符串净化不完整告警
升级 aiohttp 和 cryptography 以清除六个 GHSA 公告
对 map 字面量内部的失败报告真实的 CEL 错误
对于仅文档的 PR 正确跳过代码 CI

文档

v1.15.10 的快照和变更日志

贡献者

@PawanThakurIBM, @Vidit-Ostwal, @gabemilani, @joaomdmoura, @lorenzejay, @lucasgomide, @theCyberTech

v1.15.10

变更内容

特性

收集技能使用事件

文档

移除已迁移的 AMP 文档
更新安全报告指南
v1.15.9 的快照和变更日志

贡献者

@gvieira, @joaomdmoura, @theCyberTech

v1.15.9

变更内容

特性

展示工具失败，而不是将其报告为成功
当流程执行失败时发出 FlowFailedEvent
为技能实现渐进式披露

文档

更新 v1.15.8 的快照和变更日志

贡献者

@github-actions[bot], @joaomdmoura, @lorenzejay, @lucasgomide

v1.15.8

变更内容

特性

新增 WaitTool 用于在长时间运行的作业中暂停。

缺陷修复

修复 FileWriterTool 的写入问题，并处理文件工具中的粗糙之处。
将 E2B_API_KEY 标记为 E2B 工具的必需环境变量。

文档

刷新模型可用性指南。

贡献者

@github-actions[bot], @joaomdmoura, @lucasgomide, @oalami, @thiagomoretto

v1.15.7

变更内容

缺陷修复

通过运行时的 CrewAI+ 客户端解析注册表技能
从 GPT-5.6 tools + reasoning_effort 的 400 错误中恢复
让工具调用在 Responses API 路径上可用
对仅支持 Responses 的模型进行路由，而不是以 404 失败
升级 bedrock-agentcore 以修补 CVE-2026-16796

可观测性

在运行时发出技能使用事件以提升可观测性

文档

新增 v1.15.7a1 的快照和变更日志

贡献者

@alex-clawd, @joaomdmoura, @lorenzejay

v1.15.7a1

变更内容

缺陷修复

修复通过运行时 CrewAI+ 客户端的注册表技能解析。
从 GPT-5.6 tools 和 reasoning_effort 的 400 错误中恢复。
让工具调用在 Responses API 路径上可用。
对仅支持 Responses 的模型进行路由，以避免 404 错误。
升级 bedrock-agentcore 依赖以修补 CVE-2026-16796。

可观测性

在运行时发出技能使用事件以提升可观测性。

文档

1.15.6 版本的快照和变更日志更新。

贡献者

@alex-clawd, @joaomdmoura, @lorenzejay

v1.15.6

变更内容

缺陷修复

修复 Anthropic 预览版工具使用块的检测。
保留严格的工具 schema 属性名。
在团队和流程执行失败时分发 execution_end 钩子。
在 load_agent_from_repository 中处理异步 get_agent。
修复依赖解析问题。

文档

v1.15.5 的快照和变更日志。

贡献者

@alex-clawd, @iris-clawd, @lorenzejay, @lucasgomide, @theCyberTech, @vinibrsl

v1.15.5

变更内容

特性

为技能注册表下载添加身份认证

文档

更新 v1.15.4 的快照和变更日志

贡献者

@vinibrsl

v1.15.4

变更内容

特性

将技能仓库从实验状态提升为正式功能

文档

新增 Studio 中的流程文档

贡献者

@jessemiller, @joaomdmoura, @vinibrsl

v1.15.3

变更内容

特性

为 PlusAPI 客户端新增组织 ID 参数
新增步骤拦截点，并围绕 @on 重做执行钩子文档
接通执行边界的拦截点
新增通用拦截钩子分发器
在 TUI 上运行声明式流程（无头终端回退）

缺陷修复

将 kickoff-completed 事件与 OUTPUT 钩子结果同步
修复仓库智能体属性为 null 的问题
确保 after_llm_call 钩子不会破坏原生工具执行
避免在处理程序裁剪历史时重复追加轮次回复
让工具结果缓存改为选择性启用，而非默认开启
停止在构造时重写作者编写的工具描述
在智能体和团队结果中以两个名称暴露 token 用量
在 kickoff 结果上报每次调用的用量指标
当 route_turn() 返回假值时不再重放上一轮的意图

文档

更新执行钩子分组并记录所有钩子上下文

贡献者

@joaomdmoura, @lorenzejay, @lucasgomide, @vinibrsl

v1.15.3a2

变更内容

缺陷修复

修复 kickoff-completed 事件与 OUTPUT 钩子结果的同步

文档

更新 v1.15.3a1 的快照和变更日志

依赖更新

将 setuptools 升级到 0.83.0 以修复 PYSEC-2026-3447

贡献者

@lucasgomide, @vinibrsl

v1.15.3a1

变更内容

特性

为 PlusAPI 客户端新增组织 ID 参数。
新增步骤拦截点，并围绕 @on 重做执行钩子文档。
接通执行边界的拦截点。
新增通用拦截钩子分发器。
在 TUI 上运行声明式流程（无头终端回退）。
改进自定义 OpenAI URL。

缺陷修复

修复仓库智能体属性为 null 的问题。
修复 after_llm_call 钩子，避免破坏原生工具执行。
停止在处理程序裁剪历史时重复追加轮次回复。
让工具结果缓存改为选择性启用，而非默认开启。
停止在构造时重写作者编写的工具描述。
在智能体和团队结果中以两个名称暴露 token 用量。
在 kickoff 结果上报每次调用的用量指标。
当 route_turn() 返回假值时不再重放上一轮的意图。
在 kickoff 和流程完成事件之前排空记忆写入。

文档

对执行钩子进行分组并记录所有钩子上下文。
更新执行钩子的文档。

贡献者

@joaomdmoura, @lorenzejay, @lucasgomide, @vinibrsl

v1.15.2

变更内容

特性

在团队向导中动态拉取最新的 LLM 模型。
支持内联技能定义。
新增生成的流程定义编写技能。
支持模板化的流程操作输入。
为流程 CEL 提示词新增文本辅助函数。
在流程技能示例中新增文本辅助函数。
在 AgentExecutor 中实现消息设置和反馈处理。
将仓库智能体添加到流程定义中。
为流程定义流式帧协议。
在 CrewDefinition 中为 tool 和 app 添加类型标注。
将模板命令重新指向 crewAIInc-fde 组织。

缺陷修复

按精确的 API 密钥作为模型目录缓存的键、缩短 TTL，并跳过 Ollama。
统一 crewai run 的流程输入解析，并依据状态 schema 生成提示词。
解决 onnx 1.22.0 和 nltk PYSEC-2026-597 的 pip-audit 失败问题。
确保为流程写入版本号。
在 bedrock extra 中包含 aiobotocore。
拒绝自监听的流程方法。
从 Edge 中移除文档版本导航，避免新页面被丢弃。

文档

将表述从 Rules 更新为 Policies，以匹配新的仪表板变更。
记录流程智能体选项。
将流式传输文档添加到导航中。
记录 Agent Control Plane 中的成本限制规则类型。
从 Datadog 指南中移除 CREWAI_LOG_FORMAT 引用。

贡献者

@akaKuruma, @danielfsbarreto, @github-code-quality[bot], @joaomdmoura, @lorenzejay, @lucasgomide, @manisrinivasan2k1, @renatonitta, @vinibrsl

v1.15.2a2

变更内容

特性

将 aiobotocore 添加到 bedrock extra
为流程智能体选项编写文档
为流程技能示例添加文本辅助函数
为流程 CEL 提示词添加文本辅助函数
将流式传输文档添加到导航

缺陷修复

拒绝自我监听的流程方法

文档

更新 v1.15.2a1 的快照和变更日志
精简 AGENTS.md 文件

贡献者

@akaKuruma, @github-code-quality[bot], @lorenzejay, @vinibrsl

v1.15.2a1

变更内容

特性

将模板命令重新指向 crewAIInc-fde 组织
支持内联技能定义
为流程定义流式传输帧协议
在 CrewDefinition 中添加类型工具和应用
添加生成的 Flow Definition 编写技能

缺陷修复

从 Edge 中移除文档版本导航，以防止新页面被丢弃

文档

在 Agent Control Plane 中为 Cost Limit 规则类型编写文档
从 Datadog 指南中移除 CREWAI_LOG_FORMAT 引用

贡献者

@danielfsbarreto, @joaomdmoura, @lorenzejay, @lucasgomide, @vinibrsl

v1.15.1

变更内容

特性

为生成的项目初始化 Git 仓库（#6364）
要求显式定义 CrewAI 项目（#6358）
CLI deploy 后打开部署页面（#6343）

缺陷修复

修复部署页面链接 ID 解析（#6365）
修复 JSON 团队模板渲染（#6359）
修复 JSON 团队版本固定（#6342）
修复抓取请求中的 SSRF 重定向绕过（#6331）

文档

改进 README 中的开源定位（#6363）
改进编码智能体设置的行动号召（#6344）
添加 1.15.1a1 版本的快照和变更日志（#6362）

贡献者

@joaomdmoura, @lorenzejay, @oalami, @theCyberTech, @vinibrsl

v1.15.1a1

变更内容

特性

跟踪 TUI 按钮遥测
要求显式定义 CrewAI 项目
CLI deploy 后打开部署页面

缺陷修复

修复 JSON 团队模板渲染
修复 JSON 团队版本固定
修复抓取请求中的 SSRF 重定向绕过

文档

改进编码智能体设置的 CTA
v1.15.0 的快照和变更日志

贡献者

@joaomdmoura, @lorenzejay, @theCyberTech, @vinibrsl

v1.15.0

变更内容

特性

在遥测中跟踪对话式流程的轮次使用情况
在 CLI TUI 中支持对话式流程
添加统一的声明式流程加载
添加声明式 Flow CLI 支持
为 each.do 步骤添加可选的 if 表达式
在 Flow 定义中添加单智能体操作
在 FlowDefinition 中添加团队操作
添加内联团队定义加载
在 FlowDefinition 中添加 each 复合操作
在团队创建和执行中实现 DMN 模式支持

缺陷修复

修复凭据文件仅所有者权限的强制校验
修复 JSON schema 流程状态启动输入
修复技能归档解压中的符号链接路径遍历
汇总所有 LLM 调用的 token 用量
移除重复的 Exa 工具
解决 JSON 团队问题
修复 JSON 团队处理并增强记忆重置功能

文档

更新面向 JSON 优先团队项目的安装与快速入门文档
添加 Datadog 集成指南及可导入的运维仪表板
添加「每步一张卡片」Studio 页面
添加通往 v1.15.0 的此前各版本的快照和变更日志

性能

改进 crewai run 的启动体验
让嵌套团队的流程方法进度保持可见

重构

从流程状态访问中移除 StateProxy
合并 crewai run 与 crewai flow kickoff
区分 FlowDefinition 的状态类型
将 FlowDefinition 中的配置和持久化接入运行时

贡献者

@gabemilani, @github-code-quality[bot], @greysonlalonde, @iris-clawd, @jessemiller, @joaomdmoura, @lorenzejay, @lucasgomide, @theCyberTech, @vinibrsl

v1.14.8a5

变更内容

特性

让声明式引用可跨流程和团队使用（#6326）

缺陷修复

修复 JSON schema 流程状态启动输入（#6325）

文档

将「每步一张卡片」归入 Crew Studio 之下并移除发布横幅（AGE-107）（#6317）
更新 v1.14.8a4 的快照和变更日志（#6319）

重构

从流程状态访问中移除 StateProxy（#6327）

贡献者

@jessemiller, @vinibrsl

v1.14.8a4

变更内容

特性

在 CLI TUI 中支持对话式流程。

缺陷修复

修复技能归档解压中的符号链接路径遍历。
校验声明式流程定义路径。

文档

更新 v1.14.8a3 的快照和变更日志。

贡献者

@lorenzejay, @theCyberTech, @vinibrsl

v1.14.8a3

变更内容

特性

添加统一的声明式流程加载
改进 crewai run 的启动体验
合并 crewai run 与 crewai flow kickoff
让嵌套团队的流程方法进度保持可见
添加声明式 Flow CLI 支持
允许将 @router() 作为流程的起始方法
为 CrewAI 工具添加类型化输出 schema

缺陷修复

将 opentelemetry 固定为 ~=1.42.0

文档

添加「每步一张卡片」Studio 页面

贡献者

@jessemiller, @joaomdmoura, @lucasgomide, @vinibrsl

v1.14.8a2

变更内容

特性

在 Flow 定义中添加单智能体操作
在定义加载时校验流程 CEL 表达式

文档

添加 Datadog 集成指南及可导入的运维仪表板
更新 v1.14.8a1 的快照和变更日志

贡献者

@joaomdmoura, @lucasgomide, @vinibrsl

v1.14.8a1

变更内容

特性

为 each.do 步骤添加可选的 if 表达式

缺陷修复

修复 JSON 团队问题

文档

更新 v1.14.8a 的快照和变更日志

贡献者

@joaomdmoura, @vinibrsl

v1.14.8a

变更内容

特性

在 FlowDefinition 中添加脚本/代码块操作
在 FlowDefinition 中添加团队操作
在 FlowDefinition 中添加 each 复合操作
在团队创建和执行中实现 DMN 模式支持
增强记忆重置功能和 JSON 团队处理
为 FlowDefinition 操作添加表达式
实现无需 Python 代码的 Flow 定义运行工具
由流程定义驱动人工反馈
将 FlowDefinition 中的配置和持久化接入运行时
为声明式流程添加 crewai run --definition
支持 ZIP 部署回退以及 JSON 团队项目环境运行
引入 JSON 优先团队

缺陷修复

修复重复的 Exa 工具
修复汇总所有 LLM 调用的 token 用量
解决团队加载和校验逻辑的问题

文档

在 JSON schema 中记录 FlowDefinition 字段
更新面向 JSON 优先团队项目的安装与快速入门文档
更新 v1.14.7 的变更日志和版本

贡献者

@gabemilani, @greysonlalonde, @iris-clawd, @joaomdmoura, @lorenzejay, @lucasgomide, @theCyberTech, @vinibrsl

v1.14.7

变更内容

特性

为记忆、知识、rag 和流程添加可插拔的默认后端。
在 LLM 事件中暴露真实的 finish_reason、采样参数和 response.id。
将 DSL 触发器类型化为路由感知装饰器。
为对话式流程添加 chat API。
让锁定后端可覆盖。
从 Flow DSL 元数据构建 FlowDefinition。
添加原生 Snowflake Cortex LLM 服务商。
添加团队训练智能体文件支持。

缺陷修复

修复检查点恢复时将自定义 BaseLLM 重建为具体 LLM 的问题。
通过标志位控制恢复，防止实时快照被当作续跑重放。
按运行限定运行时状态范围，以限制增长并隔离并发运行。
修复 crewai-login 上的遥测设置。
对方法执行事件遵循 suppress_flow_events。
恢复 crewai 包中的 [project.scripts]，以支持 uv tool install。
解决 aiohttp、docling 和 docling-core 的 pip-audit CVE。
修复文件输入无法可靠工作的问题。
修复 Snowflake Claude 工具结果历史不完整的问题。

文档

更新 v1.14.7 的变更日志和版本。
更新 OpenTelemetry collector 文档。
更新 NVIDIA Nemotron LLM 指南。
添加 Databricks 集成指南。
添加 Snowflake 集成指南。

性能

通过延迟加载 docling 导入提升 crewai 的导入速度。

重构

简化流程条件评估，使其对每个事件无状态。
将对话逻辑与运行时解耦，并添加 conversational_definition。
将 flow.py 拆分为 DSL、定义和运行时。

贡献者

@Luzk, @alex-clawd, @devin-ai-integration[bot], @greysonlalonde, @gvieira, @jessemiller, @lorenzejay, @lucasgomide, @mattatcha, @vinibrsl

v1.14.7rc2

变更内容

缺陷修复

通过标志位控制恢复，防止实时快照被当作续跑重放

文档

更新 v1.14.7rc1 的变更日志和版本

贡献者

@greysonlalonde

v1.14.7rc1

变更内容

特性

添加 reset_runtime_state 以释放累积的事件总线状态
支持同时兼容两种自定义提示词
将对话逻辑与运行时解耦，并添加 conversational_definition

缺陷修复

修复按运行限定运行时状态范围的问题，以限制增长并隔离并发运行
修复 crewai-login 上的遥测设置
修复对方法执行事件的 suppress_flow_events 遵循问题

文档

更新 OpenTelemetry 图片
更新文档以反映 OpenTelemetry collector 的新状态
更新 v1.14.7a4 的变更日志和版本

重构

简化流程条件评估，使其对每个事件无状态
以少一条路由改进对话路由循环

贡献者

@greysonlalonde, @lorenzejay, @lucasgomide, @vinibrsl

v1.14.7a4

变更内容

特性

将 @listen/@router 运行时迁移为从 FlowDefinition 读取
为记忆、知识、rag 和流程添加可插拔的默认后端

文档

更新 v1.14.7a3 的变更日志和版本

贡献者

@greysonlalonde, @mattatcha, @vinibrsl

v1.14.7a3

变更内容

缺陷修复

修复实验性 AgentExecutor 上 ask_for_human_input 的暴露问题
解决 aiohttp、docling、docling-core 和 pip 的 pip-audit CVE

重构

将 @start 迁移为从 FlowDefinition 读取

文档

更新 v1.14.7a2 的变更日志和版本

贡献者

@greysonlalonde, @lorenzejay, @vinibrsl

v1.14.7a2

变更内容

特性

添加对话式流程追踪支持。
更新对话式流程文档以使用 handle_turn。
在 LLM 事件中暴露真实的 finish_reason、采样参数和 response.id。
将 DSL 触发器类型化为路由感知装饰器。
为对话式流程实现 chat API。
让锁定存储中的锁定后端可覆盖。
将单体的流程 DSL 拆分为职责聚焦的装饰器模块。
在 _usage_to_dict 中展平 LiteLLM 缓存/推理用量的子计数。
从 Flow DSL 元数据构建 FlowDefinition。

文档

添加 NVIDIA Nemotron LLM 指南。
记录 monorepo 部署。
更新 v1.14.7a1 的变更日志和版本。

贡献者

@alex-clawd, @gvieira, @lorenzejay, @lucasgomide, @mattatcha, @vinibrsl

v1.14.7a1

变更内容

特性

新增对团队训练智能体文件的支持
新增原生 Snowflake Cortex LLM 服务商
新增 Databricks 集成指南
新增 Snowflake 集成指南

缺陷修复

修复 CLI：在 crewai 包中恢复 [project.scripts]，以支持通过 UV 工具安装
解决文件输入可靠性问题
修复 Snowflake Claude 中工具结果历史不完整的问题
处理 Snowflake Claude 的字符串化工具调用
在路由驱动的循环中重新启用多源 or_ 监听器

性能

通过延迟加载 docling 导入提升 crewai 导入速度

重构

将 flow.py 拆分为 DSL、定义和运行时

贡献者

@Luzk, @alex-clawd, @devin-ai-integration[bot], @greysonlalonde, @jessemiller, @lorenzejay, @vinibrsl

v1.14.6

变更内容

特性

增强 StdioTransport，防止环境变量泄漏
增强规划配置与观测处理
在 DatabricksQueryTool 上声明 env_vars
新增 Agent Control Plane 文档

缺陷修复

修复工具调用循环中的结构化输出泄漏
在检查点中丢弃无法往返的回调与适配器状态
在检查点中将 type[BaseModel] 字段序列化为 JSON schema
避免在恢复作用域还原时产生孤立的 task_started
允许 AgentExecutor 从检查点恢复
将 package_dependencies 中的 mongodb 拼写错误更正为 pymongo

文档

向 Agent Control Plane 页面添加 ACP (Beta) 文档导航区块
从流程页面移除共识流程引用
重构检查点页面
记录一次性管理员包安装步骤
从 replicated-config 迁移 Secrets Manager / Workload Identity
移除破坏 <Steps> 渲染的 {" "} JSX 表达式

重构

将 Skills Repository 移至 experimental + CREWAI_EXPERIMENTAL 门控

贡献者

@akaKuruma, @alex-clawd, @github-actions[bot], @greysonlalonde, @heitorado, @iris-clawd, @lorenzejay, @lucasgomide, @mattatcha, @thiagomoretto, @vinibrsl

v1.14.6a2

变更内容

特性

增强 StdioTransport，防止环境变量泄漏
增强规划配置与观测处理
在 DatabricksQueryTool 上声明 env_vars
新增 Agent Control Plane 文档

缺陷修复

修复工具调用循环中的结构化输出泄漏
在检查点中丢弃无法往返的回调与适配器状态
在检查点中将 type[BaseModel] 字段序列化为 JSON schema
避免在恢复作用域还原时产生孤立的 task_started
允许 AgentExecutor 从检查点恢复
将包依赖中的 MongoDB 拼写错误更正为 pymongo

文档

重构检查点页面
记录一次性管理员包安装步骤
从 replicated-config 迁移 Secrets Manager / Workload Identity
从变更日志中移除 Skills Repository 条目

贡献者

@github-actions[bot], @greysonlalonde, @heitorado, @iris-clawd, @lorenzejay, @lucasgomide, @mattatcha, @thiagomoretto, @vinibrsl

v1.14.6a1

变更内容

特性

为企业版生成分类发布说明

缺陷修复

加固跨实体字段的 RuntimeState 序列化
将 idna 升级至 3.15，以解决安全问题 GHSA-65pc-fj4g-8rjx
移除破坏 <Steps> 渲染的 {" "} JSX 表达式

文档

更新 v1.14.5 的变更日志和版本

贡献者

@akaKuruma, @alex-clawd, @greysonlalonde

v1.14.5

变更内容

特性

弃用 CrewAgentExecutor，将 Crew 智能体默认设为 AgentExecutor
改进 Daytona 沙箱工具
新增 restore_from_state_id kickoff 参数
为 ExaSearchTool 添加 highlights，并从 EXASearchTool 重命名

缺陷修复

通过使用 cached_property 修复 git.py 中的内存泄漏
在缺少 available_functions 时暴露流式工具调用
确保追踪中包含 skills 加载事件
将状态端点路径从 /{kickoff_id}/status 更正为 /status/{kickoff_id}
恢复 pt-BR 首次流程指南中缺失的代码块
防止 result_as_answer 将 hook-block 或错误消息作为最终答案返回
在异步批量刷新期间保留任务输出
始终在 finally 块中恢复 task.output_pydantic
在 convert_to_model 中处理 BaseModel 输入

文档

更新 v1.14.5 的变更日志和版本
新增 OSS 升级和 crew-to-flow 迁移指南
记录 devtools 的附加环境变量
新增 TavilyGetResearch 文档

重构

将 CLI 抽取为独立的 crewai-cli 包

贡献者

@NIK-TIGER-BILL, @akaKuruma, @cgoeppinger, @github-actions[bot], @greysonlalonde, @heitorado, @irfaan101, @iris-clawd, @lorenzejay, @manisrinivasan2k1, @minasami-pr, @mislavivanda, @theCyberTech, @theishangoswami, @wishhyt

v1.14.5a7

变更内容

文档

更新 v1.14.5a6 的变更日志和版本

破坏性变更

弃用 function_calling_llm 字段

贡献者

@greysonlalonde, @heitorado

v1.14.5a6

变更内容

缺陷修复

在缺少 available_functions 时修复流式工具调用
将 langsmith 依赖升级至 >=0.8.0 版本，以解决 GHSA-3644-q5cj-c5c7
解决巴西葡萄牙语文档中未翻译的代码块占位符

文档

新增 TavilyGetResearch 文档
更新 v1.14.5a5 的变更日志和版本

贡献者

@greysonlalonde, @heitorado, @iris-clawd, @lorenzejay, @manisrinivasan2k1

v1.14.5a5

变更内容

特性

弃用 CrewAgentExecutor，将 Crew 智能体默认设为 AgentExecutor
改进 Daytona 沙箱工具

缺陷修复

修复 pt-BR 首次流程指南中缺失的代码块
记录 HITL 预审和蒸馏失败，新增 learn_strict
修补 urllib3 的安全漏洞
修补 gitpython 和 langchain-core；忽略未修补的 paramiko CVE
在 uv lock/sync 时刷新所有已发布的工作区包

文档

新增从 inputs.id 到 restoreFromStateId 的迁移指南
新增 OSS 升级和 crew-to-flow 迁移指南
更新 v1.14.5a4 的变更日志和版本

贡献者

@akaKuruma, @greysonlalonde, @iris-clawd, @lorenzejay, @mislavivanda

v1.14.5a4

变更内容

特性

更新 LLM 列表

缺陷修复

通过将 textual 移至 crewai-cli 并添加 certifi 来修复依赖问题

文档

更新 v1.14.5a3 的变更日志和版本

贡献者

@cgoeppinger, @greysonlalonde

v1.14.5a3

变更内容

缺陷修复

将状态端点路径从 /{kickoff_id}/status 修复为 /status/
将 gitpython 依赖升级到 >=3.1.47 版本，以满足安全合规要求

重构

将 CLI 抽取为独立的 crewai-cli 包

文档

更新 v1.14.5a2 的变更日志和版本

贡献者

@greysonlalonde, @iris-clawd

v1.14.5a2

变更内容

缺陷修复

修复 finally 块中的任务输出恢复
将 thoughts_token_count 计入补全 token 中
在异步批量刷新期间保留任务输出
在 CrewAIRagAdapter 中将 kwargs 转发到加载器调用
防止 result_as_answer 将 hook-block 消息作为最终答案返回
防止 result_as_answer 将错误作为最终答案返回
在异步路径中使用 acall 进行输出转换
防止共享 LLM 的停用词在智能体之间发生变更
在 convert_to_model 中处理 BaseModel 输入

文档

记录附加环境变量
更新 v1.14.5a1 的变更日志和版本

贡献者

@NIK-TIGER-BILL, @greysonlalonde, @lorenzejay, @minasami-pr, @theCyberTech, @wishhyt

v1.14.5a1

变更内容

特性

新增 restore_from_state_id kickoff 参数
为 ExaSearchTool 添加 highlights，并从 EXASearchTool 重命名

缺陷修复

修复发布流程中缺失的 crewai pin sites
确保追踪中包含 skills 加载事件

文档

更新 v1.14.4 的变更日志和版本

贡献者

@akaKuruma, @github-actions[bot], @greysonlalonde, @lorenzejay, @theishangoswami

v1.14.4

变更内容

特性

新增 @persist 中自定义持久化键的支持
新增 Azure OpenAI 服务商对 Responses API 的支持
将 credential_scopes 转发到 Azure AI Inference 客户端
新增 Vertex AI 工作负载身份设置指南
新增 Tavily Research 和 get Research
新增用于搜索、研究和内容提取的 You.com MCP 工具

缺陷修复

修复 JSON 正则匹配不是有效 JSON 时的穿透问题
修复当响应同时包含文本时保留 tool_calls 的问题
修复将 base_url 和 api_key 转发到 instructor.from_provider 的问题
修复原生 MCP 服务器未返回工具时发出警告并返回空结果的问题
修复在非流式处理程序中使用已验证的 messages 变量的问题
修复保护 crew 聊天描述辅助函数免受 LLM 失败影响的问题
修复在多次调用之间重置 messages 和 iterations 的问题
修复通过 replay 和 test 转发 trained-agents 文件的问题
修复在推理时遵循自定义 trained-agents 文件的问题
修复将仅任务智能体绑定到 crew，以支持多模态 input_files 的问题
修复将护栏可调用对象序列化为 null 以进行 JSON 检查点的问题
修复重命名 force_final_answer 以避免自引用路由的问题
修复升级 litellm 以修复 SSTI；忽略无法修复的 pip CVE

文档

更新 v1.14.4a1 的变更日志和版本
新增 E2B Sandbox Tools 页面
新增 Daytona 沙箱工具文档

贡献者

@EdwardIrby, @dependabot[bot], @factory-droid-oss, @factory-droid[bot], @greysonlalonde, @kunalk16, @lorenzejay, @lucasgomide, @manisrinivasan2k1, @mattatcha, @vinibrsl

v1.14.4a1

变更内容

缺陷修复

修复团队聊天描述辅助函数以应对 LLM 故障。
在执行器的多次调用之间重置 messages 和 iterations。
通过 CLI 中的 replay 和 test 转发 trained-agents 文件。
在智能体推理时遵循自定义 trained-agents 文件。
将仅任务智能体绑定到团队，以确保多模态 input_files 到达 LLM。
将护栏可调用对象序列化为 null，以进行 JSON 检查点。
重命名 agent_executor 中的 force_final_answer，以避免自引用路由。
升级 litellm 以修复 SSTI，并忽略无法修复的 pip CVE。

文档

新增 E2B Sandbox Tools 页面。
新增 Daytona 沙箱工具文档。
新增 Vertex AI 工作负载身份设置指南。
新增用于搜索、研究和内容提取的 You.com MCP 工具。
更新 v1.14.3 的变更日志和版本。

贡献者

@EdwardIrby, @dependabot[bot], @factory-droid-oss, @factory-droid[bot], @greysonlalonde, @lorenzejay, @manisrinivasan2k1, @mattatcha

v1.14.3

变更内容

特性

新增检查点操作的生命周期事件
新增对 e2b 的支持
在 Azure 集成中未提供 API 密钥时回退到 DefaultAzureCredential
新增 Bedrock V4 支持
新增 Daytona 沙箱工具以增强功能
新增对独立智能体的检查点和 fork 支持

缺陷修复

修复 execution_id，使其与 state.id 分离
解决检查点恢复时已记录的方法事件的重放问题
修复 initial_state 类引用作为 JSON schema 的序列化
保留仅含元数据的智能体技能
将隐式 @CrewBase 名称传播到 crew 事件
在重复批处理初始化时合并执行元数据
修复用于检查点的 Task 类引用字段的序列化
在护栏重试循环中处理 BaseModel 结果
在 Gemini 流式工具调用中保留 thought_signature
在派生恢复时发出 task_started 并重新设计检查点 TUI
在检查点清理测试中使用未来日期，以防止依赖时间的失败
修复 devtools 发布中的试运行顺序并处理已检出的过期分支
将 lxml 升级至 >=6.1.0 以获取安全补丁
将 python-dotenv 升级至 >=1.2.2 以获取安全补丁

文档

更新 v1.14.3 的变更日志和版本
新增「Build with AI」页面并更新所有语言的导航
从所有语言版本的 build-with-ai 页面移除定价 FAQ

性能

优化 MCP SDK 和事件类型，将冷启动时间缩短约 29%

重构

重构检查点辅助函数以消除重复并收紧状态类型提示

贡献者

@MatthiasHowellYopp, @akaKuruma, @alex-clawd, @github-actions[bot], @github-advanced-security[bot], @greysonlalonde, @iris-clawd, @lorenzejay, @mattatcha, @renatonitta

v1.14.3a3

变更内容

特性

新增对 e2b 的支持
在未提供 API key 时回退到 DefaultAzureCredential

缺陷修复

将 lxml 升级至 >=6.1.0 以解决安全问题 GHSA-vfmq-68hx-4jfw

文档

从所有语言版本的 build-with-ai 页面移除定价 FAQ

性能

通过惰性加载 MCP SDK 和事件类型，将冷启动时间缩短约 29%

贡献者

@alex-clawd, @github-advanced-security[bot], @greysonlalonde, @iris-clawd, @lorenzejay, @mattatcha

v1.14.3a2

变更内容

特性

新增对 bedrock V4 的支持
新增 Daytona 沙箱工具以增强功能
新增「Build with AI」页面 —— 面向编码智能体的 AI 原生文档
将 Build with AI 添加到 Get Started 导航，并为所有语言（en、ko、pt-BR、ar）添加页面文件

缺陷修复

修复隐式 @CrewBase 名称到 crew 事件的传播
解决执行元数据合并中重复批处理初始化的问题
修复用于检查点的 Task 类引用字段的序列化
在护栏重试循环中处理 BaseModel 结果
将 python-dotenv 升级至 >=1.2.2 版本以符合安全要求

文档

更新 v1.14.3a1 的变更日志和版本
更新描述并应用实际译文

贡献者

@MatthiasHowellYopp, @github-actions[bot], @greysonlalonde, @iris-clawd, @lorenzejay, @renatonitta

v1.14.3a1

变更内容

特性

为独立智能体新增检查点和派生支持

缺陷修复

在 Gemini 流式工具调用中保留 thought_signature
在派生恢复时发出 task_started 并重新设计检查点 TUI
修正 devtools 发布中的试运行顺序并处理已检出的过期分支
在检查点清理测试中使用未来日期，以防止依赖时间的失败（#5543）

文档

更新 v1.14.2 的变更日志和版本

贡献者

@alex-clawd, @greysonlalonde

v1.14.2

变更内容

特性

新增检查点恢复、差异对比和清理命令，并提升其可发现性。
为 Agent.kickoff 及相关方法新增 from_checkpoint 参数。
新增项目模板的模板管理命令。
在 devtools 发布失败时新增恢复提示。
新增部署校验 CLI 并增强 LLM 初始化的易用性。
新增带有谱系追踪的检查点派生。
用推理 token 和缓存创建 token 丰富 LLM token 追踪。

缺陷修复

修复 devtools 发布中过期分支冲突时的提示。
修补 authlib、langchain-text-splitters 和 pypdf 中的漏洞。
限定流式处理器的作用域，防止跨运行的 chunk 污染。
在 TUI 中通过 Flow API 分发 Flow 检查点。
对 JSON 检查点发现使用递归 glob。
在 MCP 工具解析中处理循环 JSON schema。
通过移除真值默认值来保留 Bedrock 工具调用参数。
在人在回路恢复后发出 flow_finished 事件。
通过更新依赖修复多个漏洞，包括 requests、cryptography 和 pytest。
修复停止将严格模式转发到 Bedrock Converse API 的问题。

文档

补充缺失参数的文档并新增检查点章节。
更新 v1.14.2 及此前候选版本的变更日志和版本。
新增企业版 A2A 功能文档并更新 OSS A2A 文档。

贡献者

@Yanhu007, @alex-clawd, @github-actions[bot], @greysonlalonde, @iris-clawd, @lorenzejay, @lucasgomide

v1.14.2rc1

变更内容

缺陷修复

修复 MCP 工具解析中循环 JSON schema 的处理
通过将 python-multipart 升级至 0.0.26 修复漏洞
通过将 pypdf 升级至 6.10.1 修复漏洞

文档

更新 v1.14.2a5 的变更日志和版本

贡献者

@greysonlalonde

v1.14.2a5

变更内容

文档

更新 v1.14.2a4 的变更日志和版本

贡献者

@greysonlalonde

v1.14.2a4

变更内容

特性

在 devtools 发布失败时新增恢复提示

缺陷修复

修复向 Bedrock Converse API 转发严格模式的问题
将 pytest 版本固定为 9.0.3，以应对安全漏洞 GHSA-6w46-j5rx-g56g
将 OpenAI 的最低版本提升至 >=2.0.0

文档

更新 v1.14.2a3 的变更日志和版本

贡献者

@greysonlalonde

v1.14.2a3

变更内容

特性

新增部署校验 CLI
改善 LLM 初始化的易用性

缺陷修复

针对 CVE-2026-40260 和 GHSA-pjjw-68hj-v9mw，将 pypdf 和 uv 覆盖为已修补版本
为修复 CVE 临时文件漏洞，将 requests 升级至 >=2.33.0
通过移除真值默认值来保留 Bedrock 工具调用参数
为严格模式清理工具 schema
消除 MemoryRecord 嵌入序列化测试的不稳定因素

文档

整理企业版 A2A 的措辞
新增企业版 A2A 功能文档
更新 OSS A2A 文档
更新 v1.14.2a2 的变更日志和版本

贡献者

@Yanhu007, @greysonlalonde

v1.14.2a2

变更内容

特性

新增带树视图、派生支持和可编辑输入/输出的检查点 TUI
用推理 token 和缓存创建 token 丰富 LLM token 追踪
为 kickoff 方法新增 from_checkpoint 参数
通过迁移框架在检查点中嵌入 crewai_version
新增带有谱系追踪的检查点派生

缺陷修复

修复向 Anthropic 和 Bedrock 服务商转发严格模式的问题
通过默认只读、查询校验和参数化查询加固 NL2SQLTool

文档

更新 v1.14.2a1 的变更日志和版本

贡献者

@alex-clawd, @github-actions[bot], @greysonlalonde, @lucasgomide

v1.14.2a1

变更内容

缺陷修复

修复人在回路恢复后 flow_finished 事件的发出
将 cryptography 版本固定为 46.0.7，以应对 CVE-2026-39892

重构

重构为使用共享的 I18N_DEFAULT 单例

文档

更新 v1.14.1 的变更日志和版本

贡献者

@greysonlalonde

v1.14.1

变更内容

特性

新增异步检查点 TUI 浏览器
为流式输出新增 aclose()/close() 和异步上下文管理器

缺陷修复

修复模板 pyproject.toml 版本升级的正则表达式
清理 hook 装饰器过滤器中的工具名称
修复创建 CheckpointConfig 时检查点处理器的注册
将 transformers 升级至 5.5.0 以解决 CVE-2026-1839
移除 FilteredStream 的 stdout/stderr 包装

文档

更新 v1.14.1rc1 的变更日志和版本

重构

在规范生成中将硬编码拒绝列表替换为动态 BaseTool 字段排除
在 devtools CLI 中用 tomlkit 替换正则表达式
使用共享的 PRINTER 单例
将 BaseProvider 改为带有 provider_type 判别字段的 BaseModel

贡献者

@greysonlalonde, @iris-clawd, @joaomdmoura, @lorenzejay

v1.14.1rc1

变更内容

特性

新增异步检查点 TUI 浏览器
为流式输出新增 aclose()/close() 和异步上下文管理器

缺陷修复

使用正则表达式修复模板 pyproject.toml 版本升级
清理 hook 装饰器过滤器中的工具名称
将 transformers 升级至 5.5.0 以解决 CVE-2026-1839
在创建 CheckpointConfig 时注册检查点处理器

重构

在规范生成中将硬编码拒绝列表替换为动态 BaseTool 字段排除
在 devtools CLI 中用 tomlkit 替换正则表达式
使用共享的 PRINTER 单例
将 BaseProvider 改为带有 provider_type 判别字段的 BaseModel
移除 FilteredStream 的 stdout/stderr 包装
移除未使用的 flow/config.py

文档

更新 v1.14.0 的变更日志和版本

贡献者

@greysonlalonde, @iris-clawd, @joaomdmoura

v1.14.0

变更内容

特性

新增检查点 list/info CLI 命令
新增 guardrail_type 和 name 以区分追踪
新增用于检查点存储的 SqliteProvider
新增用于自动检查点的 CheckpointConfig
实现运行时状态检查点、事件系统和执行器重构

缺陷修复

新增 SSRF 和路径遍历防护
为 RAG 工具新增路径和 URL 校验
从记忆序列化中排除嵌入向量以节省 token
确保在 flow 模板中写入前输出目录已存在
将 litellm 升级至 >=1.83.0 以应对 CVE-2026-35030
移除导致阿拉伯语页面渲染异常的 SEO 索引字段

文档

更新 v1.14.0 的变更日志和版本
更新快速入门和安装指南以提升清晰度
新增存储服务商章节，导出 JsonProvider
新增 AMP Training Tab 指南

重构

清理检查点 API
移除 CodeInterpreterTool 并废弃代码执行参数

贡献者

@alex-clawd, @github-actions[bot], @greysonlalonde, @iris-clawd, @joaomdmoura, @lorenzejay, @lucasgomide

v1.14.0a4

变更内容

特性

新增 guardrail_type 和 name 以区分追踪
新增用于检查点存储的 SqliteProvider
新增用于自动检查点的 CheckpointConfig
实现运行时状态检查点、事件系统和执行器重构

缺陷修复

从记忆序列化中排除嵌入向量以节省 token
将 litellm 升级至 >=1.83.0 以应对 CVE-2026-35030

文档

更新快速入门和安装指南以提升清晰度
新增存储服务商章节并导出 JsonProvider

性能

为检查点数据列使用 JSONB

重构

移除 CodeInterpreterTool 并废弃代码执行参数

贡献者

@alex-clawd, @github-actions[bot], @greysonlalonde, @joaomdmoura, @lorenzejay, @lucasgomide

v1.14.0a3

变更内容

文档

更新 v1.14.0a2 的变更日志和版本

贡献者

@joaomdmoura

v1.14.0a2

版本 1.14.0a2

v1.13.0

变更内容

特性

新增 RuntimeState RootModel，以实现统一的状态序列化
为技能和记忆事件添加新的遥测 span，以增强事件监听器
新增 A2UI 扩展，支持 v0.8/v0.9，并包含 schema 和文档
在 LLMCallCompletedEvent 中输出 token 用量数据
在发布期间自动更新部署测试仓库
提升企业版发布的韧性与用户体验

缺陷修复

为 crewai install 添加工具仓库凭据
为 tool publish 中的 uv build 添加工具仓库凭据
通过 config 而不是工具参数传递指纹元数据
处理不支持 stop API 参数的 GPT-5.x 模型
将 GPT-5 和 o 系列加入多模态视觉前缀
在企业版发布中清除新发布包的 uv 缓存
为兼容 Windows，将 lancedb 限制在 0.30.1 以下
修正 RBAC 权限级别，使其与实际 UI 选项一致
修复所有语言版本中 agent-capabilities 的不准确之处

文档

在入门页面添加编码智能体技能演示视频
添加完整的 SSO 配置指南
添加完整的 RBAC 权限矩阵与部署指南
更新 v1.13.0 的变更日志与版本

性能

通过惰性事件总线降低框架开销，并在禁用追踪时跳过追踪

重构

将 Flow 转换为 Pydantic BaseModel
将 LLM 类转换为 Pydantic BaseModel
用普通类型注解替换 InstanceOf[T]
移除未使用的 third_party LLM 目录

贡献者

@alex-clawd, @dependabot[bot], @greysonlalonde, @iris-clawd, @joaomdmoura, @lorenzejay, @lucasgomide, @thiagomoretto

v1.13.0a7

变更内容

特性

新增 A2UI 扩展，支持 v0.8/v0.9，并包含 schema 和文档

缺陷修复

通过添加 GPT-5 和 o 系列来修复多模态视觉前缀

文档

更新 v1.13.0a6 的变更日志与版本

贡献者

@alex-clawd, @greysonlalonde, @joaomdmoura

v1.13.0a6

变更内容

文档

修正 RBAC 权限级别，使其与实际 UI 选项一致 (#5210)
更新 v1.13.0a5 的变更日志与版本 (#5200)

性能

通过实现惰性事件总线并在禁用追踪时跳过追踪来降低框架开销 (#5187)

贡献者

@alex-clawd, @joaomdmoura, @lucasgomide

v1.13.0a5

变更内容

文档

更新 v1.13.0a4 的变更日志与版本

贡献者

@greysonlalonde, @joaomdmoura

v1.13.0a4

变更内容

文档

更新 v1.13.0a3 的变更日志与版本

贡献者

@greysonlalonde

v1.13.0a3

变更内容

特性

在 LLMCallCompletedEvent 中输出 token 用量数据
提取工具元数据并发布到 AMP

缺陷修复

处理不支持 stop API 参数的 GPT-5.x 模型

文档

修复所有语言版本中 agent-capabilities 的不准确之处
添加智能体能力概览并改进技能文档
添加完整的 SSO 配置指南
更新 v1.13.0rc1 的变更日志与版本

重构

将 Flow 转换为 Pydantic BaseModel
将 LLM 类转换为 Pydantic BaseModel
用普通类型注解替换 InstanceOf[T]
移除未使用的方法

贡献者

@dependabot[bot], @greysonlalonde, @iris-clawd, @lorenzejay, @lucasgomide, @thiagomoretto

v1.13.0rc1

变更内容

文档

更新 v1.13.0a2 的变更日志与版本

贡献者

@greysonlalonde

v1.13.0a2

变更内容

特性

在发布期间自动更新部署测试仓库
提升企业版发布的韧性与用户体验

文档

更新 v1.13.0a1 的变更日志与版本

贡献者

@greysonlalonde

v1.13.0a1

变更内容

缺陷修复

通过将 Node 固定为 LTS 22 来修复文档工作流中的失效链接
在企业版发布中清除新发布包的 uv 缓存

文档

添加完整的 RBAC 权限矩阵与部署指南
更新 v1.12.2 的变更日志与版本

贡献者

@greysonlalonde, @iris-clawd, @joaomdmoura

v1.12.2

变更内容

特性

为 devtools release 添加企业版发布阶段

缺陷修复

对带 emit 的 @human_feedback，保留方法返回值作为流程输出

文档

更新 v1.12.1 的变更日志与版本
修订安全策略与报告说明

贡献者

@alex-clawd, @greysonlalonde, @joaomdmoura, @theCyberTech

v1.12.1

变更内容

特性

为 HumanFeedbackRequestedEvent 添加 request_id
为记忆系统添加 Qdrant Edge 存储后端
添加 docs-check 命令，用于分析变更并生成带翻译的文档
为变更日志与发布工具添加阿拉伯语支持
添加所有文档的现代标准阿拉伯语翻译
在 CLI 中添加 logout 命令
添加智能体技能
实现用于层级记忆隔离的自动 root_scope
实现原生 OpenAI 兼容服务商（OpenRouter、DeepSeek、Ollama、vLLM、Cerebras、Dashscope）

缺陷修复

修复追踪批量推送的凭据错误（404）
解决 HITL 流程系统中的多个问题
修复智能体记忆保存
解决 crewai 包中所有严格 mypy 错误
修复 FlowMeta 中 listener+router 方法对 router_paths 的使用
修复在不支持文件时抛出的 ValueError
更正文档中 litellm 隔离相关措辞
修复 crewai-files 中所有 mypy 错误，并将所有包纳入 CI 类型检查
将 litellm 的上限固定为最后测试通过的版本 (1.82.6)

文档

更新 v1.12.0 的变更日志与版本
添加 CONTRIBUTING.md
添加不使用 LiteLLM 使用 CrewAI 的指南

贡献者

@akaKuruma, @alex-clawd, @greysonlalonde, @iris-clawd, @joaomdmoura, @lorenzejay, @lucasgomide, @nicoferdi96

v1.12.0

变更内容

特性

为记忆系统添加 Qdrant Edge 存储后端
添加 docs-check 命令，用于分析变更并生成带翻译的文档
为变更日志与发布工具添加阿拉伯语支持
添加所有文档的现代标准阿拉伯语翻译
在 CLI 中添加 logout 命令
实现智能体技能
实现用于层级记忆隔离的自动 root_scope
实现原生 OpenAI 兼容服务商（OpenRouter、DeepSeek、Ollama、vLLM、Cerebras、Dashscope）

缺陷修复

修复追踪批量推送的凭据错误（404）
解决 HITL 流程系统中的多个问题
解决 crewai-files 中的 mypy 错误，并将所有包纳入 CI 类型检查
解决 crewai-tools 包中所有严格 mypy 错误
解决 crewai 包中所有 mypy 错误
修复智能体中的记忆保存
修复 FlowMeta 中 listener+router 方法对 router_paths 的使用
在不支持文件时抛出 ValueError
更正文档中 litellm 隔离相关措辞
在人工反馈学习中用 None 检查代替 isinstance 检查记忆
将 litellm 的上限固定为最后测试通过的版本 (1.82.6)

文档

更新 v1.12.0 的变更日志与版本
添加 CONTRIBUTING.md
添加不使用 LiteLLM 使用 CrewAI 的指南

重构

重构以去除智能体中同步/异步任务执行与 kickoff 的重复
简化源自 litellm 的内部底层逻辑（token 计数、回调、特性检测、错误）

贡献者

@akaKuruma, @alex-clawd, @greysonlalonde, @iris-clawd, @joaomdmoura, @lorenzejay, @nicoferdi96

v1.12.0a3

变更内容

缺陷修复

修复追踪批量推送的凭据错误（404）
解决 HITL 流程系统中的多个问题

文档

更新 v1.12.0a2 的变更日志与版本

贡献者

@akaKuruma, @greysonlalonde

v1.12.0a2

变更内容

特性

为记忆系统添加 Qdrant Edge 存储后端

文档

更新 v1.12.0a1 的变更日志与版本

贡献者

@greysonlalonde

v1.12.0a1

变更内容

特性

添加 docs-check 命令，用于分析变更并生成带翻译的文档
为变更日志与发布工具添加阿拉伯语支持
添加所有文档的现代标准阿拉伯语翻译
添加原生 OpenAI 兼容服务商（OpenRouter、DeepSeek、Ollama、vLLM、Cerebras、Dashscope）
添加智能体技能
在 CLI 中添加 logout 命令
实现用于层级记忆隔离的自动 root_scope

缺陷修复

修复智能体记忆保存
解决 crewai-files 中的 mypy 错误，并将所有包纳入 CI 类型检查
解决 crewai-tools 包中所有严格 mypy 错误
解决 crewai 包中所有 mypy 错误
修复 FlowMeta 中 listener+router 方法对 router_paths 的使用
将 litellm 的上限固定为最后测试通过的版本 (1.82.6)
在不支持文件时抛出 ValueError
更正文档中 litellm 隔离相关措辞

文档

添加 CONTRIBUTING.md
添加不使用 LiteLLM 使用 CrewAI 的指南
更新 v1.11.1 的变更日志与版本

重构

重构以去除智能体中同步/异步任务执行与 kickoff 的重复
将内部底层逻辑与 litellm 解耦（token 计数、回调、特性检测、错误）

贡献者

@alex-clawd, @greysonlalonde, @iris-clawd, @lorenzejay, @nicoferdi96

v1.11.1

变更内容

特性

为 Flow 类内省添加 flow_structure() 序列化器。

缺陷修复

通过升级 pypdf、tinytag 和 langchain-core 修复安全漏洞。
在非 OpenAI 服务商的 HITL 恢复过程中保留完整 LLM 配置。
防止 FileWriterTool 中的路径穿越。
修复未安装 redis 包时 lock_store 崩溃。
将 cache_function 从 BaseTool 传递到 CrewStructuredTool。

文档

添加带翻译的发布自定义工具指南。
更新 v1.11.0 的变更日志与版本。
补充缺失的事件监听器文档。

重构

在 pdf 加载器中用 requests 替换 urllib。
将 Any 类型的回调与模型字段替换为可序列化类型。

贡献者

@alex-clawd, @danielfsbarreto, @dependabot[bot], @greysonlalonde, @lorenzejay, @lucasgomide, @mattatcha, @theCyberTech, @vinibrsl

v1.11.0

变更内容

文档

更新 v1.11.0rc2 的变更日志与版本

贡献者

@greysonlalonde

v1.11.0rc2

变更内容

缺陷修复

增强 LLM 响应处理与序列化。
升级存在漏洞的传递依赖（authlib、PyJWT、snowflake-connector-python）。
在不安全模式的 pip install 中用 subprocess.run 替换 os.system。

文档

更新 Exa Search Tool 页面，改进命名、描述与配置选项。
在操作指南中添加自定义 MCP 服务器。
更新 OTEL 收集器文档。
更新 MCP 文档。
更新 v1.11.0rc1 的变更日志与版本。

贡献者

@10ishq, @greysonlalonde, @joaomdmoura, @lucasgomide, @mattatcha, @theCyberTech, @vinibrsl

v1.11.0rc1

变更内容

特性

在 a2a 中添加 Plus API token 身份认证
实现计划执行模式

缺陷修复

解决代码解释器沙箱逃逸问题

文档

更新 v1.10.2rc2 的变更日志和版本

贡献者

@Copilot, @greysonlalonde, @lorenzejay, @theCyberTech

v1.10.2rc2

变更内容

缺陷修复

从只读存储操作中移除独占锁

文档

更新 v1.10.2rc1 的变更日志和版本

贡献者

@greysonlalonde

v1.10.2rc1

变更内容

特性

添加发布命令并触发 PyPI 发布

缺陷修复

修复未受保护 I/O 的跨进程与线程安全锁定问题
在所有线程和执行器边界传播 contextvars
将 ContextVars 传播到异步任务线程

文档

更新 v1.10.2a1 的变更日志和版本

贡献者

@danglies007, @greysonlalonde

v1.10.2a1

变更内容

特性

为 Anthropics 添加工具搜索支持、节省 token，并在执行期间动态注入合适的工具。
引入更多 Brave Search 工具。
为夜间发布创建 action。

缺陷修复

修复并发多进程执行下的 LockException。
解决将并行工具结果分组到单个用户消息中的问题。
处理 MCP 工具解析问题，并消除所有共享的可变连接。
更新 human_feedback 函数中的 LLM 参数处理。
为 LockedListProxy 和 LockedDictProxy 添加缺失的 list/dict 方法。
将 contextvars 上下文传播到并行工具调用线程。
将 gitpython 依赖升级到 >=3.1.41，以解决 CVE 路径遍历漏洞。

重构

重构记忆类以使其可序列化。

文档

更新 v1.10.1 的变更日志和版本。

贡献者

@akaKuruma, @github-actions[bot], @giulio-leone, @greysonlalonde, @joaomdmoura, @jonathansampson, @lorenzejay, @lucasgomide, @mattatcha

v1.10.1

变更内容

特性

升级 Gemini GenAI

缺陷修复

调整执行器监听器值以避免递归
在 Gemini 中将并行函数响应部分分组到单个 Content 对象中
在 Gemini 中呈现思考模型的思考输出
当智能体工具为 None 时加载 MCP 和平台工具
支持 A2A 中具有运行中事件循环的 Jupyter 环境
为临时追踪使用匿名 ID
有条件地传递 plus header
在非主线程中跳过遥测的信号处理器注册
将工具错误作为观察结果注入，并解决名称冲突
将 pypdf 从 4.x 升级到 6.7.4，以解决 Dependabot 警报
解决 Dependabot 的严重和高危安全警报

文档

同步各语言区域的 Composio 工具文档

贡献者

@giulio-leone, @greysonlalonde, @haxzie, @joaomdmoura, @lorenzejay, @mattatcha, @mplachta, @nicoferdi96

v1.10.1a1

变更内容

特性

在步骤回调方法中实现异步调用支持
在 Memory 模块中实现重型依赖的延迟加载

文档

更新 v1.10.0 的变更日志和版本

重构

重构步骤回调方法以支持异步调用
重构以在 Memory 模块中实现重型依赖的延迟加载

缺陷修复

修复发布说明的分支

贡献者

@greysonlalonde, @joaomdmoura

v1.10.1a1

变更内容

重构

重构步骤回调方法以支持异步调用
在 Memory 模块中实现重型依赖的延迟加载

文档

更新 v1.10.0 的变更日志和版本

缺陷修复

为发布说明创建分支

贡献者

@greysonlalonde, @joaomdmoura

v1.10.0

变更内容

特性

增强 MCP 工具解析及相关事件
更新 lancedb 版本并添加 lance-namespace 包
增强 CrewAgentExecutor 和 BaseTool 中的 JSON 参数解析与校验
将 CLI HTTP 客户端从 requests 迁移到 httpx
添加带版本的文档
为版本说明添加 yanked 检测
在 Flows 中实现用户输入处理
增强人工反馈集成测试中的 HITL 自循环功能
添加 started_event_id 并在 eventbus 中设置
自动更新 tools.specs

缺陷修复

即使为空也校验工具 kwargs，以防止晦涩的 TypeError
为 LLM 保留工具参数 schema 中的 null 类型
将 output_pydantic/output_json 映射到原生结构化输出
确保在返回 promise 时运行/等待回调
在异常上下文中捕获方法名
在路由结果中保留 enum 类型；改进类型
修复在输入中传入持久化 ID 时循环流程静默中断的问题
将 CLI 标志格式从 --skip-provider 更正为 --skip_provider
确保 OpenAI 工具调用流最终完成
解决 MCP 工具中复杂的 schema $ref 指针
在 schema 中强制 additionalProperties=false
拒绝团队文件夹的保留脚本名称
解决护栏事件发出测试中的竞态条件

文档

为非原生 LLM 服务商添加 litellm 依赖说明
阐明 NL2SQL 安全模型和加固指南
在 9 个集成中添加 96 个缺失的 action

重构

将 crew 重构为 provider
将 HITL 提取为 provider 模式
改进 hook 类型和注册

贡献者

@dependabot[bot], @github-actions[bot], @github-code-quality[bot], @greysonlalonde, @heitorado, @hobostay, @joaomdmoura, @johnvan7, @jonathansampson, @lorenzejay, @lucasgomide, @mattatcha, @mplachta, @nicoferdi96, @theCyberTech, @thiagomoretto, @vinibrsl

v1.9.0

变更内容

特性

为各服务商添加结构化输出和 response_format 支持
为流式响应添加响应 ID
添加具有父子层级的事件排序
添加 Keycloak SSO 身份认证支持
添加多模态文件处理能力
添加原生 OpenAI responses API 支持
添加 A2A 任务执行实用工具
添加 A2A 服务器配置和智能体卡片生成
增强事件系统并扩展传输选项
改进工具调用机制

缺陷修复

当 aiocache 不可用时，使用回退内存缓存增强文件存储
确保文档列表不为空
正确处理 Bedrock 停止序列
添加 Google Vertex API 密钥支持
增强 Azure 模型停止词检测
改进流程执行中 HumanFeedbackPending 的错误处理
修复执行 span 任务解除链接的问题

文档

添加原生文件处理文档
添加 OpenAI responses API 文档
添加智能体卡片实现指南
完善 A2A 文档
更新 v1.8.0 的变更日志

贡献者

@Anaisdg, @GininDenis, @Vidit-Ostwal, @greysonlalonde, @heitorado, @joaomdmoura, @koushiv777, @lorenzejay, @nicoferdi96, @vinibrsl

v1.8.1

变更内容

特性

添加 A2A 任务执行实用工具
添加 A2A 服务器配置和智能体卡片生成
添加更多传输机制
添加 Galileo 集成支持

缺陷修复

改进 Azure 模型兼容性
扩大帧检查深度以检测 parent_flow
解决任务执行 span 管理问题
增强流程执行期间人工反馈场景的错误处理

文档

添加 A2A 智能体卡片文档
添加 PII 脱敏功能文档

贡献者

@Anaisdg, @GininDenis, @greysonlalonde, @joaomdmoura, @koushiv777, @lorenzejay, @vinibrsl

v1.8.0

变更内容

特性

为 a2a 添加原生异步链
添加带处理器和配置的 a2a 更新机制（poll/stream/push）
为人在回路反馈引入全局流程配置
添加流式工具调用事件并修复服务商 ID 跟踪
引入生产就绪的 Flows 和 Crews 架构
为 Flows 添加 HITL
改进 EventListener 和 TraceCollectionListener 以增强事件处理

缺陷修复

将缺失的 a2a 依赖作为可选依赖处理
修正 WorkOS 登录轮询的错误获取
修复示例文档中错误的触发器名称

文档

更新 webhook-streaming 文档
调整 AOP 到 AMP 文档的表述

贡献者

@Vidit-Ostwal, @greysonlalonde, @heitorado, @joaomdmoura, @lorenzejay, @lucasgomide, @mplachta

v1.7.2

变更内容

缺陷修复

解决连接问题

文档

更新 api-reference/status 文档页面

贡献者

@greysonlalonde, @heitorado, @lorenzejay, @lucasgomide

v1.7.1

变更内容

改进

为 bump 命令添加 --no-commit 标志
使用 JSON schema 进行工具参数序列化

缺陷修复

修复工具仓库登录失败时从响应中显示错误消息的问题
修复异步执行任务时 future 的优雅终止
通过添加索引修复任务排序
修复 Windows 信号的平台兼容性检查
修复 RPM 控制器定时器以防止进程挂起
修复 token 使用量记录，并在流中校验响应模型

文档

添加 async 的翻译文档
添加 AOP Deploy API 文档
添加智能体处理器连接器文档
添加原生 async 文档

贡献者

@Llamrei, @dragosmc, @gilfeig, @greysonlalonde, @heitorado, @lorenzejay, @mattatcha, @vinibrsl

v1.7.0

变更内容

特性

添加异步流程 kickoff
添加异步团队支持
添加异步任务支持
添加异步知识支持
添加异步记忆支持
为工具和智能体执行器添加异步支持；改进类型和文档
实现 a2a 扩展 API 和异步智能体卡片缓存；修复任务传播和流式传输
添加原生异步工具支持
添加异步 LLM 支持
创建 sys 事件类型和处理器

缺陷修复

修复确保 nonetypes 不会传递给 otel 的问题
修复 token 存储文件操作中的死锁
修复以确保 otel span 已关闭
使用 HuggingFaceEmbeddingFunction 进行嵌入，更新键并添加测试
修复以确保 supports_tools 对所有支持的 Anthropic 模型为 true
确保 hooks 可与轻量智能体流程配合工作

贡献者

@greysonlalonde, @lorenzejay

v1.6.1

变更内容

缺陷修复

修复 ChatCompletionsClient 调用以确保功能正常
确保异步方法可用于注解
修复 RagTool.add 中的参数，添加类型和测试
从 SSE 客户端移除无效参数
在 'crewai config reset' 命令中删除 'oauth2_extra' 设置

重构

增强 LLM 类中的模型校验和服务商推断

贡献者

@Vidit-Ostwal, @greysonlalonde, @heitorado, @lorenzejay

v1.6.0

变更内容

特性

为流程和团队添加流式结果支持
添加 gemini-3-pro-preview
支持使用 Entra ID 进行 CLI 登录
添加 Merge Agent Handler 工具
增强流程事件状态管理

缺陷修复

确保传入时已设置自定义 RAG 存储持久化路径
确保模糊返回结果更严格，并显示类型警告
重新添加 openai response_format 参数并添加测试
修复 RAG 工具嵌入配置
确保图表上不显示流程执行启动面板

文档

在文档中将 AMP 的引用更新为 AOP
将 AMP 更新为 AOP

贡献者

@Vidit-Ostwal, @gilfeig, @greysonlalonde, @heitorado, @joaomdmoura, @lorenzejay, @markmcd

v0.203.2

变更内容

热修复版本从 0.203.1 升级到 0.203.2

v1.5.0

变更内容

特性

添加 a2a 信任远程完成状态标志
获取并存储更多关于 Okta 授权服务器的数据
在 CrewAgentExecutor 中实现 LLM 调用前后钩子
将消息暴露给 TaskOutput 和 LiteAgentOutputs
增强 QdrantVectorSearchTool 的 schema 描述

缺陷修复

确保追踪插桩标志被正确应用
修复自定义工具文档链接，并添加 Mintlify 失效链接操作

文档

增强任务护栏文档，加入基于 LLM 的校验支持

贡献者

@danielfsbarreto, @greysonlalonde, @heitorado, @lorenzejay, @theCyberTech

v1.4.1

变更内容

缺陷修复

修复智能体最大迭代次数的处理
解决 LLM 模型语法到相应服务商的路由问题

贡献者

@greysonlalonde

v1.4.0

变更内容

特性

添加对非 AST 绘图路由的支持
实现对 MCP 的一等支持
为 BaseInterceptor 添加 Pydantic 校验双下划线方法
添加对 LLM 消息拦截器钩子的支持
缓存 i18n 提示词以提高使用效率
增强 QdrantVectorSearchTool

缺陷修复

修复保持停用词更新的问题
解决流程状态中不可 pickle 的值
确保 lite 智能体在校验错误时纠正方向
修复回调参数哈希以确保缓存正常工作
允许从有效 URL 添加 RAG 源内容
使绘图节点选择更流畅
修复知识文档 ID 重复的问题

重构

通过并发 futures 改进 MCP 工具执行处理
简化流程处理、类型标注和日志记录；更新 UI 和测试
将停用词管理重构为属性

文档

将 embedder 迁移为 embedding_model，并在工具文档中要求 vectordb；添加服务商示例（en/ko/pt-BR）

贡献者

@danielfsbarreto, @greysonlalonde, @lorenzejay, @lucasgomide, @tonykipkemboi

v1.3.0

变更内容

特性

重构流程处理、类型标注和日志记录
增强 QdrantVectorSearchTool

缺陷修复

修复 Firecrawl 工具并添加测试
将 use_stop_words 重构为属性，并添加停用词检查

文档

将 embedder 迁移为 embedding_model，并在工具文档中要求 vectordb
添加英语、韩语和葡萄牙语的服务商示例

重构

改进流程处理和 UI 更新

贡献者

@danielfsbarreto, @greysonlalonde, @lorenzejay, @lucasgomide, @tonykipkemboi

v1.2.1

变更内容

特性

添加对 Datadog 集成的支持
在 liteagent 中支持 apps 和 mcps

文档

描述为每个集成调用 Platform 工具时的必需环境变量
添加 Datadog 集成文档

贡献者

@barieom, @lorenzejay, @lucasgomide, @sabrenner

v1.2.0

变更内容

缺陷修复

更新默认 LLM 模型并改进 LLM 工具中的错误日志记录
更改流程可视化目录和方法检查

移除未使用项

移除 aisuite

贡献者

@greysonlalonde, @lorenzejay

v1.1.0

变更内容

特性

增强 InternalInstructor 以支持多个 LLM 服务商
实现 mypy 插件基类
改进 QdrantVectorSearchTool

缺陷修复

修正失效的集成文档链接
修复重复追踪调用并添加类型
将模板版本固定到最新版本

文档

更新 LLM 集成细节和示例

重构

改进 CrewBase 类型标注

贡献者

@cwarre33, @danielfsbarreto, @greysonlalonde, @lorenzejay

v1.0.0

变更内容

特性

将版本升级到 1.0.0
增强 Agent 类中的知识和护栏事件处理
在 crewai run 命令中注入工具仓库凭据

缺陷修复

在 Flow 装饰器中保留嵌套条件结构
为 Printer.print 方法添加标准打印参数
修复没有可用 input() 时的错误
解码 JWT 时增加 10 秒容差
回滚错误的 cron 计划
修正 cron 计划以在特定日期每 5 天运行一次
对 Docker 二进制文件使用系统 PATH，而不是硬编码路径
添加 CodeQL 配置以正确排除模板目录

文档

更新漏洞报告安全政策
添加在 CrewAI AMP 中捕获遥测日志的指南
添加缺失的 /resume 文件
澄清 HITL 工作流中的 webhook URL 参数

贡献者

@Vidit-Ostwal, @greysonlalonde, @heitorado, @joaomdmoura, @lorenzejay, @lucasgomide, @mplachta, @theCyberTech

v1.0.0b3（预发布）

变更内容

特性

增强任务护栏功能和校验
改进对导入原生 SDK 的支持
添加 Azure 原生测试
通过高级功能增强 BedrockCompletion 类
通过客户端参数支持增强 GeminiCompletion 类
通过额外的客户端参数增强 AnthropicCompletion 类

缺陷修复

在 Flow 装饰器中保留嵌套条件结构
为 Printer.print 方法添加标准打印参数
移除 stdout 打印并提高测试确定性

重构

将项目模块转换为具有完整类型标注的元类

贡献者

@greysonlalonde, @lorenzejay

v1.0.0b2（预发布）

变更内容

特性

通过额外的客户端参数增强 OpenAICompletion 类
改进事件总线线程安全性和异步支持
在 crewai run 命令中注入工具仓库凭据

缺陷修复

修复没有可用 input() 时会报错的问题
解码 JWT 时增加 10 秒容差
修复复制问题并在 task.py 中添加 NOT_SPECIFIED 检查

文档

确保文档中提及 CREWAI_PLATFORM_INTEGRATION_TOKEN
更新触发器文档

贡献者

@Vidit-Ostwal, @greysonlalonde, @heitorado, @joaomdmoura, @lorenzejay, @lucasgomide

v1.0.0b1（预发布）

变更内容

特性

通过额外的客户端参数增强 OpenAICompletion 类
改进事件总线线程安全性和异步支持
实现 Bedrock LLM 集成

缺陷修复

修复 input() 可用性缺失的问题
通过增加 10 秒容差解决 JWT 解码错误
在 crewai run 命令中注入工具仓库凭据
修复复制问题并在 task.py 中添加 NOT_SPECIFIED 检查

文档

确保文档中提及 CREWAI_PLATFORM_INTEGRATION_TOKEN
更新触发器文档

贡献者

@Vidit-Ostwal, @greysonlalonde, @heitorado, @joaomdmoura, @lorenzejay, @lucasgomide

v0.203.1

变更内容

核心改进与修复

修复了将工具仓库凭据注入 crewai run 命令的问题
解码 JWT 时增加 10 秒容差，以减少 token 校验错误
修正了（随后回滚了）旨在特定日期每 5 天运行任务的 cron 计划修复

文档与指南

更新安全政策，以明确漏洞报告流程

v1.0.0a4（预发布）

变更内容

特性

增强 Agent 类中的知识和护栏事件处理
为本地开发引入触发器列表和执行命令
更新文档，介绍使用 Platform Actions 的新方式
添加在 CrewAI AMP 中捕获遥测日志的指南

缺陷修复

回滚错误的 cron 计划
修正 cron 计划以在特定日期每 5 天运行一次
移除重复行并添加显式环境变量
解决整个代码库中的 lint 错误
在智能体和记忆处理中用 logger 替换 print 语句
对 Docker 二进制文件使用系统 PATH，而不是硬编码路径
允许 PyPI 发布失败
匹配标签和发布标题，在 PyPI 中忽略 devtools 构建

文档

更新漏洞报告安全政策
添加缺失的 /resume 文件
澄清 HITL 工作流中的 webhook URL 参数

贡献者

@Vidit-Ostwal, @greysonlalonde, @lorenzejay, @lucasgomide, @theCyberTech

v1.0.0a1

变更内容

核心改进与修复

修复了智能体配置中 actions 的权限处理
更新 CI 工作流和发布流程，以支持新的 monorepo 结构
将 Python 支持升级到 3.13 并刷新工作区元数据

新功能与增强

为 Agent 添加 apps 和 actions 属性，以实现更丰富的运行时控制
将 crewai-tools 仓库合并到主工作区（monorepo）
将所有包升级到 1.0.0a1 以标记 alpha 里程碑

清理与基础设施

交付了具有版本固定和发布策略的新 CI 流水线
统一内部代码以一致地管理多个包

v0.201.1

变更内容

核心改进与修复

将 Watson 嵌入服务商重命名为 watsonx，并刷新环境变量前缀
为 watsonx 和 voyageai 嵌入服务商添加 ChromaDB 兼容性

清理与弃用

标准化所有嵌入服务商的环境变量前缀
将 CrewAI 升级到 0.201.1 并更新内部依赖

v0.201.0

变更内容

核心改进与修复

将 _create_reasoning_plan 中的 ready 参数设为可选
修复嵌入器配置的嵌套配置处理
添加 batch_size 支持以避免 token 限制错误
修正 Quickstart 文档目录命名
解决测试持续时间缓存问题和事件导出问题
为团队设置添加回退逻辑

新功能与增强

引入线程安全的平台上下文管理
添加 crewai uv 包装命令，以便从 CLI 运行 uv
支持为可观测性工作流将追踪标记为失败
添加自定义嵌入类型和服务商迁移支持
将 ChromaDB 升级到 v1.1.0，包含兼容性修复和类型改进
添加 Pydantic 兼容的导入校验，并重新组织依赖组

文档与指南

更新变更日志覆盖范围，以包含近期发布（0.193.x 系列）
编写文档说明 LLM 护栏事件的元数据支持
添加关于回退行为和配置可见性的指南

清理与弃用

解决各模块中的 Ruff 和 MyPy 问题
改进类型标注并整合工具函数
弃用旧版工具，改用 Pydantic 兼容的导入

贡献者

@qizwiz（首次贡献）

v0.193.2

变更内容

更新 pyproject 模板以使用正确的版本

v0.193.1

变更内容

一系列小修复和 linter 改进

v0.193.0

核心改进与修复

修复了 OpenAI 适配器初始化期间 model 参数的处理问题
解决了 CI 工作流中的测试时长缓存问题
修复了与智能体重复使用工具相关的偶发测试失败
在 __init__.py 中补上了缺失的事件导出，保证模块行为一致
从 Mem0 的元数据中移除了消息存储，以减少冗余膨胀
修复了向量搜索中为保持向后兼容而提供的 L2 距离度量支持

新功能与增强

引入了线程安全的平台上下文管理
新增测试时长缓存，以优化 pytest-split 的运行
新增临时追踪改进，实现更好的追踪控制
使 RAG、知识和记忆的搜索参数完全可配置
使 ChromaDB 能够使用 OpenAI API 作为嵌入函数
新增更深入的观测工具，提供用户级洞察
统一了 RAG 存储系统，并支持实例级客户端

文档与指南

更新了 RagTool 相关引用，以反映 CrewAI 原生 RAG 实现
完善了 langgraph 和 openai 智能体适配器的内部文档，补充了类型注解和文档字符串

v0.186.1

变更内容

修复了找不到版本并导致版本回退静默失败的问题
将 CrewAI 版本升级至 0.186.1，并更新了 CLI 中的依赖

v0.186.0

变更内容

详细变更请参阅 GitHub 发布说明

v0.177.0

核心改进与修复

实现了 rag 包与当前实现之间的一致性
增强了 LLM 事件处理，加入任务和智能体元数据
修复了可变默认参数问题，将其替换为 None
在初始化期间抑制了 Pydantic 弃用警告
修复了 README.md 中失效的示例链接
移除了仅适用于 Python 3.12+ 的 Ruff 规则以保持兼容性
将 CI 工作流迁移为使用 uv，并更新了开发工具

新功能与增强

新增追踪改进与清理
通过将 events 模块移至 crewai.events，集中了事件逻辑

文档与指南

更新了 Enterprise Action Auth Token 章节文档
发布了 v0.175.0 版本的文档更新

清理与重构

将解析器重构为模块化函数，改善结构

v0.175.0

核心改进与修复

修复了 crewai update 期间 tool 章节的迁移问题
回退了 OpenAI 版本锁定：由于导入问题已修复，现在要求 openai >=1.13.3
修复了偶发测试失败，并提升了测试稳定性
改进了 Flow 监听器在人在回路和循环流程中的可恢复性
增强了 PlusAPI 和 TraceBatchManager 中的超时处理
对实体记忆条目进行批处理，以减少冗余操作

新功能与增强

新增对 Flow.start() 方法中额外参数的支持
在详细 CLI 输出中显示任务名称
新增集中式嵌入类型，并引入了基础嵌入客户端
为 ChromaDB 和 Qdrant 引入了通用客户端
新增 crewai config reset 支持，用于清除 token
启用了 crewai_trigger_payload 自动注入
简化了 RAG 客户端初始化，并引入了 RAG 配置系统
新增 Qdrant RAG 服务商支持
改进了追踪，提供更好的事件数据
新增在 crewai login 时移除 Auth0 和邮箱输入的支持

文档与指南

新增自动化触发器文档
修复了 API Reference 的 OpenAPI 来源和重定向
在文档中新增了混合搜索 alpha 参数

清理与弃用

为 Task.max_retries 添加了弃用通知
从登录流程中移除了 Auth0 依赖

v0.165.1

核心改进与修复

修复了 XMLSearchTool 的兼容性问题，将配置值转换为字符串以适配 configparser
修复了涉及 PytestUnraisableExceptionWarning 的偶发测试失败
在测试套件中模拟了遥测，使 CI 运行更稳定
将 Chroma 锁文件处理移至 db_storage_path
忽略了来自 chromadb 的弃用警告
由于 ResponseTextConfigParam 导入问题，将 OpenAI 版本锁定为 <1.100.0

新功能与增强

将交互的智能体消息纳入 ExternalMemory 元数据
自动注入 crewai_trigger_payload
将内部标志 inject_trigger_input 重命名为 allow_crewai_trigger_context
持续改进追踪及临时追踪逻辑
合并了追踪逻辑的条件判断
新增对 Mem0 中与 agent_id 关联的记忆条目的支持

文档与指南

在 Tool Repository 文档中新增了示例
更新了 Mem0 文档，涵盖短期记忆和实体记忆集成
修订了韩语翻译并改进了句式结构

清理与杂项

移除了已弃用的 AgentOps 集成

v0.165.0

核心改进与修复

修复了 XMLSearchTool 的兼容性问题，将配置值转换为字符串以适配 configparser
修复了涉及 PytestUnraisableExceptionWarning 的偶发测试失败
在测试套件中模拟了遥测，使 CI 运行更稳定
将 Chroma 锁文件处理移至 db_storage_path
忽略了来自 chromadb 的弃用警告
由于 ResponseTextConfigParam 导入问题，将 OpenAI 版本锁定为 <1.100.0

新功能与增强

将交互的智能体消息纳入 ExternalMemory 元数据
自动注入 crewai_trigger_payload
将内部标志 inject_trigger_input 重命名为 allow_crewai_trigger_context
持续改进追踪及临时追踪逻辑
合并了追踪逻辑的条件判断
新增对 Mem0 中与 agent_id 关联的记忆条目的支持

文档与指南

在 Tool Repository 文档中新增了示例
更新了 Mem0 文档，涵盖短期记忆和实体记忆集成
修订了韩语翻译并改进了句式结构

清理与杂项

移除了已弃用的 AgentOps 集成

v0.159.0

核心改进与修复

改进了 LLM 消息格式化性能，提升了运行时效率
修复了企业版配置认证/参数中使用错误端点的问题
注释掉了监听器可恢复性检查，以保证部分流程恢复期间的稳定性

新功能与增强

在 CLI 中新增 enterprise configure 命令，简化企业版配置
引入了部分流程可恢复性支持

文档与指南

新增了新工具的文档
新增了韩语翻译
更新了文档，补充 TrueFoundry 集成详情
新增了 RBAC 文档并做了整体清理
修复了 API 参考，并改版了英语、葡萄牙语（巴西）和韩语的示例/食谱

v0.157.0

v0.157.0 变更内容

核心改进与修复

为长输入工具启用了自动换行
允许使用 BaseModel 条目持久化 Flow 状态
使用 partition() 优化字符串操作以提升性能
移除了对已弃用的 User Memory 系统的支持
将 LiteLLM 版本升级至 1.74.9
修复了 CLI 在导入时更清晰地显示缺失模块的问题
支持使用 Okta 进行设备授权

新功能与增强

新增了带测试的 crewai config CLI 命令组
新增了对 crew.name 默认值的支持
引入了初始追踪能力
新增了对 LangDB 集成的支持
新增了对 CLI 配置文档的支持

文档与指南

更新了 MCP 文档，补充 connect_timeout 属性
新增了 LangDB 集成文档
新增了 CLI 配置文档
整体功能文档更新与清理

v0.152.0

核心改进与修复

移除了 crewai signup 相关引用，替换为 crewai login
修复了使用 agent_id 向 Mem0 添加记忆的支持问题
更改了 Mem0 配置中的默认值
更新了导入错误提示，以清晰显示缺失的模块文件
为事件时间戳添加了时区支持

新功能与增强

增强了 Flow 类以支持自定义流程名称
将 RAG 组件重构为独立的顶层模块

文档与指南

修复了 Google Vertex AI 文档中错误的模型命名

v0.150.0

核心改进与修复

在 Chroma 客户端初始化期间使用了文件锁
移除了与不支持 FTS5 的 SQLite 相关的变通方案
自动移除 LLM 模型不支持的 stop 参数
修复了 save 方法并更新了相关测试用例
修复了 Ollama 模型在最后一条消息来自 assistant 时的消息处理问题
移除了 LLM 调用出错时的重复打印
为 UserMemory 添加了弃用通知
将 LiteLLM 升级至 1.74.3 版本

新功能与增强

新增了通过内部 LLM 类进行临时工具调用的支持
将 Mem0 存储从 v1.1 更新至 v2

文档与指南

修复了 neatlogs 文档
在 Search-Research 套件中新增了 Tavily Search 和 Extractor 工具
新增了 SerperScrapeWebsiteTool 文档，并重新组织了 Serper 章节
整体文档更新与改进

crewai-tools v0.58.0

新工具 / 增强

SerperScrapeWebsiteTool：新增了从 URL 提取干净内容的工具
Bedrock AgentCore：为 Bedrock 智能体集成了浏览器和代码解释器工具包
Stagehand 更新：重构并更新了 Stagehand 集成

修复与清理

FTS5 支持：在测试工作流中启用了 SQLite FTS5，以改进文本搜索
测试加速：并行化了 GitHub Actions 测试套件，加快 CI 运行
清理：由于 FTS5 支持已可用，移除了 SQLite 变通方案 MongoDBVectorSearchTool：修复了序列化和 schema 处理

v0.148.0

核心改进与修复

使用了生产环境的 WorkOS 环境 ID
在测试工作流中新增了 SQLite FTS5 支持
修复了智能体知识处理问题
改用 BaseLLM 类进行比较，而非 LLM
修复了 Task 类中缺失 create_directory 参数的问题

新功能与增强

引入了智能体评估功能
新增了 Evaluator 实验和回归测试方法
实现了线程安全的 AgentEvaluator
为智能体评估启用了事件发射
支持对单个 Agent 和 LiteAgent 进行评估
新增了与 neatlogs 的集成
为 LLM 护栏事件新增了团队上下文追踪

文档与指南

新增了 guardrail 属性及用法示例文档
新增了 neatlogs 集成指南
更新了智能体仓库和 Agent.kickoff 用法的文档

v0.141.0

核心改进与修复

通过并行化加快了 GitHub Actions 测试

新功能与增强

为 LLM 护栏事件新增了团队上下文追踪

文档与指南

新增 Agent 仓库使用文档
新增 Agent.kickoff 方法文档

v0.140.0

核心改进与修复

修复测试提示词中的拼写错误
修复项目名称规范化问题：创建团队时去除末尾斜杠
确保环境变量以大写形式写入
更新 LiteLLM 依赖
重构 RAGStorage 中的集合处理
实现 PEP 621 动态版本管理

新功能与增强

新增按任务和智能体追踪 LLM 调用的能力
引入 MemoryEvents 以监控记忆使用情况
为记忆系统和 LLM 护栏事件新增控制台日志
改进对最高 7B 参数模型的数据训练支持
新增 Scarf 和 Reo.dev 分析追踪
CLI workos 登录

文档与指南

更新 CLI LLM 文档
在文档中新增 Nebius 集成
修正安装文档和 pt-BR 文档中的拼写错误
新增关于 MemoryEvents 的文档
实现文档重定向并纳入开发工具

v0.134.0

核心改进与修复

修复 tools 参数语法
修复 Task 中的类型注解
修复从 GitHub 获取 LLM 数据时的 SSL 错误
确保兼容 Pydantic 2.7.x
从项目依赖中移除 mkdocs
将 Langfuse 代码示例升级为使用 Python SDK v3
在 mem0 存储中新增角色清理功能
改进记忆重置期间的 Crew 搜索
改进控制台打印输出

新功能与增强

新增从已定义的 Tool 属性初始化工具的支持
新增在 CrewBase 中使用 MCP 工具的官方方式
增强 MCP 工具支持，允许在 CrewBase 中为每个智能体选择多个工具
新增 Oxylabs 网页抓取工具

文档与指南

更新 quickstart.mdx
新增关于 LLMGuardrail 事件的文档
更新文档，补充全面的服务集成细节
更新 MCP 和企业版工具的建议筛选条件
更新 Maxim 可观测性文档
新增 pt-BR 文档翻译
整体文档改进

v0.130.0

核心改进与修复

移除与工具结果输出相关的重复消息
修复 kickoff 中 usage_metrics 缺少 manager_agent token 统计的问题
修复遥测单例，使其遵循动态环境变量
修复 Flow 状态日志可能掩盖人工输入的问题
增大 flow 绘图的默认 X 轴间距

新功能与增强

在 CLI 中新增多组织操作支持
启用异步工具执行，打造更高效的工作流
引入集成了护栏的 LiteAgent
升级 LiteLLM 以支持最新 OpenAI 版本

文档与指南

记录工具仓库所需的最低 UV 版本
改进幻觉护栏的示例
更新关于 LLM 用法的规划文档
新增 Agent 可观测性中 Maxim 支持的文档
扩展集成文档，为企业版功能补充图片
修复持久化指南
更新 Python 版本支持，以支持 python 3.13.x

v0.126.0

变更内容

核心改进与修复

新增对 Python 3.13 的支持
修复智能体知识来源问题
持久化工具仓库中可用的工具
支持通过各自模块从 Agent 仓库加载工具
记录工具被 LLM 调用时的使用情况

新功能与增强

在 MCP 集成中新增 streamable-http 传输支持
新增社区分析支持
扩展 OpenAI 兼容章节，补充 Gemini 示例
为提示词和记忆系统引入透明化功能
工具发布方面的小幅增强

文档与指南

大幅重构文档，提升导航体验
扩展 MCP 集成文档
更新记忆文档和 README 视觉素材
修复异步 kickoff 示例中缺失的 await 关键字
更新 Portkey 和 Azure 嵌入文档
在 LLM 指南中新增企业版测试图片
README 的常规更新

v0.121.1

缺陷修复与文档改进

v0.121.0

变更内容

核心改进与修复

修复创建工具时的编码错误
修复失败的 llama 测试
更新日志配置以保持一致性
增强遥测初始化与事件处理

新功能与增强

为 Task 类新增 markdown 属性
为 Agent 类新增 reasoning 属性
为 Agent 新增 inject_date 标志，用于自动注入日期
实现 HallucinationGuardrail（空实现，含测试覆盖）

文档与指南

新增 StagehandTool 文档并改进 MDX 结构
新增 MCP 集成文档并更新企业版文档
记录知识事件并更新推理文档
新增 stop 参数文档
修复文档示例中的导入引用（before_kickoff、after_kickoff）
整体文档更新与重构，提升清晰度

v0.120.1

新增内容

修复带连字符的插值问题

v0.120.0

核心改进与修复

• 默认启用完整的 Ruff 规则集，以实现更严格的 lint 检查 • 使用上下文管理器解决 FilteredStream 中的竞态条件 • 修复智能体知识重置问题 • 将智能体获取逻辑重构到实用模块中

新功能与增强

• 新增直接从仓库加载 Agent 的支持 • 支持为 Task 设置空上下文 • 增强 Agent 仓库反馈并修复 Tool 自动导入行为 • 引入知识直接初始化（绕过 knowledge_sources）

文档与指南

• 根据当前安全实践更新 security.md • 整理 Google 配置章节以提升清晰度 • 在输入 Gemini 密钥时新增指向 AI Studio 的链接 • 更新 Arize Phoenix 可观测性指南 • 刷新 flow 文档

v0.119.0

变更内容

核心改进与修复

通过增强 pytest 对不稳定测试的处理来提升测试可靠性
修复嵌入维度不匹配时记忆重置崩溃的问题
为 Crew 和 LiteAgent 启用父 flow 识别
防止遥测不可用时引发的相关崩溃
升级 LiteLLM 版本以获得更好的兼容性
通过移除 skip_external_api 修复 llama 转换器测试

新功能与增强

在 Agent 中引入知识检索提示词重写，以改进追踪和调试
使 LLM 设置和快速开始指南与模型无关

文档与指南

新增 RAG 工具的高级配置文档
更新 Windows 故障排查指南
优化文档示例以提升清晰度
修复文档和配置文件中的拼写错误

v0.118.0

核心改进与修复

修复提示词模板或系统模板缺失的问题。
移除全局日志配置，避免意外的覆盖。
将 TaskGuardrail 重命名为 LLMGuardrail，以提升清晰度。
将 litellm 降级至 1.167.1 版本以保证兼容性。
补充缺失的 init.py 文件，确保模块正确初始化。

新功能与增强

新增无代码创建护栏的支持，简化 AI 行为控制。

文档与指南

从公开文档中移除 CrewStructuredTool，以反映其内部用途。
更新企业版文档和 YouTube 嵌入内容，改善上手体验。

v0.117.1

build: 升级 crewai-tools
将 liteLLM 升级至最新版本
修复 Mem0 OSS

v0.117.0

变更内容

新功能与增强

在 @tool 装饰器中新增 result_as_answer 参数支持。
引入对新语言模型的支持：GPT-4.1、Gemini-2.0 和 Gemini-2.5 Pro。
增强知识管理能力。
在 CLI 中新增 Huggingface 服务商选项。
改进对 Python 3.10+ 的兼容性与 CI 支持。

核心改进与修复

修复模板参数不正确和输入缺失的问题。
通过协程条件检查改进异步 flow 处理。
通过隔离配置和正确的记忆对象复制增强记忆管理。
修复 lite 智能体初始化时引用不正确的问题。
解决 Python 类型提示问题并移除冗余导入。
更新事件位置，改善工具使用追踪。
在 flow 失败时抛出明确的异常。
从各模块中移除未使用的代码和冗余注释。
将 GitHub App token action 更新至 v2。

文档与指南

增强文档结构，包括企业版部署说明。
自动创建用于文档生成的输出文件夹。
修复 WeaviateVectorSearchTool 文档中的失效链接。
修复护栏文档用法以及 JSON 搜索工具的导入路径。
更新 CodeInterpreterTool 的文档。
改进文档页面的 SEO、上下文导航和错误处理。

v0.114.0

变更内容

新功能与增强

智能体作为原子单元。（Agent(...).kickoff()）
支持自定义 LLM 实现。
集成外部记忆和 Opik 可观测性。
增强 YAML 提取。
多模态智能体验证。
为智能体和团队新增安全指纹。

核心改进与修复

改进序列化、智能体复制和 Python 兼容性。
为 emit() 新增通配符支持
新增对额外路由调用和上下文窗口调整的支持。
修复类型问题、校验和 import 语句。
改进方法性能。
增强智能体任务处理、事件发射和记忆管理。
修复 CLI 问题、条件任务、克隆行为和工具输出。

文档与指南

改进文档结构、主题和组织方式。
新增本地 NVIDIA NIM（配合 WSL2）、W&B Weave 和 Arize Phoenix 的指南。
更新工具配置示例、提示词和可观测性文档。
关于在 Flow 中使用单个智能体的指南

v0.108.0

功能

在 PR #2190 中将 crew.py 模板中的制表符转换为空格
在 PR #2266 中增强 LLM 流式响应处理和事件系统
在 PR #2310 中加入 model_name
在 PR #2321 中增强事件监听器，提供丰富的可视化并改进日志记录
在 PR #2332 中新增指纹

缺陷修复

在 PR #2308 中修复 Mistral 问题
在 PR #2370 中修复文档中的一处缺陷
在 PR #2369 中修复 fingerprint 属性的类型检查错误

文档更新

在 PR #2259 中改进工具文档
在 PR #2196 中更新 uv 工具包的安装指南
在 PR #2363 中补充使用 uv 工具升级 crewAI 的说明
在 PR #2254 中新增 ApifyActorsTool 文档

v0.105.0

核心改进与修复

修复了模板变量缺失和用户记忆配置的问题。
改进了异步流程支持，并处理了智能体响应格式问题。
增强了记忆重置功能，并修复了 CLI 记忆命令。
修复了类型问题、工具调用属性和遥测解耦问题。

新功能与增强

新增流程状态导出，并改进了状态工具。
增强了智能体知识设置，支持可选的团队嵌入器。
引入了事件发射器，以提升可观测性和 LLM 调用追踪能力。
新增对 Python 3.10 以及来自 langchain_ollama 的 ChatOllama 的支持。
集成了对 o3-mini 模型的上下文窗口大小支持。
新增对多次路由调用的支持。

文档与指南

改进了文档布局和层级结构。
新增 QdrantVectorSearchTool 指南，并阐明了事件监听器的用法。
修复了提示词中的拼写错误，并更新了 Amazon Bedrock 模型列表。

v0.102.0

核心改进与修复

增强 LLM 支持：改进了 Anthropic 模型的结构化 LLM 输出、参数处理和格式化。
团队与智能体稳定性：修复了使用知识源克隆智能体/团队、条件任务中多个任务输出以及团队任务回调被忽略的问题。
记忆与存储修复：修复了 Bedrock 的短期记忆处理问题，确保嵌入器正确初始化，并在团队类中新增了重置记忆函数。
训练与执行可靠性：修复了训练损坏以及 dict 和 list 输入类型的插值问题。

新功能与增强

高级知识管理：改进了命名约定，并通过自定义嵌入器支持增强了嵌入配置。
扩展日志与可观测性：新增日志的 JSON 格式支持，并集成了 MLflow 追踪文档。
数据处理改进：更新了 excel_knowledge_source.py 以处理多工作表文件。
常规性能与代码库清理：简化了企业版代码对齐，并解决了 lint 问题。
新增工具 QdrantVectorSearchTool

文档与指南

更新 AI 与记忆文档：改进了 Bedrock、Google AI 和长期记忆文档。
任务与工作流说明更清晰：在任务属性中新增“人工输入”行、Langfuse 指南和 FileWriterTool 文档。
修复了各种拼写错误和格式问题。

维护与其他

针对当前年份优化了 Google Docs 集成和任务处理。

v0.100.0

功能：新增 Composio 文档
功能：将 SageMaker 添加为 LLM 服务商
修复：整体 LLM 连接问题
修复：在训练中使用安全访问器
修复：为 crew_chat.py 添加版本检查
文档：crewai chat 的新文档
文档：改进 CLI 和 Composio Tool 文档中的格式与清晰度

v0.98.0

功能：对话团队 v1
功能：为流程状态添加唯一 ID
功能：添加带有 FlowPersistence 接口的 @persist 装饰器
集成：添加 SambaNova 集成
集成：在 CLI 中添加 NVIDIA NIM 服务商
集成：引入 VoyageAI
杂项：将模板中的日期更新为当前年份
修复：修复 Mem0 集成中的 API Key 行为和实体处理
修复：修复核心 invoke 循环逻辑及相关测试
修复：使工具输入为实际对象而非字符串
修复：为创建工具补充重要的缺失部分
修复：降低 litellm 版本以预防 Windows 问题
修复：kickoff 前输入为 none 的情况
修复：拼写错误
修复：嵌套 Pydantic 模型问题
修复：Docling 问题
修复：union 问题
文档更新

v0.95.0

功能：为团队添加多模态能力
功能：程序化护栏
功能：人在回路多轮
功能：支持 Gemini 2.0
功能：CrewAI 流程改进
功能：新增工作流权限
功能：新增对 langfuse 与 litellm 的支持
功能：Portkey 与 CrewAI 集成
功能：新增 interpolate_only 方法并改进错误处理
功能：支持 Docling
功能：支持 Weviate
修复：output_file 未遵循系统路径
修复重置短期记忆时的磁盘 I/O 错误。
修复：CrewJSONEncoder 现在接受枚举
修复：Python 最高版本限制
修复：任务中 output_file 的插值
修复：正确处理同事角色名称的大小写/空白
修复：将 tiktoken 添加为显式依赖并记录 Rust 要求
修复：在规划流程中包含智能体知识
修复：将 KnowledgeStorage 的存储初始化改为 None
修复：修复可选存储检查
修复：在流程中包含事件发射器
修复：文档字符串、错误处理和类型提示改进
修复：抑制由 litellm Pydantic 问题引发的 userWarnings

v0.86.0

移除所有对 pipeline 和 pipeline router 的引用
文档：在自定义 LLM 中将 Nvidia NIM 添加为服务商
新增知识演示 + 改进知识文档
Brandon/cre 509 人在回路多轮跟进
关于使用装饰器的 YAML 团队的新文档。简化团队模板

v0.85.0

将知识添加到智能体级别
功能/移除 langchain
改进类型化任务输出
在 crewai login 时登录工具仓库
修复将结果作为答案时未正确退出 LLM 循环的问题
修复：使用 Ollama 服务商运行时缺少 key 名称
修复发现的拼写问题
更新运行 mypy 的 readme
将知识添加到 mint.json
更新 GitHub Actions
文档：更新智能体文档，加入两种创建智能体的方法
文档改进：LLM 配置与用法

v0.83.0

新增 before_kickoff 和 after_kickoff 团队回调
支持用知识预填充智能体
新增使用 Mem0 检索用户偏好和记忆的支持
修复异步执行
升级 chroma 并调整嵌入器函数生成器
更新 CLI 中 Watson 支持的模型 + 文档
降低 Bandit 级别
修复所有测试
更新文档

v0.80.0

修复 token 回调替换缺陷
修复步骤回调问题
在使用指标中添加缓存的提示词 token 信息
修复 crew_train_success 测试

v0.79.4

一系列围绕 LLM 支持的小型缺陷修复

v0.79.0

为流程添加输入
增强日志存储以支持更多数据类型
新增对 IBM 记忆的支持
在 CLI 中添加 Watson 选项
新增 security.md 文件
用 uv 环境变量替换 .netrc
将 BaseTool 移至主包并集中工具描述生成
当 LLM 未返回响应时抛出错误
修复流程以支持循环，并在测试中添加
更新团队的命名方式并修复缺失配置
更新文档

v0.76.9

将流程的 plot 命令更新为 crewai flow plot
添加 tomli，以便支持 Python 3.10
将安装命令选项转发到 uv sync
改进工具文本描述和参数
改进工具和流程文档
更新流程 CLI，使你能够通过 crewai flow add-crew 轻松向流程添加额外团队
修复使用多个 start 和 listen(and_(..., ..., ...)) 时的流程缺陷

v0.76.2

更新 crewai create 命令

v0.76.0

修复/已修复缺失的 API 提示词 + CLI 文档更新
杂项(readme)：修复贡献中“运行测试”的步骤
支持不安全代码执行。添加 Docker 安装和运行检查
修复嵌入函数的记忆导入 by

v0.75.1

在 crewai crewat 上新增 --provider 选项

v0.75.0

修复训练后测试
简化流程
适配 crewai tool install <tool>
确保原始嵌入配置可用
修复缺陷
更新文档——包括将 Cerebras LLM 示例配置添加到 LLM 文档
移除不必要的测试

v0.74.2

功能：将 poetry.lock 添加到 uv 迁移中
修复工具调用问题

v0.74.0

UV 迁移
使工具 CLI 适配 UV
添加从 Poetry 到 UV 的警告
CLI 支持模型选择和提交 API 密钥
新增记忆基类
修复 lint 和警告
更新文档
缺陷修复

v0.70.1

新流程功能
流程可视化器
创建 crewai create flow 命令
创建 crewai tool create <tool> 命令
为发布工具添加 Git 校验
修复：JSON 编码日期对象
新文档
更新 README
缺陷修复

v0.65.2

添加实验性流程功能
修复任务顺序缺陷
更新模板

v0.64.0

正确排序任务
修复摘要逻辑
修复停用词逻辑
将默认最大迭代次数增加到 20
修复输入插值后的团队 key
修复训练功能
添加初始工具 API
拼写错误
更新文档

修复：#1359 #1355 #1353 #1356 及其他

v0.63.6

更新项目模板

v0.63.5

恢复对 o1 系列以及任何不支持停用词的模型的支持
更新依赖
更新日志
更新文档

v0.63.2

将 OPENAI_BASE_URL 添加为回退
添加正确的 LLM 导入
更新文档

v0.63.1

为支持未来的 CrewAI 部署做的小型缺陷修复

v0.63.0

新增用于与 LLM 交互的 LLM 类（借助 LiteLLM）
新增对自定义记忆接口的支持
将 GPT-4o-mini 设为默认模型
更新文档
更新依赖
缺陷修复
- 移除 kickoff_for_each_async 中多余的任务创建

v0.61.0

更新依赖
以不同颜色打印 max rpm 消息
更新所有测试 cassettes
始终以用户消息结束——以更好地支持某些模型（如 Bedrock 模型）
整体小型缺陷修复

v0.60.0

移除 LangChain 并重建 Executor
让所有测试恢复通过
新增在智能体上不使用系统提示词的能力，通过 use_system_prompt 配置
新增不使用停用词的能力（以支持 o1 模型），通过智能体上的 use_stop_words 配置
滑动上下文窗口重命名为 respect_context_window，并默认启用
委派现在默认禁用
内部提示词也略有调整
整体可靠性和结果质量
新增支持：
- 每分钟最大请求数
- 给出最终答案前的最大迭代次数
- 正确利用系统提示词
- token 计算流程
- 新增团队和智能体执行的日志

v0.55.2

新增自动补全能力
为 TaskOutput 添加 name 和 expected_output
新增 crewai install CLI
新增 crewai deploy CLI
清理 Pipeline 功能
更新文档
开发者体验改进，例如 bandit CI 流水线
修复缺陷：
- 能够使用 planning_llm
- 修复基于 YAML 的项目
- 修复 Azure 支持
- 添加对 Python 3.10 的支持
- 迁移离开 Pydantic v1

v0.51.0

crewAI 测试 / 评估 - https://docs.crewai.com/core-concepts/Testing/
新增滑动上下文窗口
允许在 YAML 中使用所有属性 - https://docs.crewai.com/getting-started/Start-a-New-CrewAI-Project-Template-Method/#customizing-your-project
新增初始 Pipeline 结构 - https://docs.crewai.com/core-concepts/Pipeline/
能够为规划步骤设置 LLM - https://docs.crewai.com/core-concepts/Planning/
新增团队运行命令 - https://docs.crewai.com/getting-started/Start-a-New-CrewAI-Project-Template-Method/#running-your-project
保存文件现在会将字典导出为 JSON - https://docs.crewai.com/core-concepts/Tasks/#creating-directories-when-saving-files
对工具输出使用 verbose 设置
新增 GitHub 模板
新增 Vision 工具 - https://docs.crewai.com/tools/VisionTool/
新增 DALL-E 工具 - https://docs.crewai.com/tools/DALL-ETool/
新增 MySQL 工具 - https://docs.crewai.com/tools/MySQLTool/
新增 NL2SQL 工具 - https://docs.crewai.com/tools/NL2SQLTool.md
缺陷修复：
- 规划功能输出的缺陷
- 层级流程的异步任务
- 为非 OAI 模型提供更好的 pydantic 输出
- JSON 截断问题
- 修复日志类型
- 仅在设置了 Env Key 时才导入 AgentOps
- 清理智能体角色以确保目录名有效（Windows）
- 对 OpenAI 而言工具名不应包含空格
- 一系列小问题

v0.41.1

修复规划功能中的缺陷

v0.41.0

[破坏性变更] 类型安全的输出
- 所有团队和任务现在都会返回恰当的对象 TaskOuput 和 CrewOutput
[功能] 团队的新规划功能（先规划再行动）
- 通过向 Crew 实例添加 planning=True
[功能] 引入重放功能
- 新增 CLI，可列出上次运行的任务并从指定任务开始重放
[功能] 能够重置记忆
- 可以在再次运行前清理团队记忆
[功能] 为 LLM 调用添加重试功能
- 可以重试 LLM 调用而不会停止团队执行
[功能] 新增自定义转换器的能力
[工具] 增强工具，支持类型提示和新属性
[工具] 新增 MultiON 工具
[工具] 修复 filecrawl 工具
[工具] 修复 Scraping 工具中的缺陷
[工具] 将 crewAI-tools 依赖升级到该版本
[缺陷] 常规缺陷修复与改进
[缺陷] 遥测修复
[缺陷] 拼写检查修正
[文档] 更新文档

v0.36.0

缺陷修复
更新文档
更新原生提示词
修正提示词中的拼写错误
新增 AgentOps 原生支持
新增 Firecrawl 工具
新增将工具结果作为智能体结果返回的能力
改进代码解释器工具
新增创建自定义 corveter 类的选项（文档待补充）

v0.35.8

修复 embechain 依赖问题

v0.35.7

新的 @composiohq 集成已发布
文档更新
更新自定义 GPT
调整管理器详细程度
缺陷修复

v0.35.5

修复 embedchain 依赖

v0.35.4

更新 crewai create CLI 以使用新版本

v0.35.3

修复代码执行缺陷
更新整体文档
升级 crewai-tools 版本
升级多个依赖的版本
整体缺陷修复

v0.35.0

你的智能体现在可以执行代码
接入任何第三方智能体，LlamaIndex、LangChain 和 Autogen 智能体现在都可以成为你团队的一部分！
在执行前训练你的团队，获得一致的结果！新增 CLI crewai train -n X
缺陷修复和文档更新（还有一些新的文档更新即将发布）

v0.32.2

更新 crewai create CLI 以使用新版本
修复委派智能体匹配

v0.32.0

新增 kickoff_for_each、kickoff_async 和 kickoff_for_each_async 方法，更好地控制 kickoff 流程
添加对所有 LlamaIndex hub 集成的支持
在团队的完整输出中添加 usage_metrics
在新的 YAML 格式上支持多个团队
更新依赖
修复缺陷和拼写错误
文档更新
在文档中添加搜索功能
将 gpt-4o 设为默认模型
新增 LangTrace、Browserbase 和 Exa Search 的文档
为日志添加时间戳

v0.30.11

更新项目生成模板

v0.30.8

更新依赖
修复 crewAI 项目结构中的小缺陷
暂时移除自定义 YAML 解析器

v0.30.5

让智能体委派对较小模型更加通用

v0.30.4