--- title: Ferramentas do Agent description: Dê superpoderes ao seu Agent conectando ferramentas externas — busca na web, conexões com sistemas, automações, MCP servers e sub-agents. --- # 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, se conectar a outros sistemas, executar ações em outras plataformas. ## Tipos de ferramenta disponíveis ### MCP Servers MCP (Model Context Protocol) é um padrão aberto que permite conectar o Agent a serviços externos de forma padronizada — pensa nele como uma "tomada universal" que liga o Agent a outros sistemas. O Atende Direito tem um [catálogo de MCP servers](/dev/catalogo-mcp) com integrações prontas (como Asaas, ElevenLabs, Resend, ZapSign e outros) e suporte a servidores personalizados. 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. Alguns MCP servers, como o **Google Workspace**, pedem uma conexão de conta antes de aparecerem disponíveis para uso — não uma credencial digitada à mão. Veja [Conectar Google Workspace](/guia/conectar/google-workspace) para o passo a passo. 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](/dev/cadastrar-mcp-server) para adicionar um novo. Confirme quais ferramentas do servidor ficarão disponíveis para o Agent (você pode desabilitar ferramentas específicas se quiser limitar o escopo). Para saber mais sobre MCP, consulte [Para Desenvolvedores](/dev/o-que-e-plugin). --- ### Skills Skills são instruções escritas 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. #### Skills Globais Além das Skills que você mesmo cria no seu workspace, a plataforma disponibiliza um conjunto de **Skills Globais** — nativas do Atende Direito, prontas para uso em qualquer workspace, sem precisar cadastrar nada. Na lista de Skills, elas aparecem com um badge **"Global"**. Características importantes: - **Somente-leitura para o seu workspace.** Skills Globais não podem ser editadas nem excluídas por você — os botões de editar/excluir ficam desabilitados para elas. Só a própria plataforma mantém o conteúdo dessas Skills. - **Vincular e desvincular funciona normalmente.** Você pode adicionar ou remover uma Skill Global de qualquer Agent como faria com uma Skill própria — a restrição é só sobre editar o conteúdo dela. - **Precedência: a sua Skill local sempre vence.** Se você criar, no seu workspace, uma Skill com o **mesmo nome** de uma Skill Global (por exemplo, uma versão personalizada de `humanizer`), o Agent usa a **sua versão local**, não a global. Isso permite sobrescrever o comportamento padrão da plataforma sem conflito. - **Aplicação automática.** Duas Skills Globais — `humanizer` e `formatacao-whatsapp` — são aplicadas automaticamente em todo Agent, sem precisar ser vinculadas manualmente na aba Ferramentas. As demais Skills Globais só entram em uso quando o Agent decide usá-las durante a conversa, como qualquer outra Skill. Se um Agent parece estar formatando mensagens ou aplicando um tom que você não configurou explicitamente, é provável que seja efeito de uma Skill Global aplicada automaticamente (como `humanizer` ou `formatacao-whatsapp`). Crie uma Skill local com o mesmo nome se quiser sobrescrever esse comportamento padrão. **Vincular ou desvincular uma Skill de um Agent já publicado não afeta as conversas em andamento nem as novas conversas até você republicar.** O Agent fica marcado internamente como desatualizado em relação à configuração atual. Veja o detalhe completo em [Criar seu primeiro Agent → publicar](/guia/agents/criar-primeiro). #### Resiliência: skill que não resolve mais Se uma Skill referenciada na versão publicada do Agent deixar de existir (foi excluída, recriada com outro identificador, ou pertencia a um workspace que perdeu acesso a ela), o atendimento **não para**. A plataforma identifica a referência quebrada, registra um aviso e continua a conversa ignorando só aquela Skill — as demais Skills, ferramentas e o restante do comportamento do Agent seguem funcionando normalmente. Isso vale só para skill **inexistente**. Falhas passageiras (instabilidade momentânea) não são ignoradas — a plataforma tenta novamente automaticamente, como em qualquer outra chamada de ferramenta. --- ### Function Tools Function Tools são ações programadas com um formato definido que o Agent pode chamar para executar tarefas específicas. Cada function tool tem: - Um nome - Uma descrição (para o Agent saber quando usar) - Um formato de parâmetros esperados - Uma implementação (conectada via webhook — uma chamada automática para outro sistema — ou código) São ideais para ações personalizadas que não estão no catálogo MCP. **Permissão requerida:** gravar ou trocar a credencial secreta de uma Function Tool do tipo HTTP exige a permissão de gerenciar credenciais do Agent. Editar a ferramenta sem mexer nessa credencial (nome, descrição, parâmetros, URL) continua exigindo só a permissão de editar o Agent. Na prática, uma pessoa com permissão para editar o Agent mas sem permissão para gerenciar credenciais (por exemplo, um Manager) consegue editar a ferramenta normalmente, mas recebe erro de acesso negado ao tentar definir ou trocar a credencial. --- ### Ferramentas embutidas O Atende Direito já vem com ferramentas prontas, sem precisar configurar nada: | Ferramenta | O que faz | |-----------|-----------| | Busca no Google | 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. #### CRM nativo (Atende Direito) Além das embutidas acima, todo Agent recebe **automaticamente** acesso ao CRM da própria plataforma (o sistema de gestão de contatos, negócios e conversas) como um conjunto de ferramentas — sem precisar vincular nada. O catálogo completo tem 90 ferramentas (negócios, funis/etapas, contatos, conversas, atividades, tags, campos personalizados, respostas rápidas e produtos). No painel de ferramentas/catálogo, o **Atende Direito** aparece marcado com o badge **"Interno"** — diferente dos apps externos (Asaas, ElevenLabs, etc.), que exigem clicar em "Instalar" e preencher credencial, ele já vem pré-instalado desde a criação do workspace e fica disponível para uso imediato em qualquer Agent. Como o CRM nativo é aplicado automaticamente em **todos** os Agents, qualquer Agent do seu workspace pode agir sobre o CRM (criar/mover negócios, marcar ganhos/perdas, adicionar tags, etc.). As ações são sempre restritas ao seu workspace, mas leve isso em conta ao escrever as instruções e os guardrails — defina claramente quando o Agent deve (ou não) agir sobre o CRM. ##### Catálogo seguro por padrão, com restrição opcional Todo Agent (e sub-agent) que usa o CRM nativo Atende Direito recebe, por padrão, o **catálogo seguro**: todas as ferramentas, **exceto** as que apagam dados diretamente (como excluir um contato ou excluir um funil). Isso vale mesmo quando o servidor foi adicionado manualmente na configuração do Agent — o comportamento padrão não muda. Se você quiser restringir ainda mais quais ações do CRM o Agent pode executar, isso é possível de forma avançada por integração — fale com o time técnico ou veja [Catálogo MCP → Atende Direito](/dev/catalogo-mcp) para os detalhes. Restringir quais ferramentas do CRM o Agent pode usar só tem efeito depois de **republicar o Agent** — como qualquer outra mudança de configuração, ela não se aplica retroativamente às conversas em andamento até a republicação. Veja o detalhe completo em [Criar seu primeiro Agent → publicar](/guia/agents/criar-primeiro). ##### Otimização de ferramentas sob demanda (experimental) Se você trabalha com agentes que precisam acessar muitas ferramentas, mas nem sempre utilizam todas na mesma conversa, existe um recurso experimental para reduzir o custo de cada mensagem: em vez de o Agent receber todas as ferramentas de uma vez, ele recebe apenas os grupos essenciais no início e pode carregar grupos adicionais sob demanda durante a conversa, conforme a necessidade. As 90 ferramentas do CRM estão organizadas em 11 grupos temáticos (Negócios, Pipeline, Campos de Pipeline, Contatos, Notas de Contato, Conversas, Atividades, Tags, Campos Customizados, Respostas Rápidas, Produtos), o que reduz o custo por mensagem e melhora a precisão na escolha da ferramenta certa. Esse recurso ainda é experimental e a ativação depende do time técnico — se você tem muitos agents com muitas ferramentas e sente lentidão ou custo alto, converse com o suporte. ##### Preenchimento automático de contato e conversa Nas ferramentas do CRM que atuam sobre o contato ou a conversa em andamento (cerca de 30 ferramentas — por exemplo, buscar dados do contato, adicionar tags, criar um negócio ou encerrar uma conversa), você não precisa informar o contato ou a conversa: quando o Agent não informa, a plataforma preenche automaticamente com o contato ou a conversa da interação atual. Isso reduz bastante os casos em que o Agent "inventa" um identificador. Há exceções deliberadas, que continuam exigindo que o contato ou a conversa sejam informados explicitamente — por exemplo, ao excluir um contato ou ao buscar/listar outros contatos: nesses casos, preencher automaticamente com o contato ou a conversa atual mudaria o sentido da ação (afinal, uma busca de contatos existe justamente para achar *outro* contato). ##### Validação prévia dos dados Antes de qualquer ação do CRM ser enviada, a plataforma valida os dados que o Agent montou (campo faltando, tipo errado, valor fora do esperado). Se algo estiver inválido, a ação é bloqueada e o Agent recebe de volta um erro claro apontando exatamente o campo e o problema — permitindo que ele se corrija sozinho na tentativa seguinte, sem ida e volta desnecessária ao CRM. Detalhes técnicos (rota, aliases e comportamento) em [Catálogo MCP → Atende Direito](/dev/catalogo-mcp). A busca no Google é 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 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 Sub-agents também consomem tokens (o "combustível" cobrado pelo uso de IA) e chamadas ao modelo de IA. Em cadeias longas de sub-agents, o custo e o tempo de resposta se multiplicam. Monitore o uso e simplifique sempre que possível. Quando um sub-agent inline responde no chat (transferência direta entre agents), o badge da mensagem mostra o **nome** do sub-agent que respondeu — não mais sempre o nome do Agent orquestrador. Cor e ícone, por ora, ainda vêm do orquestrador. Veja o detalhe em [Quem respondeu cada mensagem](/guia/atendimento/controle-da-ia-no-chat#quem-respondeu-cada-mensagem). #### Roteamento por etapa do CRM (além da transferência direta) Existe uma segunda forma de trocar "quem responde", diferente da delegação direta entre agents: o orquestrador consulta a **etapa atual do negócio no funil do CRM** e decide, a cada nova mensagem, qual sub-agent deve atender. É um **re-roteamento por estado** — a decisão é simples e reavaliada do zero a cada mensagem, com base na etapa do negócio associado ao contato, não uma passagem de bastão explícita entre duas partes. Exemplo do workspace de demonstração **Advocacia Serafim**, com o funil `Comercial`: | # | Etapa | Tipo | |---|-------|------| | 1 | Triagem | aberta | | 2 | SDR | aberta | | 3 | SDR - 1º Follow Up | aberta | | 4 | SDR - 2º Follow Up | aberta | | 5 | SDR - 3º Follow Up | aberta | | 6 | Closer | aberta | | 7 | Closer - 1º Follow Up | aberta | | 8 | Closer - 2º Follow Up | aberta | | 9 | Closer - 3º Follow Up | aberta | | 10 | Contrato Gerado | aberta | | 11 | Aguardando Assinatura | aberta | | 12 | Gerar Financeiro | ganho | | 13 | Desqualificado | perdido | **Regra de roteamento:** o orquestrador só direciona a conversa para a closer **Aurora** quando o negócio está numa etapa cujo nome começa com `Closer` (`Closer`, `Closer - 1º/2º/3º Follow Up`, `Contrato Gerado`, `Aguardando Assinatura`, `Gerar Financeiro`). Enquanto o negócio está em `Triagem` ou `SDR*`, quem atende é a SDR **Sofia**. Na prática, é a própria Sofia quem dispara a troca: ao qualificar o lead, ela move o negócio para a etapa `Closer`. Isso não aciona a Aurora na hora — o repasse acontece na **próxima mensagem** do contato, quando o orquestrador reavalia a etapa do CRM e roteia para quem é dono daquela etapa. O handoff Sofia → Aurora é **imediato e contínuo, no mesmo WhatsApp** — não é uma ligação telefônica nem um "alguém vai te contatar em breve". Se você está escrevendo instruções para uma SDR que qualifica e passa o bastão para uma closer, deixe isso explícito na instrução: ela deve indicar que a conversa continua ali mesmo, sem prometer contato humano ou por telefone. Os agents também têm autonomia para criar, via suas ferramentas de CRM, a estrutura que estiver faltando, em vez de depender de tudo pré-cadastrado. Antes de mover um negócio, o agent confere a lista de etapas do funil; se a etapa canônica necessária não existir, ele a cria usando o nome canônico exato e só então move o negócio. O mesmo vale para tags: o agent confere se a tag já existe antes de aplicar e, se faltar, cria a tag antes de aplicá-la ao contato. Os nomes de etapa são um **vocabulário canônico compartilhado** entre os agents — o roteamento por etapa (regra `Closer*` → Aurora, acima) depende do nome exato. O agent **não pode inventar variações** (ex.: "Fechamento" no lugar de "Closer"); só cria a etapa se ela realmente não existir, sempre com o nome canônico, evitando duplicar etapas já existentes. ## 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 personalizadas via webhook ou código próprio | | **Builtins** | Busca na web sem configuração extra | | **Sub-agents** | Delegar tarefas especializadas para Agents específicos | ## Saiba mais - [Conectar Google Workspace](/guia/conectar/google-workspace) — habilita as integrações de Google Calendar e Google Sheets no catálogo MCP - [Guardrails](/guia/agents/guardrails) — regras de segurança para o que o Agent pode dizer e fazer - [Jornada do Lead](/guia/agents/jornada-do-lead) — roteamento por etapa do CRM entre orquestrador e sub-agents - [Controle da IA no chat](/guia/atendimento/controle-da-ia-no-chat) — como o badge identifica qual agent (ou sub-agent) respondeu cada mensagem - [Criar seu primeiro Agent](/guia/agents/criar-primeiro) — por que mudar as ferramentas exige republicar o Agent