Sobre

As funções são ferramentas que ajudam o agente da IA a realizar tarefas específicas, como definir valores, fazer chamadas de API, acionar fluxos automáticos ou se conectar com sistemas externos por meio de webhooks. Elas funcionam como um apoio para que o agente IA consiga formular uma resposta mais completa.

Cada função no chatbot é como um bloco de construção, responsável por uma tarefa específica, como analisar uma entrada do usuário, consultar uma base de dados ou API, e formular uma resposta.

🚨Atenção!

Se você utilizar a funcionalidade "Funções" no seu agente de IA, é essencial também descrever no Cérebro da IA, dentro do prompt, em que momento ou contexto a função deve ser acionada.

Isso é importante porque o agente só saberá que deve chamar uma função se for orientado corretamente no seu treinamento. Sem essa indicação no prompt, a IA pode ignorar ou usar a função de forma errada, comprometendo o fluxo e a precisão das respostas.

A função deve ser indicada com prompt com o mesmo nome que ela for criada. Exemplo: "Use a função Previsão-do-tempo quando o usuário perguntar sobre a previsão do tempo".

Passo a passo

Existem dois caminhos que podem ser usados para criar funções dentro da plataforma: através do menu lateral ou no formulário de criação/edição do chatbot. Vamos mostrar os dois neste artigo.

❗Informação importante: o formulário para criação da função e os campos a serem preenchidos são os mesmos nos dois caminhos.

Ao criar uma função, por qualquer um dos dois caminhos, ela será salva no banco de dados da sua plataforma. Depois disso, você poderá usá-la em qualquer chatbot que quiser.

Acessando o formulário de criação de Função através do menu lateral

1º passo: no menu lateral, clique na opção "Funções".

Depois, clique no botão "+ Criar Função" localizado no canto superior direito da tela.

💡Dica: se você estiver criando sua primeira função, verá este mesmo botão no centro da tela.

Acessando o formulário de criação de Função através da criação/edição de Chatbots

1º passo: dentro do formulário de criação/edição de chatbot, na parte "Agente", role a tela para encontrar seção de "Recursos do Agente".

Ative a chave da funcionalidade "Funções". Repare que ela ficará colorida.

2º passo: um botão escrito "Funções" aparecerá no menu superior. Clique nele.

Na página que se abrirá, clique no botão "Criar função".

🚨Atenção! Você só consegue acessar a aba "Funções" se já tiver configurado a aba "Cérebro". Se ainda não sabe como fazer isso, clique aqui e aprenda.

Criando uma função

Daqui para frente, todos os passos de configurações e todas as telas referentes a criação de funções são os mesmos, independente do caminho que você seguiu anteriormente.

1º passo: preencha o formulário com as informações solicitadas.

Dê um nome para identificar sua função;
Exemplo: "PrevisãoDoTempo".
🚨Atenção! O nome da função não pode ter espaços. Ele pode conter somente letras maiúsculas ou minusculas, hifen "-" ou underline "_".
Breve descrição: a AI utiliza o que está escrito neste campo para entender o que esta função faz. É essencial usar a descrição para explicar, de forma explicita e didática, o objetivo da função e quando a AI deve utilizá-la.
Exemplo: "Esta função fornece ao usuário a previsão do tempo com base em sua localização atual. Se a localização não puder ser identificada, a previsão do tempo para São Paulo será retornada por padrão."

🚨Atenção! Os campos são de preenchimento obrigatório.
Insira uma foto para a função. Tenha atenção às recomendações de tamanho (proporção 1:1 e máximo 20Mb) e formatos (SVG, PNG ou JPG).

Se quiser excluir a imagem, basta clicar no ícone de lixeira que aparecerá após o upload.

Inputs

Os inputs são os dados de entrada para a execução da função. Eles podem ser captados diretamente da conversa com o usuário ou definidos como valores de variáveis que a IA identifica/calcula de acordo com as instruções em prompt/descrição da função que forem utilizadas.

Por exemplo, uma função que chama um webhook usando uma variável chamada 'tipo', você explica no prompt como definir essa variável. Assim, quando executar a função, a IA já define a variável "tipo" sem que o usuário explique especificamente ela, apenas por inferência.

No nosso exemplo, se a função receber "Rio de Janeiro" como localização, ela vai acessar uma fonte de dados, como uma API de previsão do tempo, e obter as informações meteorológicas atualizadas para o Rio de Janeiro. Se não receber informação sobre a localização, considerará sempre a previsão para a cidade de São Paulo.

2º passo: clique em "Novo Item" para criar um input e preencha as informações necessárias.

Propriedade: se refere a um atributo específico do input que está sendo definido. Ela define o tipo de informação que será incluída na resposta do chatbot.
Exemplo: Localização.
Tipo:
- String: ao definir uma propriedade como tipo string, você está indicando que o valor associado a essa propriedade será tratado como texto. Isso é útil para mensagens de texto, descrições, nomes e outras informações que não requerem cálculos matemáticos.
  
  💡Dica: para telefone usa-se o tipo "String" porque o símbolo de adição "+" usado antes do código do país é considerado como texto.
- Number: indica que o valor da propriedade é um número. É útil quando você precisa lidar com valores numéricos, como quantidades, preços, pesos, e assim por diante. Isso permite que o chatbot execute cálculos matemáticos ou manipule números de maneira adequada.
Descrição: será usada para conseguir escutar, dentro da mensagem enviada pelo usuário, a informação definida no campo "Propriedade".
Exemplo: "Identifique a localização do usuário, se não encontrar, considere sempre a cidade de São Paulo".
Obrigatório: determina se essa função é obrigatória ou não. Se no seu código está escrito que essa informação é necessária, então ela precisa ser obrigatória.
Basta clicar nela para ativar (chave colorida) ou desativar (chave cinza) a função;
Ações: clique no botão com o ícone de check "✅" para salvar as configurações e criar o input;

🚨Atenção! Clicando no botão com ícone de "x" você descarta a criação do input e todas as configurações realizadas.

3º passo: após salvar o input você tem a opção de editá-lo, clicando no botão com a imagem de um lápis ou excluí-o, clicando no botão com o desenho de uma lixeira.

Função JavaScript

Na criação de um chatbot, a função JavaScript, é um bloco de código que executa uma tarefa específica quando chamado ou invocado. Ela é usada para processar as entradas, tomar decisões com base nelas e gerar as saídas correspondentes.

Por exemplo, você pode ter uma função JavaScript que recebe uma pergunta do usuário, consulta uma base de conhecimento ou API para encontrar a resposta e, em seguida, retorna a resposta para o usuário.

As funções JavaScript permitem que você defina a lógica por trás das interações do chatbot, desde a compreensão das entradas do usuário até a geração das respostas adequadas. Elas ajudam a tornar o chatbot inteligente e responsivo às necessidades dos usuários.

4º passo: crie o código da sua função.

Use o box de texto para colar ou escrever o código da sua função;
Após escrever o código, use o botão "Criar", com o desenho de uma varinha mágica, para a função ser criada automaticamente;

🚨Atenção!
- Os campos anteriores do formulário devem ter sido preenchidos para ele funcionar corretamente;
- Você precisa primeiro inserir as instruções para que o código seja criado a partir dele. Se usar o "Criar" sem essas informações, será criado um código apenas de exemplo;
Após inserir ou escrever o código da função, use este botão "Corrigir", com o desenho de uma ferramenta, para melhorar o código ou corrigir possíveis erros e deixá-lo completamente funcional;
Clique no botão com o desenho da letra "i" dentro de um círculo para ver instruções sobre a criação da função;
Clique no botão com o desenho de uma lâmpada para ver um exemplo de código.

5º passo: após realizar todas as configurações, clique no botão "Criar".

Gerenciando funções

Todas as funções criadas, sejam através do menu lateral ou do formulário de criação de chatbot, ficam dispostas em formatos de cards na página de funções.

1º passo: para visualizar todas as funções criadas, clique na opção "Funções" no menu lateral.

2º passo: clique no botão "Configuração" para editar as propriedades da função.

3º passo: clique no botão com desenho de três pontos para ter acesso às opções de duplicar ou excluir a função.

4º passo: a chave de ativação, localizada do canto inferior direito do card, indica se a função está ativa ou não no chatbot.

Quando a chave está ativada, ela fica colorida, quando está desativada, fica cinza. Clique na chave para ativar ou desativar a função.

💡Dica

Na parte inferior do menu lateral, quando estiver na página de "Funções" você verá o contador de consumo da funcionalidade. Ele mostra quantas Funções estão ativas na sua plataforma e quanto do plano já foi consumido.

Pronto! Agora você já sabe tudo sobre criação de "Funções" no Toolzz AI.

COMO CRIAR FUNÇÕES NO TOOLZZ AI?