Como Criar e Configurar uma Função para um Agente IA
O quadro “Função” é o local onde você define ações específicas que o agente poderá executar, como consultar um banco de dados, enviar notificações ou coletar informações do usuário.
A seguir, veja o passo a passo completo para configurar uma função do jeito certo:✅ 1. Acesse o Menu de Funções A primeira etapa é alterar o nome do menu, caso deseje uma identificação mais personalizada. Depois disso, clique em “Gerenciar função” para começar as configurações detalhadas.
✏️ 2. Defina o Nome da Função • No campo superior, insira um identificador único para a função. • Exemplos: consultarPedido, enviarNotificacao, criarRelatorio. • Esse nome será usado internamente pelo agente para chamar essa função quando necessário.
🧠 3. Escreva a Descrição da Função • Logo abaixo do nome, descreva de forma clara o propósito da função. • A descrição deve responder: o O que a função faz? o Quais dados ela precisa? o O que ela retorna? • Uma boa descrição ajuda a IA e os desenvolvedores a entenderem o contexto da função.
💬 4. Adicione Instruções Extras (Prompt Contextual) • Neste campo, você pode injetar orientações adicionais que a IA irá considerar ao executar a função. • Exemplo: “Antes de enviar notificação, confirmar nome completo do cliente.” • Use isso para guiar o comportamento do agente de forma mais precisa.
🧩 5. Configure os Parâmetros da Função Aqui você define a estrutura de dados esperada: • Nome: como emailCliente, idPedido, etc. • Tipo: string, integer, boolean, array etc. • Required: marque se o parâmetro é obrigatório para a função funcionar. • Descrição: explique como o agente deve tratar cada parâmetro. ⚠️ Isso garante que a IA só execute a função quando tiver todas as informações necessárias.
🧾 6. Visualize e Gere o JSON • No painel à direita, você verá um preview em tempo real do JSON que será enviado para a API. • Clique em “Gerar com IA” para criar o esqueleto automaticamente. o Basta descrever a função em linguagem natural, clicar em OK e depois em Aplicar JSON. o O sistema preencherá todos os campos automaticamente.
💾 7. Salve e Integre ao Fluxo • Depois de revisar todos os campos, clique em “Salvar”. • A função agora está integrada ao agente. • Sempre que a IA identificar a necessidade dessa ação, ela a chamará automaticamente, enviando os dados definidos.
🚀 Pronto! Sua função está configurada e pronta para ser usada dentro do fluxo do agente. Essa personalização é o que permite que a IA realize tarefas específicas com precisão, dentro dos padrões definidos por você.