GetThreadData - STAROps: Central de Documentação do Alibaba Cloud

Obtém dados de sessão.

Descrição da operação

Obtém dados de sessão.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

starops:GetThreadData

get

*DigitalEmployee

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

Nenhuma

Sintaxe da solicitação

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

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
name	string	Sim	O nome do funcionário digital.	test
threadId	string	Sim	O identificador exclusivo do thread.	thread_id01

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
nextToken	string	Não	O cursor de paginação.	xxxxxxxxxx
maxResults	integer	Não	O número máximo de entradas de sessão a retornar. O valor máximo é 100.	10

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema de resposta.
maxResults	integer	O número máximo de resultados a retornar.	2
data	array<object>	Os dados da mensagem.
	array<object>	Um contêiner para mensagens e metadados de um único rastreamento de solicitação.
traceId	string	O ID exclusivo que identifica o rastreamento completo de uma solicitação.	3b5287b717636040171772050d0095
requestId	string	O ID da solicitação original que gerou esta mensagem.	8FDE2569-626B-5176-9844-28877A*****
messages	array<object>	Uma lista de mensagens no thread.
	array<object>	A estrutura de um objeto de mensagem.
version	string	The message data version.	v0.1.0
parentCallId	string	The parent call ID.	3b5287b7176360
callId	string	The current call ID.	3b5287b7176360
role	string	The role that initiates the message.	user
seq	integer	The sequence number of the message.	0
timestamp	string	The message creation time in nanoseconds since the Unix epoch.	1768702985000000000
type	string	The message type.	task_finished
detail	string	The message details.	context of model exceed
contents	array<object>	The contents of the message.
	object	The structure of a content item.	{ "append": false, "lastChunk": false, "type": "text", "value": "result output chunk" }
tools	array<object>	A list of tools used to generate the message.
	object	The structure of a tool 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>	A list of called agents.
	object	The structure of an agent object.	{ "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>	A list of events.
	object	The structure of an event object.	{ "payload": { "error": { "code": "TASK_FAILED", "message": "Invalid task parameter", "suggestion": "" }, "statistics": { "duration": 300000 }, "success": false }, "type": "task_finished" }
artifacts	array<object>	A list of generated artifacts.
	object	The structure of an artifact 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	O token para recuperar a próxima página de resultados. Se este parâmetro não for retornado, não há mais resultados.	xxxxxxxxx
requestId	string	O ID exclusivo desta solicitação da API GetThreadData.	8FDE2569-626B-5176-9844-28877A*****
threadId	string	O ID exclusivo do thread.	thread_id01
digitalEmployeeName	string	O nome do funcionário digital atual.	test

Exemplos

Resposta de sucesso

JSON formato

{
  "maxResults": 2,
  "data": [
    {
      "traceId": "3b5287b717636040171772050d0095\n",
      "requestId": "8FDE2569-626B-5176-9844-28877A*****\n",
      "messages": [
        {
          "version": "v0.1.0\n",
          "parentCallId": "3b5287b7176360",
          "callId": "3b5287b7176360",
          "role": "user",
          "seq": 0,
          "timestamp": "1768702985000000000",
          "type": "task_finished",
          "detail": "context of model exceed\n",
          "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*****\n",
  "threadId": "thread_id01",
  "digitalEmployeeName": "test"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.