Ferramentas do Agente
Ferramentas transformam seu agente de um simples chatbot em um assistente poderoso capaz de tomar ações reais. Sem ferramentas, um agente só consegue ter conversas. Com ferramentas, ele pode consultar informações, fazer cálculos, chamar APIs e integrar com seus sistemas de negócio.
Entendendo Ferramentas
Pense em ferramentas como "superpoderes" que você concede ao seu agente. Cada ferramenta dá ao agente uma capacidade específica que ele pode usar durante conversas.
Como Ferramentas Funcionam
- Agente recebe uma solicitação - Usuário pergunta algo que pode precisar de uma ferramenta
- Agente decide - Baseado nas descrições das ferramentas, agente escolhe se deve usar uma ferramenta
- Ferramenta executa - A plataforma executa a ferramenta e retorna resultados
- Agente responde - Agente incorpora resultados da ferramenta na sua resposta
Usuário: "Qual é 15% de gorjeta em uma conta de R$47,50?"
↓
Agente pensa: "Preciso calcular isso com precisão"
↓
Agente chama: Ferramenta Calculadora com "47.50 * 0.15"
↓
Ferramenta retorna: 7.125
↓
Agente responde: "Uma gorjeta de 15% em R$47,50 seria R$7,13"O Agente Decide Quando Usar Ferramentas
Você não diz ao agente quando usar cada ferramenta—você descreve o que cada ferramenta faz. O modelo de IA do agente decide se uma ferramenta é necessária baseado no contexto da conversa e nas descrições das suas ferramentas.
Tipos de Ferramentas Disponíveis
| Tipo de Ferramenta | Propósito | Complexidade |
|---|---|---|
| Funções Internas | Cálculos básicos e data/hora | Nenhuma (apenas habilitar) |
| Integração com API | Chamar APIs REST externas | Média (configurar endpoint) |
| Base de Conhecimento | Buscar seus documentos (RAG) | Baixa (selecionar base) |
| Ferramentas Manuais | Lógica customizada no seu backend | Alta (requer código) |
| Servidores MCP | Integrações Model Context Protocol | Média-Alta (setup de servidor) |
Escolhendo o Tipo Certo de Ferramenta
Árvore de Decisão
Precisa de matemática básica ou hora atual?
→ Funções Internas
Precisa responder perguntas dos seus documentos?
→ Base de Conhecimento
Precisa chamar uma API externa?
→ Integração com API
Precisa de lógica complexa ou múltiplos passos?
→ Ferramentas Manuais (seu código processa)
Quer integrações de IA padronizadas?
→ Servidores MCPComparação de Tipos de Ferramentas
| Cenário | Melhor Tipo de Ferramenta | Por quê |
|---|---|---|
| Calcular preços | Interna (Calculadora) | Matemática simples, sem API necessária |
| Verificar status de pedido | Integração com API | Única chamada REST ao seu sistema |
| Responder perguntas sobre produtos | Base de Conhecimento | Busca sua documentação |
| Processar solicitação de reembolso | Ferramentas Manuais | Requer lógica de negócio complexa |
| Consultar CRM Salesforce | Servidores MCP | Integração padronizada disponível |
Melhores Práticas de Configuração de Ferramentas
1. Escreva Descrições Claras
A descrição da ferramenta é como o agente sabe quando usá-la. Seja específico:
❌ Vago:
"Obtém informações do cliente"
✅ Claro:
"Recupera detalhes da conta do cliente incluindo nome, email, plano de assinatura e saldo. Use quando cliente perguntar sobre status da conta ou quando você precisar verificar a identidade dele."
2. Comece Simples
Comece com o mínimo de ferramentas necessárias:
- Semana 1: Habilite funções internas (Calculadora, Data/Hora)
- Semana 2: Adicione Base de Conhecimento para FAQs
- Semana 3: Adicione integrações de API para dados em tempo real
- Mês 2: Adicione Ferramentas Manuais para workflows complexos
Muitas Ferramentas Podem Confundir
Um agente com 20 ferramentas pode ter dificuldade para escolher a certa. Comece com 3-5 ferramentas essenciais e adicione mais conforme necessário.
3. Teste Seleção de Ferramentas
No Playground, teste cenários onde você espera que ferramentas específicas sejam usadas. Verifique se o agente:
- Escolhe a ferramenta correta
- Não usa ferramentas desnecessariamente
- Trata erros de ferramentas graciosamente
4. Trate Falhas de Ferramentas
Configure suas instruções para tratar casos onde ferramentas falham:
## Tratamento de Erros de Ferramentas
Se uma chamada de ferramenta falhar ou retornar resultado inesperado:
- Peça desculpas brevemente: "Estou tendo dificuldade para acessar essa informação."
- Ofereça alternativa: "Gostaria que eu tentasse uma abordagem diferente?"
- Nunca exponha detalhes técnicos de erro para clientes.Ferramentas e Agentes de Voz
Ao usar ferramentas com agentes de voz, considere:
Tempo de Resposta
Ferramentas adicionam latência às respostas. Para chamadas de voz:
- Use sons de fundo para mascarar tempo de processamento
- Reconheça a solicitação antes de chamar ferramentas lentas: "Deixe-me verificar isso para você..."
- Prefira ferramentas mais rápidas quando múltiplas opções existirem
Reconhecimento Verbal
Instrua seu agente a reconhecer o uso de ferramentas:
Ao usar ferramentas durante uma chamada:
- Antes de chamar: "Estou verificando isso para você agora..."
- Após receber resultados: Parafraseie naturalmente, não leia dados brutosSegurança de Ferramentas
Chaves de API e Credenciais
- Armazene chaves de API na seção de credenciais seguras, não em configurações de ferramentas
- Use as permissões mínimas necessárias para cada integração
- Rotacione credenciais regularmente
Exposição de Dados
Considere quais dados as ferramentas retornam e se devem ser compartilhados:
## Tratamento de Dados Sensíveis
Quando ferramentas retornam dados de clientes:
- Só compartilhe informações que o cliente solicitou especificamente
- Nunca leia números completos de cartão de crédito ou CPFs
- Mascare dados sensíveis: "Seu cartão terminando em 4242"Documentação Relacionada
- Funções Internas - Calculadora e ferramentas de data/hora
- Integração com API - Conecte a APIs REST
- Base de Conhecimento - Busca em documentos (RAG)
- Ferramentas Manuais - Integrações backend customizadas
- Servidores MCP - Model Context Protocol