Utilização da extensão Microsoft Foundry for Visual Studio Code (Prévia)

A Microsoft Foundry oferece uma plataforma unificada para operações empresariais de IA, construtores de modelos e desenvolvimento de aplicações. Essa base combina infraestrutura de nível de produção com interfaces amigáveis, garantindo que as organizações possam construir e operar aplicativos de IA com confiança.

Através da Foundry, pode:

• Implante os modelos de linguagem mais recentes da Microsoft, OpenAI, Meta, DeepSeek e muito mais usando o catálogo de modelos robusto

• Teste os modelos implantados numa plataforma de teste de modelos

• Comece rapidamente a desenvolver aplicativos de IA generativa usando uma coleção de modelos de código com curadoria do Azure

• Configurar e implementar agentes com o Foundry Agent Service

Com a extensão Foundry for Visual Studio Code, pode realizar grande parte deste fluxo de trabalho diretamente a partir do Visual Studio Code. Ele também vem com outros recursos, como modelos de código, playgrounds e integração com outras extensões e recursos do VS Code.

Este artigo mostra-lhe como começar rapidamente a usar as funcionalidades da extensão Foundry for Visual Studio Code.

Pré-requisitos

Antes de usar a extensão Foundry for Visual Studio Code, deve:

• Transferir, instalar e configurar o Visual Studio Code. Mais informações: Transferir o Visual Studio Code

• Sua assinatura precisa estar abaixo do limite de cota para implantar um novo modelo neste início rápido. Caso contrário, você já precisa ter um modelo de chat implantado.

• Defina as permissões RBAC apropriadas para criar e gerir recursos do Foundry com a extensão Visual Studio Code. Para mais informações, consulte Controlo de acesso baseado em funções para Foundry.

Instalação

Depois de instalar o Visual Studio Code, precisa de instalar a extensão Foundry for Visual Studio Code.

Para instalar a extensão Foundry for Visual Studio Code, pode usar o Visual Studio Code Marketplace ou instalá-la diretamente dentro do Visual Studio Code.

Instalar a partir do Visual Studio Code Marketplace

Para instalar a extensão Foundry for Visual Studio Code a partir do Visual Studio Code Marketplace, siga estes passos:

1. Abra a página de extensão Foundry for Visual Studio Code.
2. Selecione o botão Instalar.
3. Siga as instruções para instalar a extensão no Visual Studio Code.
4. Após a instalação, abra o Visual Studio Code e verifique se a extensão foi instalada com êxito a partir das mensagens de status.
5. A extensão agora deve estar visível na barra de navegação primária no lado esquerdo do Visual Studio Code.

Instalar a partir do Visual Studio Code

Para instalar a extensão Foundry for Visual Studio Code no Visual Studio Code, siga estes passos:

1. Abra o Visual Studio Code.

2. Selecione Extensões a partir do painel esquerdo.

3. Selecione o Ícone de Definições na parte superior direita no painel de extensões.

4. Procure e selecione Foundry.

5. Selecione Instalar.

6. Verifique se a extensão é instalada com êxito a partir das mensagens de estado.

Introdução

Comece a usar a extensão Foundry seguindo os seguintes passos.

Inicie sessão nos seus recursos

Entre em sua assinatura do Azure para acessar seus recursos com as seguintes etapas:

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

2. Entre selecionando o item Sign in to Azure... na visão Recursos do Azure.

   

3. Na seção "Recursos", selecione sua Assinatura do Azure e Grupo de Recursos.

4. Selecione Foundry e clique com o botão direito no seu projeto.

5. Selecione Abrir na extensão Foundry.

   

Explore a Extensão da Fundição

A Extensão Foundry abre-se na sua própria visão, com o ícone Foundry agora exibido na barra de navegação do VS Code. A extensão tem três seções principais: Recursos, Ferramentas e Ajuda e Feedback.

• Recursos: Esta secção contém os recursos a que tem acesso no seu projeto Foundry. A secção Recursos é a principal vista para interagir com os seus Foundry Services. Contém as seguintes subsecções:

  • Modelos: Esta seção contém os modelos que você pode usar para criar e implantar seus aplicativos de IA. A vista de Modelos é onde pode encontrar os seus modelos implementados no seu projeto Foundry.
  • Agentes: Esta secção contém os seus agentes destacados no seu projeto Foundry.
  • Ativos: Esta secção contém os ativos que tem no seu projeto Foundry.
    • Ligações: Esta subsecção contém as ligações que tem no seu projeto Foundry. por exemplo, conexões de Aterramento do Bing.
    • Armazenamentos Vetoriais: Esta subseção contém os armazenamentos vetoriais que tem no seu projeto Foundry.
  • Threads: Esta secção contém os threads e executa a partir de um agente implementado no seu projeto Foundry.

• Ferramentas: Esta seção contém as ferramentas que você pode usar para criar e implantar seus aplicativos de IA. A visualização Ferramentas é onde você pode encontrar as ferramentas disponíveis para implantar e, em seguida, trabalhar com seus modelos e agentes implantados. Contém as seguintes subsecções:

  • Catálogo de modelos: o link para o catálogo de modelos que você pode usar para descobrir e implantar modelos.
  • Model Playground: O link para o Model Playground para interagir com os seus modelos implementados no seu projeto Foundry.
  • Agent Playground: A ligação para o playground de agentes, onde poderá interagir com os seus agentes implantados no seu projeto Foundry.

• Ajuda e Feedback: Esta secção contém ligações para a documentação da Foundry, feedback, suporte e a Declaração de Privacidade da Microsoft. Contém as seguintes subsecções:

  • Documentação: O link para a documentação da Foundry Extension.
  • GitHub: O link para o repositório GitHub da extensão Foundry.
  • Declaração de Privacidade da Microsoft: O link para a Declaração de Privacidade da Microsoft.
  • Junta-te à Comunidade Foundry: Discord + Fórum: O link para o servidor Discord da comunidade Foundry.

Criar um projeto

Pode criar um novo projeto Foundry a partir da vista Foundry Extension com os seguintes passos:

1. Selecione o ícone mais ao lado de Recursos na secção Recursos da vista da Extensão Foundry.

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

2. Para criar um novo grupo de recursos:

   1. No centro superior, selecione Criar novo grupo de recursos e pressione Enter.

      

   2. No centro superior, insira o nome do Grupo de Recursos do Azure a ser usado na caixa de texto Inserir novo grupo de recursos e pressione Enter.

   3. No centro superior, selecione o local que deseja usar na lista de locais disponíveis e pressione Enter.

3. Para usar um grupo de recursos existente:

   • No centro superior, selecione o grupo de recursos que deseja usar na lista de grupos de recursos disponíveis e pressione Enter.

4. No centro superior, introduza o nome do Projeto Foundry para usar na caixa de texto Introduzir nome do projeto e pressione Enter.

   

Após a implantação do projeto, um pop-up aparece com a mensagem Projeto implantado com êxito.

Para implantar um modelo no projeto recém-criado, selecione o botão Implantar um modelo no pop-up. Esta ação abre a página do Catálogo de Modelos na vista da Extensão Foundry para selecionar o modelo desejado a implementar.

O Projeto Foundry padrão

Quando abres um projeto na Foundry Extension, esse projeto é definido como o teu projeto padrão.

Mude seu projeto padrão seguindo estas etapas:

1. Clique com o botão direito no Projeto Foundry e selecione a opção Alternar Projeto Padrão na Extensão Azure.

2. No centro superior, selecione o Projeto de Fundição que pretende usar na lista de projetos disponíveis e pressione Enter.

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

Trabalhar com modelos

A extensão Foundry para Visual Studio Code permite-lhe criar, interagir e implementar Grandes Modelos de Linguagem a partir do Visual Studio Code.

Explore todos os modelos com o catálogo de modelos

O catálogo de modelos no portal Foundry é o ponto de encontro e utilização de uma vasta gama de modelos para construir aplicações de IA generativa.

Aceda ao catálogo de modelos de várias formas diferentes:

• O comando da paleta de comandos Foundry: Open Model Catalog.
• Selecione o ícone de mais ao lado de Modelos na secção de Recursos da vista de Extensão Foundry.
• Selecione o link Catálogo de Modelos na secção Ferramentas da visualização da Extensão Foundry.

Abra o catálogo de modelos a partir da paleta de comandos

Acede ao catálogo de modelos a partir da paleta de comandos para explorar e implementar uma seleção selecionada de modelos disponíveis no Foundry, diretamente a partir do VS Code.

1. Selecione F1 para abrir a paleta de comandos.

2. Entra no Foundry: Abrir Catálogo de Modelos e pressiona Enter.

3. A página Catálogo de modelos é exibida.

   

4. Filtre o Catálogo de modelos por Publisher e/ou Task usando os desdobráveis no canto superior esquerdo da página.

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

O Catálogo de Modelos também está disponível na secção de Recursos da vista Extensão da Fundição.

Na vista de Extensão do Foundry, selecione o ícone de mais ao lado de Modelos para abrir o Catálogo de Modelos.

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

O Catálogo de Modelos também está disponível na secção Ferramentas na visualização da Extensão Foundry. Clique duas vezes no link Catálogo de modelos para abrir o Catálogo de modelos.

Implantar um modelo a partir do catálogo de modelos

Implante um modelo selecionado no catálogo de modelos usando as seguintes etapas:

1. Selecione Implantar no Azure imediatamente após o nome do modelo selecionado.

   

2. A página Implantação do modelo é exibida.

   

3. Digite o nome da implantação do modelo a ser usado na caixa de texto Digite o nome da implantação e pressione Enter.

   

4. Selecione o tipo de implantação a ser usado na lista suspensa Tipo de implantação e pressione Enter.

   

5. Selecione a versão do modelo a ser usada na lista suspensa Versão do modelo e pressione Enter.

   

6. (Opcional) Selecione os tokens por minuto para usar no controle deslizante Tokens por minuto e pressione Enter.

7. No canto inferior esquerdo, selecione o botão Deploy in Foundry para implementar o modelo.

8. Uma caixa de diálogo de confirmação é exibida. Selecione o botão Implantar para implantar o modelo em seu projeto.

   

9. Após uma implantação bem-sucedida, seu modelo será listado por nome de implantação com seus outros modelos implantados na seção Modelos em seu projeto.

   

Exibir modelos implantados

No modo de exibição Extensão de Recursos do Azure, selecione o ícone de seta na frente da seção Modelos para ver a lista de modelos implantados.

A seção Modelos expandida exibe a lista de modelos implantados.

Ver informações do cartão modelo

A seleção de um modelo implantado abre um painel que fornece algumas informações básicas:

• Informações de implantação: Esta seção contém as informações sobre o modelo:
  • Nome
  • Estado de aprovisionamento
  • Tipo de implantação
  • Informações sobre limites de taxa
  • Informações sobre a versão
  • Nome do modelo
  • Versão do modelo
• Informações do ponto de extremidade: Esta seção contém o link URI de destino, o tipo de autenticação e a chave.
• Links úteis: Esta seção contém o repositório de exemplo de código e links de tutorial para começar a desenvolver aplicativos de IA.

Atualizar um modelo

Para atualizar as informações do cartão modelo, selecione o botão Editar no canto superior direito do cartão modelo.

Atualize os campos editáveis desejados, como limite de taxa, diretamente no VS Code.

Para salvar as alterações, selecione o botão Salvar no canto superior direito do cartão modelo.

Explore o código de exemplo do modelo

Crie um arquivo de código de exemplo usando as etapas a seguir.

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

   

2. No centro superior, selecione seu SDK preferido para usar na lista suspensa Choose preferred SDK e pressione Enter.

   

3. No centro superior, selecione seu idioma preferido para usar na lista suspensa Escolher idioma e pressione Enter.

   

4. No centro superior, selecione seu método de autenticação preferido para usar na lista suspensa Escolher método de autenticação e pressione Enter.

   

Arquivo de código de exemplo

Este arquivo de código de exemplo Python que demonstra uma chamada básica para a API de conclusão de chat. A chamada é síncrona:

Interaja com modelos usando um ambiente interativo de modelos

Converse interativamente com o modelo, altere as configurações e as instruções do sistema usando o Model Playground.

O Model Playground está disponível na secção Ferramentas da vista de Extensão do Foundry. Clique duas vezes no link Model Playground para abrir o Model Playground.

Você também pode abrir o playground modelo usando as seguintes etapas:

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

   

2. A página Playground é exibida.

   

3. Digite o seu prompt e veja os resultados.

4. Além disso, você pode usar o código View no canto superior direito para ver detalhes sobre como acessar a implantação do modelo programaticamente.

5. Selecione o link Histórico no canto superior esquerdo do playground para visualizar o histórico de bate-papo.

Recursos de limpeza

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.

Eliminar os seus modelos

1. Na barra de navegação VS Code, atualize a Extensão Foundry. Na seção Recursos , expanda a subseção Modelos para exibir a lista de modelos implantados.

2. Clique com o botão direito do mouse no modelo implantado para excluir e selecione a opção Excluir .

   

Exclua suas ferramentas

Exclua a ferramenta conectada com as seguintes etapas:

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.

Próximos passos

• Saiba como trabalhar com o Agent Service usando esta extensão Visual Studio Code.