SuperAPI AI 工具集

flexport-upgrade-migration

部署与运维

查看项目

更新于 10-15 23:26

技能介绍

用途:指导 Flexport REST 集成的版本升级,兼顾账户默认版本选择与每请求 Flexport-Version 覆盖,并让读取端与路由端容忍向后兼容的新增内容(属性、资源、可选参数、枚举值、事件类型)。

主要能力:发现有效版本(记录账户默认与各客户端的显式请求头行为,不假设硬编码 v2 路径决定契约);区分破坏性差异与兼容性新增;加固读取端(忽略或保留未知可选字段、安全路由未知枚举/事件值、仅在必需不变量缺失时失败);用覆盖头做只读测试;先部署容忍代码再切换小范围读取队列做金丝雀,对账通过后才启用写操作;最后再改账户默认,保留显式回滚覆盖并验证事件与在途操作。

使用方式:REST 调用使用缓存的 OAuth 2.0 客户端凭证 Bearer 令牌,audience 为 https://api.flexport.com,或使用明确接受的宽泛 API key;每个工作负载使用独立凭证,绝不记录凭证或令牌。MCP 调用使用到 https://mcp.flexport.com/mcp 的已认证连接,并受各工具文档化账户权限约束。发现与取证用 Read 和 Grep,仅对已批准的产物、代码、配置、测试或回执使用 Write 或 Edit,不做未批准的 Flexport 侧变更。

输出:范围明确的决策或实现产物、脱敏的操作与验证回执、失败/回滚/后续责任记录。回执示例字段包括 surface、operation、decision、outcome、evidence(release_sha、provider_reference)、rollback_owner,但不得放入凭证或提供方载荷。

限制与错误处理:有效版本未知时停止并检查账户设置与出站请求头;未知新增枚举导致路由崩溃时安全隔离并使解析容忍;读取结果不一致时暂停迁移并对账语义、展开与分页差异;回滚头未测试时不得更改账户默认。具体价格、平台支持范围等资料未提供。