Compartilhar via

Preparar seu ambiente de desenvolvimento (clássico)

Visualizando atualmente:Versão do portal do Foundry (clássico) - Alternar para a versão do novo portal do Foundry

Observação

Links neste artigo podem abrir conteúdo na nova documentação do Microsoft Foundry em vez da documentação da Foundry (clássica) que você está exibindo agora.

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

Importante

Este artigo aborda apenas pré-requisitos gerais, como runtimes de linguagem, ferramentas globais, e a 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 um dos seguintes papéis 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 exigidas em outros cenários no Foundry. Para evitar bloqueios em qualquer cenário do Foundry, é obrigatória a atribuição da função de proprietário.

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

    • Usuário de Azure AI em projetos que você usa (papel 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.

Observação

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 dá suporte a 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 LTS (Suporte de Longo Prazo) mais recente ou uma versão posterior, se necessário, para o 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 seu 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 o 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 pasta MyConsoleApp no VS Code (Arquivo > Abrir Pasta...) para começar a trabalhar no projeto em C#. O VS Code, com a extensão C# Dev Kit, detectará automaticamente o projeto, habilitando funcionalidades como IntelliSense, depuração e tarefas de compilação.

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 CI/CD pipelines. 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 Foundry do VS Code

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

Resolução de 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 utilizando um fluxo de código de 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