调用GetThreadData接口获取数字员工的会话数据-云监控-阿里云

获取会话数据。

接口说明

获取会话数据

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

cms:GetThreadData

get

*DigitalEmployee

acs:cms:{#regionId}:{#accountId}:digitalemployee/{#name}/thread/{#threadId}

无

请求语法

GET /digitalEmployee/{name}/thread/{threadId}/data HTTP/1.1

路径参数

名称	类型	必填	描述	示例值
name	string	是	数字员工名称	test
threadId	string	是	会话 id	thread_id01

请求参数

名称	类型	必填	描述	示例值
nextToken	string	否	分页游标。	xxxxxxxxxx
maxResults	integer	否	返回会话数据最大数据，最大值:100	1

返回参数

名称	类型	描述	示例值
	object	Schema of Response
maxResults	integer	最大结果数量	1
data	array<object>	消息数据
	array<object>	消息数据
traceId	string	当前 message 请求的 id 数据根数据中第一个追踪 ID	3b5287b717636040171772050d0095
requestId	string	当前 message 请求的 id 数据根数据中第一个 RequestID	8FDE2569-626B-5176-9844-28877A*****
messages	array<object>	会话的消息列表
	array<object>	消息数据明细结构
version	string	消息数据的版本号	v0.1.0
parentCallId	string	上一层级执行 ID	3b5287b7176360
callId	string	当前执行 ID	3b5287b7176360
role	string	消息发起角色	user
seq	integer	消息序列号	0
timestamp	string	timestamp / 纳秒	1768702985000000000
type	string	消息具体类型	task_finished
detail	string	消息明细	context of model exceed
contents	array<object>	内容信息
	object	内容信息明细结构	{ "append": false, "lastChunk": false, "type": "text", "value": "result output chunk" }
tools	array<object>	工具使用列表
	object	工具明细结构	{ "arguments": { "confidence": "high", "intent": "analyser", "is_new_turn": true, "language": "en", "title": "Root Cause of Alert" }, "id": "IntentRecognition", "name": "IntentRecognition", "status": "start", "toolCallId": "019bc1cb-adad" }
agents	array<object>	调用的 Agent 列表
	object	调用的 Agent 详细内容	{ "callId": "019bc1cb-adad", "id": "analyser", "inputs": [ { "append": false, "lastChunk": false, "type": "text", "value": "Analyze this trace: TraceID=xxx" } ], "name": "analyser", "status": "start" }
events	array<object>	事件列表
	object	事件详细内容	{ "payload": { "error": { "code": "TASK_FAILED", "message": "Invalid task parameter", "suggestion": "" }, "statistics": { "duration": 300000 }, "success": false }, "type": "task_finished" }
artifacts	array<object>	产物产出信息
	object	产物明细的结构	{ "artifactId": "019bc1cb-9600-703axxx", "name": "sql output", "description": "sql generation task result", "extensions": ["sql_generation_tool", "sql_diagnosis"], "metadata": { "model": "qwen3-coder-plus" }, "parts": [ { "text": "select * from table", "kind": "text" } ] }
nextToken	string	分页游标。	xxxxxxxxx
requestId	string	Id of the request	8FDE2569-626B-5176-9844-28877A*****
threadId	string	会话 id	thread_id01
digitalEmployeeName	string	数字员工名称	test

示例

正常返回示例

JSON格式

{
  "maxResults": 1,
  "data": [
    {
      "traceId": "3b5287b717636040171772050d0095",
      "requestId": "8FDE2569-626B-5176-9844-28877A*****",
      "messages": [
        {
          "version": "v0.1.0",
          "parentCallId": "3b5287b7176360",
          "callId": "3b5287b7176360",
          "role": "user",
          "seq": 0,
          "timestamp": "1768702985000000000",
          "type": "task_finished",
          "detail": "context of model exceed",
          "contents": [
            {
              "append": false,
              "lastChunk": false,
              "type": "text",
              "value": "result output chunk"
            }
          ],
          "tools": [
            {
              "arguments": {
                "confidence": "high",
                "intent": "analyser",
                "is_new_turn": true,
                "language": "en",
                "title": "Root Cause of Alert"
              },
              "id": "IntentRecognition",
              "name": "IntentRecognition",
              "status": "start",
              "toolCallId": "019bc1cb-adad"
            }
          ],
          "agents": [
            {
              "callId": "019bc1cb-adad",
              "id": "analyser",
              "inputs": [
                {
                  "append": false,
                  "lastChunk": false,
                  "type": "text",
                  "value": "Analyze this trace: TraceID=xxx"
                }
              ],
              "name": "analyser",
              "status": "start"
            }
          ],
          "events": [
            {
              "payload": {
                "error": {
                  "code": "TASK_FAILED",
                  "message": "Invalid task parameter",
                  "suggestion": ""
                },
                "statistics": {
                  "duration": 300000
                },
                "success": false
              },
              "type": "task_finished"
            }
          ],
          "artifacts": [
            {
              "artifactId": "019bc1cb-9600-703axxx",
              "name": "sql output",
              "description": "sql generation task result",
              "extensions": [
                "sql_generation_tool",
                "sql_diagnosis"
              ],
              "metadata": {
                "model": "qwen3-coder-plus"
              },
              "parts": [
                {
                  "text": "select * from table",
                  "kind": "text"
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "nextToken": "xxxxxxxxx",
  "requestId": "8FDE2569-626B-5176-9844-28877A*****",
  "threadId": "thread_id01",
  "digitalEmployeeName": "test"
}

错误码

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

变更历史

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