Skip to main content
El widget soporta acciones interactivas (Human-in-the-Loop) que permiten al agente pedir confirmacion, recopilar datos o presentar opciones al usuario antes de ejecutar una tool.

​
Como funciona

  1. El agente intenta ejecutar una tool que tiene una instruccion con accion asociada
  2. En lugar de ejecutar directamente, Thaliq envia un evento action al widget
  3. El widget muestra una tarjeta interactiva al usuario
  4. El usuario responde (acepta, rechaza, selecciona, llena formulario)
  5. El widget envia la respuesta y el agente continua (o se detiene si fue rechazado)
Las acciones se configuran en la plataforma, en la seccion Instrucciones. No requieren codigo adicional en el widget.

​
Tipos de acciones

Requiere que el usuario marque un checkbox y acepte explicitamente. Caso de uso: Aceptar terminos antes de procesar datos personales. El usuario ve:
  • Un mensaje explicativo
  • Un checkbox “Acepto”
  • Botones “Rechazar” / “Aceptar” (habilitado solo con checkbox marcado)

​
Confirm

Pregunta simple de Si/No. Caso de uso: Confirmar antes de agendar una cita o realizar una accion. El usuario ve:
  • Un mensaje con la pregunta
  • Botones “No” / “Si”

​
Select

Presenta opciones para que el usuario elija una. Caso de uso: Elegir el tipo de consulta, seleccionar una categoria. El usuario ve:
  • Un mensaje
  • Lista de opciones (con descripcion opcional)
  • Boton “Confirmar seleccion” (habilitado al elegir una opcion)

​
Form

Formulario dinamico con campos configurables. Caso de uso: Recopilar datos del usuario (nombre, email, telefono) antes de continuar. El usuario ve:
  • Un mensaje
  • Campos de formulario (text, email, number, textarea, select)
  • Indicador de campos requeridos (*)
  • Boton “Enviar” (habilitado cuando todos los campos requeridos estan llenos)

​
Configuracion en el workspace

Las acciones se configuran al crear una instruccion en el detalle del agente:
  1. Ir a Agente > Instructions (thaliq.com/agents/:agentId/instructions)
  2. Crear una nueva instruccion
  3. Asociar la instruccion a una o mas tools
  4. En la seccion Accion, elegir el tipo (consent, confirm, select, form)
  5. Configurar el mensaje, opciones/campos y comportamiento onReject
El agente muestra automaticamente la accion cuando intenta usar esa tool. Mas detalle en Instrucciones.

​
Flujo tecnico

Usuario: "Quiero agendar una cita"
    │
    ▼
Agente: Intenta usar tool "agendar_cita"
    │
    ▼
Backend: Detecta instruccion con action → Emite SSE event "action"
    │
    ▼
Widget: Muestra tarjeta de confirm ("¿Confirmas la cita para mañana 10am?")
    │
    ▼
Usuario: Click "Si"
    │
    ▼
Widget: Re-envia el mensaje con actionResponse
    │
    ▼
Backend: Ejecuta tool "agendar_cita" → Agente responde con resultado

​
Limites por plan

Ver la tabla completa en Planes y limites. Resumen:
PlanInstrucciones maxTipos de accion
Free3Solo consent
Starter5Consent + confirm
Growth15Todos
Scale30Todos
EnterpriseIlimitadasTodos