Trabalhar com o Serviço do Foundry Agent no Visual Studio Code (versão prévia)

Depois de começar a usar a extensão Microsoft Foundry para Visual Studio Code, use o Serviço do Foundry Agent para criar agentes. Os agentes são microsserviços que:

• Responda a perguntas usando seus dados de treinamento ou pesquise outras fontes com geração aumentada de recuperação (RAG).
• Execute ações específicas.
• Automatizar fluxos de trabalho completos.

Os agentes combinam modelos de IA com ferramentas para acessar e interagir com seus dados.

Os desenvolvedores de Foundry podem se manter produtivos desenvolvendo, testando e implantando agentes no ambiente familiar do Visual Studio Code (VS Code).

Criar e editar um agente de IA do Azure no modo de exibição do designer

Siga estas etapas para criar um agente de IA do Azure:

1. Entre em seus recursos do Azure.

2. Defina seu projeto padrão.

3. Implante um modelo a ser usado com seu agente.

4. Na visualização da Extensão Foundry, localize a seção Recursos.

5. Selecione o ícone de adição (+) ao lado da subseção Agents para criar um novo agente de IA.

   

Interagir com seu agente no designer

Depois de escolher o local de salvamento, o arquivo .yaml do agente e o modo de exibição do designer são abertos para que você possa editar seu agente de IA. Execute as seguintes tarefas no designer do agente:

1. Na solicitação, insira um nome para o seu agente.

2. Na lista suspensa, selecione o nome da implantação do modelo. O nome da implantação é o que você escolheu quando implantou um modelo existente.

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

   • Adicione uma descrição para o agente.
   • Defina as instruções do sistema.
   • Configurar ferramentas para uso por parte do agente.

   

4. Para salvar o arquivo .yaml, selecione Salvar Arquivo> na barra de menus do VS Code.

Explorar a definição .yaml do agente de IA do Azure

Seu arquivo .yaml do Agente de IA foi aberto ao mesmo tempo que o designer. Esse arquivo contém os detalhes e as informações de configuração do agente. É semelhante ao seguinte exemplo de arquivo .yaml:

# 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 de IA do Azure

O Serviço de Agente tem o seguinte conjunto de ferramentas que você pode usar para interagir com suas fontes de dados. Essas ferramentas estão disponíveis na extensão Foundry para Visual Studio Code.

• Grounding com pesquisa do Bing
• Pesquisa de arquivo
• Interpretador de códigos
• Ferramentas especificadas para OpenAPI
• Protocolo de Contexto de Modelo (MCP)

Para obter mais informações sobre como usar ferramentas MCP, consulte Work with Agent Service e ferramentas de servidor MCP no Visual Studio Code (versão prévia).

Adicionar uma ferramenta ao agente de IA

1. No designer, no canto superior direito da seção FERRAMENTA , selecione Adicionar ferramenta. Na lista suspensa, selecione a ferramenta que você deseja adicionar.

   

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

   • Aterramento com a pesquisa do Bing:

     

   • Pesquisa de arquivo:

     

   • Interpretador de código:

     

   • Ferramentas especificadas do OpenAPI 3.0:

     

3. Depois de inserir as informações necessárias, selecione Criar e conectar, Carregar e salvar ou Criar Ferramenta. O botão varia de acordo com o painel.

Ao adicionar uma ferramenta, você também pode adicionar todos os novos ativos necessários. Por exemplo, se você adicionar uma ferramenta de pesquisa de arquivos, poderá usar um ativo existente do repositório de vetores ou criar um novo ativo para o repositório de vetores hospedar seus arquivos carregados.

Criar um agente de IA do Azure no Foundry

Crie seu agente diretamente na Foundry usando as seguintes etapas:

1. No designer, selecione o botão Criar Agente na Fundiária .

   

2. No VS Code, atualize o modo de exibição Recursos do Azure. O agente implantado aparece na subseção Agentes.

   

Exibir os detalhes do agente de IA implantado

Selecionar o agente implantado abre o painel AGENT PREFERENCES em um modo somente exibição. É possível:

• Selecione o botão Editar Agente para exibir o designer do agente e a definição .yaml do agente para edição.
• Selecione o botão Abrir arquivo de código para criar um arquivo de código de exemplo que usa o agente.
• Selecione o botão Abrir Playground para abrir o playground do agente.

Editar e atualizar o agente de IA implantado

1. No painel PREFERÊNCIAS DO AGENTE , selecione o botão Editar Agente . O designer do agente é aberto com o arquivo .yaml do agente.

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

3. Depois de concluir a edição, selecione o botão Atualizar Agente no Foundry para salvar suas alterações.

Criar um arquivo de código de exemplo

1. Clique com o botão direito do mouse no agente implantado e selecione a opção Abrir Arquivo de Código . Ou, no painel PREFERÊNCIAS DO AGENTE , selecione o botão Abrir Arquivo de Código .

   

2. Na lista suspensa Escolha seu SDK preferido, selecione o SDK preferido para o arquivo de código do agente e, em seguida, selecione a tecla Enter.

   

3. Na lista suspensa Escolher um idioma , selecione seu idioma preferido para o arquivo de código do agente e, em seguida, selecione a chave Enter .

   

4. Na lista suspensa Escolher um método de autenticação, selecione seu método de autenticação preferido para o arquivo de código do agente e, em seguida, pressione a tecla Enter.

   

Explorar o arquivo de código de exemplo

O arquivo de código de exemplo python a seguir demonstra uma chamada básica para interagir com o agente por meio da API de Projetos do Foundry.

Interagir com agentes usando o playground do agente

1. Clique com o botão direito do mouse no agente implantado e selecione a opção Abrir Playground .

   Como alternativa, selecione o link Playground do Agente na subseção Ferramentas e selecione seu agente na lista suspensa.

   Esta etapa abre o painel Agent Playground e inicia uma thread com seu agente para que você possa enviar mensagens.

   

2. Insira seu prompt e exiba as saídas.

   Esse exemplo usa o Aterramento do Bing para ilustrar uma pesquisa na Web para obter informações. O agente usa o modelo e as ferramentas que você configurou no designer do agente. A origem das informações aparece na seção para anotações do agente.

   

Explorar threads

A subseção Threads exibe os threads criados durante uma execução com seu agente. No modo de exibição do Recursos do Azure, expanda a subseção Threads para exibir a lista.

Tenha esses termos em mente ao explorar threads:

• Um thread é uma sessão de conversa entre um agente e um usuário. Os threads armazenam mensagens e manipulam automaticamente o truncamento para ajustar o conteúdo ao contexto de um modelo.

• Uma mensagem é uma única interação entre o agente e o usuário. As mensagens podem incluir texto, imagens e outros arquivos. As mensagens são armazenadas como uma lista no thread.

• Uma execução é uma execução única de um agente. Cada execução pode ter vários threads e cada thread pode ter várias mensagens. O agente usa sua configuração e as mensagens de um thread para executar tarefas chamando modelos e ferramentas. Como parte de uma execução, o agente acrescenta mensagens ao thread.

Exibir detalhes do thread

Para exibir o painel DETALHES DO THREAD , selecione um thread.

Exibir detalhes da execução

Para exibir informações de execução em um arquivo JSON, selecione o botão Exibir informações de execução no painel DETALHES DO THREAD . A captura de tela a seguir mostra um arquivo JSON de exemplo.

Limpar os recursos

Os recursos do Azure criados neste artigo são cobrados para sua assinatura do Azure. Se você não espera precisar desses recursos no futuro, exclua-os para evitar incorrer em mais encargos.

Excluir seus agentes

1. No VS Code, atualize o modo de exibição Recursos do Azure. Expanda a subseção Agents para exibir a lista de agentes implantados.
2. Clique com o botão direito do mouse no agente implantado que você deseja excluir e selecione Excluir.

Exclua seus modelos

1. No VS Code, atualize o modo de exibição Recursos do Azure. Expanda a subseção Modelos para exibir a lista de modelos implantados.

2. Clique com o botão direito do mouse no modelo implantado que você deseja excluir e selecione Excluir.

   

Excluir suas ferramentas conectadas

1. Abra o portal do Azure.

2. Selecione o grupo de recursos do Azure que contém a ferramenta.

3. Selecione o botão Excluir.

Conteúdo relacionado

• Saiba mais sobre as ferramentas que você pode usar com agentes de IA do Azure, como pesquisa de arquivo ou interpretador de código.