Funções de IA

Clique em “+ AI Function” para criar uma nova Função de IA.

2026-08-11

Criando Funções de IA

Clique em “+ AI Function” para criar uma nova Função de IA.

Na primeira seção, você terá que definir o nome e a descrição da função.

Exemplo de Descrição:

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.

Na próxima seção, você terá que definir o prompt completo para a função (ou seja, o que você deseja que a função faça ou execute).

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

Na próxima seção, você terá que definir os valores que deseja obter da função (como nome, sobrenome etc.) e descrevê-los, além de escolher em qual CUF deseja que sejam salvos.

Atenção
Nota: Certifique-se de marcar a opção “Required” para tornar o valor obrigatório para a coleta da função. Você também pode ativar o recurso de "Memory", que verificará o histórico da conversa para checar se o valor já existe. Se já existir, ele pulará a solicitação e seguirá para o próximo parâmetro.

Por fim, será necessário anexar o fluxo (apenas workflows permitidos) que deve ser acionado quando a função for chamada.

Você pode usar esse recurso para enviar valores capturados para outra plataforma por meio de integrações nativas (como Google Sheets) ou realizar chamadas de API via o nó de solicitações externas (external requests node). Ele também pode recuperar informações de uma fonte externa e passá-las de volta para o agente de IA, permitindo que a conversa continue de forma fluida.

Isso facilita a automação de tarefas, a atualização de informações em tempo real e aprimora as respostas da IA com os dados mais recentes.

Atenção
Nota: Agora é possível usar os blocos “Send Message” dentro dos workflows. Isso foi feito para permitir que os agentes de IA enviem mídias e outros conteúdos dinâmicos conforme as informações recebidas.

Selecionando a Função de IA

Para que os Agentes de IA possam usar funções de IA, você precisará selecioná-las dentro das modificações dos Agentes de IA.

Uma vez selecionada, ficará algo assim (com uma visão geral do prompt da função).

Nota
Nota: Ao desmarcar/marcar uma função, seu prompt aparecerá/desaparecerá do overlay de acordo.

Usando Funções de IA

(Você só pode usar Funções de IA em Fluxo de Trabalho ).