Instructor v1.17.0
Instructor v1.17.0 于 2026-09-09 发布，包含原计划用于 1.16.1 的修复。缓存响应使用新键，默认按客户端隔离命名空间；现有缓存条目将失效。带 async-validator 装饰器的响应模型在调用 provider 或缓存查找前被拒绝，包括嵌套模型。远程媒体 URL 必须解析为公共地址且不能包含凭据，检查重定向和连接对等方，并限制下载大小。修复了缓存隔离，包括 provider 身份和生成设置。
Development
- First ReportInstructor v1.17.0Instructor Releases
- Industry Responsev1.17.0OpenHands
- Current AssessmentInstructor 作为结构化输出库，其版本更新反映了对安全性和隔离性的重视，这可能是为了满足企业级部署的需求。缓存隔离和验证时序的变化可能影响依赖该库的 Agent 框架，促使它们调整缓存策略和验证流程。Agent Pulse · analysis
Instructor v1.17.0 于 2026-09-09 发布，包含原计划用于 1.16.1 的修复。主要变更包括：缓存响应使用新键，默认按客户端隔离命名空间，现有缓存条目将失效；仅当客户端有意共享结果时才设置相同的显式 cache_namespace，以保持账户、端点和租户隔离。带 Instructor async-validator 装饰器的响应模型（包括嵌套模型）在 provider 调用或缓存查找前被拒绝，建议使用 Pydantic 验证器或显式等待应用级验证。远程媒体 URL 必须解析为公共地址且不能包含凭据，检查重定向和连接对等方，并限制下载大小。修复了缓存隔离，包括 provider 身份和生成设置，缓存命中保留当前验证上下文和严格性。
此版本表明 Instructor 正在收紧验证和缓存语义：async-validator 的自动执行被推迟，意味着开发者需要显式处理验证，这改变了异步验证的时序。缓存命名空间隔离默认开启，要求开发者显式配置共享，这会影响多租户场景下的缓存命中率。远程媒体 URL 的限制（公共地址、无凭据、大小限制）暗示了安全加固，可能影响依赖私有媒体 URL 的工作流。
Instructor 作为结构化输出库，其版本更新反映了对安全性和隔离性的重视，这可能是为了满足企业级部署的需求。缓存隔离和验证时序的变化可能影响依赖该库的 Agent 框架，促使它们调整缓存策略和验证流程。
对于使用 Instructor 的企业，此更新可能带来缓存命中率下降和验证时序变化，需要调整代码以适配。但安全加固和隔离性提升有助于满足合规要求，降低多租户数据泄露风险。
后续可观察信号：Instructor 是否会提供迁移工具或文档以帮助用户处理缓存失效；async-validator 的自动执行是否会恢复或提供替代方案；社区对缓存命名空间隔离的反馈。