Prepare o seu ambiente de desenvolvimento

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 linguagem, CLI do Azure, CLI do Azure Developer, a extensão Foundry VS Code e Git.

Importante

Este artigo cobre apenas pré-requisitos gerais, como runtimes de linguagem, ferramentas globais, e a configuração do VS Code e das suas extensões.
Não cobre passos específicos de cenários como instalação ou autenticação do SDK.
Quando o seu ambiente estiver pronto, prossiga para o guia de início rápido para seguir 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, 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 as atribuições adicionais de funções requeridas por outros cenários na Foundry. Para garantir que estejas desbloqueado no Foundry em todos os cenários, a atribuição de função 'Proprietário' é 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. Abre 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.

Crie 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.

Nota

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 de uma versão posterior, se o seu projeto exigir.

  1. Descarregue o SDK .NET da página oficial de download 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 comandos e executando:

    dotnet --version

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

Instale o Kit de Desenvolvimento C# para Visual Studio Code

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

  1. Abre o Visual Studio Code.
  2. Vai à vista de Extensões (Ctrl+Shift+X ou Cmd+Shift+X).
  3. Procura por C# Dev Kit.
  4. Instale a extensão publicada pela Microsoft. Isto também vai instalar a extensão base em C#, caso ainda não a tenhas.

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 uma nova aplicação de consola:

# 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 MyConsoleApp pasta no VS Code (File > Open Folder...) para começar a trabalhar no seu projeto em 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 após 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 não tiver o Git instalado, siga as instruções da sua plataforma e selecione o seu sistema operativo.

Resolução de problemas

Problema 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

  • Last updated on