Trabalhe com a extensão Microsoft Foundry do Visual Studio Code

Neste artigo, aprenda como instalar e usar o Microsoft Foundry para Visual Studio extensão de código. 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.

Instalar 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 visualização de extensões do VS Code.

1. Abra o VS 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. 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.

Observação

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 procure por Foundry. A captura de ecrã seguinte mostra alguns dos comandos disponíveis.

Inicie sessão nos seus recursos

Inicia sessão na tua subscrição do Azure para que a extensão possa acessar os teus 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 project 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.

Seção	O que contém	Quando Utilizar
Recursos	Implemente modelos, agentes declarativos, agentes alojados, ligações e armazenamento vetorial para o seu projeto Foundry.	Visualize e gere os recursos do seu projecto.
Tools	Catálogo de modelos, ambiente de teste de modelos, ambientes de teste de agentes (remotos e locais), visualizador local e implementação de agentes hospedados.	Implementar novos modelos, testar prompts e interagir com agentes.
Ajuda e Feedback	Documentação, repositório GitHub, Declaração de Privacidade da Microsoft e links da comunidade.	Peça ajuda ou dê feedback.

Crie um project

Crie um novo projeto Foundry diretamente através 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.

   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. 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 usar 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 prima Enter.

Após a implementação do projeto, aparece um popup com a mensagem Projeto implementado com sucesso.

Para implementar um modelo no projeto recém-criado, selecione o botão Implementar um modelo no pop-up. 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 project na extensão Foundry, esse project é definido como o teu project predefinido. Para mudar o teu projeto padrão:

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

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

O projeto selecionado agora mostra Default após o nome projeto.

Sugestão

Clique com o botão direito no nome do seu projeto para aceder ao endpoint do projeto ou à chave API do projeto.

Trabalhar 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. Entra no Foundry: Abrir Catálogo de Modelos e pressiona 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 a opção Suporte de Ajuste Fino para filtrar modelos que suportem 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 vista de extensão Foundry, selecione o ícone Adicionar ao lado Modelos para abrir o catálogo de modelos.

Sugestão

Também pode clicar com o botão direito em Modelos e selecionar Implementar novo modelo de IA para ir diretamente ao fluxo de implementação.

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

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

Implantar um modelo a partir do catálogo de modelos

Depois de encontrares um modelo no catálogo, implementa-o no teu project Foundry para poderes usá-lo 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 implantação no menu suspenso de tipo de implantação.

5. Selecione a versão do modelo na lista suspensa de Versão do Modelo.

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 implantação, o modelo aparece pelo nome de implantação na secção Models no seu projeto.

Visualizar e gerir modelos implementados

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

Ver informações do cartão 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 na lista suspensa Escolher o SDK preferido.

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

4. Selecione o seu método de autenticação preferido no menu suspenso Escolher 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 Ver código no canto superior direito para ver como aceder ao desdobramento do modelo programaticamente.

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:

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á ativada na vista de Extensões .
Falha o início de sessão ou as subscrições não carregam	Verifica se a tua conta Azure tem as permissões corretas. Tente sair e iniciar sessão novamente a partir da perspetiva Azure Resources.
A implementação do modelo falha devido a um erro de quota	Verifique a sua quota de subscrições e peça um aumento ou apague as implementações não utilizadas.

Limpeza de recursos

Os recursos do Azure que criou neste artigo são faturados para a sua subscrição 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 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 nele incluídos:

Advertência

Eliminar um grupo de recursos remove permanentemente todos os recursos dentro dele, incluindo o seu project Foundry e quaisquer modelos implementados. Esta ação não pode ser anulada.

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

Próximos passos

• Explore modelos do Foundry
• Implementar modelos com Foundry