Ferramenta de Conversação
Crie uma ferramenta que a IA possa usar durante as conversas. A IA decide quando chamá-la com base no contexto.
Quando Usar
Use este gatilho para ampliar o que sua IA pode fazer:
- Pesquisar produtos em seu catálogo
- Verificar o status do pedido em seu sistema
- Consultar dados do cliente no CRM
- Criar tickets de suporte no JIRA
- Agendar compromissos
- Qualquer capacidade personalizada
Configuração
Configurações Básicas
| Campo | Descrição |
|---|---|
| Nome da Ferramenta | Nome legível por humanos (exibido na Biblioteca de Nós) |
| Descrição | Explica quando/como a IA deve usar esta ferramenta |
Segmentação de Usuários
Escolha quem pode usar esta ferramenta:
| Opção | Descrição |
|---|---|
| Todos os Usuários | Usuários anônimos + usuários conectados |
| Apenas Usuários Conectados | Apenas usuários logados |
| Acesso Baseado em Função | Funções de usuário específicas |
Variáveis da Ferramenta
Defina os parâmetros que a IA precisa coletar do usuário:
| Campo | Descrição |
|---|---|
| Nome da Variável | Nome interno (ex.: query, orderId) |
| Descrição | Ajuda a IA a entender o que perguntar |
As variáveis ficam disponíveis como {{variableName}} em seu fluxo.
Como Funciona
- Você define uma ferramenta com nome, descrição e variáveis
- A IA aprende quando usá-la a partir de sua descrição
- O usuário pergunta algo relacionado (ex.: "Encontre um laptop")
- A IA coleta as variáveis necessárias de forma conversacional
- O fluxo é executado com os dados coletados
- O resultado retorna para a IA para a resposta final
Nomeando Suas Ferramentas: Por Que Isso Importa
Quando seu assistente de IA tem acesso a várias ferramentas, ele escolhe qual chamar com base em três coisas apenas: o nome da ferramenta, a descrição da ferramenta e as descrições das variáveis. Ele não consegue ver o que está dentro do fluxo — ele lê o texto e decide.
Se esses três campos forem vagos ou muito semelhantes entre as ferramentas, a IA escolherá a ferramenta errada. Estudos sobre chamadas de função de LLM mostram que melhorar a clareza da descrição pode aumentar a seleção correta da ferramenta em 15–20 pontos percentuais, sem alterar o modelo subjacente.
Isso é especialmente crítico quando você tem várias ferramentas que pesquisam diferentes bases de conhecimento — do ponto de vista da IA, todas "pesquisam informações". O nome e a descrição são a única maneira de diferenciá-las.
Nome da Ferramenta
Use o padrão domain_action_target para que o nome por si só distinga cada ferramenta:
| ❌ Vago | ✅ Claro |
|---|---|
Search | rgpd_legal_analysis |
search_docs | ecommerce_product_search |
Tool 2 | support_ticket_lookup |
A IA usa o nome como um primeiro filtro antes de ler a descrição. Um nome claro permite que ela faça uma pré-seleção instantaneamente; um nome genérico a força a adivinhar.
Descrição da Ferramenta
A descrição é sua alavanca mais poderosa. Use esta fórmula:
[O que faz — 1 frase]
Usar para: [3–5 casos de uso concretos com as palavras que seus usuários realmente usariam]
❌ Ruim:
Pesquise a base de conhecimento por informações.
✅ Bom:
Pesquisa sanções da CNIL e jurisprudência do CJUE.
Usar para: encontrar decisões de penalidades por setor ou tipo de violação,
consultar valores de multas, citar precedentes legais,
avaliar o risco financeiro de não conformidade com o RGPD.
As palavras dentro de "Usar para" atuam como gatilhos semânticos. Quando a mensagem de um usuário contém "multa", "penalidade" ou "risco", a IA imediatamente a associa a esta ferramenta.
Descrições das Variáveis
Uma variável descrita como "A consulta de pesquisa" não diz nada à IA. Ela colará a pergunta bruta do usuário toda vez. Uma descrição melhor orienta a IA a extrair as palavras-chave corretas antes de enviá-las.
| ❌ Vago | ✅ Claro |
|---|---|
A consulta de pesquisa | Consulta de pesquisa: tipo de violação, nome da empresa, setor, valor da multa ou conceito legal |
Entrada do usuário | Tipo de documento solicitado: modelo, formulário, cláusula ou contrato |
Isso leva a IA a reformular em vez de copiar toda a mensagem do usuário — resultando em pesquisas mais direcionadas e melhores resultados.
Evitando Conflitos de Ferramentas
Quando duas ferramentas podem responder à mesma pergunta, a IA hesita — e às vezes escolhe aleatoriamente. Cada ferramenta deve cobrir um território exclusivo.
A regra: se você consegue pensar em uma pergunta do usuário que poderia ir para qualquer uma das ferramentas, suas descrições precisam de mais precisão.
Exemplo — 5 ferramentas de conformidade com limites claros:
| Ferramenta | Cobre | NÃO cobre |
|---|---|---|
compliance_legal_analysis | Artigos de lei, obrigações legais, direitos | Nenhum conselho prático, nenhum caso do mundo real |
compliance_methodology | Guias passo a passo, procedimentos de auditoria, estruturas | Nenhum texto legal, nenhum modelo |
compliance_document_templates | Modelos prontos para uso, formulários, cláusulas contratuais | Nenhuma metodologia, nenhuma análise legal |
compliance_business_processes | Fluxos de trabalho operacionais, circuitos de aprovação | Nenhum texto legal, apenas processos internos |
compliance_operational_solutions | Soluções concretas, recomendações técnicas | Nenhuma teoria, apenas soluções acionáveis |
Quanto mais específicas forem as descrições sobre o que a ferramenta cobre, menos ambiguidade haverá. Você não precisa escrever exclusões explícitas — a precisão faz o trabalho.
Lista de Verificação Rápida
Antes de publicar um fluxo com um gatilho de Ferramenta de Conversação, verifique:
- Nome segue
domain_action_target— distinguível sem ler a descrição - Descrição começa com o que a ferramenta faz em 1 frase
- Descrição inclui "Usar para:" com 3–5 casos de uso concretos
- Descrições das variáveis listam os tipos de informações esperadas, não apenas "a consulta"
- Sem sobreposição com o território de outra ferramenta
- Testado com 2–3 perguntas ambíguas no painel de Teste para confirmar o roteamento correto
Exemplo: Pesquisa de Produto
Configuração da Ferramenta:
- Nome:
ecommerce_product_search - Descrição: Pesquisa o catálogo de produtos por nome, categoria ou recurso. Usar para: encontrar um produto específico, comparar produtos em uma categoria, verificar se um produto existe, consultar especificações ou preços de produtos.
- Variável:
query— "Nome do produto, categoria, recurso ou faixa de preço a ser pesquisada"
Fluxo:
- Gatilho: Ferramenta de Conversação
- Ação: Pesquisar Base de Conhecimento (
{{query}}) - Ação: Definir Observação (retornar resultados)
Conversa do usuário:
Usuário: "Você tem fones de ouvido sem fio?"
IA: chama ecommerce_product_search com query="fones de ouvido sem fio"
IA: "Sim! Encontrei 3 fones de ouvido sem fio. O Sony WH-1000XM5 é o nosso mais vendido a €349..."
Exemplo: Ticket JIRA
Configuração da Ferramenta:
- Nome:
support_create_jira_ticket - Descrição: Cria um ticket de suporte JIRA a partir da conversa. Usar para: quando o usuário relata um bug, solicita um recurso ou precisa escalar um problema para a equipe técnica.
- Variáveis:
title— "Resumo curto do problema (1 frase)",description— "Descrição detalhada incluindo etapas para reproduzir, comportamento esperado e comportamento real"
Fluxo:
- Gatilho: Ferramenta de Conversação
- Ação: Solicitação da IA (gerar título/descrição)
- Paralelo: Gerar descrição + título
- Ação: JIRA Criar Problema
