用途:发布调用 Attio REST API 的应用代码,采用渐进式证据,避免错误 schema 映射、权限或重试策略在广泛变更 CRM 前未被发现。
前提:已版本化的应用制品与经测试的配置;按环境区分的 Attio 工作区与密钥引用;一次性的金丝雀记录或已批准的只读冒烟路径;明确的回滚负责人、触发条件与上一版制品。
主要能力与用法:用 Read、Glob、Grep 检查部署清单、密钥名、健康检查、迁移与回滚命令;WebFetch 仅用于获取最新官方 Attio 文档;确认发布目标与审批边界后才用 Write 或 Edit。令牌由部署平台注入,不得写入镜像或清单;启用写入前先验证目标工作区的对象与列表 schema;读写流量控制需分开,因 Attio 对不同层级限速不同;进程健康检查成功不代表 CRM 变更正确。
流程:比对制品、配置、密钥引用、工作区别名与端点集是否与批准发布记录一致;对同一制品运行离线契约与脱敏测试;先禁用 Attio 写入部署并做有界只读冒烟;确认目标工作区当前对象/列表属性与分页行为;启用一次幂等或可逆的金丝雀写入并读回验证;逐步放量并观察 4xx、429、5xx、延迟、重复写入与队列积压;触发回滚条件时回滚,并验证应用与 CRM 状态。
审批边界:生产写入、令牌轮换、schema 变更及金丝雀数据清理需显示确切目标并经负责人批准;不得在出现无法解释的校验或授权失败时继续推进。
输出:制品标识、环境检查、只读冒烟、金丝雀证据、流量阶段、观测指标、回滚状态与残留风险。
错误处理:工作区身份不确定时在启用流量前停止;schema 与预发不一致时禁用写入并核对映射;429 上升时暂停或降低流量并遵守 Retry-After;金丝雀不可逆时改用更安全的验证方式。
限制:具体工具参数、密钥字段名、限速阈值和端点清单资料未提供,需依据官方文档确认。