Skip to main content

Tenant

Un tenant es tu organizacion dentro de Thaliq. Todo esta aislado por tenant: agentes, tools, documentos, configuraciones y metricas. Cuando te registras, se crea un tenant automaticamente. Puedes invitar miembros con diferentes roles:
RolPermisos
OwnerControl total del tenant
AdminGestionar configuracion, tools, miembros
EditorCrear/editar tools, documentos, instrucciones
ViewerSolo lectura

Agente

El agente es la IA que interactua con tus usuarios. Esta potenciado por Claude (Anthropic) y se configura con:
  • System prompt: Las instrucciones base que definen su comportamiento
  • Modelo de IA: Claude Haiku (rapido), Sonnet (balanceado) u Opus (mas capaz)
  • Tools: Las acciones que puede ejecutar
  • Documentos: La base de conocimiento (RAG)
  • Instrucciones: Reglas y flujos interactivos
Un solo agente puede atender miles de conversaciones simultaneas.

API Key

Las API Keys autentican las peticiones de tu widget o integracion con Thaliq.
tq_live_xxxxxxxxxxxxxxxxxxxx
  • Se crean desde la plataforma
  • Solo se muestran una vez al crearlas
  • Thaliq almacena unicamente el hash SHA-256 (no la key original)
  • Puedes tener multiples keys activas (ej: una para produccion, otra para staging)

Tools

Las tools son acciones que el agente puede ejecutar durante una conversacion. Hay tres tipos:

Nativas

Tools built-in de Thaliq (ej: buscar documentos RAG).

HTTP

Llaman a cualquier API REST externa que configures (ej: tu API de productos).

MCP

Se conectan a MCP Servers para acceder a sistemas complejos.

Visibilidad de tools

Cada tool tiene una propiedad requiresAuth que controla donde esta disponible:
requiresAuthWidgetSDK / API
falseDisponibleDisponible
trueNo disponibleDisponible
Esto permite que tools que requieren autenticacion del usuario (ej: “ver mis datos”) solo esten disponibles cuando el usuario esta autenticado via SDK.

Instrucciones

Las instrucciones son reglas configurables que modifican el comportamiento del agente. Se compilan en el system prompt y pueden incluir acciones interactivas (Human-in-the-Loop).

Triggers

TriggerCuando se aplica
ALWAYSEn cada conversacion
CONVERSATION_STARTSolo al inicio de una conversacion
INTENTCuando el usuario menciona cierto tema
FALLBACKCuando el agente no sabe que hacer

Acciones interactivas (Human-in-the-Loop)

Las instrucciones pueden requerir interaccion del usuario antes de ejecutar una tool:
TipoDescripcionEjemplo
ConsentCheckbox + Aceptar/Rechazar”¿Aceptas los terminos para procesar tu solicitud?”
ConfirmSi / No”¿Confirmas que quieres agendar la cita?”
SelectElegir entre opciones”¿Que tipo de consulta necesitas?”
FormFormulario con campos”Completa tus datos para continuar”

Documentos (RAG)

El sistema RAG (Retrieval-Augmented Generation) permite subir documentos para que el agente responda basandose en tu informacion:
  1. Subes un documento (PDF, DOCX, TXT, Markdown)
  2. Thaliq lo divide en chunks y genera embeddings con Voyage AI
  3. Cuando un usuario pregunta algo relevante, el agente busca los chunks mas similares
  4. Usa esa informacion como contexto para generar su respuesta

Conversaciones

Cada interaccion crea una conversacion (thread) que mantiene el contexto:
  • Las conversaciones se identifican por un conversationId
  • El widget lo gestiona automaticamente
  • Tienen un session timeout configurable (default: 30 min)
  • Se persisten con TTL segun el plan (7/30/90 dias)

Planes

Thaliq tiene tres planes:
StarterGrowthEnterprise
PrecioGratisContactanosContactanos
Requests/mes50010,000Personalizado
Rate limit5 req/min50 req/minSin limite
Tools HTTPHasta 5IlimitadasIlimitadas
MCP ServersIncluidoIncluido
RAGIncluidoIncluido
SDKIncluidoIncluido
Audit logs7 dias30 dias90+ dias