Skip to main content

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.

Un workflow es un flujo guiado por pasos secuenciales. El agente le pregunta al usuario en orden los datos que necesita (text, email, telefono, fecha, select, etc.), opcionalmente ejecuta tools en el medio para validar/enriquecer, y al final cierra con una tool de submit que persiste o procesa el resultado.
Disponible desde Starter.

​
Cuando usar workflows vs instrucciones HITL

CasoMejor opcion
El agente necesita confirmar una accion puntualInstruccion con accion HITL
El agente necesita una decision Si/No o eleccion entre opcionesInstruccion con accion confirm / select
El agente necesita multiples campos en orden (alta de cliente, ticket detallado, cotizacion)Workflow
El flujo tiene que hacer un tool_call en medio (validar codigo postal, buscar producto)Workflow con step tool_call

​
Como llegar

thaliq.com/agents/:agentId/workflows (tab Workflows del agente).

​
Anatomia de un workflow

CampoDescripcion
NombreIdentificador del workflow (ej: “Alta de cliente”)
DescriptionDescripcion para humanos
Trigger IntentFrase descriptiva del intent que dispara el workflow (ej: “el usuario quiere registrarse”)
StepsLista ordenada de pasos
Completion toolTool que se invoca al final con los datos recolectados
Output schemaMapeo de campos del workflow a parametros de la completion tool
Confirm before submitSi pide confirmacion al usuario antes de invocar la completion tool
Success messageMensaje que el agente muestra al cerrar exitosamente
PriorityOrden vs otros workflows del mismo agente

​
Tipos de step

fieldTypeQue hace
textPregunta texto libre
emailPregunta email con validacion de formato
phonePregunta telefono
numberPregunta numero
datePregunta fecha
textareaPregunta texto largo
selectPresenta opciones (options[])
tool_callInvoca una tool en medio del flujo (toolId, toolInputMapping, storeResultAs)
displayMuestra info al usuario sin pedir input (displayTemplate)

​
Step tool_call

Permite ejecutar una tool en el medio del workflow. Util para validar (codigo postal -> ciudad), enriquecer (DNI -> datos del cliente) o consultar (precio del producto antes de cerrar pedido).
CampoDescripcion
toolIdTool a invocar
toolInputMappingMapeo { paramName: fieldName } desde campos previos
storeResultAsNombre de variable para usar el resultado en steps siguientes
onErrorcontinue, stop, retry
onErrorMessageMensaje al usuario si la tool falla
resultTemplateTemplate para mostrar el resultado al usuario (con variables {{var}})

​
Ejemplo: alta de cliente

Step 1 (text)        -> name = "Cual es tu nombre completo?"
Step 2 (email)       -> email = "Cual es tu email?"
Step 3 (phone)       -> phone = "Cual es tu telefono?"
Step 4 (select)      -> country = "Pais? [Peru, Mexico, Argentina]"
Step 5 (tool_call)   -> validate_email (toolInputMapping: { email })
                        storeResultAs: emailValid
Step 6 (display)     -> "Email validado: {{emailValid.message}}"
Step 7 (date)        -> birthdate = "Fecha de nacimiento?"
Completion tool      -> create_customer
                        outputSchema: { name, email, phone, country, birthdate }
Confirm before submit: true
Success message: "Cliente {{name}} creado correctamente."

​
Limites por plan

PlanWorkflows max
Free0
Starter3
Growth10
Scale30
EnterpriseIlimitados

​
Buenas practicas

  • Pasos atomicos — un campo por step, no combines varios datos en un mismo prompt
  • Validacion temprana — pone los tool_call apenas tengas los datos necesarios, no al final
  • Mensajes de error claros — onErrorMessage debe explicar como corregir, no solo decir “fallo”
  • Confirm antes de submit — si el flujo crea registros o cobra, siempre pide confirmacion final
  • Trigger Intent especifico — describe el intent en la voz del usuario, no en la del agente

​
Que sigue

Tools

La tool de submit y las tools que usas en tool_call steps.

Instrucciones

Para confirmaciones y consents puntuales (no formularios).