用途:以可回滚方式部署 Exa 集成,覆盖服务端凭据、受限并发、金丝雀发布,以及对定时/异步工作的显式回滚。适用于需治理凭据、查询、检索内容、生成输出、花费与破坏性状态的运维场景。
前置条件:目标仓库、环境、Exa 团队、产品面与责任人;数据分类、延迟与新鲜度承诺、成本上限与保留策略;当前第一方文档,以及仅用于受限在线验证的凭据。
当前契约:生产 worker 应从可信服务端运行时调用 Exa。Search 与 Contents 可同步;Agent、Monitors、Websets 与 Batch 需持久 ID 与终态对账。部署须考虑生命周期长于进程发布的队列与定时资源。
认证:常规 REST 从已批准的服务端密钥管理器注入 EXA_API_KEY,仅以 Authorization: Bearer 发往配置的第一方 Exa API 主机。团队管理服务密钥、托管 MCP OAuth 或企业托管授权、支付协议调用属不同信任模型。切勿打印、提交、放入 URL 或暴露给不可信客户端。
步骤:识别发布中的每个运行时、队列、webhook、计划、密钥与 Exa 产品;按环境注入密钥并禁止浏览器或预览构建访问;配置超时、端点预算、队列上限与内容大小限制;先暗部署、验证配置,再启用小规模合成金丝雀;观察请求 ID、错误类别、延迟、成本与异步积压;回滚代码并单独暂停或对账 monitors、batches 与 runs。
工具纪律:使用 Read、Glob、Grep 检查代码、配置、夹具与证据;Write、Edit 仅用于已批准的实现或文档变更。不得仅因调用本技能就调用 Exa、运行付费研究,或创建/修改 Monitor、Webset、Agent 运行、Batch、团队、成员、API 密钥、预算、webhook 或部署。
审批边界:涉及敏感意图的在线查询、生产凭据、花费或速率限制变更、强制在线抓取、生成摘要、外部投递、部署、成员或密钥变更、创建计划、破坏性取消/停止/删除/撤销,均须有责任人批准。只读仓库检查与离场合成的验证不授权在线厂商操作。
失败模式:回滚代码不会取消厂商侧异步工作;预览环境可能泄露生产密钥或创建付费计划;无共享限流器的自动扩缩 worker 可能超出团队限额。
输出:返回操作范围、环境、团队与产品面、授权类别、契约与策略决策、确定性验证结果、无内容标识符、状态与成本计数、风险、清理或回滚状态,以及简洁的通过或失败回执。除非单独批准,排除凭据、原始查询、提示、预签名 URL、检索内容、生成输出与客户衍生数据。
验证:重跑最小相关确定性测试,将实际行为与请求结果及当前第一方契约对比,确认敏感字段不在证据中,并在报告成功前确认截止时间、终态、下游保留与回滚。其他参数、价格、限制等细节暂未提供。