Prepare o seu ambiente de desenvolvimento

Prepare o seu ambiente de desenvolvimento para construir com a Microsoft Foundry. Precisas de uma linguagem de programação suportada, a CLI do Azure para autenticação, Git e ferramentas de desenvolvimento Foundry.

Sugestão

O Foundry DevPack é a forma recomendada de instalar as ferramentas de desenvolvimento num só comando. Também podes instalar cada ferramenta separadamente.

Importante

Este artigo aborda pré-requisitos gerais, ferramentas globais e configuração do Visual Studio Code. Não cobre pacotes SDK específicos de cenários nem códigos de autenticação. Quando o seu ambiente estiver pronto, continue com o quickstart.

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 use o IDE que preferir.

  • Para criar e gerir recursos do Foundry, utilize uma destas funções do Azure RBAC:

    • Gestor de Projeto do Foundry para gerir projetos no Foundry.

    Importante

    As funções RBAC do Foundry foram recentemente renomeadas. Foundry User, Foundry Owner, Foundry Account Owner e Foundry Project Manager foram anteriormente nomeados Azure AI User, Azure AI Owner, Azure AI Account Owner e Azure AI Project Manager. Poderá ainda ver os nomes anteriores em alguns locais enquanto esta alteração de nome está a ser implementada. Os IDs das funções e as permissões principais não são alterados por esta mudança de nome.

    • Proprietário para permissões ao nível de subscrição e atribuições de funções exigidas por alguns cenários.

  • Para usar um projeto existente sem criar recursos, é necessário pelo menos o Foundry User no projeto.

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

Instalar o Foundry DevPack

O Foundry DevPack instala as ferramentas de desenvolvimento do Foundry para o seu editor, terminal e agente de programação. Executa o comando para o teu sistema operativo.

Windows

winget install Microsoft.FoundryDevPack

macOS

brew install --cask microsoft/foundry/devpack && foundry-devpack install

Linux

curl -fsSL https://aka.ms/foundry-devpack-install.sh | bash

O DevPack instala estas ferramentas:

Tool O que pode fazer
Microsoft Foundry Toolkit para Visual Studio Code Compilar, testar, avaliar e implementar a partir do Visual Studio Code.
azd e azd ai Cria a estrutura, faz a implementação, avalia e automatiza no terminal.
Foundry Canvas (prévia) Criar e implementar agentes alojados com uma área de trabalho guiada do Copilot.
Skill do Microsoft Foundry Dê aos agentes de codificação orientações reutilizáveis para os fluxos de trabalho do Foundry.

Continue com as secções seguintes para configurar a sua linguagem de programação, iniciar sessão com a CLI do Azure e instalar o Git.

Trabalho com uma linguagem de programação

Use a linguagem que a sua candidatura exige. Expanda uma secção caso precise de instalar o ambiente de execução ou a extensão do Visual Studio Code.

Píton

Instala Python 3.10 ou posterior. Python 3.9 é a versão mínima suportada. Crie um ambiente virtual para o seu projeto em vez de instalar pacotes globalmente.

Windows

py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1

macOS e Linux

python3 -m venv .venv
source .venv/bin/activate

Para suporte a editores, instale a extensão Python para Visual Studio Code.

Java

Instala o JDK 17 ou mais recente. O Microsoft Build do OpenJDK é uma distribuição gratuita com suporte de longo prazo. Para suporte ao editor, instale o Visual Studio Code Extension Pack para Java.

JavaScript/TypeScript

Instalar o Node.js. Recomenda-se a versão 20 ou posterior.

C#

Instale a versão mais recente de suporte de longo prazo do .NET SDK. Para suporte a editores, instale o C# Dev Kit para Visual Studio Code.

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 depois de iniciar sessão.

Instalar o Git

Para clonar samples do Foundry SDK, precisas do Git. Se não tiveres o Git instalado, descarrega e instala a partir do site do Git.

Instale ferramentas de desenvolvimento individualmente

Se não usar o Foundry DevPack, instale cada ferramenta de desenvolvimento separadamente:

  1. Instale a Azure Developer CLI.
  2. Instale todas as extensões Foundry para azd: 
    azd ext install microsoft.foundry
    Para instalar extensões individuais em vez disso, veja Instalar as extensões Azure Developer CLI Foundry.
  3. Instala o editor e as ferramentas do agente de código:

Muitos templates de soluções de IA suportam a implementação com azd.

Resolução de problemas

Problema Resolução
Comando não encontrado após a instalação Fecha e reabre o teu terminal, ou reinicia o Visual Studio Code, para que as alterações no PATH entrem em vigor.
az login falha devido a um erro do navegador Executa az login --use-device-code para autenticar com um código de dispositivo.
Python não é encontrado Use python3 em vez de python no macOS ou Linux, ou instale Python 3.9 ou posterior.
Permissão negada durante a instalação do pacote Python No macOS ou Linux, não uses sudo pip install. Use antes um ambiente virtual.

Conteúdo relacionado

  • Last updated on