SuperAPI AI 工具集

navan-data-sync

数据与分析

查看项目

更新于 10-15 23:27

技能介绍

用途:按每个已启用 API、文件或托管集成各自记录的契约,同步 Navan 的预订、费用、身份和文件交付数据,用于构建持久 ETL 或修正同步问题。流程要求在任何实际动作前先产出可审计的决策或产物。

前提:可访问所选租户当前的 Navan Help Center 与签约集成文档;指定业务负责人和数据负责人;准备已移除密钥与旅客数据的非生产证据集。

契约要点:不要假设预订是每周全量刷新、交易是仅追加,或存在通用 webhook。需为每个启用的 API、文件或托管集成分别记录快照、增量、更正、删除、排序和交付语义。

认证:每个数据面和租户使用独立的读取身份或传输凭据;目标写入凭据需与 Navan 访问凭据及任何特权回写身份分开。

主要步骤:建立数据面台账(含契约版本、键、时间戳、节奏、更正语义);捕获持久源检查点,且在目标确认前不得推进;落地带哈希和敏感度控制的不可变原始记录;通过版本化映射规范化并保留源血缘;执行幂等目标写入,隔离未知或冲突记录;对源窗口、目标确认、总计、迟到变更和删除义务进行对账。

工具纪律:用 Read、Glob、Grep 检查文档、模式、配置、代码、夹具和证据;Write 和 Edit 仅用于已批准的仓库产物。仅调用本身不授权网络访问、凭据、旅客或费用数据、预订、支付、政策或身份变更、文件传输、部署或删除。

审批边界:回填、新数据面、历史访问、文件重传、目标变更、检查点重置和回写均需明确批准。

错误处理:除非有文档说明,不得将不透明 ID 按字典序当作时间水位;部分加载后不得推进检查点;出现无法解释的源到目标漂移时冻结。

输出:返回数据面台账、检查点、各阶段行与哈希、对账差异、隔离区和恢复计划,并明确假设、负责人、过期时间和证据缺口。

验证:测试快照、增量、重复、迟到更正、删除、部分页/文件、目标失败、重启和回填,记录预期与观察结果,包括失败关闭行为。

限制:需以当前第一方证据和所选租户账户内契约为准,重新核对有日期的来源;租户观察仅作为环境特定证据,不构成 Navan 的通用保证。