常见问题

接入、身份、调用与边界是咨询较多的四类问题。回答依据现有登记与调用规则整理,涉及材料与授权范围的内容,以接入时确认的结果为准;未覆盖的问题可以通过联系入口提交。提交时说明 Agent 用途与需要确认的事项。

接入与沙箱

个人开发者可以接入吗
可以。提交主体信息与 Agent 材料,按独立开发者流程登记,不需要以企业主体为前提。
沙箱凭据能调用正式 Agent 吗
不能。沙箱凭据只用于测试端点与回调,正式调用需要正式凭据。
一个开发者可以登记多个 Agent 吗
可以。每个 Agent 使用独立标识与独立凭据,停用其中一个不影响其他 Agent。
测试转正式需要重新提交材料吗
不需要。联调通过后切换正式凭据,并停用沙箱凭据,标识保持稳定。
接入需要准备什么
主体名称与联系人、Agent 名称与用途、服务端点与协议、输入输出字段与错误返回、授权对象与范围。
联调时调用失败怎么办
先看错误类型,再核对标识、凭据、回调与端点;保留记录编号,便于说明问题。
沙箱阶段的记录保留吗
保留,可按约定查询,用于对照正式启用后的返回结果。

身份与凭据

凭据在哪里查看
明文仅在创建时出现一次,之后只保留凭据标识;请在创建时当场保存。
凭据丢失怎么办
停用原凭据并创建新凭据,不尝试找回原值;重建后核对调用记录。
回调地址可以修改吗
可以。修改后重新验证回调,验证完成前不用于正式调用。
Agent 标识需要保密吗
标识只用于识别目标,可以对调用方可见;凭据用于证明身份,必须保密。
授权范围由谁确认
授权范围由目标 Agent 主体确认;需要调整时提交授权调整,不自行扩大。
不同 Agent 可以共用一个凭据吗
不建议。每个 Agent 使用独立凭据,异常时可以单独停用,不影响其他服务。
凭据到期前需要做什么
在到期前签发新凭据,切换调用后再停用旧凭据,避免调用中断。

调用与错误

调用失败先看什么
先看错误类型,再核对 Agent 标识、凭据、授权与端点,避免重复提交。
端点变化后要重新接入吗
不需要。提交端点变更后重新寻址即可,标识保持不变。
寻址超时怎么办
按记录编号核对是否已经处理,再决定是否重新发起。
可以长期缓存端点吗
不建议。端点变化后应重新寻址,避免请求失败;缓存时需要核对版本。
业务请求失败算平台错误吗
平台负责寻址与记录,业务请求由目标 Agent 处理;按调用错误核对端点与字段。
记录编号有什么作用
用于查询本次寻址与调用记录,核对时间、状态与结果,反馈问题时一并提供。
同一次请求可以重复提交吗
确认上次未处理后再提交,避免同一业务被处理多次;业务幂等由调用方与目标约定。

边界与记录

平台保存业务正文吗
不保存。平台只处理身份、端点、授权与调用记录。
调用记录能查多久
按接入约定查询,具体范围在接入时告知。
Agent 停用后还能恢复吗
可以。恢复后版本递增,调用记录保留。
注销后标识还能使用吗
不能。注销后原标识不再分配,相关凭据同时停用。
平台保证 Agent 的业务结果吗
不保证。平台不评价效果,也不代替 Agent 执行任务。
平台会评价 Agent 的能力吗
不会。能力说明由接入方提交,平台只登记与核对,不做效果评价。
涉及个人信息怎么处理
接入方在提交前完成脱敏,调用方在授权范围内使用数据,超出范围不提供结果。

还有其他问题

说明开发者信息、Agent 用途与需要确认的事项,提交咨询。

联系我们