GetAgentTaskResult - 获取Agent任务结果-伶鹊(Cloud Contact Center)-阿里云帮助中心

获取Agent任务结果

接口说明

可以查询通过 UploadAudioData 、 UploadData 上传的数据，也可以查询数据集质检任务 SubmitQualityCheckTask 的数据。可以根据任务 ID（taskId）查询，也可以根据时间范围查询。此接⼝返回结果中默认只返回部分参数，可通过请求参数中的 requiredFields 来⾃定义设置返回参数中需要返回哪些字段。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

sca:GetAgentTaskResult

none

*全部资源

*

无

请求语法

POST  HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
JsonStr	string	否	完整 JSON 字符串信息，具体内容参见以下详细信息。	{\"vid\":\"sip-11-1766561862.293393\",\"taskId\":\"20251224-D3B32484-2D53-5B53-A618-483A7941029E\"}
BaseMeAgentId	string	否	业务空间 Id	123456

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	Id of the request	F190ADE9-619A-447D-84E3-7E241A5C428E
Code	string	状态码，200 表示正常	200
Message	string	错误的时候，返回错误信息	successful
Success	string	请求是否成功。调用方可根据此字段来判断请求是否成功： true 表示成功 false/null表示失败	true
Data	object	返回结果
TaskId	string	任务 ID。	A6BEC8D-9A5B-4BE5-8432-4F635E***
Vid	string	会话 ID。	6fa76916-3ce6-45d8-ac64-01b7f31***
LlmRequestId	string	大模型服务返回的 requestId	106C6CA0-282D-4AF7-85F0-D2D24***
Status	string	1:待执行，2:运行中，3:成功，4:失败	1
ErrorMessage	string	当 status 是非 0、1 时表示错误详情。	xxxx
Response	object	计算任务的结果
FieldResponse	object	属性抽取结果
FieldVoList	array<object>	属性列表
	object	属性
Name	string	属性名称	phone
Value	string	属性值	1234561
Remarks	string	判断理由	通过客服第一句话判断
OriginalUtterances	array	判断理由引用的句子
	integer	判断理由引用的句子序号	1
TagCategoryResponse	object	标签分类返回结果
TagCategoryVoList	array<object>	标签列表
	object	标签
Dimension	string	标签维度	客户意图
IsMatch	boolean	是否匹配	true
ResultLabels	array	命中标签列表
	string	命中标签	退货
Remarks	string	判断理由	通过客服第一句话判断
OriginalUtterances	array	判断理由引用的句子
	string	判断理由引用的句子序号	1
ServiceInspectionResponse	object	服务质检返回结果
ServiceInspectionVoList	array<object>	质检项列表
	object	质检项
Dimension	string	质检维度	服务态度
IsMatch	boolean	是否匹配	true
Remarks	string	判断理由	通过客服第一句话判断
OriginalUtterances	array	判断理由引用的句子
	string	判断理由引用的句子序号	1
CustomerPromptResponse	object	自定义指令的返回结果
Text	string	大模型返回的结果。	175/xl面料摸着很舒服,穿起来看着也挺修身的挺好的好衣服超好看,质量手感没得说一级棒,很满意的一次购物。
VoiceprintResponse	object
Dialogue	array<object>	对话语料
	array<object>	对话语料
Words	string	对话内容	不清楚
Begin	integer	本句话的开始时间，是相对起始点的开始时间偏移，单位 ms。	443
End	integer	本句话的结束时间，是相对起始点的结束时间偏移，单位 ms。	1767492840000
Additions	object
Speaker	string	说话人	12
IsKnownVoiceprint	boolean	是否是声纹识别主人公	true
BestVoiceprintScore	number	最高声纹分数	0.6
Gender	string	性别	女
GenderScore	number	性别置信度	0.8
Age	string	年龄	38
AgeGroup	string	年龄段（儿童，中年，老年）	中年
AgeScore	number	年龄段置信度	0.9
Emotion	string	9 种情绪：生气/angry 厌恶/disgusted 恐惧/fearful 开心/happy 中立/neutral 其他/other 难过/sad 惊讶/surprised 未知/unknown	中立/neutral
EmotionScore	number	情绪置信度	0.9
Errors	array<object>	各子发布模块的错误信息，key 是子发布模块，value 是错误信息
	object	错误列表
Code	string	结果代码，200 表示成功，若为别的值则表示失败，调用方可根据此字段判断失败原因。	200
Message	string	出错时表示出错详情，成功时为 successful。	successful
MultiLevelTagResponse	object
TagList	array<object>	子节点列表
	array<object>	标签分析说明
TagName	string	标签名称
Remarks	string	标签分析说明
Children	array<object>	子节点列表
	array<object>	子节点列表
TagName	string	标签名称
Remarks	string	标签分析说明
Children	array<object>	标签分析说明
	array<object>	标签分析说明
TagName	string	标签名称
Remarks	string	标签分析说明
Children	array<object>	标签名称
	array<object>	子节点列表
TagName	string	标签名称
Remarks	string	标签分析说明
Children	array<object>	子节点列表
	object	标签分析说明
TagName	string	标签名称
Remarks	string	标签分析说明
Dialogues	array<object>	对话数据。
	object	对话数据。
Words	string	对话内容	你好有什么可以帮您
Begin	integer	这句话的开始时间相对对话整体开始时间的偏移量，毫秒级，例如录音总时长为 2 分 10 秒，客户的谋一句话是在 1 分 12 秒时开始讲的，1 分 20 秒时讲完，则 begin 的值为 72000，end 的值为 80000。	980
EmotionValue	integer	情绪能量值，取值为音量分贝值/10。取值范围：[1,10]。值越高情绪越强烈。	7
End	integer	这句话的开始时间相对对话整体开始时间的偏移量，毫秒级，例如录音总时长为 2 分 10 秒，客户的谋一句话是在 1 分 12 秒时开始讲的，1 分 20 秒时讲完，则 begin 的值为 72000，end 的值为 80000。	80000
SpeechRate	integer	本句的平均语速，单位：字数/分钟。	200
Role	string	该句话的角色，可能值：客服；客户。	客服
HourMinSec	string	这句话的时分秒格式的开始时间，格式：hh:mm:ss	00:08
Usage	object	Token 使用情况
InputTokens	string	LLM 输入 token 量
OutputTokens	string	LLM 输出 token 量
TotalTokens	string	本次任务累计 token 总数	0
TymxTurboCount	string
TymxPlusCount	string

示例

正常返回示例

JSON格式

{
  "RequestId": "F190ADE9-619A-447D-84E3-7E241A5C428E",
  "Code": "200",
  "Message": "successful",
  "Success": "true",
  "Data": {
    "TaskId": "A6BEC8D-9A5B-4BE5-8432-4F635E***",
    "Vid": "6fa76916-3ce6-45d8-ac64-01b7f31***",
    "LlmRequestId": "106C6CA0-282D-4AF7-85F0-D2D24***",
    "Status": "1",
    "ErrorMessage": "xxxx",
    "Response": {
      "FieldResponse": {
        "FieldVoList": [
          {
            "Name": "phone",
            "Value": "1234561",
            "Remarks": "通过客服第一句话判断",
            "OriginalUtterances": [
              1
            ]
          }
        ]
      },
      "TagCategoryResponse": {
        "TagCategoryVoList": [
          {
            "Dimension": "客户意图",
            "IsMatch": true,
            "ResultLabels": [
              "退货"
            ],
            "Remarks": "通过客服第一句话判断",
            "OriginalUtterances": [
              "1"
            ]
          }
        ]
      },
      "ServiceInspectionResponse": {
        "ServiceInspectionVoList": [
          {
            "Dimension": "服务态度",
            "IsMatch": true,
            "Remarks": "通过客服第一句话判断",
            "OriginalUtterances": [
              "1"
            ]
          }
        ]
      },
      "CustomerPromptResponse": {
        "Text": "175/xl面料摸着很舒服,穿起来看着也挺修身的挺好的好衣服超好看,质量手感没得说一级棒,很满意的一次购物。"
      },
      "VoiceprintResponse": {
        "Dialogue": [
          {
            "Words": "不清楚",
            "Begin": 443,
            "End": 1767492840000,
            "Additions": {
              "Speaker": "12",
              "IsKnownVoiceprint": true,
              "BestVoiceprintScore": 0.6,
              "Gender": "女",
              "GenderScore": 0.8,
              "Age": "38",
              "AgeGroup": "中年",
              "AgeScore": 0.9,
              "Emotion": "中立/neutral",
              "EmotionScore": 0.9
            }
          }
        ],
        "Errors": [
          {
            "Code": "200",
            "Message": "successful"
          }
        ]
      },
      "MultiLevelTagResponse": {
        "TagList": [
          {
            "TagName": "",
            "Remarks": "",
            "Children": [
              {
                "TagName": "",
                "Remarks": "",
                "Children": [
                  {
                    "TagName": "",
                    "Remarks": "",
                    "Children": [
                      {
                        "TagName": "",
                        "Remarks": "",
                        "Children": [
                          {
                            "TagName": "",
                            "Remarks": ""
                          }
                        ]
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      }
    },
    "Dialogues": [
      {
        "Words": "你好有什么可以帮您",
        "Begin": 980,
        "EmotionValue": 7,
        "End": 80000,
        "SpeechRate": 200,
        "Role": "客服",
        "HourMinSec": "00:08"
      }
    ],
    "Usage": {
      "InputTokens": "",
      "OutputTokens": "",
      "TotalTokens": "0",
      "TymxTurboCount": "",
      "TymxPlusCount": ""
    }
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。