Preparar seu ambiente de desenvolvimento

Prepare seu ambiente de desenvolvimento para criar com o Microsoft Foundry. Você precisa de uma linguagem de programação com suporte, o CLI do Azure para autenticação, Git e ferramentas de desenvolvedor do Foundry.

Dica

O Foundry DevPack é a maneira recomendada de instalar as ferramentas de desenvolvedor em um comando. Você também pode instalar cada ferramenta separadamente.

Importante

Este artigo aborda pré-requisitos gerais, ferramentas globais e configuração de Visual Studio Code. Ele não abrange pacotes do SDK específicos do cenário ou código de autenticação. Quando o ambiente estiver pronto, prossiga para o início rápido.

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 use o IDE de sua escolha.

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

    • Gerenciador de Projetos do Foundry para gerenciar projetos do Foundry.

    Importante

    As funções RBAC do Foundry foram renomeadas recentemente. Foundry User, Foundry Owner, Foundry Account Owner e Foundry Project Manager eram anteriormente chamados de Usuário do Azure AI, Proprietário do Azure AI, Proprietário da conta do Azure AI e Gerente de Projeto do Azure AI. Você ainda pode ver os nomes anteriores em alguns lugares enquanto essa mudança de nome está sendo implementada. Os IDs das funções e as permissões principais não são alterados com a mudança de nome.

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

  • Para usar um projeto existente sem criar recursos, você precisa, pelo menos, do Usuário do Foundry no projeto.

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

Instalar o Foundry DevPack

O Foundry DevPack instala as ferramentas de desenvolvedor do Foundry para seu editor, terminal e agente de codificação. Execute o comando do sistema operacional.

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 você pode fazer
Microsoft Foundry Toolkit for Visual Studio Code Compilar, testar, avaliar e implantar a partir do Visual Studio Code.
azd e azd ai Crie a estrutura, implante, avalie e automatize pelo terminal.
Canvas do Foundry (versão prévia) Projete e implante agentes hospedados com uma tela guiada Copilot.
Habilidade do Microsoft Foundry Forneça diretrizes reutilizáveis aos agentes de codificação para fluxos de trabalho do Foundry.

Continue com as seções a seguir para configurar sua linguagem de programação, entrar com o CLI do Azure e instalar o Git.

Trabalhar com uma linguagem de programação

Use o idioma necessário para seu aplicativo. Expanda uma seção caso precise instalar seu runtime ou a extensão do Visual Studio Code.

Python

Instale Python 3.10 ou posterior. Python 3.9 é a versão mínima com suporte. Crie um ambiente virtual para 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 obter suporte ao editor, instale a extensão Python para Visual Studio Code.

Java

Instale o JDK 17 ou posterior. O Microsoft Build do OpenJDK é uma distribuição gratuita com suporte de longo prazo. Para obter suporte ao editor, instale o Pacote de Extensão Visual Studio Code para Java.

JavaScript/TypeScript

Instale o Node.js. A versão 20 ou posterior é recomendada.

C#

Instale a versão mais recente com Suporte de Longo Prazo do .NET SDK. Para obter suporte ao editor, instale o Kit de Desenvolvimento do C# para Visual Studio Code.

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 o Git

Para clonar exemplos do SDK do Foundry, você precisa do Git. Se você não tiver o Git instalado, baixe-o e instale-o no site do Git.

Instalar ferramentas de desenvolvedor individualmente

Se você não usar o Foundry DevPack, instale cada ferramenta de desenvolvedor separadamente:

  1. Instale a CLI de Desenvolvedor do Azure.
  2. Instale todas as extensões do Foundry para azd: 
    azd ext install microsoft.foundry
    Em vez disso, para instalar extensões individuais, consulte Instalar as extensões da CLI do desenvolvedor do Azure.
  3. Instale as ferramentas do editor e do agente de codificação:

Muitos modelos de solução de IA dão suporte à implantação com azd.

Solucionando problemas

Questão Resolução
Comando não encontrado após a instalação Feche e reabra o terminal ou reinicie Visual Studio Code, para que as alterações de PATH entrem em vigor.
az login falha com um erro do navegador Execute az login --use-device-code para autenticar com um código de dispositivo.
Python não foi 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 de pacote do Python No macOS ou linux, não use sudo pip install. Em vez disso, use um ambiente virtual.

Conteúdo relacionado

  • Last updated on