SuperAPI AI 工具集

anth-upgrade-migration

编程与开发

查看项目

更新于 10-15 22:42

技能介绍

用途:指导升级 Anthropic SDK(Python/TypeScript)并在 Claude API 版本之间迁移,SDK 遵循 semver,主版本可能含破坏性变更。

主要能力:检查当前与最新版本(pip show anthropic | grep Version、npm list @anthropic-ai/sdk、pip index versions anthropic、npm view @anthropic-ai/sdk version);创建升级分支(git checkout -b upgrade/anthropic-sdk);升级 SDK(pip install --upgrade anthropic、npm install @anthropic-ai/sdk@latest);梳理破坏性变更,如 Python 0.20+ 从 Text Completions 迁移到 Messages API、0.30+ 流式改为 client.messages.stream、TypeScript 0.20+ 导入路径改为 @anthropic-ai/sdk;设置 anthropic-version 与 anthropic-beta 头;运行测试与实调验证;回滚(pip install anthropic==0.39.0、npm install @anthropic-ai/sdk@0.34.0 或 git 还原)。

使用方式:先记录当前 SDK 版本、锁文件摘要、API 版本头、模型标识、运行时版本与可回滚修订;从官方来源获取发布说明,在沙箱中用合成提示测试,禁止使用生产凭据。在沙箱更新 SDK 与请求结构,保留显式模型 ID、max_tokens、密钥管理与最小权限。运行单元、契约、流式、工具调用、错误与 token 计数测试,对比脱敏后的响应结构与用量,不记录提示或响应内容。在零客户流量的隔离工作区做金丝雀,经负责人批准且达标后再推广,监控错误、延迟、限流与花费。任一门槛失败即停止推广、恢复先前锁文件/修订、撤销临时凭据并保留脱敏迁移记录。

适用场景:SDK 版本升级、API 版本迁移、CI 集成前的验证。

限制:资料未提供具体价格、平台支持范围或效果数据;迁移测试须使用合成数据与沙箱,不得使用生产凭据。