Trabalhar com o Foundry Agent Service em Visual Studio Code (pré-visualização)

Depois de começares a usar a extensão Microsoft Foundry para Visual Studio Code, usa o Foundry Agent Service 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.
• Automatize fluxos de trabalho completos.

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

Os programadores da Foundry podem manter-se produtivos desenvolvendo, testando e implementando 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 para usar com seu agente.

4. Na vista Foundry Extension, encontre a seção Recursos.

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

   

Interaja com o seu agente no designer

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

1. No prompt, insira um nome para 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 Id . Configure os seguintes campos:

   • Adicione uma descrição para o seu agente.
   • Defina as instruções do sistema.
   • Configure ferramentas para utilização pelo agente.

   

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

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

O arquivo .yaml do seu agente de IA foi aberto ao mesmo tempo que o designer. Este arquivo contém os detalhes e informações de configuração para seu 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

A Agent Service tem o seguinte conjunto de ferramentas que pode usar para interagir com as suas fontes de dados. Estas ferramentas estão disponíveis na extensão Foundry for Visual Studio Code.

• Utilização da pesquisa do Bing
• Pesquisa de ficheiros
• Interpretador de código
• Ferramentas especificadas OpenAPI
• Protocolo de contexto de modelo (MCP)

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

Adicionar uma ferramenta ao agente de IA

1. No designer, no canto superior direito da seção FERRAMENTA , selecione Adicionar ferramenta. No menu suspenso, selecione a ferramenta que pretende adicionar.

   

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

   • Fundamentação com a pesquisa do Bing

     

   • Pesquisa de ficheiros:

     

   • Intérprete 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 quaisquer novos ativos necessários. Por exemplo, se você adicionar uma ferramenta de pesquisa de arquivos, poderá usar um ativo de armazenamento de vetores existente ou criar um novo ativo para seu repositório de vetores para hospedar os arquivos carregados.

Criar um agente Azure AI no Foundry

Crie o seu agente diretamente na Foundry usando os seguintes passos:

1. No designer, selecione o botão Criar Agente na Foundry .

   

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

   

Veja os detalhes do agente de IA implantado

Selecionar o agente implantado abre o painel PREFERÊNCIAS DO AGENTE em um modo somente visualização. É possível:

• Selecione o botão Editar agente para visualizar 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 Ambiente para abrir o ambiente do agente.

Editar e atualizar o agente de IA implantado

1. No painel PREFERÊNCIAS DO AGENTE , selecione o botão Editar agente . O criador de agentes abre-se com a ficha .yaml do agente.

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

3. Depois de terminares de editar, seleciona o botão Atualizar Agente na Foundry para guardar as tuas 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 seu SDK preferido para o arquivo de código do agente e selecione a tecla Enter .

   

3. Na lista suspensa Escolha um idioma , selecione seu idioma preferido para o arquivo de código do agente e selecione a tecla Enter .

   

4. Na lista suspensa Escolha um método de autenticação, selecione o seu método de autenticação preferido para o ficheiro de código do agente e depois selecione a tecla Enter.

   

Explore o arquivo de código de exemplo

O seguinte ficheiro de código de exemplo em Python demonstra uma chamada básica para interagir com o agente através da API do Foundry Projects.

Interaja com agentes usando o playground de agentes

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

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

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

   

2. Digite seu prompt e visualize as saídas.

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

   

Explorar tópicos

A subseção Threads exibe os threads criados durante uma execução com seu agente. Na Vista de Recursos do Azure, expanda a subseção Threads para ver a lista.

Tenha estes termos em mente ao explorar tópicos:

• Um thread é uma sessão de conversa entre um agente e um usuário. Os threads armazenam mensagens e lidam automaticamente com 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 ficheiros. As mensagens são armazenadas como uma lista no thread.

• Uma execução é uma única execução 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.

Ver detalhes do tópico

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

Ver 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.

Limpeza de recursos

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

Exclua seus agentes

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

Eliminar os 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 Eliminar.

Conteúdo relacionado

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