SuperAPI AI 工具集

integration-capability-analysis

数据与分析

查看项目

更新于 10-16 08:37

技能介绍

用途:把某个外部系统的 API 或文件规范,对照 Factorial 的集成框架逐能力分析,输出一份集成映射文档,供决策者判断是否值得做集成,也供工程师按文档实现。

能力目录以官方文档为准:薪酬域见 https://apidoc.factorialhr.com/v2026-10-01/docs/payroll-integrations ,财务域见 https://apidoc.factorialhr.com/v2026-10-01/docs/finance-integrations 。每次分析先读取对应域页面,按其列出的能力、方向与所链接的 Factorial 端点字段来工作,不得凭记忆推断。URL 有版本号,按请求方指定版本,未指定用上述版本,并在文档头部记录版本;页面无法获取时应停止说明,不要自行编造能力清单。

流程:先判定系统属于哪个域(薪酬引擎归薪酬,会计或 ERP 归财务,跨域则每域各出一份文档;两者都不属于则说明并停止),在文档顶部一行写明分类及理由。再加载该域能力清单与端点字段,并记录整体约束(创建顺序、写入所需的 external_id 等标识、增量同步参数)。随后清点供应商规范:API 规范按操作逐行记录方法、路径、作用、请求响应字段与必填标志及出处;文件规范按记录类型和列对应。同时做全文检查,确认方法分布、实际生效的鉴权、错误响应、无响应体操作、分页与增量过滤、限流、枚举、已弃用标记等,结论须经计数或检索验证。

匹配时按方向判断:出站以 Factorial 为源,供应商需有写入端点;入站以供应商为源,需有可读端点(最好支持分页与按修改时间过滤)。按调用顺序排列端点,并逐字段映射,写明源字段、目标字段全路径、是否必填、转换方式与证据。转换需具体说明日期与金额格式、代码表取值映射、结构拆分合并、单位换算、标识匹配方式。分别列出供应商必填但 Factorial 无来源的缺口和 Factorial 数据无供应商落点的缺口,不得虚构供应商字段。

每个能力给出三种结论:完全支持、部分支持(须说明限制及上线可行性)、不支持(注明规范排除还是未提及)。文档按 assets/report-template.md 撰写,能力摘要在前,逐能力分段,最后按影响程度排序列出待向供应商确认的问题,保存为 <vendor>-<domain>-integration-mapping.md。

限制:仅依据官方域页面与供应商规范;规范未覆盖、页面取不到或系统不属于现有域时如实说明;证据缺失的映射不得写为事实。