Partilhar via

Prepare seu ambiente de desenvolvimento

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

Neste artigo, irá instalar ambientes de execução de linguagem, Azure CLI, Azure Developer CLI, a extensão Foundry para VS Code e 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 que preferir. Para mais informações, consulte Descarregue Visual Studio Código.

  • 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 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 com privilégios mínimos 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 projecto. Abra uma janela de terminal nessa pasta.

Primeiro, crie um novo ambiente Python. Não instale pacotes em sua instalação global do 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, instale o Python

Use Python 3.10 ou posterior, mas pelo menos Python 3.9 é obrigatório. Se você não tiver uma versão adequada do Python instalada, siga as instruções no VS Code Python Tutorial para a maneira mais fácil de instalar o Python em seu sistema operacional.

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, a execução python ou pip a partir da linha de comandos usa o interpretador Python na .venv pasta da tua aplicação.

Observação

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

Instale a extensão Python para o 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:

  • Java Development Kit (JDK) 17 ou posterior

Instalar o Visual Studio Code Extension Pack para Java

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

Instale o pacote de extensão de código Visual Studio para Java.

InstalaNode.js (recomenda-se a versão 18 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 do .NET da página de download oficial do .NET. Selecione o instalador apropriado para o seu sistema operacional (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 Código do Visual Studio

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 .NET usando o terminal integrado do 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 Azure CLI e inicie sessão

Instala o Azure CLI e inicia sessão a partir do seu ambiente local de desenvolvimento, para que possa usar as suas credenciais de utilizador para ligar Azure OpenAI no Microsoft Foundry Models.

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

winget install -e --id Microsoft.AzureCLI

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

Depois de instalar o Azure CLI, 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, criar 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