GetThreadData - Simple Log Service: Central de Documentação do Alibaba Cloud

Obtém os dados de conversação de uma sessão especificada e retorna as mensagens geradas em cada turno em ordem cronológica com paginação.

Descrição da operação

Os dados da sessão são organizados por turnos de conversação no campo data. Cada elemento corresponde a um turno de conversação, contendo as mensagens geradas nesse turno, bem como o ID da solicitação e o ID do Tracing Analysis que iniciaram o turno. A estrutura da mensagem é consistente com as mensagens retornadas na resposta de streaming do CreateChat. Você pode usar callId e parentCallId para reverter a hierarquia de execução do agente, usar contents para obter o conteúdo de texto, usar events para rastrear alterações de status do nó e usar tools e agents para entender o procedimento de execução. Para sessões longas, você deve ler os dados página por página usando nextToken.

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

log:GetThreadData

get

*DataAgent

acs:log:{#regionId}:{#accountId}:dataagent/{#name}/thread/{#threadId}

Nenhuma

Sintaxe da solicitação

GET /dataagents/{name}/threads/{threadId}/data HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
name	string	Não	O nome do DataAgent. É passado no caminho da solicitação para especificar o DataAgent ao qual a sessão pertence.	order-analysis-agent
threadId	string	Não	O ID da sessão a ser consultada. É passado no caminho da solicitação e retornado por CreateThread.	thread-tiirv9-irwdoal8t4rm

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
nextToken	string	Não	O cursor de paginação. Passe o nextToken retornado na resposta anterior para obter a próxima página. Este parâmetro não é obrigatório para a primeira consulta.	e81493d42a7d212810e0ac****
maxResults	integer	Não	O número de turnos de conversação a serem retornados por página. Valor máximo: 100.	20

Para a primeira consulta, você só precisa passar name e threadId no caminho. Para ler a próxima página, passe o nextToken da resposta anterior como um parâmetro de consulta exatamente como está. Se maxResults não for especificado, o número padrão de itens por página será usado.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O corpo da resposta. Retorna os dados de conversação e as informações de paginação da sessão.
data	array<object>	Os dados da sessão retornados na solicitação atual. Os dados são paginados e retornados em ordem cronológica das conversações.
	array<object>	Os dados de um turno de conversação.
messages	array<object>	A lista de mensagens geradas no turno de conversação atual, incluindo entradas do usuário, respostas do agente, invocações de ferramentas e eventos de status.
	array<object>	Uma mensagem.
agents	array<object>	A lista de chamadas de subagentes iniciadas na mensagem atual. Este campo pode aparecer apenas quando role está definido como assistant.
	object	As informações sobre uma chamada de subagente.
	any	Os detalhes das invocações de subagentes. Os campos comuns incluem name (o nome do subagente), arguments (os parâmetros de entrada para a invocação atual) e status (o status de execução: start, progress, success ou fail).	search_data
artifacts	array<object>	A lista de artefatos (arquivos) gerados pela mensagem atual. Este campo pode aparecer apenas quando role está definido como assistant.
	object	Um artefato.
	any	Os detalhes dos artefatos. Os campos comuns incluem name (o nome do artefato) e path (o caminho do artefato). Você pode chamar operações como ListArtifacts e GetArtifact para recuperar os arquivos gerados.	report.md
callId	string	O ID de chamada da execução atual. As mensagens que usam este valor como parentCallId são suas mensagens subordinadas. Este campo pode ser usado para reconstruir a hierarquia de execução do agente.	call_0fdabe9ba7c645a7a6cbf34f
contents	array<object>	A lista de conteúdos na mensagem atual.
	object	Um bloco de conteúdo.
	any	Os detalhes do conteúdo. Os campos comuns incluem type e value. Se type for text, value é o trecho de texto da resposta. Se type for spin_text, value é o prompt para o processo de raciocínio e execução do agente. Se type for thread_title_updated, value é o título da conversa atualizado. Se type for error, value é a mensagem de erro que contém code e message. Durante a saída em streaming, os marcadores append (se é um trecho incremental) e lastChunk (se é o último chunk) também são incluídos.	text
detail	string	A descrição suplementar da mensagem atual, como a descrição da ação que está sendo executada no momento.	Analyzing query conditions
events	array<object>	A lista de eventos transportados na mensagem atual, que indica as alterações no status da sessão. Os tipos comuns incluem: thinking (o agente está pensando), interactive (é necessária entrada ou confirmação adicional de você), task_finished (o nó atual foi concluído e o payload contém informações de status de sucesso e estatísticas), stream_done (a saída de streaming atual foi concluída), error (ocorreu um erro de execução) e thread_title_updated (o título da sessão foi atualizado).
	object	Um evento.
	any	Os detalhes dos eventos. Os campos comuns incluem type (o tipo de evento) e payload (os dados do evento, cuja estrutura varia dependendo do tipo de evento).	task_finished
parentCallId	string	O ID da chamada pai, que é usado para reconstruir a hierarquia de execução. Uma string vazia indica o nó raiz da sessão atual.	thread-tiirv9-irwdoal8t4rm
role	string	O remetente da mensagem. Valores válidos: assistant (a resposta ou ação do agente), tool (o resultado da execução de uma ferramenta), user (a entrada do usuário) e system (uma mensagem do sistema).	assistant
seq	integer	O número de sequência da mensagem. Ele é incrementado dentro da mesma sessão e pode ser usado para classificar mensagens no mesmo nível. Recomendamos que você também consulte o timestamp e não dependa estritamente deste valor.	1
timestamp	string	A hora em que a mensagem foi gerada. É um timestamp UNIX no formato de string.	1765289000
tools	array<object>	A lista de invocações de ferramentas iniciadas pelo agente na mensagem atual. Este campo pode aparecer apenas quando role está definido como assistant.
	object	Uma invocação de ferramenta.
	any	Os detalhes das invocações de ferramentas. Os campos comuns incluem name (o nome da ferramenta), arguments (os parâmetros de entrada), status (o status do estágio de execução: start, success ou fail), state (o resultado da execução: success ou fail) e contents (o conteúdo de saída da ferramenta).	get_current_time
type	string	O tipo de mensagem. As mensagens de resposta regulares podem não ter este campo. Ele aparece quando a mensagem inteira é usada para expressar um status. Por exemplo, done indica que a sessão foi encerrada e error indica uma mensagem de erro.	done
version	string	O número da versão da estrutura da mensagem. Valor atual: v0.1.0.	v0.1.0
requestId	string	O ID da solicitação que gerou o turno de conversação atual. Pode ser usado para associar a chamada CreateChat que iniciou o turno.	5B0A6B60BB6EE39764D458B5
traceId	string	O ID do Tracing Analysis do turno de conversação atual. É usado para localizar a invocação atual durante a solução de problemas.	88b50db22437400fa9c16c5399722310
maxResults	integer	O número real de itens por página que entra em vigor na solicitação atual.	20
nextToken	string	O cursor para a próxima página. Se este campo não for retornado, indica que a última página foi alcançada. Passe este valor como nextToken na solicitação para obter a próxima página.	e81493d42a7d212810e0ac****
requestId	string	O ID da solicitação atual. É usado para localizar a chamada atual durante a solução de problemas.	5B0A6B60BB6EE39764D458B5
threadId	string	O ID da sessão para a consulta atual. É o mesmo que o threadId passado no caminho da solicitação.	thread-tiirv9-irwdoal8t4rm

O exemplo de estrutura dos dados para um turno de conversação:

{
  "requestId": "1B2E6A9D-8C4F-4E2A-9E7D-3F5A6B7C8D9E",
  "threadId": "thread-tiirv9-irwdoal8t4rm",
  "maxResults": 20,
  "nextToken": "e81493d42a7d212810e0ac****",
  "data": [
    {
      "requestId": "2C3F7B0E-9D5A-4F3B-8E1C-4A6B7C8D9E0F",
      "traceId": "88b50db22437400fa9c16c5399722310",
      "messages": [
        {
          "role": "assistant",
          "callId": "thread-tiirv9-irwdoal8t4rm",
          "parentCallId": "",
          "seq": 4,
          "timestamp": "1765289004",
          "version": "v0.1.0",
          "contents": [
            { "type": "text", "value": "The URL with the highest number of requests in the last hour is...", "append": true, "lastChunk": true }
          ]
        }
      ]
    }
  ]
}

Exemplos

Resposta de sucesso

JSON formato

{
  "data": [
    {
      "messages": [
        {
          "agents": [
            {
              "key": "search_data"
            }
          ],
          "artifacts": [
            {
              "key": "report.md"
            }
          ],
          "callId": "call_0fdabe9ba7c645a7a6cbf34f",
          "contents": [
            {
              "key": "text"
            }
          ],
          "detail": "Analyzing query conditions",
          "events": [
            {
              "key": "task_finished"
            }
          ],
          "parentCallId": "thread-tiirv9-irwdoal8t4rm",
          "role": "assistant",
          "seq": 1,
          "timestamp": "1765289000",
          "tools": [
            {
              "key": "get_current_time"
            }
          ],
          "type": "done",
          "version": "v0.1.0"
        }
      ],
      "requestId": "5B0A6B60BB6EE39764D458B5",
      "traceId": "88b50db22437400fa9c16c5399722310"
    }
  ],
  "maxResults": 20,
  "nextToken": "e81493d42a7d212810e0ac****",
  "requestId": "5B0A6B60BB6EE39764D458B5",
  "threadId": "thread-tiirv9-irwdoal8t4rm"
}

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.