Una AI Function le permite a un AI Agent hacer algo fuera de la conversación: guardar los datos del usuario, consultar otro sistema o reservar un turno. El agente decide cuándo llamar a la función, le pide al usuario los valores que necesita y corre un workflow con ellos. El workflow puede devolverle un resultado al agente para que la conversación siga con esa información.
Crear una AI Function
- En tu bot, ve a AI Hub → AI Functions y haz clic en + AI Function.
- Ponle un nombre y una descripción. La descripción le dice al agente qué hace la función y cuándo usarla. Por ejemplo: “Esta función guarda el nombre, el apellido y el email del usuario. El agente tiene que validar el formato del email si el usuario da uno inválido”.
- Escribe el prompt de la función: qué tiene que hacer, los pasos, las restricciones y las condiciones. Haz clic en Generate para armar una primera versión a partir de la descripción y los parámetros, y después revísala y ajústala.
- Agrega los parámetros que la función tiene que juntar, como nombre, apellido y email. En cada uno:
- Name y Description: qué es el valor, para que el agente sepa qué pedir.
- Required: la función no corre hasta que el agente tenga este valor.
- Memory: el agente revisa primero el historial de la conversación. Si el usuario ya dio el valor, no lo vuelve a pedir y pasa al parámetro siguiente.
- Save value to: el custom field donde se guarda el valor.
- En Trigger workflow, elige el workflow que corre cuando se llama a la función. Solo se pueden asociar workflows.
- Guarda la AI Function.
Una regla útil para sumar al prompt de la función: “Pide cada dato del usuario por separado, y llama a la función solo cuando tengas todos los parámetros”.
Qué puede hacer el workflow
El workflow recibe los valores que juntó el agente. A partir de ahí puedes:
- Mandarlos a otra plataforma con una integración nativa, como Google Sheets, o con un External Request.
- Traer información de una fuente externa, como los horarios libres de un calendario, y devolvérsela al agente.
- Mandar archivos u otro contenido dinámico con pasos Send Message.
Para devolverle datos al agente, agrega el paso AI Function Result al final del workflow. Está en el bloque de acciones, dentro de AI Actions. Lo que pongas ahí es lo que recibe el agente después de que corre la función.
Sumar la función a un agente
Un AI Agent solo puede usar las funciones que le selecciones. Abre el agente en AI Hub → AI Agents y elige la función en AI Functions. Cuando seleccionas o sacas una función, su prompt aparece o desaparece del resumen del prompt del agente.
Para configurar el agente, mira AI Agents.
Si la función no corre
- Revisa que el prompt del agente diga con claridad cuándo llamar a la función.
- Revisa que la función esté seleccionada en el agente.
- Si un valor no se guarda, revisa el parámetro y el custom field de Save value to.