A aba Capacidades (skills) de um Agente de IA reúne tudo o que dá capacidades adicionais a ele: as integrações e as MCP, que permitem realizar ações em sistemas externos, e as lógicas, que controlam o fluxo do processo. Trabalhar com serviços externos tem dois momentos: primeiro integrar o serviço ao projeto, ou seja, vincular a conta uma única vez, e depois conectar essa integração ao agente, habilitando suas ações e descrevendo quando usá-las.

Você pode:

• Integrar serviços externos ao projeto (Google Calendar, Gmail, Google Sheets, entre outros).
• Conectar integrações e MCP a um ou mais Agentes de IA.
• Usar suas próprias ações de código como MCP internas.
• Conectar servidores MCP externos para acessar sistemas próprios da sua empresa.
• Criar e usar lógicas: instrução e condicional.
• Adicionar ferramentas (skills) e lógicas dentro de um estado do Funnel.

Pré-requisitos

Acesso à sua conta Botmaker com permissões para administrar integrações do projeto.

Pelo menos um Agente de IA criado, ao qual você vai conectar as capacidades.

As credenciais da conta do serviço externo que você vai vincular (por exemplo, o usuário do Google que administra a agenda do negócio).

Para as MCP internas, ter ações de código já criadas no projeto. Para as MCP externas, a URL do servidor MCP e seus dados de autenticação, que devem ser fornecidos pela equipe técnica que administra esse servidor.

Conceitos-chave

Integrar: vincular a conta de um serviço externo ao projeto. É feito uma única vez e deixa a integração disponível para todos os seus agentes.

Conectar: habilitar uma integração já disponível dentro de um agente, selecionando suas ações e descrevendo quando usá-las.

Ação: cada tarefa concreta que o agente pode executar no serviço externo (por exemplo, consultar disponibilidade ou criar um evento em uma agenda).

MCP (Model Context Protocol): padrão que permite que o seu Agente de IA use ferramentas de outros sistemas sem que você precise programar a conexão do zero. Cada MCP adiciona ao agente um conjunto de ações que ele pode executar durante a conversa. Na Botmaker existem dois tipos: internas e externas.

MCP internas: as que vivem dentro da Botmaker. Ali você encontra as ações de código próprias que criou no seu projeto, escritas em JavaScript ou Python.

MCP externas: servidores MCP que já existem fora da Botmaker e que você conecta informando a URL. As ferramentas já estão criadas: ao conectar o servidor, elas passam a ficar disponíveis para o seu agente. São usadas para acessar sistemas próprios da sua empresa, por exemplo o estoque da sua loja ou o seu CRM privado.

Lógicas: nós que controlam o que o agente faz e como ele avança. Existem três tipos: instrução, condicional e laço. Agora são gerenciadas dentro de Capacidades (skills).

Como integrar e conectar um serviço externo

Passo 1: Integre o serviço ao projeto

Vincule a conta do serviço externo ao seu projeto. Esse passo autoriza a Botmaker a usar esse serviço em seu nome e deixa a integração disponível para conectá-la depois aos seus agentes. É feito uma única vez por projeto: se você já integrou o Google Calendar, não precisa repetir para cada agente.

Nota: conceder permissões a um serviço externo significa autorizar o acesso àquela conta. Faça isso apenas com contas próprias do negócio e revise as permissões solicitadas.

Passo 2: Abra a aba Capacidades (skills) do agente

Entre no Agente de IA e abra a aba Capacidades (skills). Ali você verá as integrações, as MCP e as lógicas disponíveis para esse agente. O fato de uma integração aparecer na lista significa que ela já está vinculada ao projeto, não que o agente esteja usando: isso você define no passo seguinte.

Passo 3: Conecte a integração e habilite suas ações

Conecte a integração que você vai usar e selecione as ações concretas que o agente poderá executar, por exemplo consultar disponibilidade ou criar um evento. Depois descreva em quais casos ele deve usar cada uma.

Essa descrição é o que permite ao agente decidir quando recorrer a cada ação, então vale ser concreto: em vez de “consulta a agenda”, escreva “use quando o cliente pedir um horário e já tiver informado o dia que prefere”.

Nota: habilite apenas as ações de que o agente realmente precisa para o seu processo. Quanto menos opções ele tiver, mais precisa será a decisão de qual usar em cada momento.

Passo 4: Teste

Teste o comportamento pelo botão Testar do orquestrador e verifique, no raciocínio, se o agente executa a ação externa quando é o caso. O raciocínio mostra qual ferramenta ele escolheu e com quais dados a chamou, então, se o agente não usar a ação que você esperava, é ali que você vai ver o motivo.

Nota: se você for conectar uma caixa de e-mail, a vinculação é feita pelo Mailbot; depois você volta para Agentes de IA para continuar.

Como conectar MCP ao seu agente

Além das integrações prontas para usar, dentro de Capacidades (skills) você pode adicionar ao seu agente ferramentas próprias por meio de MCP. Existem duas formas de fazer isso, e cada uma resolve uma necessidade diferente:

• MCP internas: ferramentas que você cria e que vivem dentro da Botmaker, a partir das suas ações de código em JavaScript ou Python.
• MCP externas: ferramentas que já existem em um servidor MCP fora da Botmaker e que você conecta informando a URL. São o caminho para que o agente consulte sistemas próprios da sua empresa, como o estoque de uma loja ou um CRM privado.

A diferença prática é onde a ferramenta vive: nas internas o código é seu e roda dentro da Botmaker; nas externas o sistema já está construído do seu lado e a Botmaker apenas se conecta a ele.

Nota: nos dois casos, adicionar a MCP é só a primeira metade do trabalho. Depois você precisa conectá-la ao agente em Capacidades (skills) e descrever quando ele deve usar cada ferramenta, igual a qualquer integração.

MCP internas: use suas próprias ações de código

Entre no Agente de IA, abra a aba Capacidades (skills) e acesse MCP internas. Ali você verá listadas as ações de código que já criou no seu projeto, em JavaScript ou Python.

Cada ação de código é uma função que você escreveu para resolver algo pontual: calcular um desconto, validar um número de documento ou montar uma mensagem com dados do seu negócio. Ao expô-las como MCP interna, o seu agente pode executá-las durante a conversa.

Se você ainda não tem ações de código criadas, esta seção aparecerá vazia. Primeiro é preciso criá-las no seu projeto: para aprender a fazer isso, recomendamos o curso “Ações de código” da Botmaker Academy .

Conecte a ação que quiser habilitar e descreva em quais casos o agente deve usá-la, com o mesmo critério das integrações: quanto mais concreta for a descrição, melhor o agente decide.

MCP externas: conecte um servidor MCP da sua empresa

Em MCP externas você conecta servidores MCP que já existem fora da Botmaker. As ferramentas não são criadas aqui: elas já estão construídas nesse servidor e, ao conectá-lo, passam a ficar disponíveis para o seu agente.

Passo 1: Clique em Criar

Dentro de Capacidades (skills) → MCP externas, clique em Criar. O formulário de conexão será aberto.

Passo 2: Preencha os dados do servidor MCP

Você vai encontrar quatro campos. Preencha assim:

• URL do MCP: o endereço do servidor ao qual você quer se conectar. É o dado que define a qual sistema o seu agente chega, então peça-o à equipe técnica que administra esse servidor.
• Nome: como você vai identificar essa MCP dentro da Botmaker. Use um nome que diga qual é o sistema, por exemplo “Estoque loja online” ou “CRM interno”, para reconhecê-lo facilmente ao conectá-lo a diferentes agentes.
• Descrição: para que serve esse servidor e que tipo de informação ou ações ele oferece. Escreva pensando no agente: quanto mais claro estiver o que ele resolve, melhor será a decisão de quando usá-lo.
• Tipo de autenticação: como a Botmaker se identifica perante esse servidor para ter permissão de usá-lo. Escolha o que corresponde ao servidor que você está conectando; se escolher um diferente do que esse servidor espera, a conexão é recusada.

Passo 3: Conecte a MCP ao agente e habilite suas ferramentas

Criar a MCP a deixa disponível no projeto, mas nenhum agente a usa ainda. Volte para a aba Capacidades (skills) do Agente de IA, conecte-a e selecione as ferramentas concretas que quer habilitar, descrevendo em quais casos ele deve usá-las.

Passo 4: Teste

Teste o comportamento pelo botão Testar do orquestrador e verifique, no raciocínio, se o agente chama a ferramenta do MCP quando é o caso e se a resposta do servidor chega completa.

Como usar as lógicas

As lógicas controlam como o processo do agente avança e são gerenciadas dentro de Capacidades (skills). Existem três tipos:

• Instrução: indica ao agente uma tarefa pontual, descrita em linguagem natural.
• Condicional: abre caminhos diferentes conforme uma condição seja ou não cumprida.
• Laço (loop): repete um conjunto de passos, por exemplo percorrer uma lista, até cumprir uma condição.

Além de gerenciá-las nesta aba, você pode adicionar uma lógica dentro de um estado do Funnel, na seção Instruções para o agente. Esse é o caminho recomendado quando a lógica se aplica apenas a um momento pontual do processo, e não ao agente inteiro.

Considerações importantes

• Integrar não é conectar: integrar vincula a conta ao projeto e é feito uma única vez; conectar habilita essa integração dentro de um agente específico. Se o agente não vê uma ferramenta que você já integrou, quase sempre falta o passo de conectá-la.
• As integrações dependem do serviço externo: se o serviço apresentar uma instabilidade, o agente pode informar que não consegue concluir a ação temporariamente. Não é um erro de configuração.
• As MCP externas dependem de um sistema que a Botmaker não administra: se o servidor estiver fora do ar, mudar de URL ou alterar suas ferramentas, o agente também não conseguirá concluir a ação. Diante de um comportamento estranho, verifique primeiro o estado desse servidor.
• Cuide das permissões e dos dados: uma MCP externa pode dar acesso a informações sensíveis do seu negócio. Conecte apenas servidores próprios ou de fornecedores de confiança, e use credenciais com as permissões mínimas necessárias.
• A descrição não é um detalhe: tanto nas integrações quanto nas MCP, a descrição de quando usar cada ação é o que guia a decisão do agente. Se ele não usa uma ferramenta que você esperava, comece revisando esse ponto.

Para saber mais sobre as ações de código que são expostas como MCP internas, compartilhamos o curso “Ações de código” da Botmaker Academy.

Lembre-se de visitar nossa Central de Ajuda para obter mais informações.