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

Neste artigo, aprenda como instalar e usar o Microsoft Foundry para Visual Studio Code extensão. Criar projetos, implementar modelos a partir do catálogo de modelos Foundry e interagir com playgrounds de modelos a partir do VS Code.

Pré-requisitos

• Uma subscrição do Azure. Crie um gratuitamente.
• Visual Studio Code instalado.
• A sua subscrição precisa de estar abaixo do limite da sua quota para implementar um novo modelo neste artigo. Se já atingiu o limite da quota, precisa de ter um modelo de chat implementado.
• Permissões RBAC apropriadas para criar e gerir recursos Foundry. Para mais informações, consulte Controlo de acesso baseado em funções para Foundry.

Instala a extensão

Para utilizar as capacidades do Foundry no VS Code, instale a extensão Foundry for Visual Studio Code. Instale a partir do Visual Studio Code Marketplace ou diretamente dentro do VS Code.

Instalar a partir do Visual Studio Code Marketplace

Usa o marketplace para instalar a extensão sem abrires primeiro o VS Code.

1. Abra a página da extensão Foundry para 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 está instalada com sucesso a partir das mensagens de estado.
5. O ícone Foundry aparece na barra de navegação principal do lado esquerdo do VS Code.

Instalar a partir do Visual Studio Code

Alternativamente, procure a extensão diretamente na vista de extensões do VS Code.

1. Abrir VS Code.

2. Selecione Extensões no painel esquerdo.

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

4. Procure e selecione Foundry.

5. Selecionar Instalar.

6. Após a conclusão da instalação, uma mensagem de estado confirma que a extensão foi instalada. O ícone Foundry aparece na barra de navegação à esquerda.

Ligue-se aos seus recursos do Azure

Depois de instalar a extensão, inicie sessão na sua subscrição do Azure e abra um projeto Foundry para começar a trabalhar com modelos, agentes e playgrounds.

Inicie sessão nos seus recursos

Inicie sessão na sua subscrição do Azure para que a extensão possa aceder aos seus projetos Foundry e modelos implementados.

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

2. Selecione Iniciar sessão para Azure... na perspetiva Azure Resources.

3. Na secção Resources, selecione a sua subscrição 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.

   Os recursos do seu projeto Foundry aparecem na vista de extensão, e o ícone Foundry aparece na barra de navegação do VS Code.

Navegar pela interface de extensão

A extensão Foundry organiza o seu espaço de trabalho em três secções principais.

Crie um projeto

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

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

   Podes criar um novo grupo de recursos ou selecionar um já existente.

2. Para criar um novo grupo de recursos:

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

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

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

3. Para utilizar um grupo de recursos existente:

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

4. Introduza o nome do projeto Foundry na caixa de texto Introduzir nome do projeto e pressione Enter.

Após a implementação do projeto, aparece uma janela de mensagem com a mensagem Projeto implementado com sucesso.

Para implementar um modelo no projeto recém-criado, selecione o botão Implementar um modelo no popup. Esta ação abre a página do Catálogo de Modelos , onde pode selecionar o modelo desejado a implementar.

Mudar o projeto padrão

Quando abres um projeto na extensão Foundry, esse projeto é definido como o teu projeto predefinido. Para mudar o teu projeto padrão:

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

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

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

Trabalho com modelos

A extensão Foundry permite-lhe descobrir, implementar e interagir diretamente com modelos do catálogo de modelos Foundry no VS Code.

Consulte o catálogo de modelos

O catálogo de modelos oferece acesso a modelos da Microsoft, OpenAI, Meta, DeepSeek e outros fornecedores. Pode abrir o catálogo de modelos de várias formas:

• Execute o comando Foundry: Open Model Catalog a partir da paleta de comandos.
• 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 vista de extensão Foundry.

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

Use a paleta de comandos para abrir o catálogo de modelos sem ter de navegar pela vista de extensão.

1. Selecione F1 para abrir a paleta de comandos.

2. Entre em Foundry: Abrir Catálogo de Modelos e prima Enter.

3. A página do Catálogo de Modelos abre-se.

   

4. Filtre o Catálogo de Modelos por Hospedado por, Publisher, Feature ou Tipo de Modelo usando os menus suspensos no topo da página. Selecione o alternador de Suporte de Ajuste Fino para filtrar modelos que suportem ajuste fino.

5. Procure um modelo específico usando a barra de pesquisa no topo central da página.

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

Na vista de extensão 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 secção de Ferramentas

Na secção Ferramentas da vista de extensão Foundry, clique duas vezes no link do Catálogo de Modelos .

Implemente um modelo a partir do catálogo de modelos

Depois de encontrares um modelo no catálogo, implementa-o no teu projeto Foundry para o poderes usar nas tuas aplicações.

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

2. A página de implementação do modelo abre-se.

3. Introduza o nome de implementação do modelo na caixa de texto Introduzir nome de implementação e pressione Enter.

4. Selecione o tipo de implementação no menu suspenso Tipo de Implementação.

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

6. (Opcional) Ajusta os tokens por minuto usando o slider Tokens por minuto .

7. Selecione o botão Deploy in Foundry no canto inferior esquerdo.

8. No diálogo de confirmação, selecione Implementar.

9. Após a conclusão da implementação, o modelo aparece pelo nome da implementação na secção Modelos do seu projeto.

Visualizar e gerir modelos implementados

Expanda a secção Modelos na vista de extensão Foundry para ver todos os modelos implementados no seu projeto.

Ver informações do cartão do modelo

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

• Informação de Implementação: Nome, estado de provisionamento, tipo de implementação, limite de taxa, informação de versão, nome do modelo e versão do modelo.
• Informação do endpoint: Link URI do alvo, tipo de autenticação e chave.
• Links úteis: Repositório de exemplos de código e links para tutoriais para desenvolvimento de aplicações de IA.

Atualizar definições de implementação do modelo

Para atualizar definições de implementação, como limites de taxa:

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

Gerar código de exemplo para um modelo

Gera um ficheiro de código inicial para o teu modelo implementado para acelerar o desenvolvimento de aplicações.

1. Clique com o botão direito no seu modelo implementado e selecione Abrir ficheiro de código.

2. Selecione o seu SDK preferido no menu suspenso Escolher SDK preferido.

3. Selecione o seu idioma preferido no menu suspenso escolher idioma.

4. Selecione o seu método de autenticação preferido no menu suspenso “Escolha método de autenticação” .

5. Um ficheiro de código de exemplo abre numa nova aba no VS Code.

A captura de ecrã seguinte mostra um exemplo de Python gerado que faz uma chamada síncrona à API de respostas:

Interagir com modelos no parque infantil

Use o playground de modelos para conversar interativamente com o seu modelo implementado, ajustar definições e modificar instruções do sistema.

Para abrir o playground, clique duas vezes no link Model Playground na secção Ferramentas da vista de extensão Foundry. Alternativamente, clique com o botão direito no seu modelo implementado e selecione Abrir no playground.

1. A página do Playground abre-se.

2. Escreve o teu prompt e revê o resultado.

3. Selecione Visualizar código no canto superior direito para ver como aceder à implementação do modelo de forma programática.

4. Selecione o link Histórico no canto superior esquerdo do parque infantil para ver o seu histórico de conversas.

Resolver problemas comuns

Se tiver problemas ao usar a extensão Foundry, verifique os seguintes problemas comuns:

Liberar recursos

Os recursos do Azure que criou neste artigo são faturados para a sua subscrição do Azure. Se não espera precisar destes recursos no futuro, elimine-os para evitar mais cobranças.

Apague os seus modelos

1. Na barra de navegação VS Code, atualize a extensão Foundry. Na secção de Recursos , expanda a subsecção de Modelos .

2. Clique com o botão direito no modelo implementado que quer remover e selecione Eliminar.

Eliminar recursos do Azure

Para eliminar o grupo de recursos e todos os recursos dentro dele:

1. Abre o portal Azure.
2. Navegue até ao grupo de recursos que contém o seu projeto Foundry.
3. Selecione Eliminar grupo de recursos e confirme a eliminação.

Próximos passos

• Explore modelos de Foundry
• Implementar modelos com Foundry