AI 助理代理 API

Agent 模块提供 Agent 配置的增删改查、用户使用限制管理以及对话生成/回复建议（转发到应用配置的 AI 服务端点）。

模块概览​

项目值
接口数量11
幂等接口2
路径前缀/im/v2
请求方法POST（JSON 请求体）
鉴权方式App-Key / Nonce / Timestamp / Signature（见 鉴权与签名）
响应信封{ code, msg?, data?, requestId? }

接口列表​

接口方法路径说明幂等
创建 AgentPOST/im/v2/agent/create创建 Agent（对话代理配置；对话生成需外部模型接入）。否
获取指定 AgentPOST/im/v2/agent/get获取指定 Agent。否
列出 AgentPOST/im/v2/agent/list列出 Agent（分页）。否
更新 Agent 配置POST/im/v2/agent/update更新 Agent 配置。是
删除 AgentPOST/im/v2/agent/delete删除 Agent。否
设置用户对 Agent 的使用限制POST/im/v2/agent/restriction/set设置用户对 Agent 的使用限制（level=blocked|limited）。是
获取用户 Agent 限制记录POST/im/v2/agent/restriction/get获取用户 Agent 限制记录。否
删除用户 Agent 限制记录POST/im/v2/agent/restriction/remove删除用户 Agent 限制记录。否
查询 Agent 的用户限制列表POST/im/v2/agent/restriction/list查询 Agent 的用户限制列表（分页）。否
Agent 对话生成POST/im/v2/agent/chat/generateAgent 对话生成（转发到应用配置的 AI 服务端点；未配置返回 1021 服务未开通）。覆盖融云 /v3/chat/generate。否
生成回复建议POST/im/v2/agent/chat/suggest生成回复建议（转发到 AI 服务端点；未配置返回 1021）。覆盖融云 /v3/chat/suggest。否

接口约定​

  • 完整请求地址 = 部署域名 + /im/v2 + 接口路径；所有接口使用 POST。
  • 请求头必须携带 App-Key / Nonce / Timestamp / Signature；签名规则见鉴权与签名。
  • 响应统一为 { code, msg?, data?, requestId? }；code = 0 表示成功。
  • 列表类接口使用 limit 分页，单页上限见限频与限制。

相关说明​