协作前提与角色
协作前提是双方分别完成 Agent 登记,且记录处于有效状态。调用方需要有自身标识和凭据,目标方需要明确可调用对象、字段和期限。任一方记录失效,互通无法完成,重复请求也不能绕过这一判断。
角色分为业务对接人、技术联系人和记录核对人。业务对接人确认协作范围与数据用途,技术联系人核对端点与协议,记录核对人按请求编号比对双方记录。三方可以兼任,但每项职责要有明确承担者。
协作前先做适用性判断。双方是否都需要长期引用对方能力、数据是否需要跨系统直接处理、授权范围能否写成明确字段,三项都清楚时再进入登记。只偶尔调用一次、或范围无法界定的协作,先从小范围验证开始,避免一次性铺开。
双方材料对照
材料对照的目的,是让双方在提交前看到同一组事项。一方准备了能力说明,另一方只写了系统名称,核验时仍要退回补充。把对照表作为协作附件,双方按同一顺序填写,可以减少理解偏差。
| 事项 | 调用方准备 | 目标方准备 |
|---|---|---|
| 身份 | 自身 Agent 标识与凭据 | 目标 Agent 标识与状态 |
| 能力 | 需要调用的能力与字段 | 可提供的能力摘要 |
| 授权 | 说明调用目的与范围 | 确认授权对象、字段与期限 |
| 端点 | 可接收响应的地址 | 调用入口、协议与接入方式 |
| 联系人 | 技术与业务对接人 | 变更与故障通知人 |
| 记录 | 保存请求编号 | 保存调用与授权记录 |
| 变更通知 | 接收端点与授权变化 | 提前告知调整时间 |
| 退出安排 | 停止请求并清理配置 | 停用或注销并保留记录 |
协作建立步骤
- 双方确认协作目标、涉及能力与数据范围。
- 各自核对 Agent 身份记录是否有效。
- 目标方确认授权对象、字段和期限。
- 调用方提交匹配请求,取得端点与版本。
- 双方完成一次联合调用,核对返回字段。
- 保存请求编号与记录编号,形成验证结论。
- 确认无误后进入正式调用,约定变更通知方式。
- 把验证结论与请求编号发送双方存档,作为协作开始的依据。
授权对齐方法
授权范围有交集才返回结果。交集之外的能力不出现,调用方不应把无结果理解为目标不存在,先核对范围再判断,避免据此调整业务方案。
对齐时以书面记录为准,不用口头约定替代。谁在什么时间确认了哪些字段、期限到何时,写入协作说明并双方留存。后续人员变动时,新接手的人可以按记录恢复上下文,不必重新猜测此前的约定。
- 以能力为单位对齐,不按系统整体授权。
- 字段范围写明名称,不使用笼统表述。
- 期限写明起止,到期前确认是否续期。
- 调用方向与调用频次在协作说明中列明。
- 新增能力按授权调整办理,不默认继承。
- 授权变更后双方重新匹配,确认新范围生效。
数据与责任边界
平台处理身份、匹配、授权判断和调用记录,不转发业务结果,不保存业务正文。业务数据由双方系统直接处理,数据用途、保存期限和脱敏方式由双方约定。
主体对 Agent 的业务行为、数据质量和结果负责。平台不评价业务效果,不保证目标持续可用,也不参与合同签署。涉及个人信息时,双方在调用前完成脱敏;国家秘密和重要数据不接入。
数据边界要在协作说明中写清,不等出现问题再补。哪些字段用于定位、哪些字段属于业务数据、业务数据在双方系统中如何保存,分别说明。平台只保留调用记录,业务争议按双方系统记录处理。
异常处理与退出
异常处理以控制影响为先。暂停期间双方各自保留记录,确认原因后再恢复或退出,避免一边恢复一边排查导致结论反复。
- 目标停用:暂停调用,核对登记状态,确认恢复方式。
- 授权过期:提交授权调整,不通过重复请求试探。
- 端点不可达:核对端点记录,由目标方提交变更。
- 版本不一致:重新匹配,不使用缓存中的旧端点。
- 调用异常:保留请求编号与记录编号,双方按同一编号核对。
- 退出协作:目标方停用或注销,调用方停止请求并清理配置。
- 通知中断:先核对联系人是否失效,再补充通知并确认送达。
- 争议处理:双方按同一记录编号各自核对,不各查各的记录。
常见问题
- 协作需要双方都登记吗
- 需要。双方分别登记身份和授权范围,平台才能核对双方记录并判断范围。
- 平台会转发业务数据吗
- 不会。平台返回端点和授权信息,业务调用由双方系统完成。
- 授权范围可以一方单独扩大吗
- 不可以。授权范围由目标主体确认,调整需双方知悉并重新匹配。
- 协作结束后记录还保留吗
- 保留。记录用于核对历史调用与授权范围,按登记规则保存。
- 一方更换对接人需要重新登记吗
- 不需要。更新联系人即可,记录版本随之递增,双方确认通知链路。
- 联合验证需要覆盖全部能力吗
- 至少覆盖本次协作要用的能力与字段,其余能力按授权调整另行验证。