COMO CRIAR FUNÇÕES NO TOOLZZ AI?
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 agente de IA é 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 no 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 agente de IA. 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 agente de IA 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 Agentes de IA.
1º passo: dentro do formulário de criação/edição de agente de IA, 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 agente de IA.
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 agente de IA 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".
- 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.
- Obrigatório: determina se esse input é obrigatório 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 na chave de ativação para ativar (chave colorida) ou desativar (chave cinza) a função;
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 agente de IA, 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 agente de IA, desde a compreensão das
entradas do usuário até a geração das respostas adequadas. Elas ajudam a tornar o agente de IA 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 agente de IA, 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
agente de IA.
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.
