Criando Ferramentas de IA

Dê superpoderes ao seu assistente de IA com ferramentas personalizadas

O construtor visual de nós SmartFlow da AI SmartTalk permite que você crie ferramentas personalizadas para o seu assistente de IA sem escrever código. Essas ferramentas ampliam as capacidades da sua IA além da conversa, para ações reais.

---

O Que São Ferramentas de IA?

Ferramentas (também chamadas de "chamada de função") permitem que sua IA execute tarefas específicas durante as conversas. Em vez de apenas responder perguntas, sua IA pode:

• Pesquisar seu catálogo de produtos
• Agendar compromissos
• Criar tickets de suporte
• Consultar o status do pedido
• E muito mais

Sem Ferramentas vs Com Ferramentas

Cenário	Sem Ferramentas	Com Ferramentas
Status do Pedido	"Por favor, visite nosso site para verificar seu pedido"	A IA busca informações de rastreamento e as exibe instantaneamente
Agendamento de Compromissos	"Ligue para nós no 555-1234 para agendar"	A IA verifica a disponibilidade e reserva o horário
Pesquisa de Produtos	"Navegue em nosso catálogo em..."	A IA pesquisa e mostra produtos correspondentes

---

Criando Ferramentas com SmartFlow

Use o gatilho Conversation Tool para criar ferramentas que sua IA pode usar durante as conversas.

Passo 1: Criar um Novo SmartFlow

1. Vá para Automação → SmartFlows
2. Clique em + Novo SmartFlow
3. Dê um nome descritivo (por exemplo, "Ferramenta de Pesquisa de Produtos")

Passo 2: Adicionar o Gatilho Conversation Tool

Arraste o gatilho Conversation Tool para a tela:

Configure o gatilho:

Campo	Descrição
Nome	Nome da ferramenta que a IA reconhecerá
Descrição	Ajuda a IA a entender quando usar esta ferramenta
Segmentação de Usuários	Quem pode usar esta ferramenta (todos os usuários, apenas conectados, etc.)
Variáveis da Ferramenta	Parâmetros que a IA deve coletar do usuário

Passo 3: Definir Variáveis

Adicione variáveis que sua IA deve coletar de forma conversacional:

Variável	Tipo	Descrição
productName	String	Qual produto pesquisar
maxPrice	Number	Filtro de preço máximo
category	String	Categoria do produto

A IA perguntará naturalmente aos usuários por esses valores durante a conversa.

Passo 4: Adicionar Ações

Conecte ações para realizar o trabalho real:

Combinações comuns de ações:

Caso de Uso	Ações
Pesquisa de Produtos	Search Knowledge → Set Observation
Criação de Tickets	JIRA Create Issue → Set Observation
Compromisso	API Call (calendar) → Send Message
Consulta de Pedido	API Call (e-commerce) → Set Observation

Passo 5: Retornar Resultados com Set Observation

Use Set Observation para enviar resultados de volta para a IA:

A IA recebe a observação e a usa para responder ao usuário.

Passo 6: Testar Sua Ferramenta

Clique em ▶ Testando para experimentar sua ferramenta:

1. Crie uma conversa de teste
2. Digite uma mensagem que deve acionar sua ferramenta
3. Observe a execução do fluxo
4. Verifique se a IA responde corretamente

---

Exemplo: Ferramenta de Pesquisa de Produtos

Objetivo: Permitir que os usuários pesquisem produtos perguntando naturalmente

Configuração do Gatilho:

• Nome: searchProducts
• Descrição: "Pesquise o catálogo de produtos por nome, categoria ou preço"
• Variáveis: query (String), maxPrice (Number, opcional)

Fluxo:

Conversation Tool Trigger
    ↓
Search Knowledge Base
  → Query: {{trigger.query}}
  → Limit: 5 results
    ↓
Set Observation
  → Results: {{searchResults}}

Experiência do Usuário:

Usuário: Você tem algum widget azul abaixo de €50?

IA: Deixe-me pesquisar isso...

    Encontrei 3 widgets azuis abaixo de €50:
    1. Widget Azul Básico - €29.99
    2. Widget Azul Pro - €45.00
    3. Widget Azul Mini - €19.99
    
    Você gostaria de mais detalhes sobre algum deles?

---

Exemplo: Criação de Ticket JIRA

Objetivo: Permitir que os usuários criem tickets de suporte a partir do chat

Configuração do Gatilho:

• Nome: createTicket
• Descrição: "Crie um ticket de suporte para problemas técnicos"
• Variáveis: title (String), description (String), priority (String)

Fluxo:

Conversation Tool Trigger
    ↓
JIRA Create Issue
  → Project: SUPPORT
  → Type: Bug
  → Summary: {{trigger.title}}
  → Description: {{trigger.description}}
    ↓
Set Observation
  → "Ticket {{jiraIssue.key}} criado com sucesso"

---

Melhores Práticas

Descrições Claras das Ferramentas

Escreva descrições que ajudem a IA a entender quando usar cada ferramenta:

// Bom
"Pesquise o catálogo de produtos por nome, categoria ou faixa de preço"

// Muito vago
"Pesquisar produtos"

Nomes de Variáveis Significativos

Use nomes de variáveis descritivos e descrições:

Variável	Descrição
customerEmail	Endereço de e-mail para consultar o pedido
appointmentDate	Data preferida para o compromisso

Lidar com Erros de Forma Elegante

Inclua tratamento de erros em suas observações:

// Sucesso
{"found": true, "results": [...]}

// Sem resultados
{"found": false, "message": "Nenhum produto corresponde à sua pesquisa"}

Testar Conversacionalmente

Teste suas ferramentas conversando naturalmente, não apenas clicando em botões. Certifique-se de que a IA:

• Pergunte pelas variáveis necessárias de forma natural
• Use a ferramenta no momento certo
• Apresente os resultados de forma clara

---

Documentação Relacionada

• Introdução ao SmartFlow — Aprenda sobre o construtor de nós
• Gatilho Conversation Tool — Referência completa do gatilho
• Observações — Retornando dados para a IA
• Visão Geral das Ações — Todas as ações disponíveis