SuperAPI AI 工具集

glean-upgrade-migration

编程与开发

查看项目

更新于 10-15 23:26

技能介绍

用途:该技能面向 Glean 企业搜索平台的升级与迁移,帮助检查 Glean 开发者变更日志中的 API 变更。Glean 通过连接器索引 SaaS 工具中的文档,并暴露 Search 与 Indexing API;迁移通常涉及连接器 schema 变更、搜索 API 响应格式更新和文档权限模型升级。

主要能力:提供版本检测思路(检查 Indexing API 健康与版本、搜索 API 中已弃用的查询参数)、迁移检查清单(审查 Indexing API schema 变更、审计自定义连接器弃用字段、核对 objectType 定义、检查权限模型新增必填字段、测试搜索响应解析、验证批量索引等)、文档 schema 迁移示例(扁平权限到结构化 ACL 模型)、回滚策略(v2 失败回退 v1)、错误处理对照表(schema 校验失败、权限模型不匹配、连接器认证过期、搜索响应格式变化、数据源配额超限)以及升级流程说明。

使用方式:资料给出触发词“glean upgrade migration”“upgrade-migration”,并包含 TypeScript 代码示例,涉及 GLEAN_BASE 地址、Bearer 令牌、/index/v1/status、/client/v1/search、/index/{version}/indexdocuments 等端点。前置条件包括固定当前与目标版本、兼容性评估、沙箱夹具、每个破坏性行为的负责人、按修订标识的配置与 schema 备份、已批准的回退与连接器禁用流程、合成数据与允许/拒绝身份验证。流程为:读取版本差异并盘点受影响的客户端、连接器、schema 与授权契约;先在沙箱升级并运行有界回归测试;经批准后经 staging 与单个金丝雀数据源推进;监控回滚触发条件后分阶段推进或恢复固定修订;金丝雀与回滚演练均完成后更新兼容性记录。输出为升级回执,含 from/to 版本、受影响契约、测试/金丝雀结果、允许/拒绝结果、负责人批准、兼容性决定与回滚修订,且不得包含生产数据或密钥。

适用场景:Glean 连接器、搜索 API、索引 API 或权限模型发生版本升级时的迁移与验证。

限制:资料未提供具体价格、平台支持范围或实际效果数据;示例中的域名、令牌与端点为占位内容,需替换为实际环境值。