Dicionário de Funções Personalizadas: termos que todo profissional deve conhecer
Aprenda a criar funções personalizadas em IA para automatizar tarefas e integrar dados com a Toolzz AI.
Dicionário de Funções Personalizadas: termos que todo profissional deve conhecer
17 de abril de 2026
As Funções Personalizadas na Toolzz AI representam um salto significativo na capacidade de customização e integração de agentes de inteligência artificial. Permitem que você expanda as habilidades do seu agente para além do processamento de linguagem natural, conectando-o a APIs externas, bancos de dados e lógicas de negócio específicas da sua empresa. Este guia detalhado explora o conceito, a implementação e as possibilidades que as Funções Personalizadas oferecem.
O que são Funções Personalizadas
Funções Personalizadas, também conhecidas como Custom Functions, são trechos de código JavaScript que você pode definir dentro da plataforma Toolzz AI e que o agente pode executar durante uma conversa. Imagine que, ao invés de apenas responder perguntas sobre seus produtos, seu agente precise verificar o estoque em tempo real, gerar um link de pagamento com base em um valor específico, ou agendar uma reunião diretamente no Google Calendar do cliente. Tudo isso se torna possível com as Funções Personalizadas.
Tecnicamente, você escreve uma função JavaScript que recebe parâmetros de entrada (extraídos da conversa do usuário) e retorna um valor de saída (que o agente utiliza para responder). A Toolzz AI cuida da execução do código, da segurança e da integração com o fluxo da conversa.
Problema que resolve
Sem Funções Personalizadas, seus agentes de IA ficam limitados a responder com base no conhecimento que já possuem. Isso significa que tarefas que exigem acesso a dados externos ou a lógica de negócio específica da sua empresa precisam ser tratadas manualmente por atendentes humanos, gerando custos operacionais e lentidão no atendimento. Empresas como o Bradesco e o iFood, que lidam com um alto volume de solicitações complexas, podem se beneficiar enormemente da capacidade de automatizar tarefas que antes exigiam intervenção humana. Um time de suporte pode gastar até 4 horas por dia respondendo as mesmas perguntas sobre status de pedidos, boletos ou informações cadastrais. As Funções Personalizadas eliminam essa necessidade.
Quer automatizar tarefas complexas e reduzir custos? Conheça a Toolzz AI e veja como as Funções Personalizadas podem transformar seu atendimento.
Como configurar no Toolzz AI
Configurar uma Função Personalizada na Toolzz AI é um processo simples e intuitivo:
- Acesse o painel de administração: Faça login em admin.toolzz.ai.
- Navegue até a seção 'Funções': No menu lateral, clique em 'AI Agents' e selecione o agente que você deseja configurar.
- Crie uma nova função: Clique no botão 'Nova Função'.
- Defina o nome e a descrição: Dê um nome claro e descritivo para a sua função, e adicione uma breve descrição do que ela faz.
- Escreva o código JavaScript: No editor de código, escreva a função JavaScript que você deseja executar. Você pode usar as APIs da Toolzz (e outras que precisar) para acessar dados externos.
- Defina os parâmetros de entrada: Especifique os parâmetros que a função espera receber da conversa do usuário. Você pode definir o tipo de dado (texto, número, data, etc.) e um nome para cada parâmetro.
- Teste a função: Use a ferramenta de teste integrada para verificar se a função está funcionando corretamente.
Exemplo prático
Vamos criar uma função que gera um link de pagamento para um determinado valor usando a API da Stripe.
Código JavaScript:
javascript const stripe = require('stripe')('SUA_CHAVE_SECRETA_STRIPE');
async function gerarLinkPagamento(valor) { const paymentIntent = await stripe.paymentIntents.create({ amount: valor * 100, currency: 'brl', automatic_payment_methods: { enabled: true, }, });
return paymentIntent.client_secret; }
module.exports = gerarLinkPagamento;
Diálogo de Exemplo:
Cliente: "Eu gostaria de pagar R$ 50,00"
Agente: "Ok, estou gerando um link de pagamento para você."
(O agente extrai o valor '50' da mensagem do cliente e chama a função gerarLinkPagamento)
Agente: "Por favor, clique neste link para concluir o pagamento: [link gerado pela Stripe]"
Dicas de configuração avançada
- Validação de dados: Sempre valide os dados de entrada para garantir que sua função receba os parâmetros corretos.
- Tratamento de erros: Implemente um tratamento de erros robusto para lidar com falhas inesperadas na API externa.
- Cache: Utilize cache para armazenar resultados de chamadas de API que são frequentes, reduzindo a carga no sistema externo.
- Segurança: Nunca armazene informações confidenciais (como chaves de API) diretamente no código da função. Utilize variáveis de ambiente ou um gerenciador de segredos.
- Documentação: Documente suas funções de forma clara e concisa para facilitar a manutenção e a colaboração.
Limitações e workarounds
- Tempo de execução: As Funções Personalizadas têm um tempo de execução limitado. Funções muito complexas ou que demoram muito para executar podem gerar erros.
- Acesso a recursos: As Funções Personalizadas têm acesso limitado aos recursos do sistema. Não é possível, por exemplo, escrever arquivos no servidor.
- Complexidade: Funções muito complexas podem ser difíceis de manter e depurar. Divida funções complexas em funções menores e mais modulares.
Planos que incluem
As Funções Personalizadas estão disponíveis nos planos Starter (R$990/mês) e Enterprise (R$3.900+/mês) da Toolzz AI. O plano Mini (R$399/mês) não possui acesso a este recurso.
Quer testar essa feature?
Solicitar demonstraçãoQuer saber mais sobre como a Toolzz pode otimizar seus processos com inteligência artificial? Acesse nosso site e descubra todas as nossas soluções.
Para empresas que buscam alternativas, existem plataformas como o Dialogflow CX do Google e o Amazon Lex, que também oferecem recursos de programação de funções. No entanto, a Toolzz AI se destaca pela facilidade de uso e pela integração nativa com diversos canais de comunicação, como WhatsApp, Instagram e sites. A interface intuitiva e o editor de código integrado tornam o desenvolvimento e a implantação de Funções Personalizadas mais rápidos e eficientes.
Demo Bots
Explore a demo interativa do Toolzz Bots, uma poderosa plataforma no-code que permite a criação de chatbots que operam 24 horas por dia, 7 dias por semana.
.webp){kind=small}
