ExecuteAgent

1. Overview

Scenarios: When you invoke the ExecuteAgent operation, serialize the fields of this class into JSON and pass them in. The server routes to different instruction processors (key attribute extraction, service inspection, tag classification, and others) based on the instructionType value.

2. Top-level field description

Field	Type	Required	Description
vid	String	No	The session ID. If not specified, a value is automatically generated based on the current timestamp.
modelType	String	Yes	The large language model type.
agentId	Long	Yes	The agent configuration ID.
inputType	String	Yes	The type of the analysis object. Valid values: text
instructionType	String	Yes	The instruction type. Valid values: serviceInspection: service inspection. field: key attribute extraction. tagCategory: tag classification. customPrompt: custom instruction.
instructionTypeParam	InstructionTypeParam	Yes	The parameters corresponding to the instruction type. Different instructionType values require different sub-parameters. For more information, see §4.1.
taskParam	TaskParam	Yes	The task data parameters, which contain text dialogue or audio file information. For more information, see §3.1.

3. Detailed description of nested classes.

3.1 TaskParam — Task data parameters

AgentTaskParam.TaskParam carries the input data for the current task. Different sub-parameters are used based on the inputType value.

Field	Type	Description
textParam	TextParam	The text parameters. Used when inputType = "text".
callbackUrl	String	The callback URL for notification after the task is complete. Optional.

3.2 TextParam — Text parameters

AgentTaskParam.TextParam encapsulates text-type input data.

Field	Type	Description
dialogue	List<Dialogue>	The dialogue list. Each comment is a Dialogue object.

Dialogue object structure:

Field	Type	Required	Description
role	String	Yes	The speaker role, such as "客户" / "客服".
words	String	Yes	The dialogue text content.
identity	String	No	The speaker identity, such as the agent ID.
begin	Long	No	The relative offset of the start time of this sentence, in milliseconds.
end	Long	No	The relative offset of the end time of this sentence, in milliseconds.
beginTime	Date	No	The absolute start time of this sentence (yyyy-MM-dd HH:mm:ss).
hourMinSec	String	No	The time in HH:mm:ss format. Required for phone call scenarios.
emotionValue	Integer	No	The emotion energy value (1-10).
speechRate	Integer	No	The speech rate in words per minute.
silenceDuration	Integer	No	The silence duration in seconds.

---

4. InstructionTypeParam — Detailed description of instruction parameters

AgentManageParam.InstructionTypeParam carries different instruction configuration parameters based on the instructionType value. You only need to specify the sub-parameters corresponding to the current instructionType. Leave the other fields empty.

4.1 FieldsParam — Key attribute extraction (instructionType = "field")

Field	Type	Required	Description
nameDescPairList	List<NameDescPair>	Yes	The list of attribute dimensions to extract.

NameDescPair structure:

Field	Type	Description
name	String	The attribute name. Required.
desc	String	The attribute description. Optional.

4.2 ServiceInspectionParam — Service inspection (instructionType = "serviceInspection")

Field	Type	Required	Description
sceneName	String	Yes	The name of the inspection scenario.
sceneDescription	String	No	The description of the inspection scenario.
dimensions	List<Dimension>	Yes	The list of inspection dimensions.

Dimension structure:

Field	Type	Description
dimension	String	The dimension name. Required.
desc	String	The dimension description. Optional.

4.3 TagCategoryParam — Tag classification (instructionType = "tagCategory")

Field	Type	Required	Description
nameDescPairList	List<NameDescValueListPair>	Yes	The list of tag classification dimensions.

NameDescValueListPair structure:

Field	Type	Description
name	String	The dimension name.
desc	String	The dimension description.
valueList	List<String>	The list of candidate tag values.

4.4 CustomPrompt — Custom instruction (instructionType = "customPrompt")

Field	Type	Required	Description
customPrompt	String	Yes	The custom prompt template content.

---