Skip to main content
Las instrucciones son reglas configurables que modifican el comportamiento del agente. Se compilan automaticamente en el system prompt y pueden incluir acciones interactivas (Human-in-the-Loop) que se renderizan inline en la conversacion.
Las instrucciones son propias de cada agente, no compartidas a nivel tenant. Si tenes varios agentes, cada uno define su propio comportamiento y triggers. Al eliminar un agente sus instrucciones se borran en cascada.

Como llegar

thaliq.com/agents/:agentId/instructions (tab Instructions del agente).

Crear una instruccion

  1. Ir a Agente > Instructions
  2. Click en Crear instruccion
  3. Configurar los campos

Campos basicos

CampoDescripcion
NombreNombre descriptivo (ej: “Saludo inicial”)
ContenidoEl texto que se inyecta en el prompt compilado
TriggerCuando se aplica la instruccion
PrioridadOrden de aplicacion (drag & drop en la lista)
Tools asociadasTools que activan esta instruccion (para acciones HITL)
AccionAccion interactiva opcional (consent, confirm, select, form)

Triggers

TriggerCuando se aplicaEjemplo
ALWAYSEn cada conversacion”Siempre responde en espanol”
CONVERSATION_STARTSolo al inicio”Saluda y pregunta como ayudar”
INTENTCuando detecta un tema especifico”Si pregunta por precios, muestra la tabla de planes”
FALLBACKCuando no sabe que hacer”Si no podes ayudar, sugeri contactar soporte”
Para INTENT, configura la condicion del trigger con una descripcion del tema:
Condicion: "El usuario pregunta sobre precios, planes o costos"

Acciones interactivas (HITL)

Podes asociar una accion a una instruccion para que el agente pida interaccion del usuario antes de ejecutar una tool.
TipoDescripcion
ConsentCheckbox + Aceptar/Rechazar
ConfirmPregunta Si/No
SelectElegir entre opciones
FormFormulario con campos (text, email, number, date, textarea, select)

Renderizado inline

Las acciones aparecen dentro del mismo mensaje del asistente (como un MessagePart), no como un mensaje separado. Asi el usuario ve un solo bloque con texto + accion + tool calls + texto post-resolucion, en orden cronologico:
Assistant message (un solo mensaje con parts):
- text: "Dejame verificar..."
- action: { status: 'accepted', message: 'Autorizar?' }
- tool_call: get_accounts (success)
- text: "Aqui tienes el detalle..."
Cuando el usuario responde, la accion se resuelve inline (pending -> accepted / rejected) y el agente continua el turno en el mismo mensaje.

Comportamiento al rechazar

Cada accion tiene un parametro onReject:
onRejectEfecto
stopPausa la conversacion y la pasa al Inbox para humano
continueContinua sin ejecutar la tool, el agente responde con un texto alternativo

Ejemplo: confirmar antes de agendar

  1. Crear instruccion con trigger INTENT
  2. Condicion: “El usuario quiere agendar una cita”
  3. Asociar la tool agendar_cita
  4. Accion: Confirm con mensaje “Confirmas que queres agendar la cita para manana 10am?”
  5. onReject: continue
Flujo resultante:
Usuario:  Quiero una cita para manana
Agente:   Dejame verificar disponibilidad...
          [Confirm card inline]
          [tool: agendar_cita -> ok]
          Tu cita esta agendada para manana a las 10am
Usuario:  Click "Si" en la card -> "accepted"
Todo eso queda como un solo mensaje del asistente con multiples parts ordenados.

Prioridad y orden

Las instrucciones se aplican en orden de prioridad. Drag & drop en la lista para reordenar. Las de mayor prioridad aparecen primero en el prompt compilado del agente.

Limites por plan

PlanInstrucciones maxTipos de accion
Free3Solo consent
Starter5Consent + confirm
Growth15Todos
Scale30Todos
EnterpriseIlimitadasTodos

Que sigue

Acciones interactivas (widget)

Como se ven las HITL del lado del usuario final.

HITL en el SDK

Manejar acciones con tu propia UI.

Inbox

Que pasa cuando una accion se rechaza con stop.

Workflows

Para flujos multi-step con formulario completo.