Os principais conceitos de Custom Functions explicados

Lucas (CEO Toolzz)
17 de abril de 2026

No cenário atual, a capacidade de automatizar tarefas e integrar sistemas é crucial para a eficiência operacional. As Custom Functions do Toolzz AI permitem que você expanda as capacidades do seu agente de IA, conectando-o a APIs externas, executando cálculos complexos ou automatizando ações específicas, como gerar links de pagamento ou agendar compromissos. Isso vai além das capacidades de chatbots tradicionais, transformando seu agente em um assistente virtual verdadeiramente inteligente e adaptado às suas necessidades.

O que são Custom Functions?

Custom Functions, ou Funções Personalizadas, são trechos de código JavaScript que você pode escrever e incorporar diretamente no Toolzz AI. Esses códigos são executados pelo agente de IA quando uma determinada solicitação é feita, permitindo que ele realize ações que não seriam possíveis apenas com a base de conhecimento pré-existente. Pense nelas como mini-aplicações que rodam dentro do seu agente de IA, estendendo suas funcionalidades de forma ilimitada. Ao contrário de sistemas que exigem conhecimento profundo em programação ou a criação de integrações complexas, as Custom Functions do Toolzz AI simplificam esse processo, permitindo que desenvolvedores e até mesmo usuários com conhecimentos básicos de JavaScript criem funcionalidades personalizadas de forma rápida e eficiente.

Problema que resolve

Empresas como o Bradesco, Itaú e Mercado Bitcoin lidam diariamente com um grande volume de solicitações que exigem acesso a dados em tempo real ou a execução de tarefas específicas em sistemas internos. Um time de atendimento tradicional pode gastar horas respondendo manualmente a perguntas sobre saldos, status de pedidos ou agendando serviços. As Custom Functions resolvem esse problema permitindo que o agente de IA acesse essas informações e execute essas tarefas automaticamente, liberando os atendentes humanos para lidar com questões mais complexas e estratégicas. Por exemplo, um agente de IA pode consultar a API de um sistema de CRM para fornecer informações detalhadas sobre um cliente ou gerar um link de pagamento via API do Stripe durante uma conversa. Isso não apenas aumenta a eficiência, mas também melhora a experiência do cliente, oferecendo respostas rápidas e personalizadas.

Descubra como a Toolzz AI pode otimizar o atendimento da sua empresa. Conheça a Toolzz e veja como a automação inteligente pode transformar seus resultados.

Como configurar no Toolzz AI

Configurar uma Custom Function no Toolzz AI é um processo simples e intuitivo. Siga estes passos:

1. Acesse o painel de administração: Faça login em admin.toolzz.ai.
2. Navegue até a seção Custom Functions: No menu lateral, clique em "AI Studio" e selecione "Custom Functions".
3. Crie uma nova função: Clique no botão "Criar Nova Função".
4. Defina um nome e descrição: Dê um nome descritivo à sua função e adicione uma breve descrição do que ela faz.
5. Escreva o código JavaScript: No editor de código, escreva o código JavaScript que implementa a lógica da sua função. Certifique-se de que o código retorna um valor que o agente de IA possa usar na conversa.
6. Defina os parâmetros de entrada: Especifique os parâmetros que sua função recebe, incluindo o nome, tipo e descrição de cada um.
7. Salve a função: Clique no botão "Salvar" para salvar sua função.

Exemplo prático

Imagine um agente de IA do iFood que precisa consultar o status de um pedido para um cliente. Usando uma Custom Function, o agente pode enviar o ID do pedido para uma API interna do iFood e receber o status em tempo real. Veja um exemplo de diálogo:

Cliente: Qual o status do meu pedido #12345?

Agente AI: Aguarde um momento enquanto consulto o status do seu pedido...

(A Custom Function é executada, consultando a API do iFood)

Agente AI: Seu pedido #12345 está em preparação e deve ser entregue em aproximadamente 20 minutos. Deseja mais alguma informação?

O código JavaScript para essa função poderia ser algo como:

javascript async function consultarStatusPedido(idPedido) { const apiKey = 'SUA_API_KEY'; const url = https://api.ifood.com.br/pedidos/${idPedido};

const response = await fetch(url, { headers: { 'Authorization': Bearer ${apiKey} } });

const data = await response.json(); return data.status; }

Dicas de configuração avançada

• Utilize variáveis de ambiente: Para proteger informações confidenciais, como chaves de API, utilize variáveis de ambiente em vez de hardcodificá-las no código.
• Implemente tratamento de erros: Adicione tratamento de erros ao seu código para lidar com situações inesperadas e evitar que o agente de IA falhe.
• Otimize o desempenho: Escreva código eficiente e evite chamadas desnecessárias a APIs externas para garantir que o agente de IA responda rapidamente.
• Documente suas funções: Adicione comentários claros e concisos ao seu código para facilitar a manutenção e o compartilhamento com outros desenvolvedores.
• Teste exaustivamente: Teste suas funções em diferentes cenários para garantir que elas funcionem corretamente em todas as situações.

Limitações e workarounds

As Custom Functions oferecem grande flexibilidade, mas é importante estar ciente de algumas limitações:

• Tempo de execução: O tempo de execução de uma Custom Function é limitado para evitar o consumo excessivo de recursos. Se sua função levar muito tempo para ser executada, ela pode ser interrompida.
• Segurança: Certifique-se de que o código JavaScript que você escreve é seguro e não contém vulnerabilidades que possam comprometer a segurança do seu sistema.
• Complexidade: Funções muito complexas podem ser difíceis de manter e depurar. Tente manter suas funções simples e focadas em uma única tarefa.

Para contornar essas limitações, você pode dividir tarefas complexas em várias funções menores, utilizar filas de mensagens para processar tarefas assíncronas ou otimizar o código para melhorar o desempenho.

Planos que incluem

As Custom Functions estão disponíveis nos planos Starter (R$990/mês) e Enterprise (R$3.900+/mês) do Toolzz AI. O plano Mini (R$399/mês) não oferece acesso a essa funcionalidade. Consulte a página de preços em https://toolzz.com.br/ai#pricing para mais detalhes.

Quer testar essa feature? Crie seu agente de IA no Toolzz AI a partir de R$399/mês no plano Mini. Já imaginou seu agente usando Custom Functions para atender seus clientes 24/7 pelo WhatsApp? Conheça em toolzz.com.br/ai.

Com as Custom Functions do Toolzz AI, você pode criar agentes de IA verdadeiramente inteligentes e personalizados, capazes de automatizar tarefas complexas e integrar-se perfeitamente aos seus sistemas existentes. Não perca tempo com tarefas repetitivas – deixe o Toolzz AI cuidar delas para você!