Skip to main content

​
Tenant

Un tenant es tu organizacion dentro de Thaliq. Todo esta aislado por tenant: agentes, tools, documentos, conversaciones, metricas y miembros. Al registrarte se crea un tenant automaticamente y vos sos el OWNER. Despues podes invitar miembros con distintos roles desde el Workspace > Team.
RolPermisos
OwnerControl total del tenant
AdminConfiguracion, tools, miembros
SupervisorDashboard + Inbox + Conversations + Usage. Asigna y reasigna conversaciones
AgentAtiende conversaciones humanas desde el Inbox (solo ve las asignadas)
EditorCrear/editar tools, documentos, instrucciones
ViewerSolo lectura

​
Workspace

El workspace (thaliq.com/workspace) es la consola del tenant. Reune los espacios cross-agente:
SeccionURLPara que
Dashboard/workspace/dashboardVision general y actividad reciente
Agents/workspace/agentsLista de agentes — punto de entrada al detalle de cada uno
Inbox/workspace/inboxConversaciones con intervencion humana (HITL)
Usage/workspace/usageConsumo, tokens, costos
Settings/workspace/settingsPlan, billing, perfil del tenant
Team/workspace/teamMiembros e invitaciones
API & SDK/workspace/api-sdkDocumentacion y herramientas de integracion

​
Agentes

Un agente es una IA configurable que conversa con tus usuarios. Cada agente tiene su propio set de tools, documentos, instrucciones, workflows y credenciales — completamente aislado del resto del tenant. Cada tenant puede tener varios agentes (cantidad segun plan). Uno de ellos esta marcado como default del tenant: las API keys sin agente especifico le rutean a el.

​
Anatomia de un agente

Cada agente vive en thaliq.com/agents/:agentId y se configura por tabs:
TabQue hace
OverviewMetricas y actividad del agente
PromptSystem prompt y compilacion (con preview de tokens)
ToolsHTTP, MCP, A2A — acciones que puede ejecutar
MCPMCP Servers conectados a este agente
RAGDocumentos que alimentan respuestas con tu informacion
InstructionsReglas y acciones interactivas (HITL)
WorkflowsFormularios guiados multi-step
Linked AgentsConexion A2A con otros agentes del tenant
ChannelsWidget, SDK, WhatsApp, Telegram, Slack (soon)
CredentialsAPI keys y access keys de este agente
SettingsIdentidad, modelo, temperatura, idioma, session timeout

​
Routing automatico

Cada API Key puede asociarse a un agente especifico:
KeyAsociada aComportamiento
tq_live_aaaAgente “Soporte”Las requests con esta key van al agente Soporte
tq_live_bbbAgente “Ventas”Las requests con esta key van al agente Ventas
tq_live_ccc(ninguno)Caen al agente default del tenant
Override por request: podes pasar agentId en el body (POST /chat) o como query param (GET /stream) para forzar un agente distinto al de la key. 
// Widget asociado a un agente especifico
ThaliqWidget.init({
  apiKey: 'tq_live_xxx',  // si la key esta bindeada a un agente, se usa ese
  agentId: 'agent_uuid',  // override explicito (opcional)
});

​
API Keys y Access Keys

Las credenciales autentican las peticiones desde tu integracion:
TipoPrefijoVisibilidadUso tipico
API Keytq_live_ / tq_test_Solo se ve al crear (hash SHA-256 en backend)SDK, integraciones server-side
Access Keytq_ak_Visible siempre desde el workspaceWidget publico, snippets que viven en HTML
Mas detalle en Credentials.

​
Tools

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

Nativas

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

HTTP

Llaman a cualquier API REST que configures (tu API de productos, pedidos, etc.).

MCP

Importadas desde MCP Servers, ideales para sistemas estandarizados.

A2A (Agent-to-Agent)

Otro agente del tenant aparece como una tool ask_<slug> invocable.

​
Visibilidad de tools

Cada tool tiene requiresAuth que controla donde esta disponible:
requiresAuthWidgetSDK / API
falseDisponibleDisponible
trueNo disponibleDisponible
Esto permite que tools que requieren auth del usuario final (“ver mis pedidos”) solo aparezcan via SDK con identidad de usuario.

​
Instrucciones

Las instrucciones son reglas configurables que 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
INTENTCuando el usuario menciona cierto tema
FALLBACKCuando el agente no sabe que hacer

​
Acciones interactivas (Human-in-the-Loop)

TipoDescripcion
ConsentCheckbox + Aceptar/Rechazar
ConfirmPregunta Si/No
SelectElegir entre opciones
FormFormulario con campos
Las acciones se renderizan inline dentro del mensaje del asistente (como un MessagePart), no como un mensaje aparte.

​
Workflows

Un workflow es un formulario guiado multi-step. El agente conduce al usuario por pasos secuenciales (texto, email, telefono, fecha, select, tool_call, display) hasta cerrar con una tool de submit. Util para: agendamiento, alta de cliente, ticket de soporte estructurado, cotizacion guiada.

​
Documentos (RAG)

El sistema RAG 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 el usuario pregunta algo relevante, el agente busca los chunks mas similares
  4. Usa esa info como contexto para generar una respuesta precisa
Los documentos son propios de cada agente — el RAG del agente “Soporte” no es visible al agente “Ventas”.

​
Conversaciones

Cada interaccion crea una conversacion (thread) que mantiene contexto:
  • Identificada por conversationId
  • El widget la gestiona automaticamente
  • Session timeout configurable por agente (default 30 min)
  • Se persisten en DynamoDB con TTL segun el plan

​
Canales

Cada agente puede activar varios canales en paralelo:
  • Widget — chat embebible en sitios web (built-in, siempre disponible)
  • SDK — libreria headless para apps con auth
  • WhatsApp Business — atencion conversacional via WhatsApp
  • Telegram — bot conectado al agente con setup guiado
  • Slack · Email · Voice — en roadmap
Configuras cada canal desde la tab Channels del agente.

​
Planes

Thaliq tiene cinco niveles de plan. Los limites estan en Planes.