Funções de IA
- Nicola Occhipinti
Analytics
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:
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:
### 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.
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.
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: 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 ).
Você pode selecionar o nó AI Function Output na guia AI Agents dentro do bloco de ação.
Este será o dado que será retornado para o seu Agente de IA depois que uma função for chamada e um fluxo de trabalho for processado.