> ## 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.
# Configurar el agente
> Tabs del agente, identidad, prompt, modelo, temperatura, session timeout
Cada agente vive en `thaliq.com/agents/:agentId` y se configura por tabs. La forma mas rapida de armarlo es desde el [Studio](/platform/studio) — pero todas las pantallas siguen disponibles para edicion fina.
Cada tenant puede tener varios agentes (cantidad segun [plan](/introduction/plans)). Cada agente tiene su propio set de tools, RAG, instrucciones, workflows, canales y credenciales — totalmente aislado del resto.
## Como acceder
1. Iniciar sesion en [thaliq.com/auth/login](https://thaliq.com/auth/login)
2. Ir a **Workspace > Agents**
3. Seleccionar el agente (o **+ Nuevo agente**)
4. Aterrizas en `/agents/:agentId/metrics` por default
## Tabs del agente
| Tab | Ruta | Para que |
| ----------------- | ---------------- | -------------------------------------------------------------------------- |
| **Overview** | `/metrics` | Metricas del agente: actividad, top tools, distribucion por modelo |
| **Prompt** | `/prompt` | System prompt + preview del prompt compilado con secciones e instrucciones |
| **Tools** | `/tools` | HTTP tools, MCP tools, A2A — acciones que el agente puede ejecutar |
| **MCP** | `/mcp` | MCP Servers conectados a este agente |
| **RAG** | `/documents` | Documentos cargados (Growth+) |
| **Instructions** | `/instructions` | Reglas + acciones interactivas (HITL) |
| **Workflows** | `/workflows` | Formularios guiados multi-step |
| **Linked Agents** | `/linked-agents` | A2A: conectar con otros agentes del tenant |
| **Channels** | `/channels` | Widget, SDK, WhatsApp, Telegram |
| **Credentials** | `/credentials` | API keys y access keys de este agente |
| **Settings** | `/settings` | Identidad, modelo, temperatura, idioma, session timeout |
La ruta vieja `/agents/:agentId/api-keys` redirige automaticamente a `/credentials`. La pestaña se renombro porque ahora maneja API keys (`tq_live_`, ofuscadas) **y** access keys (`tq_ak_`, visibles para widget publico).
## Identidad del agente — tab Settings
| Campo | Descripcion |
| ---------------------- | ------------------------------------------------------------------------ |
| **Name** | Nombre interno (visible solo en el workspace) |
| **Slug** | Identificador URL-safe unico dentro del tenant (ej: `soporte`, `ventas`) |
| **Description** | Descripcion corta para humanos |
| **Assistant name** | Nombre publico que el agente usa para presentarse (ej: "Sofia") |
| **Welcome message** | Mensaje inicial que el widget muestra al abrir el chat |
| **Preferred language** | Idioma preferido (`es`, `en`, ...) |
| **Is default** | Marca este agente como default del tenant |
El agente marcado como `default` **no se puede eliminar**. Si querias borrarlo, primero marca otro como default.
## System Prompt — tab Prompt
El **system prompt** es la instruccion base que define la personalidad y reglas del agente. Es lo primero que el modelo lee antes de cada conversacion.
### Buenas practicas
Un buen system prompt hace toda la diferencia. Especifico > generico.
**Incluye:**
* **Rol** — quien es el agente (*"Eres el asistente virtual de MiEmpresa"*)
* **Tono** — formal / casual / tecnico
* **Limites** — que NO debe hacer
* **Contexto** — informacion relevante de tu negocio
* **Formato** — como estructurar las respuestas
**Ejemplo:**
```
Eres el asistente virtual de Clinica Salud. Ayudas a pacientes con
consultas generales, agendar citas y resolver dudas frecuentes.
Reglas:
- Se amable y profesional
- No proporciones diagnosticos medicos
- Si el paciente describe una emergencia, indicale llamar al 911
- Responde siempre en espanol
- Usa listas cuando ayude a la claridad
```
### Preview del prompt compilado
La tab Prompt tiene un boton **Preview** que muestra el prompt **completo** que recibe el modelo, con las secciones inyectadas:
* Identidad (assistant name, idioma, welcome message)
* System prompt custom
* Instrucciones compiladas (por trigger y prioridad)
* Lista de tools disponibles
* Documentos RAG referenciables
Tambien muestra el conteo estimado de tokens.
## Modelo de IA — tab Settings
| Modelo | Velocidad | Capacidad | Disponible en |
| ---------------------------- | :-------: | :-------: | :--------------: |
| Claude Haiku 4.5 *(default)* | Rapida | Buena | Todos los planes |
| Claude Sonnet 4 | Media | Alta | Growth+ |
| Claude Opus 4 | Lenta | Maxima | Scale+ |
**Haiku 4.5 es el default en todos los planes.** Es el balance optimo entre costo, velocidad y calidad para la mayoria de casos.
## Temperatura
Controla la creatividad de las respuestas:
| Valor | Comportamiento | Caso de uso |
| :---: | ------------------------- | -------------------------- |
| 0.0 | Determinista, consistente | FAQs, datos exactos |
| 0.5 | Balanceado | Uso general (default) |
| 1.0 | Creativo, variado | Copywriting, brainstorming |
## Max tokens
Limita la longitud de cada respuesta del agente:
| Valor | Longitud aprox | Caso de uso |
| :---: | :-------------: | --------------------- |
| 256 | \~200 palabras | Respuestas cortas |
| 1024 | \~750 palabras | Uso general |
| 4096 | \~3000 palabras | Respuestas detalladas |
## Session timeout
Tiempo de inactividad antes de cerrar la conversacion y arrancar un thread nuevo.
* **Default:** 30 minutos
* **Bajalo a 10–15 min:** chats transaccionales (FAQ, atencion rapida)
* **Subilo a 60+ min:** acompanamiento largo, soporte tecnico
## Probar cambios
Antes de aplicar cambios en produccion:
1. Ajusta la configuracion
2. Click en **Studio** desde la cabecera del agente
3. En el panel derecho, *Probar agente* — testea distintos mensajes
4. Tambien verifica *Widget Preview* para validar UX final
5. Cuando estes conforme, los cambios ya estan vigentes (no hay deploy manual)
Los cambios aplican **inmediatamente** a todas las conversaciones nuevas. Las conversaciones en curso mantienen la configuracion previa hasta cerrar.
## Que sigue
Construir el agente conversando con el meta-agente.
HTTP, MCP, A2A.
Subir documentos para grounded responses.
API keys y access keys del agente.