Você está aqui:
Adicionar uma ação da ferramenta MCP ao seu agente
Adicione a ação do agente que faz referência à sua ferramenta de MCP a um agente da biblioteca de ativos para que o agente possa chamar a ferramenta em conversa.
Edições obrigatórias
| Disponível em: Lightning Experience |
| Disponível em: Edições Enterprise, Performance, Unlimited e Developer. As licenças complementares necessárias variam de acordo com o tipo de agente. |
| Permissões de usuário necessárias | |
|---|---|
| Para gerenciar ações do agente: | Gerenciar agentes de IA E as permissões necessárias para seu tipo de agente |
Se ainda não tiver feito isso, registre um servidor MCP e lista de permissões as ferramentas que deseja usar com seu agente.
Para fazer alterações ao seu agente, ele deve estar em um estado de rascunho. Se você quiser fazer alterações em um agente confirmado, criar um novo rascunho do seu agente.
Estas etapas abrangem como adicionar uma ação de ferramenta MCP a um subagente existente em seu agente. Se você quiser usar um novo subagente com sua ferramenta de MCP, consulte Gerenciar subagentes.
- Na lista Agentes no aplicativo Agentforce Studio, abra o agente ao qual deseja adicionar uma ação.
-
No painel do Explorador, passe o mouse sobre o subagente ao qual deseja adicionar a ação e clique em
.
- Selecione Adicionar da biblioteca de ativos.
-
Selecione uma ou mais ações da biblioteca de ativos para adicionar ao seu subagente e salve suas alterações.
As ações do agente que fazem referência às ferramentas MCP seguem o padrão de nomenclatura "Nome da ferramenta ServerName" e são indicadas pelo ícone de
. - Depois de adicionar uma ação de ferramenta MCP ao seu subagente, adicione instruções de raciocínio para informar ao agente como ele deve usar a ação.
- Salve suas alterações.
Quando você adiciona uma ação de ferramenta MCP ao seu agente:
- Os rótulos de entrada e saída para alguns tipos de dados (por exemplo, números) podem ser substituídos pelo rótulo "string". Isso não afeta a lógica ou o raciocínio do seu agente, mas, para facilitar o uso, recomendamos substituir os rótulos pelos valores originais da ação da ferramenta MCP na biblioteca de ativos ou do esquema de entrada ou saída da ferramenta MCP. Uma correção está a caminho.
- O campo Tipo de ação de referência aparece vazio. A ação pode ser executada sem um tipo de ação de referência, embora esteja identificada como um campo obrigatório, pois a ação de referência é preenchida. Se você clicar ou alterar o campo Tipo de ação de referência, a ação de referência será redefinida e não poderá ser redefinida manualmente para a ferramenta MCP. Nesse caso, remova a ação de seu agente e adicione-a novamente da biblioteca de ativos. Uma correção está a caminho.
Antes de confirmar e ativar seu agente, teste cuidadosamente seu agente para verificar se o desempenho da ação da ferramenta MCP é o esperado. Ajuste suas instruções de raciocínio com base nos resultados.
- Esquemas de resposta da ferramenta MCP e design do agente
As ferramentas do servidor MCP são adicionadas ao seu agente como ações do agente que fazem referência à ferramenta do servidor (ações da ferramenta MCP) e podem ser usadas exatamente como outras ações do agente. No entanto, nem todos os esquemas de resposta MCP válidos têm suporte total no Agentforce Builder. Conforme você cria seu agente, planeje diferenças em mapeamento de variável, encadeamento de ação e renderização de entrada e saída. Respostas complexas podem exigir padrões de design de agente mais simples. - Remover uma ação da ferramenta MCP de um agente
Exclua a ação do agente que faz referência a uma ferramenta de MCP para remover o acesso do seu agente. - Excluir uma ação da ferramenta MCP da biblioteca de ativos
Exclua uma ação de agente que faça referência a uma ferramenta de MCP da biblioteca de ativos para que ela não possa ser adicionada a nenhum agente. Quando você exclui uma ação do agente da biblioteca de ativos, ela ainda está disponível em quaisquer subagentes e agentes aos quais você já a tenha adicionado. Recomendamos remover a ação de qualquer agente antes de excluí-la da biblioteca de ativos.
