Preparar seu ambiente de desenvolvimento

Configure seu ambiente de desenvolvimento para usar o SDK do Microsoft Foundry. Você também precisa CLI do Azure para autenticação para que seu código possa acessar suas credenciais de usuário.

Neste artigo, você instala runtimes de idiomas, CLI do Azure, CLI do Azure do Desenvolvedor, a extensão do VS Code do Foundry e o Git.

Importante

Este artigo aborda apenas pré-requisitos gerais, como runtimes de linguagem, ferramentas globais e configuração do VS Code e suas extensões.
Ele não abrange etapas específicas do cenário, como instalação ou autenticação do SDK.
Quando o ambiente estiver pronto, prossiga para o início rápido para essas instruções.

Pré-requisitos

  • Uma conta Azure com uma assinatura ativa. Se você não tiver uma, crie uma conta de Azure free, que inclui uma assinatura de avaliação gratuita.

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

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

    • Azure AI Project Manager (para gerenciar projetos do Foundry)
    • Proprietário (para permissões no nível da assinatura). O proprietário é necessário para atribuições de função adicionais necessárias para outros cenários na Foundry. Para garantir que você tenha acesso desbloqueado para todos os cenários no Foundry, o papel de Proprietário é a atribuição necessária.

  • Para usar o projeto, mas não criar novos recursos, você precisa pelo menos:

    • Usuário de Azure AI em seus projetos (função de privilégio mínimo para desenvolvimento)

    Para obter detalhes sobre as permissões de cada função, consulte o controle de acesso baseado em Role para Microsoft Foundry.

Instalar sua linguagem de programação

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

Primeiro, crie um novo ambiente de Python. Não instale pacotes na instalação do Python global. Sempre use um ambiente virtual ou conda ao instalar pacotes Python. Caso contrário, você poderá interromper a instalação global de Python.

Se necessário, instale Python

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

Criar um ambiente virtual

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

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

Quando você ativa o ambiente de Python, executar python ou pip da linha de comando usa o interpretador de Python na pasta .venv do aplicativo.

Nota

Use o comando deactivate para sair do ambiente virtual Python. Você pode reativar mais tarde, quando necessário.

Instalar a extensão Python para Visual Studio Code

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

Instale a Extensão Python para Visual Studio Code.

Instalar:

  • Java Kit de Desenvolvimento (JDK) 17 ou posterior

Instalar o Pacote de Extensões do Visual Studio Code para Java

O Pacote de Extensão para Java é uma coleção de extensões populares que podem ajudá-lo a escrever, testar e depurar aplicativos Java em Visual Studio Code.

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

Instale Node.js (a versão 20 ou posterior é recomendada).

Verifique se você tem as ferramentas necessárias instaladas para .NET desenvolvimento.

Instalar o SDK do .NET

Você precisa do SDK .NET (Software Development Kit) para criar, compilar e executar aplicativos .NET. Recomendamos instalar a versão mais recente do LTS (Suporte a Longo Prazo) ou uma versão posterior, se necessário, pelo seu projeto.

  1. Baixe o SDK do .NET da página de download do official .NET. Selecione o instalador apropriado para seu sistema operacional (Windows, Linux ou macOS).

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

  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.

Instalar o Kit de Desenvolvimento do C# para Visual Studio Code

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

  1. Abra Visual Studio Code.
  2. Vá para o modo de exibição Extensões (Ctrl+Shift+X ou Cmd+Shift+X).
  3. Pesquise o Kit de Desenvolvimento em C#.
  4. Instale a extensão publicada pelo Microsoft. Isso também instalará a extensão base do C# se você ainda não a tiver.

Criar um novo .NET Project

Você pode criar um novo projeto de .NET usando o terminal integrado ao 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 você pode abrir essa MyConsoleApp pasta no VS Code (Arquivo > Abrir Pasta...) para começar a trabalhar em seu projeto em C#. O VS Code, com a extensão C# Dev Kit, detectará automaticamente o projeto, habilitando recursos como IntelliSense, depuração e tarefas de build.

Instalar o CLI do Azure e entrar

Instale o CLI do Azure e entre em seu ambiente de desenvolvimento local para que seu código possa usar suas credenciais de usuário para chamar serviços Azure por meio do Foundry.

Na maioria dos casos, você pode instalar CLI do Azure do terminal usando o seguinte comando:

winget install -e --id Microsoft.AzureCLI

Você pode seguir as instruções Como instalar o CLI do Azure se esses comandos não funcionarem para seu sistema operacional específico ou configuração.

Depois de instalar o CLI do Azure, entre usando o comando az login e entre usando o navegador:

az login

Como alternativa, você pode entrar manualmente por meio do navegador com um código de dispositivo.

az login --use-device-code

Mantenha esse terminal aberto para executar scripts depois de entrar.

Instalar a CLI do Desenvolvedor do Azure

A CLI do Desenvolvedor Azure (azd) é uma ferramenta de software livre que ajuda você a configurar e implantar recursos de aplicativo em Azure. Ele fornece comandos simples para os principais estágios de desenvolvimento, quer você use um terminal, IDE ou pipelines de CI/CD. Instale a CLI do Desenvolvedor Azure para sua plataforma.

Muitos dos modelos de solução de IA incluem uma opção de implantação usando azd.

Instalar a extensão do VS Code do Foundry

A extensão Foundry para Visual Studio Code permite implantar modelos, criar aplicativos de IA e trabalhar com agentes diretamente da interface do VS Code. Instale a extensão do VS Code do Foundry.

Instalar o Git

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

Solucionando problemas

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

Conteúdo relacionado

  • Last updated on