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

# Usage

> Monitorea consumo, tokens, costos y estado de las llamadas del tenant

La seccion **Usage** (`thaliq.com/workspace/usage`) muestra el consumo del tenant: resoluciones, requests, tokens, costos estimados y estado de las llamadas.

## Metricas principales

* **Resoluciones** — interacciones cerradas (la unidad de medida del plan)
* **Requests** — total de peticiones al agente
* **Tokens** — input + output consumidos por modelo
* **Costo estimado** — en USD basado en el modelo usado
* **Tasa de exito** — porcentaje de requests `SUCCESS` vs `ERROR` / `RATE_LIMITED`

## Graficas

* **Uso diario** — resoluciones y requests por dia en el periodo
* **Top tools** — las tools mas invocadas
* **Distribucion por modelo** — Haiku vs Sonnet vs Opus en el tenant
* **Distribucion por agente** — cuanto consume cada agente del tenant

## Log de llamadas

Tabla con detalle por llamada (paginada):

| Campo        | Descripcion                        |
| ------------ | ---------------------------------- |
| **Fecha**    | Cuando se hizo la peticion         |
| **Agente**   | Que agente del tenant atendio      |
| **Estado**   | `SUCCESS`, `ERROR`, `RATE_LIMITED` |
| **Modelo**   | Modelo de IA usado                 |
| **Tokens**   | Input + Output                     |
| **Costo**    | USD estimado                       |
| **Tools**    | Tools ejecutadas en esa llamada    |
| **Duracion** | Tiempo de respuesta                |
| **User ID**  | Si se envio `X-User-Id`            |

## Privacidad de los datos

Las metricas de uso **NO** almacenan:

* Prompts ni mensajes del usuario
* Respuestas del agente
* Datos personales (PII)
* Contenido de las tools

Solo se registran **metricas operacionales** (tokens, costos, status, duracion). El contenido conversacional vive aparte (Inbox + DynamoDB) con su propia retencion.

## Retencion por plan

| Plan       |    Retencion de logs    |
| ---------- | :---------------------: |
| Free       |          7 dias         |
| Starter    |          7 dias         |
| Growth     |         30 dias         |
| Scale      |         90 dias         |
| Enterprise | 90+ dias (configurable) |

## Tracking por usuario

Si tu integracion envia el header `X-User-Id`, podes filtrar las metricas por usuario final:

```bash theme={null}
curl -H "X-API-Key: tq_live_xxx" \
     -H "X-User-Id: usr_abc123" \
     https://api.thaliq.com/api/agent/stream?q=Hola
```

| Modo                                | Como llega el `userId`                           |
| ----------------------------------- | ------------------------------------------------ |
| **JWT** (Studio, workspace interno) | Se extrae automaticamente del JWT                |
| **API Key** (Widget / SDK)          | El tenant lo envia explicitamente en `X-User-Id` |

## Stats con LangFuse (interno)

Para el equipo de Thaliq, todas las traces se replican en LangFuse Cloud para debug y observabilidad de LLM. Los tenants no acceden a LangFuse — sus metricas operacionales viven en este Workspace.

## Que sigue

<CardGroup cols={2}>
  <Card title="Inbox" icon="inbox" href="/platform/inbox">
    Atencion en vivo y conversaciones escaladas a humano.
  </Card>

  <Card title="Planes" icon="layers" href="/introduction/plans">
    Limites por plan y como subir.
  </Card>
</CardGroup>