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

Neste artigo, aprenda como instalar e utilizar a extensão Microsoft Foundry Toolkit for Visual Studio Code. 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 Microsoft Foundry Toolkit 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 Microsoft Foundry Toolkit 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 do Foundry Toolkit 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. Pesquise e selecione Foundry Toolkit for VS Code.

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 do Foundry Toolkit 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 Toolkit.

   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 Microsoft Foundry Toolkit for Visual Studio Code 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 + Create Project na secção My Resources na vista da extensão Microsoft Foundry Toolkit para Visual Studio Code.

   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 Microsoft Foundry Toolkit for Visual Studio Code, 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 Microsoft Foundry Toolkit for Visual Studio Code permite-lhe descobrir, implementar e interagir com modelos do catálogo de modelos Foundry diretamente 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:

• Na paleta de comandos, execute o comando Foundry Toolkit: Show model catalog.
• Selecione o ícone mais ao lado de Modelos na secção Os Meus Recursos da vista da extensão Microsoft Foundry Toolkit for Visual Studio Code.
• Selecione a ligação Model Catalog na secção Developer Tools da vista Extensões do Microsoft Foundry Toolkit para Visual Studio Code.

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. Introduza Foundry Toolkit: mostrar o 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 da extensão Microsoft Foundry Toolkit para Visual Studio Code, selecione o ícone mais junto a Models para abrir o catálogo de modelos.

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

Na secção Developer Tools da vista da extensão Microsoft Foundry Toolkit para Visual Studio Code, clique duas vezes na ligação Model Catalog.

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 Models na vista da extensão do Microsoft Foundry Toolkit para Visual Studio Code 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 ambiente de testes, faça duplo clique na ligação Model Playground na secção Ferramentas de Programador da vista da extensão Microsoft Foundry Toolkit para Visual Studio Code. 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 Microsoft Foundry Toolkit for Visual Studio Code, 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 do VS Code, atualize a extensão Microsoft Foundry Toolkit for Visual Studio Code. Na secção Os Meus Recursos , expanda a subsecção 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