> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Threads de conversa em traces

> Agrupe chamadas de LLM relacionadas em threads para observabilidade e análise. Threads são um mecanismo de rotulagem e não armazenam nem injetam histórico de mensagens.

Consulte [URLs e autenticação HTTP](/docs/pt-BR/reference/base-urls.md) e a referência da API para os formatos completos de solicitação e resposta.

Threads agrupam chamadas relacionadas do [AI Gateway](/docs/pt-BR/ai-gateway/using-the-router.md) em uma única visualização de conversa, permitindo rastrear interações de vários turnos entre seus Deployments e Agents.

## Visualizar Threads

Abra **Threads** na seção **Observability** da barra lateral. Cada linha é um thread:

| Coluna | Mostra |
| - | - |
| **Timestamp** | Quando o thread foi atualizado pela última vez. |
| **Project** | O projeto ao qual o thread pertence. |
| **Title** | O título do thread. |
| **ID** | O ID externo registrado para o thread. |
| **Tags** | As tags associadas ao thread. |
| **Total Cost** | O custo de todos os traces do thread. |
| **Total Tokens** | Os tokens de todos os traces do thread. |
| **# of Traces** | Quantos traces o thread agrupa. |

O botão de intervalo mostra **30 days** por padrão. **Filter** restringe a lista por **Kind**, **Conversation** ou **Coding agent**, e por **Tags**. Leia a mesma lista pela API com [List trace threads](/docs/pt-BR/reference/threads/list-trace-threads.md).

Ao selecionar um **Thread**, você pode visualizar a conversa.

Deployment

## Adicionar uma geração a um Thread

Os **Threads** são configurados em tempo de execução ao usar a API Invoke para Deployments ou ao invocar um Agent.

A API recebe o seguinte parâmetro adicional:

> As conversas serão agrupadas pelo ID do Thread
>
> As tags podem ser usadas para filtrar e pesquisar Threads no painel.

```json JSON theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "thread": {
  "id": "<unique-thread-id>",
    "tags": ["tag1", "tag2"]
  }
}
```

> [tab] AI Gateway
>
> ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl --request POST \
> --url 'https://router.toqan.ai/eu/v3/router/responses' \
> -H 'Authorization: Bearer <insert Toqan API key>' \
> -H 'Content-Type: application/json' \
> --data '{
>   "model": "openai/gpt-4.1-mini",
>   "input": "Hello!",
>   "thread": { "id": "<unique-thread-id>", "tags": ["tag1", "tag2"] }
> }'
> ```

> [card] [Gerenciamento de Threads no AI Gateway](/docs/pt-BR/ai-gateway/thread-management.md)
>
> Referência completa da API para associar threads às invocações de Deployments e Agents do **AI Gateway**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.