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

Lista os threads de um DataAgent especificado, oferece suporte a filtragem por status e ID do thread e retorna resultados paginados.

Descrição da operação

Um thread é um contexto de conversa contínuo para um DataAgent. Um DataAgent pode ter vários threads. Esta operação consulta a lista de threads de um DataAgent específico. Você pode usá-la para retomar threads históricos, continuar conversas inacabadas ou limpar threads desnecessários. Cada thread retornado inclui informações como hora de criação, hora de atualização, status e número da versão. Para recuperar o conteúdo do thread, chame GetThreadData.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

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

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
name	string	Não	O nome do DataAgent. Este parâmetro é passado no caminho da solicitação para especificar o DataAgent cujos threads você deseja listar.	order-analysis-agent

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
nextToken	string	Não	O cursor de paginação. Passe o valor nextToken retornado na resposta anterior para recuperar a próxima página. Você não precisa especificar este parâmetro na primeira consulta.	e81493d42a7d212810e0ac****
maxResults	integer	Não	O número máximo de threads a serem retornados por página. Valor máximo: 200.	20
status	string	Não	Filtra os resultados pelo status do thread. Os valores válidos são os mesmos que os valores de status na resposta, como active.	active
threadId	string	Não	Filtra os resultados pelo ID do thread. Use este parâmetro para consultar um thread específico.	thread-tiirv9-irwdoal8t4rm
includeMission	boolean	Não	Especifica se a resposta deve incluir threads criados automaticamente por missões.	false

A paginação usa o cursor nextToken: passe o valor nextToken retornado na resposta anterior exatamente como está para recuperar a próxima página. Se a resposta não contiver nextToken, todos os resultados foram retornados. O parâmetro status usa correspondência exata. Para valores que não diferenciam maiúsculas de minúsculas, consulte os valores reais retornados.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O corpo da resposta. Retorna uma lista de threads que atendem aos critérios de filtro e informações de paginação.
maxResults	integer	O número real de threads retornados por página nesta consulta. Este valor é igual ao valor maxResults na solicitação.	20
nextToken	string	O cursor de paginação para a próxima página. Este campo não é retornado se não houver mais resultados disponíveis.	e81493d42a7d212810e0ac****
requestId	string	O ID da solicitação. Você pode usar este ID para solucionar problemas e localizar a chamada.	5B0A6B60BB6EE39764D458B5
threadId	string	Um campo reservado para compatibilidade. Este campo normalmente não é retornado. Para obter a lista de threads, leia o campo threads.	thread-tiirv9-irwdoal8t4rm
threads	array<object>	A lista de threads retornada nesta resposta. A lista contém até maxResults threads. Um array vazio é retornado se nenhum thread atender aos critérios de filtro.
	array<object>	As informações sobre um thread.
attributes	object	Os atributos personalizados do thread. Tanto as chaves quanto os valores são strings.
	string	O valor do atributo, que é uma string.	2026-08
createTime	string	A hora em que o thread foi criado. A hora está no formato ISO 8601 com informações de fuso horário.	2026-08-14T10:00:03+08:00
status	string	O status do thread. Os valores comuns incluem active (a conversa pode ser continuada), archived (o thread está arquivado), suspended (o thread está pausado e aguardando entrada adicional), failed (a execução falhou) e cancelled (o thread foi cancelado).	active
threadId	string	O ID do thread. Você pode usar este ID para iniciar uma conversa, ou consultar, modificar ou excluir o thread.	thread-tiirv9-irwdoal8t4rm
title	string	O título do thread. O título é gerado pelo serviço com base no conteúdo da conversa. Você pode modificar o título chamando UpdateThread.	Order volume anomaly investigation
updateTime	string	A hora em que o thread foi atualizado pela última vez. O formato é o mesmo de createTime.	2026-08-14T11:20:35+08:00
variables	object	As variáveis de contexto do thread.
project	string	O nome do projeto do Simple Log Service associado ao thread.	etl-dev
workspace	string	O nome do workspace associado ao thread.	order-workspace
version	integer	O número da versão do thread. Este número indica a sequência em que o thread foi modificado.	3
total	integer	O número total de threads que atendem aos critérios de filtro.	12

Esta operação retorna apenas as informações básicas dos threads. Para recuperar o conteúdo da mensagem em um thread, chame GetThreadData usando o threadId.

Exemplos

Resposta de sucesso

JSON formato

{
  "maxResults": 20,
  "nextToken": "e81493d42a7d212810e0ac****",
  "requestId": "5B0A6B60BB6EE39764D458B5",
  "threadId": "thread-tiirv9-irwdoal8t4rm",
  "threads": [
    {
      "attributes": {
        "key": "2026-08"
      },
      "createTime": "2026-08-14T10:00:03+08:00",
      "status": "active",
      "threadId": "thread-tiirv9-irwdoal8t4rm",
      "title": "订单量异常排查",
      "updateTime": "2026-08-14T11:20:35+08:00",
      "variables": {
        "project": "etl-dev",
        "workspace": "order-workspace"
      },
      "version": 3
    }
  ],
  "total": 12
}

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.