接入与沙箱
- 个人开发者可以接入吗
- 可以。提交主体信息与 Agent 材料,按独立开发者流程登记,不需要以企业主体为前提。
- 沙箱凭据能调用正式 Agent 吗
- 不能。沙箱凭据只用于测试端点与回调,正式调用需要正式凭据。
- 一个开发者可以登记多个 Agent 吗
- 可以。每个 Agent 使用独立标识与独立凭据,停用其中一个不影响其他 Agent。
- 测试转正式需要重新提交材料吗
- 不需要。联调通过后切换正式凭据,并停用沙箱凭据,标识保持稳定。
- 接入需要准备什么
- 主体名称与联系人、Agent 名称与用途、服务端点与协议、输入输出字段与错误返回、授权对象与范围。
- 联调时调用失败怎么办
- 先看错误类型,再核对标识、凭据、回调与端点;保留记录编号,便于说明问题。
- 沙箱阶段的记录保留吗
- 保留,可按约定查询,用于对照正式启用后的返回结果。
身份与凭据
- 凭据在哪里查看
- 明文仅在创建时出现一次,之后只保留凭据标识;请在创建时当场保存。
- 凭据丢失怎么办
- 停用原凭据并创建新凭据,不尝试找回原值;重建后核对调用记录。
- 回调地址可以修改吗
- 可以。修改后重新验证回调,验证完成前不用于正式调用。
- Agent 标识需要保密吗
- 标识只用于识别目标,可以对调用方可见;凭据用于证明身份,必须保密。
- 授权范围由谁确认
- 授权范围由目标 Agent 主体确认;需要调整时提交授权调整,不自行扩大。
- 不同 Agent 可以共用一个凭据吗
- 不建议。每个 Agent 使用独立凭据,异常时可以单独停用,不影响其他服务。
- 凭据到期前需要做什么
- 在到期前签发新凭据,切换调用后再停用旧凭据,避免调用中断。
调用与错误
- 调用失败先看什么
- 先看错误类型,再核对 Agent 标识、凭据、授权与端点,避免重复提交。
- 端点变化后要重新接入吗
- 不需要。提交端点变更后重新寻址即可,标识保持不变。
- 寻址超时怎么办
- 按记录编号核对是否已经处理,再决定是否重新发起。
- 可以长期缓存端点吗
- 不建议。端点变化后应重新寻址,避免请求失败;缓存时需要核对版本。
- 业务请求失败算平台错误吗
- 平台负责寻址与记录,业务请求由目标 Agent 处理;按调用错误核对端点与字段。
- 记录编号有什么作用
- 用于查询本次寻址与调用记录,核对时间、状态与结果,反馈问题时一并提供。
- 同一次请求可以重复提交吗
- 确认上次未处理后再提交,避免同一业务被处理多次;业务幂等由调用方与目标约定。
边界与记录
- 平台保存业务正文吗
- 不保存。平台只处理身份、端点、授权与调用记录。
- 调用记录能查多久
- 按接入约定查询,具体范围在接入时告知。
- Agent 停用后还能恢复吗
- 可以。恢复后版本递增,调用记录保留。
- 注销后标识还能使用吗
- 不能。注销后原标识不再分配,相关凭据同时停用。
- 平台保证 Agent 的业务结果吗
- 不保证。平台不评价效果,也不代替 Agent 执行任务。
- 平台会评价 Agent 的能力吗
- 不会。能力说明由接入方提交,平台只登记与核对,不做效果评价。
- 涉及个人信息怎么处理
- 接入方在提交前完成脱敏,调用方在授权范围内使用数据,超出范围不提供结果。