crewAI 1.15.34 发布:补齐 LiteLLM 接入、结构化输出与错误可观测性
crewAI 1.15.34 的改动重心不在加功能,而在把多智能体运行中的静默失败变成可解释的报错、可计数的遥测和可恢复的状态:密钥缺失、重复工具调用、JSON 不符合 schema、流式异常被吞、登录与部署重试等逐条修补。
原贴
查看原文原文
中文翻译
变更内容
功能
- 在版本号提升之前,先添加独立的 LiteLLM 目录 PR
- 记录 crewai run 在 kickoff 之前停在哪里
- 添加 crewai skill search,用于列出组织的技能
- 将 crewai run --inputs 传入 Python flow
- 添加 deploy create --zip,并打印 zip 所基于的 commit
- 记录使用 planningconfig 的 agent 规划,并迁移 reasoning 页面
缺陷修复
- 在 crewai create 中不再提供已停用的 Gemini 模型
- 对 OpenAI 兼容 provider 抛出 MissingAPIKeyError
- 在匿名遥测中统计重复工具调用导致的停止次数
- 统计项目脚本失败的 crewai run
- 让 crewai[litellm] 能在 Python 3.10 上导入;提高 joserfc、pyasn1、pypdf 的最低版本
- 对空的 LLM 回答重试一次,并抛出带类型的错误
- 当使用工具的 agent 结束时,请求结构化输出
- 对不符合输出模型的 JSON 进行重构,而不是直接失败
- 对重复工具调用发出警告,并在停止时保留已完成的工作
- 遵循 context_window_size,并在使用回退窗口时发出警告
- 对缺失或占位的 API key 抛出 MissingAPIKeyError
- 通过弃用警告恢复被移除的导入路径
- 在 LiteLLM 流式错误中保留 provider 的异常
- 告诉模型如何从不可读的延迟结果中恢复
- 当 eval 期间 AMP 拒绝已保存的登录时,提供登录并重试一次
- 停止 rich live 面板重绘进重定向的日志
- 从 agent 配置内部加载 from_repository 设置
- 将无法恢复的 callback 保存为 null,而不是破坏恢复
- 在 401 时显示 AMP 的原因,并让 run 应用的 deploy 日志重新登录
- 在登录时等待整个设备码生命周期,超时则以 1 退出
- 当 crewai 重建 forward-ref 命名空间时保持模块标识
- 在 crewai update 中打印升级命令,而不是重写 UV 项目
- 返回 flow 脚手架最后一步的 post
- 当 crewai+ 命令需要登录时以 1 退出
- 当 Python 对话式 flow 没有终端时,给出指引后退出
- 在 Python 3.12 的 run TUI 中将深层嵌套的 JSON 保留为文本
- 让 JSON crew runner 能针对较旧的 crewai-core 加载
- 为 LiteLLM 工具调用和结构化输出调用报告 token 用量
不兼容变更
- 记录 1.15.29 中 agent executor 的移除,并附迁移说明
贡献者
@Vidit-Ostwal、@alexmarchenko-crewai、@dependabot [bot]、@joaomdmoura、@lorenzejay
核心信息
crewAI 1.15.34 的改动重心不在加功能,而在把多智能体运行中的静默失败变成可解释的报错、可计数的遥测和可恢复的状态:密钥缺失、重复工具调用、JSON 不符合 schema、流式异常被吞、登录与部署重试等逐条修补。
- crewAI 1.15.34 的改动重心不在加功能,而在把多智能体运行中的静默失败变成可解释的报错、可计数的遥测和可恢复的状态:密钥缺失、重复工具调用、JSON 不符合 schema、流式异常被吞、登录与部署重试等逐条修补。
- 原贴提到:What's Changed Features Add standalone LiteLLM catalog PR before version
- 来源:github.com
详细解读
这是什么信号
这是一份典型的“成熟期”框架更新日志。版本号只前进了一个小位,但三十余条改动里真正算新功能的只有寥寥几条(LiteLLM 目录 PR、crewai skill search、run --inputs 传给 Python flow、deploy create --zip、planningconfig 记录规划),其余绝大多数都落在同一件事上:把多智能体运行过程中的失败路径讲清楚。MissingAPIKeyError、空回答重试一次并抛带类型错误、不符合输出模型的 JSON 改为修复而非直接失败、重复工具调用告警并保留已完成工作、LiteLLM 流式错误保留 provider 原始异常——这些不是能力扩张,而是可解释性和可恢复性的补齐。
为什么重要
Agent 框架一旦进入真实业务,最贵的不是 token 单价,而是静默失败:crew 卡在某个工具调用上无限重复、结构化输出因为一个字段不匹配整条链路崩掉、流式响应里供应商异常被吞掉只剩一个空结果、部署或登录态过期后跑了一夜才发现没有产出。这批改动几乎逐条对应一种静默失败,并把它们转成有类型的错误、可计数的遥测(重复工具调用停止次数、项目脚本失败的 run)和可恢复的状态(无法恢复的 callback 存 null 而不是破坏恢复、401 时显示 AMP 原因并允许重新登录)。同时 context_window_size 被真正遵循、回退窗口会告警,说明团队在把“模型上下文预算”从隐含假设变成显式约束。
对谁有价值
第一类是在生产里跑 crew 的工程团队,遥测计数和类型化错误直接决定他们能否在监控里发现异常;第二类是把 agent 交付给非工程同事的独立开发者和小团队,登录超时退出码为 1、对话式 flow 无终端时给指引再退出,这类细节直接决定“能不能交给别人用”;第三类是平台侧做编排的产品团队,LiteLLM 目录前置、token 用量上报到工具调用和结构化输出,是成本核算与多模型路由的基础设施。对个人开发者而言,这类 release notes 本身就是一张踩坑地图:它列出的每一条 bug,都曾是某个人的线上事故。
可以怎么行动
升级前先做三件事:检查自己使用的 OpenAI 兼容 provider 是否配置了真实密钥而非占位符,因为新版本会直接抛 MissingAPIKeyError 而不是默默失败;审视结构化输出的 schema 严格程度,因为行为已从“失败”变为“修复不符合模型的 JSON”,需要确认修复后的数据是否仍满足下游校验;把重复工具调用的告警接进日志或告警通道,它是 agent 陷入循环的最早信号。此外应主动阅读 1.15.29 agent executor 移除的迁移说明,并核对 Python 3.10 与 3.12 相关的兼容条目是否影响自己的运行环境。
风险或限制
这份文本是变更清单,不是迁移指南:原文只说“附迁移说明”,并未给出完整步骤与兼容性矩阵,实际升级仍需自行验证。JSON 自动修复虽降低失败率,但也可能掩盖上游 prompt 或 schema 设计问题,需要额外校验。匿名遥测统计了重复工具调用与失败 run,团队应明确其开关注明在内部文档中。Python 3.10 导入问题、3.12 TUI 深层 JSON 相关条目说明版本差异依然存在,跨版本部署需逐项回归。
信息差价值
这条内容的真正价值,不只是“有人发布了一个新功能”,而是它揭示了 github.com 背后的产品方向、工作流变化或竞争信号。对 OPC 来说,这种信息可以转化成持续追踪的栏目选题。
如果把《crewAI 1.15.34 发布:补齐 LiteLLM 接入、结构化输出与错误可观测性》放到你的内容系统里,它最大的价值在于帮助读者更快看懂“为什么值得关注”,而不是只看到一条碎片化动态。
参考来源
TOPIC HUBS
延伸专题
AI SUMMARY
这篇文章回答了什么
crewAI 1.15.34 发布:补齐 LiteLLM 接入、结构化输出与错误可观测性主要讲什么?
crewAI 1.15.34 的改动重心不在加功能,而在把多智能体运行中的静默失败变成可解释的报错、可计数的遥测和可恢复的状态:密钥缺失、重复工具调用、JSON 不符合 schema、流式异常被吞、登录与部署重试等逐条修补。
这篇文章最值得关注的要点是什么?
crewAI 1.15.34 的改动重心不在加功能,而在把多智能体运行中的静默失败变成可解释的报错、可计数的遥测和可恢复的状态:密钥缺失、重复工具调用、JSON 不符合 schema、流式异常被吞、登录与部署重试等逐条修补。;原贴提到:What's Changed Features Add standalone LiteLLM catalog PR before version;来源:github.com
这篇文章和哪些AI专题相关?
它适合放在Agent工作流、AI副业、AI工具专题里阅读。 关联原因:这篇内容命中「Agent、智能体」等主题信号。;这篇内容命中「项目、小生意、变现」等主题信号。;这篇内容命中「工具」等主题信号。
阅读这篇文章建议先理解哪些关键词?
建议先理解AI工具、工具、自动化、模型、Cursor这些关键词,再结合正文判断工具、机会或风险是否值得进入自己的工作流。