Funciones de IA

Haz clic en “+ AI Function” para crear una nueva Función de IA.

2026-08-12

Creando Funciones de IA

Haz clic en “+ AI Function” para crear una nueva Función de IA.

En la primera sección, tendrás que definir el nombre y la descripción de la función.

Ejemplo de Descripción:

texto
Esta função precisa capturar os detalhes do usuário, que são: nome, sobrenome e e-mail. Para o e-mail, o agente precisa validar o formato adequado caso o usuário não o forneça corretamente.

En la siguiente sección, tendrás que definir el prompt completo de la función (es decir, lo que quieres que la función haga o ejecute).

Ejemplo de Prompt:

texto
### Skill: capture_user_details  
- Esta skill captura informações essenciais do usuário: nome, sobrenome e e-mail. Ela garante que o e-mail fornecido esteja em um formato válido.  

#### Passos para Execução:  
1. Solicitar ao usuário que insira seu nome.  
2. Pedir o sobrenome do usuário.  
3. Solicitar o endereço de e-mail do usuário.  
4. Validar o formato do e-mail usando um padrão regex (ex.: `^[\w\.-]+@[\w\.-]+\.\w{2,4}$`).  
5. Se o e-mail for válido, armazenar todos os detalhes; caso contrário, solicitar ao usuário que insira um e-mail válido novamente.  

#### Restrições:  
- Todos os campos (nome, sobrenome e e-mail) não podem estar vazios.  
- O e-mail deve seguir as regras padrão de formatação.  

#### Regras de Formatação:  
- Garantir que a entrada do usuário seja limpa de espaços em branco no início e no final.  

#### Tratamento de Erros:  
- Se a validação falhar, informar o usuário sobre o erro específico (ex.: "Formato de e-mail inválido").  
- Permitir um número predefinido de tentativas para reentrada do e-mail.  

#### Condições:  
- Capturar os detalhes apenas se o e-mail for válido.  
- Solicitar cada detalhe do usuário separadamente.  
- **SOMENTE** continuar com a chamada da função quando **TODOS** os parâmetros forem capturados.  

En la siguiente sección, tendrás que definir los valores que deseas obtener de la función (como nombre, apellido, etc.) y describirlos, además de elegir en qué CUF deseas que se guarden.

Atención
Nota: Asegúrate de marcar la opción “Requerido” para que el valor sea obligatorio para la recolección de la función. También puedes activar el recurso “Memory”, que revisa el historial de la conversación para verificar si el valor ya existe. Si ya existe, omite la solicitud y pasa al siguiente parámetro.

Por último, será necesario adjuntar el flujo (solo se permiten Flujos de Trabajo) que debe activarse cuando se llame a la función.

Puedes usar este recurso para enviar los valores capturados a otra plataforma mediante integraciones nativas (como Google Sheets) o para hacer llamadas a la API mediante el bloque de solicitud externa (Solicitud Externa). También puede buscar información en una fuente externa y devolverla al agente de IA, permitiendo que la conversación continúe de forma fluida.

Esto facilita la automatización de tareas y la actualización de información en tiempo real, además de mejorar las respuestas de la IA con los datos más recientes.

Atención
Nota: Ahora es posible usar los bloques “Mensaje” dentro de los Flujos de Trabajo. Esto permite que los agentes de IA envíen medios y otros contenidos dinámicos según la información recibida.

Seleccionando la Función de IA

Para que los Agentes de IA puedan usar funciones de IA, tendrás que seleccionarlas dentro de las modificaciones de los Agentes de IA.

Una vez seleccionada, se ve así (con una vista general del prompt de la función).

Nota
Nota: Al marcar o desmarcar una función, su prompt aparece o desaparece del overlay.

Usando Funciones de IA

(Solo puedes usar Funciones de IA en Flujo de Trabajo ).