Configurar o Visual Studio Code para desenvolvimento de agentes

  • 7 minutos

Configurar o Visual Studio Code para o desenvolvimento de agentes de IA traz capacidades de nível empresarial diretamente para o seu ambiente de desenvolvimento familiar. A extensão Microsoft Foundry transforma o VS Code numa plataforma abrangente para construir, testar e implementar agentes sem sair do seu editor.

Compreender a extensão Microsoft Foundry

A extensão Microsoft Foundry para Visual Studio Code fornece acesso direto às capacidades do Microsoft Foundry Agent Service. Esta extensão cria uma experiência integrada para o desenvolvimento de agentes que combina ferramentas de design visual com configuração baseada em código.

A extensão organiza as suas funcionalidades em três secções: Recursos (para gerir modelos implementados, agentes declarativos, agentes alojados, ligações e armazenamentos vetoriais), Ferramentas (para aceder ao catálogo de modelos, playgrounds e funcionalidades de implementação) e Ajuda e Feedback.

Captura de ecrã da interface da extensão Microsoft Foundry VS Code a mostrar as secções de Recursos, Ferramentas e Ajuda e Feedback.

Instalação e configuração da extensão

Configurar a extensão Microsoft Foundry demora apenas alguns minutos e requer uma configuração mínima.

Etapas de instalação

  1. Abra o Visual Studio Code na sua máquina
  2. Selecione Extensões no painel esquerdo, ou pressione Ctrl+Shift+X (Windows/Linux) ou Cmd+Shift+X (Mac)
  3. Pesquise por Foundry na caixa de pesquisa do mercado
  4. Selecione a extensão Microsoft Foundry nos resultados
  5. Selecione Instalar para adicionar a extensão ao VS Code
  6. Aguarde que a instalação termine (o estado aparece no painel de Extensões)

Após a instalação, o ícone do Microsoft Foundry aparece na barra de atividade do VS Code no lado esquerdo da janela.

Ligação ao Azure

Antes de trabalhar com agentes, ligue a extensão à sua conta e projeto Azure:

  1. Selecione o ícone Azure na barra de atividade do VS Code
  2. No painel Recursos do Azure, inicie sessão na sua conta Azure caso seja solicitado.
  3. Expande a tua subscrição Azure na árvore de recursos
  4. Expanda a secção Foundry para ver os seus projetos
  5. Clique com o botão direito no projeto Microsoft Foundry
  6. Selecione Abrir na Extensão Foundry

A extensão agora mostra os recursos do seu projeto no painel Microsoft Foundry, incluindo agentes existentes, implementações de modelos, ligações e armazenamentos vetoriais.

Preparação para o desenvolvimento do agente

Antes de trabalhar com agentes no VS Code, certifique-se de que tem os recursos necessários disponíveis.

Implementação de um modelo

Os agentes precisam de modelos de IA implementados para funcionar. Se ainda não tem um modelo de implantação:

  1. Na extensão Microsoft Foundry, navegue até à secção de Recursos
  2. Expandir a subsecção de implementações de modelos
  3. Selecione o + ícone (mais) para criar uma nova implementação
  4. Escolha um modelo (como GPT-4o ou GPT-4) entre as opções disponíveis
  5. Configurar as definições de implementação:
    • Nome da implementação: Introduza um nome descritivo que irá usar ao configurar agentes
    • Versão do modelo: Selecione a versão específica do modelo
    • Definições de capacidade: Configure a taxa de transferência com base nas suas necessidades
  6. Selecione Implementar e aguarde que a implementação seja concluída

O modelo implementado fica disponível nos menus suspensos quando configuras agentes.

Trabalhar com agentes no VS Code

Os agentes são frequentemente criados no portal Foundry (conforme descrito na unidade anterior) e depois geridos e configurados no VS Code através da extensão. Depois de criar um agente no portal, ele aparece automaticamente na secção de Recursos da extensão.

As alterações aos agentes no VS Code podem ser guardadas diretamente no Foundry, para que possa trabalhar com o seu agente em várias plataformas.

Gerir múltiplos agentes

À medida que os seus projetos crescem, provavelmente irá gerir vários agentes com diferentes propósitos. A extensão Microsoft Foundry torna isto simples:

  • Navegar pelos agentes na vista de Recursos organizados por projeto
  • Alterna entre agentes selecionando-os da lista
  • Compare configurações abrindo vários ficheiros YAML lado a lado
  • Agentes duplicados para criar variações sem começar do zero
  • Arquive agentes não utilizados para manter o seu espaço de trabalho organizado

A extensão mantém uma visão clara de todos os seus agentes, facilitando a navegação entre diferentes projetos de automação.

Configurar o Visual Studio Code para desenvolvimento de agentes proporciona um ambiente poderoso e integrado que acelera todo o ciclo de vida do desenvolvimento. Com a extensão Microsoft Foundry, ganha capacidades de desenvolvimento de agentes de nível empresarial sem sair do seu editor de código familiar, permitindo uma iteração rápida e uma implementação fluida de automação inteligente.