Workflows

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

Caso	Mejor opcion
El agente necesita confirmar una accion puntual	Instruccion con accion HITL
El agente necesita una decision Si/No o eleccion entre opciones	Instruccion 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

Campo	Descripcion
Nombre	Identificador del workflow (ej: “Alta de cliente”)
Description	Descripcion para humanos
Trigger Intent	Frase descriptiva del intent que dispara el workflow (ej: “el usuario quiere registrarse”)
Steps	Lista ordenada de pasos
Completion tool	Tool que se invoca al final con los datos recolectados
Output schema	Mapeo de campos del workflow a parametros de la completion tool
Confirm before submit	Si pide confirmacion al usuario antes de invocar la completion tool
Success message	Mensaje que el agente muestra al cerrar exitosamente
Priority	Orden vs otros workflows del mismo agente

Tipos de step

`fieldType`	Que hace
`text`	Pregunta texto libre
`email`	Pregunta email con validacion de formato
`phone`	Pregunta telefono
`number`	Pregunta numero
`date`	Pregunta fecha
`textarea`	Pregunta texto largo
`select`	Presenta opciones (`options[]`)
`tool_call`	Invoca una tool en medio del flujo (`toolId`, `toolInputMapping`, `storeResultAs`)
`display`	Muestra 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).

Campo	Descripcion
`toolId`	Tool a invocar
`toolInputMapping`	Mapeo `{ paramName: fieldName }` desde campos previos
`storeResultAs`	Nombre de variable para usar el resultado en steps siguientes
`onError`	`continue`, `stop`, `retry`
`onErrorMessage`	Mensaje al usuario si la tool falla
`resultTemplate`	Template 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

Plan	Workflows max
Free	0
Starter	3
Growth	10
Scale	30
Enterprise	Ilimitados

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).

Empezar

Workspace

Construir un agente

Widget

Ejemplos

Cuando usar workflows vs instrucciones HITL

Como llegar

Anatomia de un workflow

Tipos de step

Step tool_call

Ejemplo: alta de cliente

Limites por plan

Buenas practicas

Que sigue

Tools

Instrucciones

​Cuando usar workflows vs instrucciones HITL

​Como llegar

​Anatomia de un workflow

​Tipos de step

​Step tool_call

​Ejemplo: alta de cliente

​Limites por plan

​Buenas practicas

​Que sigue

Tools

Instrucciones

Cuando usar workflows vs instrucciones HITL

Como llegar

Anatomia de un workflow

Tipos de step

Step tool_call

Ejemplo: alta de cliente

Limites por plan

Buenas practicas

Que sigue