AI Agent 概述

融云提供 AI Agent 管理与接入能力，帮助您快速构建智能对话与任务执行系统。 您可以在应用中创建 Agent，通过配置模型、提示词和记忆等参数，实现智能交互与任务处理。

Agent 使用流程

Agent 数据模型

下表展示 Agent 资源的常见顶层属性：

属性名称	类型	说明
agentId	String	Agent 唯一标识，建议长度 3–64 个字符。
name	String	Agent 名称，建议长度 2–128 个字符。
description	String	Agent 描述，长度 ≤ 256 个字符。
type	String	Agent 类型，当前仅支持 chat。
status	String	Agent 状态，可选：active、inactive、draft。
createdAt	Long	创建时间的 Unix 时间戳（毫秒）。
updatedAt	Long	最近更新时间的 Unix 时间戳（毫秒）。
agentConfig	Object	Agent 配置对象，见下方"Agent 配置"模块。

Agent 配置

agentConfig 由以下模块组成：model、prompt、memory。

模型配置

字段	类型	必填	说明
model.provider	String	否	模型提供商。
model.name	String	是	模型名称。
model.options	Object	否	模型选项配置。

参考：模型可用列表

模型选项

字段	类型	必填	说明
model.options.temperature	Double	否	随机性控制，范围 0.0–2.0。
model.options.topP	Double	否	核采样，范围 0.0–1.0。
model.options.maxTokens	Int	否	最大输出 tokens，范围 1–8192。
model.options.frequencyPenalty	Double	否	频率惩罚，范围 -2.0–2.0。
model.options.presencePenalty	Double	否	存在惩罚，范围 -2.0–2.0。
model.options.stop	String[]	否	停止词列表，最多 10 个，每个 ≤ 50 字符。

提示词配置

字段	类型	必填	说明
prompt.id	String	否	系统指令模版 ID，长度 0–64 字符。
prompt.variables	Map<String, String>	否	系统指令模版变量，用于替换模版中的占位符。
prompt.instructions	String	否	系统指令，长度 ≤ 10000 字符。当填写了系统指令模版 ID（prompt.id）时，该项可不填。

记忆配置

字段	类型	必填	说明
memory.strategy	String	否	记忆策略，可选： sliding_window：消息数量限制 - 维护对话历史，但确保总消息数不超过设定的最大值。 token_window：令牌限制 - 维护对话历史，但确保总令牌数不超过设定的最大值。
memory.maxMessages	Int	否	最大记忆消息数，范围 1–150。当 strategy=sliding_window 时建议填写。
memory.maxTokens	Int	否	最大记忆令牌数，范围 > 0。当 strategy=token_window 时建议填写。

使用方式

机器人已原生支持 AI Agent。您可以通过以下两种方式使用 Agent：

1. 机器人回调通道（被动触发）

   当用户向机器人发送私聊消息或在群聊中 @ 机器人时平台将基于 Agent 配置触发推理并返回结果。

2. 服务端 API（主动触发）

   直接调用对话接口 标准对话（Chat Generate），支持流式与非流式返回。

提示

复用现有机器人集成能力，无需自建中间层，即可将 Agent 能力用于 IM 会话内的对话与应答。

Agent 管理接口

功能分类	功能描述	服务端 API 文档
创建 Agent	创建应用下的 Agent，并配置模型与工具等能力。	创建 Agent
更新 Agent	更新 Agent 的信息与配置。	更新 Agent
删除 Agent	删除指定 Agent。	删除 Agent
列出 Agent	分页查询 Agent 列表。	列出 Agent
获取指定 Agent	获取指定 Agent 的详情。	获取指定 Agent
调用 Agent	发起对话推理，获取 Agent 回复，支持非流式与 SSE 流式返回。	调用 Agent