---

接口入参说明

1. 概述

Agent 管理请求的入参对象，包含 Agent 的基本属性配置和指令类型参数两大部分。

---

2. 顶层字段

字段名	类型	必填	说明
id	Long	是	Agent Id
agentName	String	是	Agent 名称
agentDescription	String	否	Agent 描述信息
modelType	String	是	大模型类型，取值参见 LLMCodeEnum 枚举
inputType	String	是	分析对象类型，可选值：text（文本）、voice（语音）、image（图片）
instructionType	String	是	指令类型 code，取值参见 AgentInstructionTypeEnum 枚举（见下表）
instructionTypeParam	InstructionTypeParam	是	指令类型的详细配置参数，根据 instructionType 的不同传入对应的子对象

instructionType 枚举值

code	描述	对应 Param
serviceInspection	服务质检	serviceInspectionParam
field	关键属性抽取	fieldsParam
tagCategory	标签分类	tagCategoryParam
multiLevelTag	多级标签识别	tagTreeLevelParam
customPrompt	自定义指令	customPromptParam

---

3. InstructionTypeParam（指令类型参数）

instructionTypeParam 是各种指令类型的配置容器，根据 instructionType 的值，仅需传入对应的子对象，其余子对象可为 null。

字段名	类型	说明
fieldsParam	FieldsParam	关键属性抽取配置，当 instructionType=field 时传入
serviceInspectionParam	ServiceInspectionParam	服务质检配置，当 instructionType=serviceInspection 时传入
tagCategoryParam	TagCategoryParam	标签分类配置，当 instructionType=tagCategory 时传入
tagTreeLevelParam	TagTreeLevelParam	多级标签分析配置，当 instructionType=multiLevelTag 时传入
customPromptParam	CustomPromptParam	自定义指令配置，当 instructionType=customPrompt 时传入

---

3.1 FieldsParam（关键属性抽取）

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

NameDescPair 结构：

字段名	类型	必填	说明
name	String	是	属性名称
desc	String	是	属性描述
value	String	是	属性值

---

3.2 ServiceInspectionParam（服务质检）

字段名	类型	必填	说明
sceneName	String	是	质检场景名称
sceneDescription	String	是	质检场景描述
dimensions	List<Dimension>	是	质检维度列表，定义具体的检查维度及其条件

Dimension 结构：

字段名	类型	必填	说明
dimension	String	是	维度名称（JSON 反序列化时也接受 title 作为别名）
desc	String	是	维度描述（JSON 反序列化时也接受 content 作为别名）

---

3.3 TagCategoryParam（标签分类）

字段名	类型	必填	说明
nameDescPairList	List<NameDescValueListPair>	是	标签分类维度列表，每个维度可包含多个候选标签值

NameDescValueListPair 结构：

字段名	类型	必填	说明
name	String	是	维度/分类名称
desc	String	是	维度描述
valueList	List<String>	是	该维度下的候选标签值列表

---

3.4 TagTreeLevelParam（多级标签识别）

字段名	类型	必填	说明
tagIds	List<Long>	是	运行时传入的标签 ID 列表。取第一个 ID 作为已命中的起始父标签，从其子节点开始继续匹配
tagTreeLevels	List<TagTreeLevelInfoParam>	是	每一级的 prompt 配置列表，按层级顺序排列

TagTreeLevelInfoParam 结构：

字段名	类型	必填	说明
tagTreeIds	List<Long>	是	当前层候选标签 ID 列表。包含 -1 表示全选（即匹配该层所有标签）
prompt	String	是	该层级的分析 prompt，与标签数据拼接后发送给大模型进行分析

---

3.5 CustomPromptParam（自定义指令）

字段名	类型	必填	说明
customPrompt	String	是	用户自定义的 prompt 指令内容
nameDescPairList	List<NameDescPair>	否	自定义字段列表，用于在 prompt 中引用的额外变量

NameDescPair 结构同 3.1。

---

4. 请求示例

{
  "id": 123,
  "userGroup": "default",
  "aliUid": 1000000001,
  "agentName": "客服质检 Agent",
  "agentDescription": "用于客服对话质量的自动检测",
  "modelType": "qwen-max",
  "inputType": "text",
  "instructionType": "serviceInspection",
  "instructionTypeParam": {
    "serviceInspectionParam": {
      "sceneName": "售后客服场景",
      "sceneDescription": "检查售后客服对话的服务质量",
      "dimensions": [
        {
          "dimension": "服务态度",
          "desc": "检查客服是否使用礼貌用语",
          "includeCondition": "包含问候语和感谢语",
          "excludeCondition": "无明显不当用语则不排除"
        }
      ]
    }
  }
}