ExecuteAgent - 运行Agent

1. 概述

使用场景： 调用 ExecuteAgent 接口时，将本类各字段序列化为 JSON 传入。服务端根据 instructionType 路由到不同的指令处理器（关键属性抽取/服务质检/标签分类等）。

2. 顶层字段说明

字段名	类型	必填	说明
vid	String	否	会话 ID，若未传入则使用当前时间戳自动生成
modelType	String	是	大模型类型，
agentId	Long	是	Agent 配置 ID
inputType	String	是	分析对象类型:text-文本
instructionType	String	是	指令类型: serviceInspection-服务质检,field-关键属性抽取,tagCategory-标签分类,customPrompt-自定义指令
instructionTypeParam	InstructionTypeParam	是	指令类型对应的参数，不同 instructionType 需要不同的子参数（详见 §4.1）
taskParam	TaskParam	是	任务数据参数，包含文本对话或音频文件信息（详见 §3.1）

3. 嵌套类详细说明

3.1 TaskParam — 任务数据参数

AgentTaskParam.TaskParam 承载本次任务的输入数据，根据 inputType 的不同，使用不同的子参数。

字段名	类型	说明
textParam	TextParam	文本参数，当 inputType = "text" 时使用
callbackUrl	String	任务完成后的回调通知地址（可选）

3.2 TextParam — 文本参数

AgentTaskParam.TextParam 封装文本类型的输入数据。

字段名	类型	说明
dialogue	List<Dialogue>	对话列表，每条评论为一个 Dialogue 对象

Dialogue 对象结构：

字段名	类型	必填	说明
role	String	是	说话角色，如 "客户" / "客服"
words	String	是	对话文本内容
identity	String	否	说话人身份标识（如客服工号）
begin	Long	否	本句开始时间相对偏移量（毫秒）
end	Long	否	本句结束时间相对偏移量（毫秒）
beginTime	Date	否	本句开始绝对时间（yyyy-MM-dd HH:mm:ss）
hourMinSec	String	否	时分秒格式（HH:mm:ss），电话场景必填
emotionValue	Integer	否	情绪能量值（1-10）
speechRate	Integer	否	语速值（每分钟字数）
silenceDuration	Integer	否	静音时长（秒）

---

4. InstructionTypeParam — 指令参数详细说明

AgentManageParam.InstructionTypeParam 根据不同的 instructionType 承载不同的指令配置参数。只需填写与当前 instructionType 对应的子参数，其余字段留空即可。

4.1 FieldsParam — 关键属性抽取（instructionType = "field"）

字段名	类型	必填	说明
nameDescPairList	List<NameDescPair>	是	需要抽取的属性维度列表

NameDescPair 结构：

字段名	类型	说明
name	String	属性名称（必填）
desc	String	属性描述（可选）

4.2 ServiceInspectionParam — 服务质检（instructionType = "serviceInspection"）

字段名	类型	必填	说明
sceneName	String	是	质检场景名称
sceneDescription	String	否	质检场景描述
dimensions	List<Dimension>	是	质检维度列表

Dimension 结构：

字段名	类型	说明
dimension	String	维度名称（必填）
desc	String	维度描述（可选）

4.3 TagCategoryParam — 标签分类（instructionType = "tagCategory"）

字段名	类型	必填	说明
nameDescPairList	List<NameDescValueListPair>	是	标签分类维度列表

NameDescValueListPair 结构：

字段名	类型	说明
name	String	维度名称
desc	String	维度描述
valueList	List<String>	候选标签值列表

4.4 CustomPrompt — 自定义指令（instructionType = "customPrompt"）

字段名	类型	必填	说明
customPrompt	String	是	用户自定义的 prompt 模板内容

---