Anthropic Python SDK发布v2.5.0:新增错误类型与工作区id过滤
anthropic-sdk-python v2.5.0在API侧新增错误详情类型和新错误类型值、为列出工作区增加ids过滤;客户端侧新增HTTP状态码与API错误码对应的错误类,并在APIStatusError上暴露error_code、details和api_message。该版本同时修复多处路径校验与线程安全问题。
AI解读:发布主体为anthropic-sdk-python的v2.5.0版本,由仓库的发布机器人账号提交,属于库版本更新而非模型能力发布。
功能性改动集中在API和客户端两层:API层新增错误详情类型、新错误类型值,以及列出工作区时的ids过滤;客户端层新增按HTTP状态和API错误码区分的错误类,并在APIStatusError上提供error_code、details、api_message三个字段。
错误层级关系被调整:OverloadedError和ServiceUnavailableError改为InternalServerError的子类。来源只列出这一继承关系,未说明对外部捕获逻辑的具体影响。
修复项涉及路径处理:Bedrock相关调用在model为 "."、".." 或空字符串时抛出ValueError,不再把请求发往其他路径或 /model//invoke;客户端拒绝 '..;x' 和 ';x' 这类路径参数,并对Vertex请求路径中的model、project ID和region做百分号编码。
线程安全相关修复包括:每个响应模型的首次解析改为线程安全;在pydantic v1下跨线程正确校验union。tools一项修复防止memory工具重命名或删除 /memories目录。
其余为文档、CI和内部整理类改动,包括澄清plugin reach与plugin版本描述、更新遥测目标header描述、在分析过滤文档中使用Claude Platform名称等。
anthropic-sdk-python发布v2.5.0。按仓库发布说明,该版本新增错误详情类型和新的错误类型值,为列出工作区增加ids过滤;客户端新增按HTTP状态码和API错误码划分的错误类,并在APIStatusError上提供error_code、details和api_message。
API新增错误类型与工作区ids过滤
发布说明将两项列为Features:api部分新增错误详情类型和新的错误类型值;列出工作区(list workspaces)的接口增加ids过滤参数。
同属api的修正包括:错误详情类型名中的CMEK改为大写;部分错误详情类型被移动到其所描述的资源下。
客户端错误类与错误字段
客户端侧新增对应HTTP状态码和API错误码的错误类,APIStatusError上新增error_code、details和api_message。
错误继承关系有调整:OverloadedError和ServiceUnavailableError成为InternalServerError的子类。
路径校验与Bedrock、Vertex修复
Bedrock相关调用在model为 "." 或 ".." 时抛出ValueError,不再把请求发到其他路径;model为空时同样抛出ValueError,不再请求 /model//invoke。
客户端拒绝 '..;x'、';x' 这类路径参数。Vertex请求路径中的model、project ID和region改为百分号编码。
线程安全与memory工具修复
每个响应模型的首次解析改为线程安全;在pydantic v1下跨线程的union校验被修正。
tools部分修复使memory工具不会再重命名或删除 /memories目录。测试项新增对None路径参数被拒绝的检查。
文档与其他改动
文档改动包括:澄清plugin reach值和plugin版本描述及长度;澄清若干API字段与三条错误描述;说明fallback block前后应回传哪些块;修正用量报告中Claude Tag直接消息的说明;改写Dream与RBAC角色权限描述;更新遥测目标header描述;在分析过滤文档中使用Claude Platform名称。CI增加以延迟构建pydantic模型方式运行测试。内部整理包括将错误体辅助函数移入内部工具、删除过时TODO与一个无法通过的测试。