Compartilhar via

Preparar seu ambiente de desenvolvimento

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

Neste artigo, você instala runtimes de linguagem, a CLI do Azure, o Azure Developer CLI, 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 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, utilize uma das seguintes funções do Azure RBAC

    • 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 do Azure AI nos projetos em que você trabalha (função de privilégio mínimo para desenvolvimento)

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

Instalar sua linguagem de programação

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

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

Se necessário, instale o Python

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

Criar um ambiente virtual

Se você já tiver o 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 do Python, a execução python ou pip a partir da linha de comando usa o interpretador do Python na .venv pasta do aplicativo.

Observação

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

Instalar a extensão do Python para Visual Studio Code

A extensão do Python para Visual Studio Code dá suporte ao Python com IntelliSense, depuração, formatação, lint, 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:

  • JDK (Java Development Kit) 17 ou posterior

Instalar o pacote de extensão de código Visual Studio 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 no Visual Studio Code.

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

Instale Node.js (a versão 18 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 pela 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 .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 Azure CLI e entrar

Instale o Azure CLI e entre em seu ambiente de desenvolvimento local, para que você possa usar suas credenciais de usuário para chamar Azure OpenAI no Microsoft Foundry Models.

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

winget install -e --id Microsoft.AzureCLI

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

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

  • Documentação de Referência do SDK da Microsoft Foundry
  • documentação de referência do Java SDK
  • Last updated on