Partilhar via

Prepare o seu ambiente de desenvolvimento (clássico)

Atualmente a ver:Versão do portal Foundry (clássica) - Mudar para a versão do novo portal Foundry

Observação

Os links neste artigo podem abrir conteúdo na nova documentação do Microsoft Foundry em vez da documentação do Foundry (clássico) que está a ver agora.

Configura o teu ambiente de desenvolvimento para usar o SDK do Microsoft Foundry. Também precisas do CLI do Azure para autenticação, para que o teu código possa aceder às tuas credenciais de utilizador.

Neste artigo, irá instalar runtimes de idiomas, o CLI do Azure, o Azure Developer CLI, a extensão Foundry para VS Code e o Git.

Importante

Este artigo cobre apenas pré-requisitos gerais, como ambientes de execução de linguagem, ferramentas globais e a configuração de extensões e de VS Code.
Não cobre passos específicos de cenários como instalação ou autenticação do SDK.
Quando o ambiente estiver pronto, continue para o início rápido para obter essas instruções.

Pré-requisitos

  • Uma conta no Azure com uma subscrição ativa. Se não tiveres uma, cria uma conta Azure free, que inclui uma subscrição de teste gratuita.

  • Descarregue, instale e configure o Visual Studio Code, ou o IDE à sua escolha. Para mais informações, consulte Download Visual Studio Code.

  • Para criar e gerir recursos Foundry, é necessário ter uma das seguintes funções do Azure RBAC

    • Azure AI Project Manager (para gerir projetos Foundry)
    • Proprietário (para permissões ao nível da subscrição). O proprietário é necessário para atribuições adicionais de funções necessárias para outros cenários em Foundry. Para garantir que fiques desbloqueado em todos os cenários no Foundry, Proprietário é a atribuição de função necessária.

  • Para usar o project mas não criar novos recursos, precisa pelo menos de:

    • Azure AI User nos projetos que utiliza (função de menor privilégio para desenvolvimento)

    Para detalhes sobre as permissões de cada função, veja Controlo de acesso baseado em funções para Microsoft Foundry.

Instale a sua linguagem de programação

No Visual Studio Code, crie uma nova pasta para o seu projeto. Abra uma janela de terminal nessa pasta.

Primeiro, crie um novo ambiente Python. Não instale pacotes na sua instalação global de Python. Use sempre um ambiente virtual ou conda ao instalar pacotes Python. Caso contrário, podes estragar a instalação global do Python.

Se necessário, instala Python

Usa Python 3.10 ou posterior, mas pelo menos Python 3.9 é obrigatório. Se não tiver uma versão adequada do Python instalada, siga as instruções no tutorial VS Code Python para a forma mais fácil de instalar Python no seu sistema operativo.

Criar um ambiente virtual

Se já tem Python 3.10 ou superior instalado, crie um ambiente virtual usando os seguintes comandos:

py -3 -m venv .venv
.venv\scripts\activate

Quando ativas o ambiente Python, executar python ou pip a partir da linha de comandos usa o interpretador Python na pasta .venv da tua aplicação.

Observação

Use o comando deactivate para sair do ambiente virtual Python. Podes reativá-lo mais tarde, quando necessário.

Instale a extensão Python para Visual Studio Code

A extensão Python para Visual Studio Code suporta Python com IntelliSense, depuração, formatação, linting, navegação de código, refatoração, explorador de variáveis, explorador de testes e gestão de ambiente.

Instale a extensão Python para Visual Studio Code.

Instalar:

  • Kit de Desenvolvimento Java (JDK) 17 ou posterior

Instale o pacote de extensão Visual Studio Code para Java

O Extension Pack for Java é uma coleção de extensões populares que pode ajudar a escrever, testar e depurar aplicações Java no Visual Studio Code.

Instale o Visual Studio Code Extension Pack para Java.

InstalaNode.js (recomenda-se a versão 20 ou posterior).

Certifique-se de que tem as ferramentas necessárias instaladas para o desenvolvimento .NET.

Instalar o SDK .NET

Precisas do SDK .NET (Software Development Kit) para criar, construir e executar aplicações .NET. Recomendamos a instalação da versão mais recente do LTS (Suporte a Longo Prazo) ou uma versão posterior, se o seu projeto exigir.

  1. Descarregue o SDK .NET da página oficial de downloads do .NET. Selecione o instalador apropriado para o seu sistema operativo (Windows, Linux ou macOS).

  2. Siga as instruções de instalação do seu sistema operativo.

  3. Verifique a instalação abrindo um terminal ou prompt de comando e executando:

    dotnet --version

    A resposta deve ser a versão do SDK instalada.

Instale o Kit de Desenvolvimento C# para Visual Studio Code

Para obter a melhor experiência de desenvolvimento em C# no VS Code, instale a extensão oficial do C# Dev Kit:

  1. Abre o Visual Studio Code.
  2. Vá para a visualização Extensões (Ctrl+Shift+X ou Cmd+Shift+X).
  3. Procure por C# Dev Kit.
  4. Instale a extensão publicada pela Microsoft. Isso também instalará a extensão C# base, se você ainda não a tiver.

Crie um novo .NET Project

Pode criar um novo projeto de .NET usando o terminal integrado no Visual Studio Code (Terminal > Novo Terminal).

Por exemplo, para criar um novo aplicativo de console:

# Navigate to the directory where you want to create your project
# cd path/to/your/projects

# Create a new console application in a subfolder named MyConsoleApp
dotnet new console -o MyConsoleApp

# Navigate into the newly created project folder
cd MyConsoleApp

Agora pode abrir esta pasta MyConsoleApp no VS Code (Ficheiro > Abrir Pasta...) para começar a trabalhar no seu project C#. O VS Code, com a extensão C# Dev Kit, irá detetar automaticamente o projeto, ativando funcionalidades como IntelliSense, depuração e tarefas de compilação.

Instale a CLI do Azure e inicie sessão

Instala o CLI do Azure e inicia sessão a partir do ambiente de desenvolvimento local para que o seu código possa usar as suas credenciais de utilizador para ligar Azure serviços através do Foundry.

Na maioria dos casos, pode instalar o CLI do Azure a partir do seu terminal usando o seguinte comando:

winget install -e --id Microsoft.AzureCLI

Podes seguir as instruções Como instalar o CLI do Azure se estes comandos não funcionarem para o teu sistema operativo ou configuração em particular.

Depois de instalar o CLI do Azure, inicie sessão usando o comando az login e inicie sessão pelo navegador:

az login

Em alternativa, pode iniciar sessão manualmente através do navegador com um código de dispositivo.

az login --use-device-code

Mantenha este terminal aberto para executar scripts depois de iniciar sessão.

Instalar a CLI do Azure Developer

O Azure Developer CLI (azd) é uma ferramenta open-source que o ajuda a configurar e implementar recursos de aplicações no Azure. Fornece comandos simples para fases-chave do desenvolvimento, quer utilize um terminal, IDE ou pipelines CI/CD. Instala a CLI de Desenvolvedor Azure para a tua plataforma.

Muitos dos modelos de soluções de IA incluem uma opção de implementação usando azd.

Instalar a extensão Foundry VS Code

A extensão Foundry para Visual Studio Code permite-lhe implementar modelos, construir aplicações de IA e trabalhar diretamente com Agentes a partir da interface do VS Code. Instala a extensão Foundry VS Code.

Instalar o Git

O git é necessário para clonar amostras do SDK do Foundry. Se você não tiver o Git instalado, siga as instruções para sua plataforma e selecione seu sistema operacional.

Solução de problemas

Questão Resolução
Comando não encontrado após a instalação Fecha e reabre o terminal, ou reinicia o VS Code, para que as alterações de PATH entrem em vigor.
az login falha devido a um erro do navegador Execute az login --use-device-code para autenticar usando um fluxo de código de dispositivo em vez disso.
Python não encontrado Use python3 em vez de python no macOS/Linux, ou instale uma versão suportada (3.9 ou posterior).
Permissão negada durante a instalação No macOS/Linux, evite sudo pip install. Use antes um ambiente virtual .

Conteúdo relacionado

  • Documentação de referência do SDK JavaScript/TypeScript
  • Last updated on