Instructor v1.16.0
Instructor v1.16.0 发布,新增 Bedrock 原生结构化输出支持,通过 Converse outputConfig.textFormat 和严格工具 schema 实现 Mode.JSON_SCHEMA 与 Mode.TOOLS_STRICT,包含递归 schema 归一化,要求 boto3 1.42.42 以上。新增验证重试预算,支持正累计 token_budget 限制、不可变 completion:usage 快照、同步/异步截止一致性及稳定累计使用量元数据。改进贡献者工作流,围绕锁定 uv sync 环境、uv run 命令和 uv add 对齐。修复 Mistral SDK 兼容性,支持 Python 3.10+ 的 mistralai 2.x 客户端导出,保留 Python 3.9 所需的 1.x 回退。Bedrock 推理 JSON 解析在推理文本或块后提取最终完整 JSON 值。
发展脉络
- 首次出现Instructor v1.16.0Instructor Releases
- 行业反馈v1.16.0OpenHands
- 当前判断Instructor 作为结构化输出库,其更新反映开发者工具链正紧跟云厂商(如 AWS Bedrock)原生结构化输出能力,可能降低第三方库的附加值,但也通过多提供商适配保持价值。验证重试预算的引入表明成本控制成为结构化输出场景的刚需,可能推动类似工具内置预算管理。Agent Pulse · 分析
Instructor v1.16.0 发布,重点增强 Bedrock 原生结构化输出,新增 Mode.JSON_SCHEMA 和 Mode.TOOLS_STRICT 支持,通过 Converse outputConfig.textFormat 和严格工具 schema 实现,包含递归 schema 归一化,要求 boto3 1.42.42 以上,模型选择仍由调用方控制。验证重试预算新增正累计 token_budget 限制,提供不可变 completion:usage 快照、同步/异步截止一致性和稳定累计使用量元数据,有效响应在超出预算后仍获胜,配置预算时失败尝试若无可用使用量则停止后续调用。贡献者工作流改为锁定 uv sync 环境、uv run 命令和 uv add 仅用于有意项目元数据变更。修复 Mistral SDK 兼容性,支持 Python 3.10+ 的 mistralai 2.x 客户端导出,保留 Python 3.9 的 1.x 回退。Bedrock 推理 JSON 解析在推理文本或块后提取最终完整 JSON 值。
此版本通过 Converse outputConfig.textFormat 和严格工具 schema 实现 Bedrock 原生结构化输出,表明 Instructor 正在适配云厂商原生 API 能力,减少对后处理解析的依赖。递归 schema 归一化可能提升复杂嵌套结构的兼容性。验证重试预算引入 token_budget 限制和不可变 usage 快照,为成本控制和确定性重试提供基础,但有效响应仍优先,预算仅作为停止条件。Mistral SDK 兼容性修复显示对多版本客户端生态的维护策略。
Instructor 作为结构化输出库,其更新反映开发者工具链正紧跟云厂商(如 AWS Bedrock)原生结构化输出能力,可能降低第三方库的附加值,但也通过多提供商适配保持价值。验证重试预算的引入表明成本控制成为结构化输出场景的刚需,可能推动类似工具内置预算管理。
对于依赖 Bedrock 结构化输出的团队,此版本减少解析错误并支持成本预算控制,可能降低推理成本。Mistral 兼容性修复扩大支持范围,减少迁移障碍。贡献者工作流改进可能提升项目维护效率,间接加速功能迭代。
后续可观察 Bedrock 原生结构化输出是否减少对 Instructor 等库的依赖,以及 token_budget 机制是否被更多工具采纳。Mistral SDK 2.x 支持可能预示 Mistral 生态扩展,需关注 Python 3.9 弃用时间线。