Criar e gerir agentes Foundry 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.

Foundry Agent Service permite-lhe construir, configurar e implementar agentes sem sair de Visual Studio Code (VS Code). Neste artigo, cria um agente usando o designer, adiciona ferramentas, testa o agente no playground, gera código de exemplo e limpa recursos quando termina.

Pré-requisitos

• Uma subscrição do Azure. Crie um gratuitamente.
• Acesso ao Foundry Agent Service.
• Visual Studio Code instalado.
• O Foundry Toolkit para Visual Studio Code instalado e com sessão iniciada.
• Um modelo implementado no seu projeto.

Crie um agente no designer

O designer fornece uma interface visual para configurar o nome, modelo, instruções e ferramentas do seu agente.

1. Inicia sessão nos teus recursos de Azure.

2. Define o teu projeto padrão.

3. Na vista Kit de Ferramentas Foundry, encontre a subseção Clássico na seção Recursos disponíveis.

4. Selecione o ícone mais (+) ao lado da subsecção Agentes Clássicos para criar um novo agente.

Configure o agente no designer

Depois de escolheres um local de gravação, abrem-se o ficheiro .yaml do agente e a vista designer. Configure as seguintes definições:

1. No prompt, introduza um nome para o seu agente.

2. Na lista suspensa, selecione o nome da implementação do seu modelo. O nome da implementação é o que escolheste quando implementaste um modelo existente.

3. A extensão gera o valor Id. Configure os seguintes campos:

   • Adicione uma descrição para o seu agente.
   • Definir instruções do sistema.
   • Configura ferramentas para uso de agentes.

4. Para guardar o ficheiro .yaml, selecione Guardar Ficheiro> na barra de menu VS Code.

Revise a definição YAML do agente

O ficheiro .yaml abre juntamente com o designer e contém os detalhes de configuração do seu agente. O formato é semelhante ao seguinte exemplo:

# yaml-language-server: $schema=https://aka.ms/ai-foundry-vsc/agent/1.0.0
version: 1.0.0
name: my-agent
description: Description of the agent
id: ''
metadata:
  authors:
    - author1
    - author2
  tags:
    - tag1
    - tag2
model:
  id: 'gpt-4o-1'
  options:
    temperature: 1
    top_p: 1
instructions: Instructions for the agent
tools: []

Adicionar ferramentas ao agente

A Agent Service disponibiliza as seguintes ferramentas para expandir as capacidades do seu agente e ligar-se às suas fontes de dados:

• Fundamentação com a pesquisa Bing
• Pesquisa de ficheiros
• Interpretador de código
• Ferramentas especificadas pela OpenAPI
• Protocolo de Contexto do Modelo (MCP)

Para mais informações sobre o uso de ferramentas MCP, consulte Trabalhar com o Agent Service e ferramentas de servidor MCP no Visual Studio Code (pré-visualização).

Adicione uma ferramenta ao agente

1. No designer, no canto superior direito da secção FERRAMENTA , selecione Adicionar ferramenta. Na lista suspensa, selecione a ferramenta que pretende adicionar.

   

2. O designer apresenta o painel apropriado para configurar a ferramenta, como mostrado nas imagens seguintes:

   • Pesquisa de "Grounding" com o Bing:

     

   • Pesquisa de ficheiros:

     

   • Interpretador de código:

     

   • Ferramentas especificadas pela OpenAPI 3.0:

     

3. Depois de introduzir a informação necessária, selecione Criar e ligar, Carregar e guardar, ou Criar Ferramenta. A etiqueta do botão varia consoante o tipo de ferramenta.

   Depois de criada a ferramenta, ela aparece na secção FERRAMENTA do designer.

Quando adicionas uma ferramenta, também podes adicionar quaisquer novos recursos que ela precise. Por exemplo, se adicionares uma ferramenta de pesquisa de ficheiros, podes usar um ativo de vector store existente ou criar um novo para alojar os ficheiros carregados.

Enviar o agente para a Fundição

Depois de terminares de configurar o teu agente, implementa-o no Foundry para que corra na cloud.

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

Selecione um agente implementado para abrir o painel PREFERÊNCIAS DO AGENTE em modo apenas de visualização. Neste painel, pode:

• Selecione Editar Agente para abrir o designer do agente e a definição .yaml para edição.
• Selecione Código de Visualização para gerar um ficheiro de código de exemplo que utiliza o agente.
• Selecione Abrir Playground para abrir o playground do agente remoto.

Atualizar um agente implementado

Podes modificar a configuração de um agente implementado e sincronizar as alterações de volta para o Foundry.

1. No painel PREFERÊNCIAS DO AGENTE , selecione 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. Selecione o botão Update Agent no Microsoft Foundry para guardar as suas alterações. A configuração atualizada entra em vigor imediatamente.

Gerar um ficheiro de código de exemplo

A extensão gera código padrão para interagir programaticamente com o seu agente implementado.

1. Clique com o botão direito no seu agente implementado e depois selecione Ver Código. Ou, no painel PREFERÊNCIAS DO AGENTE , selecione o botão Ver Código .

2. Na lista suspensa Escolher o seu SDK preferido , selecione o seu SDK.

3. Na lista pendente Escolher um idioma, selecione o seu idioma.

4. Na lista dropdown Escolher um método de autenticação, selecione o seu método de autenticação.

A extensão gera um ficheiro de código na língua selecionada e abre-o no editor.

Revise o ficheiro de código de exemplo

O ficheiro de código gerado demonstra uma chamada básica para interagir com o agente através da API Foundry Projects. A captura de ecrã seguinte mostra um exemplo em Python:

Teste o agente no ambiente de teste

Utilize a área de testes para enviar mensagens ao seu agente destacado e verificar o seu comportamento.

1. Clique com o botão direito no seu agente implementado e depois selecione Abrir Playground.

   Alternativamente, selecione o link Remote Agent Playground na Ferramentas subsecção, selecione o seu tipo de agente e depois selecione o seu agente nas listas pendentes.

   O painel do Remote Agent Playground abre e inicia um tópico com o seu agente.

2. Introduz o seu prompt e veja os resultados.

   Este exemplo utiliza o Bing Grounding para ilustrar uma pesquisa na web por informação. O agente usa o modelo e as ferramentas que configuraste no designer do agente. A fonte da informação aparece na secção para anotações de agentes.

   

Visualizar tópicos do agente

A subsecção Threads mostra os threads de conversação criados durante as operações com o seu agente. Na secção Clássica na vista Recursos, expanda a subseção Threads para visualizar a lista.

Ver detalhes do tópico

Para visualizar o painel DETALHES DO FIO , selecione um tópico da lista.

Ver detalhes da corrida

Para visualizar as informações da execução, selecione o botão Ver informações da execução no painel DETALHES DO THREAD. Um ficheiro .json abre com os detalhes da execução, incluindo a configuração do agente, mensagens e chamadas de ferramentas.

Liberar recursos

Se não precisar dos recursos que criou, elimine-os para evitar cobranças contínuas na sua subscrição do Azure.

Elimine os seus agentes

1. No VS Code, atualize a vista Azure Resources.
2. Expanda a subseção Agentes para mostrar a lista de agentes destacados.
3. Clique com o botão direito no agente que quer eliminar e depois selecione Eliminar.

Apague os seus modelos

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 que quer eliminar e depois selecione Eliminar.

Apaga as tuas ferramentas ligadas

1. Abre o portal Azure.

2. Vai ao grupo de recursos que contém o recurso da ferramenta.

3. Selecione o recurso e depois selecione Eliminar.

Conteúdo relacionado

• Trabalhe com o Serviço de Agentes e as ferramentas do servidor MCP em Visual Studio Code (pré-visualização) para adicionar ferramentas MCP aos seus agentes.
• Visão geral das ferramentas do agente para detalhes sobre pesquisa de ficheiros, interpretador de código e outras ferramentas disponíveis.
• Visão geral do Foundry Agent Service para uma análise mais aprofundada dos conceitos e capacidades dos agentes.