咨询前准备
平台按材料核对接入主体与 Agent 用途,信息不完整时会被退回补充。提前整理可以减少往返,也能让对接人明确谁负责端点、凭据与回调。
维护人与联系人可以不同,但都需要明确职责:谁提交变更、谁保管凭据、谁处理调用异常。
- 开发者主体类型:个人、团队或企业。
- 拟接入的 Agent 数量与用途。
- 回调地址、测试端点与调用说明。
- 沙箱凭据需求与测试范围。
- 授权对象、字段范围与期限。
- 维护人与联系人的分工。
提交内容
提交内容用于核对主体、能力与授权安排,不需要提供业务正文。涉及个人信息时先完成脱敏,材料中的端点与回调应与实际环境一致。
同一 Agent 的多项变更合并说明,按变更类型列出端点、能力与授权,便于一次核对完成。
| 项目 | 需要说明的内容 |
|---|---|
| 主体信息 | 名称、联系人与责任部门 |
| Agent 信息 | 名称、用途、能力说明 |
| 调用信息 | 端点、协议、输入输出字段 |
| 错误返回 | 错误类型与说明方式 |
| 授权安排 | 调用对象、字段范围与期限 |
受理流程
材料提交后由平台核对,材料不齐时退回补充。核对完成后进入沙箱配置与联调,联调通过再切换正式;需要变更端点或授权时,按变更事项办理。
受理过程中如需补充材料,按核对意见一次说明,避免多次往返。
- 整理开发者信息与 Agent 材料。
- 通过平台提供的提交地址发送材料。
- 按核对意见补充或修正内容。
- 配置沙箱并完成联调测试。
- 切换正式凭据,停用沙箱凭据。
问题反馈
反馈时按问题类型提供对应信息,便于快速定位。涉及调用的问题,记录编号是关键线索;同一问题多次出现时,按时间顺序列出记录编号与错误说明。
反馈时先说明影响范围:是单个调用方、单个 Agent,还是多个服务同时出现。范围清楚后,核对对象与记录范围更容易确定。
- 调用失败:提供错误类型、时间、Agent 标识与记录编号。
- 鉴权问题:提供调用方标识、凭据有效期与授权范围。
- 端点问题:提供端点、协议与请求字段。
- 记录问题:提供请求时间、记录编号与返回内容。
- 接入材料:说明变更项与当前登记内容。
安全事件
发现凭据泄露、标识被冒用或异常调用时,先停用相关凭据并保留调用记录,再联系平台。说明发生时间、涉及的 Agent 标识与已知的调用记录编号,便于核对影响范围。
不要在没有保留记录的情况下删除凭据或重建标识,以免影响判断;处置完成后按需重建凭据,并核对新凭据的调用情况。
安全事件处理完成后,按需更新凭据与回调,并核对新配置的调用记录。涉及多个 Agent 时分别处置,不共用同一凭据恢复。