Ferramenta de Conversação
Crie uma ferramenta que a IA pode 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 de clientes 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ções | 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
Exemplo: Pesquisa de Produto
Configuração da Ferramenta:
- Nome: Pesquisar um produto
- Descrição: Pesquisar um produto específico no catálogo
- Variável:
query— "Consulta do usuário"
Fluxo:
- Gatilho: Ferramenta de Conversação
- Ação: Pesquisar na 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 Pesquisar um produto 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: Criar um cartão no Jira
- Descrição: Cria um problema no Jira a partir da conversa
- Variáveis:
title,description
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
Melhores Práticas
- Descrições claras ajudam a IA a saber quando usar a ferramenta
- Variáveis mínimas — peça apenas o que é essencial
- Boas descrições de variáveis ajudam a IA a fazer as perguntas certas
- Teste minuciosamente usando o botão Testar antes de entrar ao vivo