Trabalhar com a extensão Microsoft Foundry do Visual Studio Code (Prévia)

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

Com o Foundry, você pode:

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

• Teste os modelos implantados em um playground de modelos

• Comece rapidamente a desenvolver aplicativos de IA generativos usando uma coleção de modelos de código curados pelo Azure

• Configurar e implantar agentes com o Serviço do Foundry Agent

Com a extensão Foundry para Visual Studio Code, você pode realizar grande parte desse fluxo de trabalho diretamente 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 como começar a usar rapidamente os recursos da extensão Foundry para Visual Studio Code.

Pré-requisitos

Antes de usar a extensão Foundry para Visual Studio Code, você deve:

• Baixar, instalar e configurar o Visual Studio Code. Mais informações: Baixar 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 gerenciar recursos do Foundry com a extensão do Visual Studio Code. Para obter mais informações, confira Controle de acesso baseado em função para a Fábrica.

Instalação

Depois de instalar o Visual Studio Code, você precisará instalar a extensão Foundry para Visual Studio Code.

Para instalar a extensão Foundry para Visual Studio Code, você pode usar o Visual Studio Code Marketplace ou instalá-la diretamente no Visual Studio Code.

Instalar a partir do Marketplace do Visual Studio Code

Para instalar a extensão Foundry para Visual Studio Code do Visual Studio Code Marketplace, siga estas etapas:

1. Abra a página de extensão Foundry para Visual Studio Code.
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 o Visual Studio Code e verifique se a extensão foi instalada com êxito nas 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 de dentro do Visual Studio Code

Para instalar a extensão Foundry para Visual Studio Code no Visual Studio Code, siga estas etapas:

1. Abra o Visual Studio Code.

2. Selecione Extensões no painel esquerdo.

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

4. Pesquise e selecione Foundry.

5. Selecione Instalar.

6. Verifique se a extensão foi instalada com sucesso com base nas mensagens de status.

Introdução

Comece a usar a extensão Foundry usando as etapas a seguir.

Entre em 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 visualização de recursos do Azure.

   

3. Na seção "Recursos", selecione sua Assinatura do 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 da Foundry.

   

Explorar a extensão Foundry

A Extensão do Foundry está aberta no seu modo de exibição, com o ícone do Foundry agora sendo exibido na barra de navegação do VS Code. A extensão tem três seções principais: Recursos, Ferramentas e Ajuda e Comentários.

• Recursos: esta seção contém os recursos aos quais você tem acesso em seu projeto do Foundry. A seção Recursos é o modo de exibição principal para interagir com seus Serviços do Foundry. Ele contém as seguintes subseções:

  • Modelos: esta seção contém os modelos que você pode usar para criar e implantar seus aplicativos de IA. A exibição Modelos é onde você pode encontrar seus modelos implantados em seu projeto do Foundry.
  • Agentes: Esta seção contém seus agentes implantados em seu projeto Foundry.
  • Ativos: esta seção contém os ativos que você tem em seu projeto do Foundry.
    • Conexões: essa subseção contém as conexões que você tem em seu projeto do Foundry. por exemplo, conexões de Fundamento do Bing.
    • Repositórios de Vetores: essa subseção contém os repositórios de vetores que você tem em seu projeto do Foundry.
  • Threads: esta seção contém os threads e é executada de um agente implantado em seu projeto do Foundry.

• Ferramentas: esta seção contém as ferramentas que você pode usar para criar e implantar seus aplicativos de IA. O modo de exibição Ferramentas é onde você pode encontrar as ferramentas disponíveis para implantar e, em seguida, trabalhar com seus modelos e agentes implantados. Ele contém as seguintes subseçõ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 playground de modelos, onde você pode interagir com os modelos implantados no seu projeto Foundry.
  • Playground do Agente: o link do playground do agente para interagir com os seus agentes implantados no seu projeto do Foundry.

• Ajuda e Comentários: esta seção contém links para a documentação do Foundry, comentários, suporte e a Política de Privacidade da Microsoft. Ele contém as seguintes subseções:

  • Documentação: link para a documentação da Extensão do Foundry.
  • GitHub: o link para o repositório GitHub da extensão Foundry.
  • Política de Privacidade da Microsoft: o link para a Política de Privacidade da Microsoft.
  • Ingresse na Comunidade Foundry: Discord + Fórum: o link para o servidor da comunidade do Foundry no Discord.

Criar um projeto

Você pode criar um novo projeto do Foundry no modo de exibição Extensão do Foundry com as seguintes etapas:

1. Selecione o ícone + ao lado de Recursos na seção Recursos da visualização de Extensão do 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 você 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 você deseja usar na lista de grupos de recursos disponíveis e pressione Enter.

4. No centro superior, insira o nome do Projeto de Fundação a ser usado 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 implantada com êxito.

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 no modo de exibição da Extensão do Foundry para selecionar o modelo desejado a ser implantado.

O projeto padrão Foundry

Quando você abre um projeto na Extensão do Foundry, esse projeto é definido como seu projeto padrão.

Alterne seu projeto padrão seguindo estas etapas:

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

2. No centro superior, selecione o Projeto de Foundry que você deseja usar na lista de projetos disponíveis e pressione Enter.

Agora, o projeto selecionado exibirá Padrão após o nome do projeto.

Trabalhar com modelos

A extensão Foundry para Visual Studio Code permite que você crie, interaja e implante modelos de linguagem grandes de dentro do Visual Studio Code.

Explorar todos os modelos com o catálogo de modelos

O catálogo de modelos no portal do Foundry é o hub para descobrir e usar uma ampla gama de modelos para criar aplicativos de IA generativos.

Acesse o catálogo de modelos de várias maneiras diferentes:

• O comando "Foundry: Abrir Catálogo de Modelos" do painel de comandos.
• Selecione o ícone mais ao lado de Modelos na seção Recursos da exibição Extensão do Foundry.
• Selecione o link catálogo de modelos na seção Ferramentas do modo de exibição Extensão do Foundry.

Abra o catálogo de modelos na paleta de comandos

Acesse o catálogo de modelos na paleta de comandos para explorar e implantar uma seleção selecionada de modelos disponíveis na Foundry, diretamente de dentro do VS Code.

1. Selecione F1 para abrir a paleta de comandos.

2. Insira Foundry: Abrir Catálogo de Modelos e clique em Enter.

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

   

4. Filtre o Catálogo de Modelos por Publisher e/ou Task usando as listas suspensas 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 seção Recursos do modo de exibição Extensão do Foundry.

No modo de exibição da Extensão do Foundry, selecione o ícone de adição 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 seção Ferramentas do modo de exibição Extensão do Foundry. Clique duas vezes no link catálogo de modelos para abrir o Catálogo de Modelos.

Implantar um modelo do catálogo de modelos

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

1. Selecione a Implantação no Azure imediatamente após o nome do modelo selecionado.

   

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

   

3. Insira o nome da implantação do modelo a ser usado na caixa de texto Inserir nome de 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 na lista suspensa Versão do modelo e pressione Enter.

   

6. (Opcional) Selecione os tokens por minuto a serem usados no controle deslizante Tokens por minuto e pressione Enter.

7. No canto inferior esquerdo, selecione o botão Implantar no Foundry para implantar o modelo.

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

   

9. Após uma implantação bem-sucedida, seu modelo será listado pelo nome da 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 sinal de interpolação à frente da seção Modelos para ver a lista de modelos implantados.

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

Exibir informações do cartão de modelo

Selecionar 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 provisionamento
  • Tipo de implantação
  • Informações de limite de taxa
  • Informações sobre versão
  • Nome do modelo
  • Versão do modelo
• Informações do ponto de extremidade: esta seção contém o link de 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 os links do tutorial para começar a usar o desenvolvimento de aplicativos de IA.

Atualizar um modelo

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

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

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

Explorar 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 preferencial para usar na lista suspensa Escolher SDK preferencial 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 preferencial 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 do Python que demonstra uma chamada básica para a API de conclusão do chat. A chamada é síncrona:

Interaja com modelos usando um playground de modelos

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

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

Você também pode abrir a área de teste de modelos seguindo as etapas a seguir:

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 a solicitação e veja as saídas.

4. Além disso, você pode usar Ver código 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 exibir o histórico de chat.

Recursos de limpeza

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.

Exclua seus modelos

1. Na barra de navegação do VS Code, atualize a Foundry Extension. 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 selecionar a opção Excluir .

   

Exclua suas ferramentas

Exclua a ferramenta conectada com as seguintes etapas:

1. Abrir o portal do Azure
2. Selecione o Grupo de Recursos do Azure que contém a ferramenta.
3. Selecione o botão Excluir.

Próximas etapas

• Saiba mais sobre como trabalhar com o Serviço de Agente usando essa extensão do Visual Studio Code.