Trabalhar com agentes Foundry e ferramentas de servidor MCP no Visual Studio Code (clássico)

Aplica-se apenas a:Portal Foundry (clássico). Este artigo não está disponível para o novo portal da Foundry. Saiba mais sobre o novo portal.

Neste artigo, adiciona e utiliza as ferramentas de servidor do Model Context Protocol (MCP) com agentes no Foundry Agent Service. Utilizas a extensão Microsoft Foundry para Visual Studio Code para configurar e testar agentes de chamada de ferramentas MCP.

Depois de construir um agente no Agent Service usando a extensão Visual Studio Code (VS Code), pode adicionar ferramentas MCP ao seu agente. Adicionar um servidor MCP permite ao seu agente:

• Aceda a informações atualizadas das suas APIs e serviços.
• Recupere contexto relevante para melhorar a qualidade das respostas dos seus modelos de IA.

Pré-requisitos

• Uma subscrição do Azure. Se não tiveres um, cria um gratuitamente.
• Um projeto da Foundry com um modelo implementado.
• Visual Studio Code com a extensão Microsoft Foundry para Visual Studio Code instalada.
• Um agente existente criado através da extensão VS Code. Para criar uma, siga os passos em Trabalhe com o Serviço de Agentes em Visual Studio Code.
• Um endereço URL remoto de servidor MCP para se ligar ao seu agente.

Crie um agente no designer

Para criar um agente, siga os passos em Criar um agente no designer.

Adicionar uma ferramenta de servidor MCP ao agente

Depois de criares o teu agente, podes adicionar ferramentas, incluindo ferramentas MCP. Para mais informações sobre as ferramentas disponíveis, consulte Ferramentas para agentes.

Podes trazer vários servidores MCP remotos adicionando-os como ferramentas. Para cada ferramenta, é necessário fornecer um valor único de Etiqueta do Servidor dentro do mesmo agente e um valor de URL do Servidor que aponte para o servidor MCP remoto.

Para adicionar uma ferramenta de servidor MCP ao seu agente, siga estes passos:

1. No designer, no canto superior direito da secção FERRAMENTA , selecione o botão Adicionar ferramenta . Na lista suspensa, selecione a ferramenta MCP Server .

2. Encontra o servidor MCP remoto ao qual queres ligar-te, como o servidor MCP do GitHub. Crie ou atualize um agente Foundry com uma ferramenta MCP utilizando a seguinte informação:

   1. URL do Servidor: A URL do servidor MCP; por exemplo, https://gitmcp.io/Azure/azure-rest-api-specs.

   2. Etiqueta do servidor: Um identificador único deste servidor MCP para o agente; por exemplo, fetch_rest_api_docs.

3. Na lista suspensa de Ferramentas Permitidas, escolha quais ferramentas o servidor MCP pode usar.

4. Depois de introduzir a informação necessária, selecione o botão Criar ferramenta . A ferramenta MCP aparece na secção TOOL do designer do agente.

Enviar o agente para a Fundição

Depois de adicionares uma ferramenta MCP, implementa o agente no Foundry para que esteja disponível para testes e uso.

1. No designer, selecione o botão Create Agent no Microsoft Foundry.

2. No VS Code, atualize a vista de Recursos . O agente destacado aparece na subsecção de Agentes Clássicos .

Ver detalhes dos agentes destacados

Depois de implementares um agente, podes inspecionar a sua configuração e interagir com ele. Selecione o agente implementado na vista de Recursos para abrir o painel PREFERÊNCIAS DO AGENTE em modo apenas de visualização. Podes:

• Selecione o botão Editar Agente para ver o designer do agente e a definição .yaml do agente para edição.
• Selecione o botão Ver Código para criar um ficheiro de código de exemplo que utilize o agente.
• Selecione o botão Abrir Playground para abrir o ambiente experimental do agente.

Editar agente implementado

Para modificar a configuração do seu agente após a implementação, siga estes passos:

1. No painel PREFERÊNCIAS DO AGENTE , selecione o botão Editar Agente . O designer do agente começa com o ficheiro .yaml do agente.

2. Edite a configuração do agente, como o modelo, ferramentas e instruções.

3. Depois de terminares de editar, seleciona o botão Update Agent no Microsoft Foundry para guardar as tuas alterações. A configuração atualizada é implementada no Foundry.

Teste o agente com ferramentas MCP no recreio

Utilize o ambiente de testes do agente para verificar se as ferramentas do seu servidor MCP funcionam corretamente com o agente implementado.

1. Clique com o botão direito no agente implementado que tenha uma ferramenta MCP Server e depois selecione a opção Open Playground . Esta ação inicia uma conversa com o seu agente para que possa enviar mensagens.

2. No painel do Remote Agent Playground , introduza um prompt como Dá-me um exemplo para criar uma aplicação de contentor e envia-o.

3. Selecione o método de autenticação para a ferramenta de servidor MCP e prossiga. Os métodos de autenticação variam consoante o servidor MCP. Opções comuns incluem chave API, OAuth ou ausência de autenticação para servidores públicos.

4. Selecione a preferência de aprovação para a ferramenta de servidor MCP e prossiga. Pode escolher Perguntar sempre para rever cada chamada de ferramenta, ou Permitir sempre que o agente invoque automaticamente as ferramentas MCP.

5. Se escolheu Perguntar sempre como a sua preferência de aprovação, precisa de aprovar ou rejeitar cada chamada de ferramenta antes de o agente avançar.

6. O agente usa o modelo e as ferramentas do servidor MCP que configuraste para recuperar a informação. Depois de o agente terminar o processamento, a resposta aparece no parque infantil. A fonte da informação aparece na secção para anotações de agentes.

Solucionar problemas de conexões ao servidor MCP

Se encontrar problemas ao usar as ferramentas do servidor MCP com o seu agente, experimente as seguintes resoluções.

Liberar recursos

Os recursos do Azure que criou neste artigo são faturados para a sua subscrição do Azure. Se não espera precisar destes recursos no futuro, elimine-os para evitar mais cobranças.

Elimine os seus agentes

Para remover agentes de que já não precisa:

1. No VS Code, atualize a vista de Recursos . Expanda a subseção Agentes Clássicos para mostrar a lista de agentes destacados.

2. Clique com o botão direito no agente implementado que quer eliminar e depois selecione Eliminar.

Apague os seus modelos

Para remover modelos implementados que já não precisa:

1. No VS Code, atualize a vista de Recursos . Expanda a subseção Modelos para mostrar a lista de modelos implementados.

2. Clique com o botão direito no modelo implementado que quer eliminar e depois selecione Eliminar.

Apaga as tuas ferramentas ligadas

Para remover recursos de ferramentas ligadas que já não precisa, elimine-os individualmente no portal Azure:

1. Abre o portal Azure.

2. Vai ao grupo de recursos que contém o teu projeto Foundry.

3. Encontra o recurso específico da ferramenta que queres eliminar e seleciona-o.

4. Selecione o botão Apagar e confirme a eliminação.

Conteúdo relacionado

• Ferramenta Model Context Protocol (MCP)
• Ferramentas para agentes
• Trabalhe com o Serviço de Agentes em Visual Studio Code
• Comece com projetos Foundry no VS Code
• Ferramenta de pesquisa de ficheiros
• Ferramenta de interpretação de código