Trabalhar com a extensão Microsoft Foundry Toolkit for Visual Studio Code

Neste artigo, saiba como instalar e usar o Microsoft Foundry Toolkit para Visual Studio Code extensão. Crie projetos, implante modelos do catálogo de modelos do Foundry e interaja com ambientes de teste para modelos diretamente no VS Code.

Pré-requisitos

Instalar a extensão

Para usar os recursos do Foundry no VS Code, instale a extensão Microsoft Foundry Toolkit for Visual Studio Code. Instale do Visual Studio Code Marketplace ou diretamente de dentro do VS Code.

Instalar do Visual Studio Code Marketplace

Use o marketplace para instalar a extensão sem abrir o VS Code primeiro.

  1. Abra a página Microsoft Foundry Toolkit for Visual Studio Code extension.
  2. Selecione o botão Instalar .
  3. Siga os prompts para instalar a extensão no Visual Studio Code.
  4. Após a instalação, abra Visual Studio Code e verifique se a extensão foi instalada com êxito nas mensagens de status.
  5. O ícone do Foundry Toolkit aparece na barra de navegação primária no lado esquerdo do VS Code.

Instalar de dentro de Visual Studio Code

Como alternativa, pesquise a extensão diretamente na exibição de extensões do VS Code.

  1. Abra o VS Code.

  2. Selecione Extensões no painel esquerdo.

  3. Selecione o ícone Configurações no canto superior direito no painel de extensões.

  4. Pesquise e selecione o Kit de Ferramentas do Foundry para VS Code.

  5. Selecione Instalar.

  6. Após a conclusão da instalação, uma mensagem de status confirma se a extensão está instalada. O ícone do Foundry Toolkit é exibido na barra de navegação à esquerda.

Conectar-se aos recursos do Azure

Depois de instalar a extensão, entre em sua assinatura Azure e abra um projeto do Foundry para começar a trabalhar com modelos, agentes e playgrounds.

Nota

Para obter uma lista completa dos recursos disponíveis na extensão, use a paleta de comandos. Selecione F1 para abrir a paleta de comandos e pesquisar o Foundry Toolkit. A captura de tela a seguir mostra alguns dos comandos disponíveis. Captura de tela da paleta de comandos do VS Code mostrando os comandos disponíveis do Foundry Toolkit, como Open Model Catalog e Open Playground.

Entre em seus recursos

Entre em sua assinatura Azure para que a extensão possa acessar seus projetos do Foundry e modelos implantados.

  1. Selecione o ícone Azure na barra de navegação do VS Code.

  2. Selecione Entrar em Azure... na exibição Recursos do Azure.

  3. Na seção Resources, selecione sua assinatura Azure e o grupo de recursos.

  4. Selecione Foundry e clique com o botão direito do mouse em seu projeto.

  5. Selecione Abrir na extensão Foundry Toolkit.

    Os recursos do projeto do Foundry são exibidos no modo de exibição de extensão e o ícone Foundry é exibido na barra de navegação do VS Code.

A extensão Microsoft Foundry Toolkit for Visual Studio Code organiza seu workspace em três seções principais.

Screenshot da interface de extensão Microsoft Foundry Toolkit for Visual Studio Code mostrando as seções Recursos, Ferramentas e Ajuda e Comentários.

Seção O que ele contém Quando usá-lo
Meus Recursos Modelos implantados, agentes declarativos, agentes hospedados, conexões e armazenamento de vetores para seu projeto Foundry. Exiba e gerencie os recursos do projeto.
Ferramentas para Desenvolvedores Catálogo de Modelos, Playground de Modelos, Playgrounds de Agentes (remoto e local), Visualizador Local e Implantação de Agentes Hospedados. Implante novos modelos, teste prompts e interaja com agentes.
Ajuda e comentários Documentação, GitHub repositório, política de privacidade Microsoft e links da comunidade. Obtenha ajuda ou forneça comentários.

Criar um projeto

Crie um novo projeto do Foundry diretamente da extensão para organizar seus modelos e recursos.

  1. Selecione + Criar Project na seção My Resources do Microsoft Foundry Toolkit for Visual Studio Code extension view.

    Você pode criar um novo grupo de recursos ou selecionar um existente.

  2. Para criar um novo grupo de recursos:

    1. Selecione Criar novo grupo de recursos e pressione Enter.

    2. Insira o nome do grupo de recursos Azure na caixa de texto Enter novo grupo de recursos e pressione Enter.

    3. Selecione o local que você deseja usar na lista de locais disponíveis e pressione Enter.

  3. Para usar um grupo de recursos existente:

    • Selecione o grupo de recursos que você deseja usar na lista de grupos de recursos disponíveis e pressione Enter.

  4. Insira o nome do projeto Foundry na caixa de texto Inserir nome do projeto e pressione Enter.

Após a implantação do projeto, um pop-up é exibido com a mensagem Projeto implantado com sucesso.

Para implantar um modelo no projeto recém-criado, selecione o botão Implantar um modelo no pop-up. Essa ação abre a página Catálogo de Modelos em que você pode selecionar o modelo desejado para implantar.

Alternar o projeto padrão

Quando você abre um projeto na extensão Microsoft Foundry Toolkit for Visual Studio Code, esse projeto é definido como seu projeto padrão. Para alternar seu projeto padrão:

  1. Clique com o botão direito do mouse no projeto Foundry e selecione a opção Switch Default Project na Azure Extension.

  2. Selecione o projeto Foundry que você deseja usar na lista de projetos disponíveis e pressione Enter.

O projeto selecionado agora exibe Padrão após o nome do projeto.

Dica

Clique com o botão direito do mouse no nome do projeto para acessar o ponto de extremidade do projeto ou a chave da API do projeto.

Trabalhar com modelos

A extensão Microsoft Foundry Toolkit for Visual Studio Code permite descobrir, implantar e interagir com modelos do catálogo de modelos Foundry diretamente no VS Code.

Navegar pelo catálogo de modelos

O catálogo de modelos fornece acesso a modelos de Microsoft, OpenAI, Meta, DeepSeek e outros provedores. Você pode abrir o catálogo de modelos de várias maneiras:

  • Execute o comando Foundry Toolkit: Mostrar catálogo de modelos na paleta de comandos.
  • Selecione o ícone plus ao lado de Models na seção My Resources do Microsoft Foundry Toolkit for Visual Studio Code extension view.
  • Selecione o link Model Catalog na seção Developer Tools do Microsoft Foundry Toolkit for Visual Studio Code extension view.

Abra o catálogo de modelos na paleta de comandos

Use a paleta de comandos para abrir o catálogo de modelos sem navegar na janela da extensão.

  1. Selecione F1 para abrir a paleta de comandos.

  2. Insira o Foundry Toolkit: mostre o catálogo de modelos e pressione Enter.

  3. A página Catálogo de Modelos é aberta.

    Captura de tela da página Catálogo de Modelos no VS Code mostrando cartões de modelo com filtros para o editor e o tipo de modelo.

  4. Filtre o Model Catalog por Hospedado por, Editora, Funcionalidade ou Tipo de modelo usando as listas suspensas na parte superior da página. Selecione o alternador Suporte de Fine-Tuning para filtrar modelos que dão suporte ao ajuste fino.

  5. Pesquise um modelo específico usando a barra de pesquisa no centro superior da página.

Abra o catálogo de modelos na seção Recursos

Na exibição de extensão Microsoft Foundry Toolkit for Visual Studio Code, selecione o ícone plus ao lado de Models para abrir o catálogo de modelos.

Dica

Você também pode clicar com o botão direito do mouse em Modelos e selecionar Implantar novo modelo de IA para ir diretamente para o fluxo de implantação.

Abra o catálogo de modelos na seção Ferramentas

Na seção Developer Tools do Microsoft Foundry Toolkit for Visual Studio Code extension view, clique duas vezes no link Model Catalog.

Implantar um modelo do catálogo de modelos

Depois de encontrar um modelo no catálogo, implante-o em seu projeto do Foundry para que você possa usá-lo em seus aplicativos.

  1. Selecione o botão Implantar ao lado do nome do modelo selecionado.

  2. A página de implantação do Modelo é aberta.

  3. Insira o nome da implantação do modelo na caixa de texto Inserir nome de implantação e pressione Enter.

  4. Selecione o tipo de implantação na lista suspensa Tipo de implantação .

  5. Selecione a versão do modelo no menu suspenso Versão do modelo.

  6. (Opcional) Ajuste os tokens por minuto usando o controle deslizante Tokens por minuto.

  7. Selecione o botão Implantar no Foundry no canto inferior esquerdo.

  8. Na caixa de diálogo de confirmação, selecione Implantar.

  9. Após a conclusão da implantação, o modelo aparece pelo nome da implantação na seção Modelos em seu projeto.

Exibir e gerenciar modelos implantados

Expanda a seção Models na exibição de extensão Microsoft Foundry Toolkit for Visual Studio Code para ver todos os modelos implantados em seu projeto.

Exibir informações do cartão de modelo

Selecione um modelo implantado para abrir um painel com os seguintes detalhes:

  • Informações de Implantação: Nome, estado de provisionamento, tipo de implantação, limite de taxa, informações de versão, nome do modelo e versão do modelo.
  • Informações do endpoint: URL de destino, tipo de autenticação e chave.
  • Links úteis: repositório de exemplo de código e links de tutorial para desenvolvimento de aplicativos de IA.

Atualizar as configurações de implantação do modelo

Para atualizar as configurações de implantação, como limites de taxa:

  1. Selecione o botão Editar no canto superior direito do cartão de modelo.
  2. Atualize os campos editáveis.
  3. Selecione o botão Salvar para aplicar as alterações.

Gerar código de exemplo para um modelo

Gere um arquivo de código inicial para o modelo implantado para acelerar o desenvolvimento do aplicativo.

  1. Clique com o botão direito do mouse no modelo implantado e selecione Abrir arquivo de código.

  2. Selecione seu SDK preferencial na lista suspensa Escolher SDK preferencial .

  3. Selecione seu idioma preferido na lista suspensa Escolher idioma .

  4. Selecione seu método de autenticação preferencial na lista suspensa Escolher método de autenticação .

  5. Um arquivo de código de exemplo é aberto em uma nova guia no VS Code.

A captura de tela a seguir mostra um exemplo de Python gerado que faz uma chamada síncrona para a API de respostas:

Screenshot de um arquivo de código de exemplo Python gerado mostrando uma chamada de API de respostas síncronas no VS Code.

Interaja com modelos no playground

Use a área experimental do modelo para interagir com seu modelo implantado, ajustar configurações e modificar as instruções do sistema.

Para abrir o playground, clique duas vezes no link Model Playground na seção Developer Tools do Microsoft Foundry Toolkit for Visual Studio Code extension view. Como alternativa, clique com o botão direito do mouse no modelo implantado e selecione Abrir no playground.

  1. A página Playground é aberta.

  2. Digite o prompt e examine a saída.

  3. Selecione Exibir código no canto superior direito para ver como acessar a implantação do modelo programaticamente.

  4. Selecione o link Histórico no canto superior esquerdo do playground para exibir seu histórico de chat.

Solucionar problemas comuns

Se você encontrar problemas ao usar a extensão Microsoft Foundry Toolkit para o Visual Studio Code, verifique os seguintes problemas comuns:

Questão Resolução
A extensão não aparece após a instalação Reinicie o VS Code e verifique se a extensão está habilitada no modo de exibição Extensões .
Falha no login ou então as assinaturas não carregam Verifique se sua conta de Azure tem as permissões corretas. Tente sair e entrar novamente na exibição Azure Resources.
Falha na implantação do modelo devido a um erro de cota Verifique sua cota de assinatura e solicite um aumento ou exclua implantações não utilizados.

Limpar recursos

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

Excluir seus modelos

  1. Na barra de navegação do VS Code, atualize a extensão Microsoft Foundry Toolkit para Visual Studio Code. Na seção Meus Recursos , expanda a subseção Modelos .

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

Excluir recursos de Azure

Para excluir o grupo de recursos e todos os recursos dentro dele, ele:

Aviso

Excluir um grupo de recursos removerá permanentemente todos os recursos dentro dele, incluindo seu projeto Foundry e todos os modelos implantados. Esta ação não pode ser desfeita.

  1. Abra o portal Azure.
  2. Navegue até o grupo de recursos que contém seu projeto Foundry.
  3. Selecione Excluir grupo de recursos e confirme a exclusão.

Próximas etapas

  • Last updated on