Appearance
Ferramentas do Agent
Um atendente humano tem acesso a ferramentas: o sistema da empresa, o Google, o WhatsApp, a planilha de clientes. Sem essas ferramentas, ele fica limitado ao que sabe de memória.
O seu Agent funciona da mesma forma. Por padrão ele responde com base nas instruções e na base de conhecimento. Mas quando você conecta ferramentas, ele ganha a capacidade de agir no mundo real — buscar informações em tempo real, chamar APIs, executar ações em outros sistemas.
CAPTURAR: tela de configuração do Agent na aba 'Ferramentas' com os quatro tipos de ferramenta (MCP, Skills, Function Tools, Builtins) visíveis
Tipos de ferramenta disponíveis
MCP Servers (mcpServers)
MCP (Model Context Protocol) é um padrão aberto que permite conectar o Agent a serviços externos de forma padronizada. O Atende Direito tem um catálogo de MCP servers com integrações prontas (como Asaas, ElevenLabs, Resend, ZapSign e outros) e suporte a servidores customizados.
Quando você vincula um MCP server ao Agent, as ferramentas daquele servidor ficam disponíveis automaticamente. O Agent decide, durante a conversa, quando e como usar cada ferramenta.
Acesse a aba Ferramentas → seção MCP Servers.
Clique em Adicionar MCP Server e selecione um servidor já cadastrado ou acesse Para Desenvolvedores → Cadastrar MCP Server para adicionar um novo.
CAPTURAR: modal de seleção de MCP server com a lista de servidores disponíveis e suas ferramentas listadas
Confirme quais ferramentas do servidor ficarão disponíveis para o Agent (você pode desabilitar ferramentas específicas se quiser limitar o escopo).
CAPTURAR: lista de ferramentas do MCP server selecionado com toggles individuais para habilitar/desabilitar cada uma
Para saber mais sobre MCP, consulte Para Desenvolvedores.
Skills (skills)
Skills são instruções em markdown que descrevem capacidades específicas para o Agent. Pensa como um "manual de procedimento" para situações específicas — o Agent lê e aplica quando relevante.
Diferente das instruções gerais (que definem a personalidade), as Skills são modulares: você pode criar uma Skill de "Como lidar com pedido de cancelamento" e reusar ela em vários Agents.
CAPTURARCAPTURAR: seção 'Skills' na aba Ferramentas com uma skill de exemplo adicionada e seu conteúdo markdown visível
Function Tools (functionTools)
Function Tools são funções com schema definido que o Agent pode chamar para executar ações programáticas. Cada function tool tem:
- Um nome
- Uma descrição (para o Agent saber quando usar)
- Um schema de parâmetros (JSON Schema)
- Uma implementação (conectada via webhook ou código)
São ideais para ações customizadas que não estão no catálogo MCP.
CAPTURARCAPTURAR: formulário de criação de Function Tool com os campos nome, descrição e schema de parâmetros preenchidos
Ferramentas embutidas (builtin)
O Atende Direito já vem com ferramentas prontas, sem precisar configurar nada:
| Ferramenta | O que faz |
|---|---|
google_search | Busca informações atualizadas na web via Google. Útil para perguntas sobre notícias, dados em tempo real ou assuntos fora da base de conhecimento. |
Para habilitar, acesse a aba Ferramentas → seção Embutidas e ligue o toggle da ferramenta desejada.
CAPTURAR: seção 'Ferramentas Embutidas' com o toggle da google_search habilitado
Dica
A google_search é especialmente útil para Agents de pesquisa ou suporte que precisam responder sobre eventos recentes, jurisprudências novas ou qualquer assunto que muda com frequência.
Sub-agents (subAgents)
Você pode vincular outros Agents como "funcionários" do seu Agent principal. O Agent orquestrador delega tarefas para os sub-agents, que as executam e retornam o resultado.
Quando usar sub-agents:
- Para dividir responsabilidades (um Agent especialista em vendas, outro em suporte técnico)
- Para criar fluxos de aprovação ou validação em múltiplas etapas
- Para escalar — cada sub-agent pode usar um modelo diferente, mais barato ou mais rápido
CAPTURAR: seção 'Sub-agents' com um Agent vinculado como sub-agent e a descrição do papel que ele exerce
Atenção
Sub-agents também consomem tokens e chamadas ao LLM. Em cadeias longas de sub-agents, o custo e a latência se multiplicam. Monitore o uso e simplifique sempre que possível.
Resumo rápido
| Ferramenta | Ideal para |
|---|---|
| MCP Servers | Integrações com sistemas externos (Asaas, ElevenLabs, etc.) |
| Skills | Procedimentos e comportamentos específicos reutilizáveis |
| Function Tools | Ações customizadas via webhook ou código próprio |
| Builtins | Busca na web sem configuração extra |
| Sub-agents | Delegar tarefas especializadas para Agents específicos |