São serviços de terceiros conectados por OAuth cujas ações o Nó Cortex pode executar diretamente, sem necessidade de gerenciar chaves de API.
🎯 Para que serve?
Esta funcionalidade permite que o nó faça coisas reais fora da conversa. Por exemplo:
Criar um evento em um calendário.
Abrir um ticket de suporte no seu sistema.
Notificar um canal da sua equipe interna.
Carregar ou atualizar um contato no seu CRM.
💡 A grande vantagem: Diferentemente de uma HTTP Request tradicional, a autenticação aqui é resolvida pela plataforma através de OAuth. Você não precisa programar integrações do zero, gerenciar tokens de segurança nem se preocupar com suas renovações.
📍 Onde se configura?
Para acessar as ferramentas, o caminho é:
Canvas → Selecionar Nó Cortex → Painel direito → Aba (Tab) Ferramentas.
🔗 Como conectar uma aplicação (Passo a passo)
O processo de conexão é visual e consta de três etapas:
1. Selecionar a aplicação
Ao clicar em adicionar, um modal de exploração abre com mais de uma centena de toolkits (pacotes de ferramentas) disponíveis. Você pode usar o buscador para encontrar rapidamente a aplicação que precisa.
2. Conectar e verificar
O sistema verificará automaticamente se a aplicação já está conectada à sua conta.
Se não estiver, será iniciado o fluxo de OAuth em uma nova aba do seu navegador para que você faça login e conceda as permissões.
Ao voltar para Cortex, simplesmente clique no botão Verificar novamente para conferir o status da conexão.
3. Selecionar as ações
Uma vez conectada a app, você poderá explorar todas as ações disponíveis (ex. "Enviar e-mail", "Criar contato"). Você pode pesquisar por nome ou descrição, e selecionar várias de uma vez antes de adicioná-las ao nó.
Gestão de Ferramentas anexadas
Cada ferramenta que você anexar aparecerá com seu nome, descrição, aplicação de origem e identificador da ação. Se você não as precisar mais, podem ser removidas individualmente do nó.
✍️ Referenciar ferramentas no prompt
Ao escrever @ dentro do campo de instruções (prompt) do seu nó, a lista de ferramentas que você acabou de conectar aparecerá.
O menu é filtrável. Ao selecionar uma, será inserida uma referência formatada, por exemplo: @[Send Message - Slack].
Em tempo de execução (runtime), esta referência é resolvida automaticamente como uma instrução vinculada àquela ferramenta.
🧠 Melhores práticas: Escrever boas descrições
A descrição da ferramenta é o texto que o modelo de linguagem (LLM) lê para decidir quando deve usá-la. É o fator mais crítico para que o nó a invoque no momento correto.
Uma descrição completa e eficaz deve cobrir três coisas:
O que a ferramenta faz: Explicado em uma ou duas frases.
Quando usá-la: As situações exatas do cliente que devem disparar a ação.
Quando NÃO usá-la: Regras de exclusão (vital se há risco de confusão com outra ferramenta similar).
✅ Recomendado (Completo e claro) | ❌ Recomendado evitar (Vago e ambíguo) |
"Consulta o estoque de um veículo no CRM. Usar quando o cliente pergunta se há disponibilidade de um modelo específico. Não usar para perguntas gerais sobre o catálogo." | "Consulta o sistema." |
⚙️ O esquema técnico vai no prompt
Embora a descrição da ferramenta diga ao modelo o que faz, é recomendável detalhar no prompt do nó o esquema técnico: qual entrada exata a ferramenta espera e o que retorna, incluindo exemplos concretos de cada parâmetro.
Os modelos interpretam melhor exemplos do que abstrações. Se você documentar um parâmetro assim:
attendees (array de strings): e-mails dos participantes. Ex: ["[email protected]"], você evita o erro clássico de a IA passar um objeto complexo onde se esperava uma simples cadeia de texto.Tratamento de erros: Também é recomendável enumerar no prompt os erros esperados e o que o nó deve fazer diante de cada um. (Por exemplo: "Se a criação do evento no calendário falhar, NÃO comunique o erro técnico ao cliente, deixe uma nota interna e encaminhe a conversa para um consultor").
💡 A divisão de tarefas:
A descrição da ferramenta define o que faz e quando se usa.
O prompt do nó define em que momento exato do fluxo conversacional deve ser invocada (usando
@[nome]), como passar os dados para ela e como reagir às suas respostas.
Dê mãos à sua Inteligência Artificial! 🚀
Ao integrar aplicações externas com OAuth e configurar descrições precisas, você transforma seu agente de um simples assistente conversacional em um operador resolutivo capaz de executar processos reais do começo ao fim, automatizando seu negócio como nunca antes. ✅