Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Configure seu ambiente de desenvolvimento para usar o SDK do Microsoft Foundry. Você também precisa da CLI do Azure para autenticação para que seu código possa acessar suas credenciais de usuário.
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 do Azure com uma assinatura ativa. Se você não tiver uma, crie uma conta gratuita do Azure, que inclui uma assinatura de avaliação gratuita.
Baixe, instale e configure o Visual Studio Code ou o IDE de sua escolha. Para obter mais informações, veja Baixar o Visual Studio Code.
Para criar e gerenciar recursos do Foundry, utilize uma das seguintes funções do Azure RBAC
- Gerenciador de Projetos de IA do Azure (para gerenciar projetos do Foundry)
- Colaborador ou Proprietário (para permissões no nível da assinatura)
Para usar o projeto, mas não criar novos recursos, você precisa pelo menos:
- Usuário de IA do Azure nos projetos que você usa (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 função para o Microsoft Foundry.
Instalar sua linguagem de programação
No Visual Studio Code, crie uma nova pasta para seu projeto. 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:
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.
Instalar:
- JDK (Java Development Kit) 17 ou posterior
- Recomendamos o Microsoft Build do OpenJDK, que é uma distribuição gratuita de LTS (Suporte Long-Term) do OpenJDK
Instalar o Pacote de Extensão 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 no Visual Studio Code.
Instale o Pacote de Extensão do Visual Studio Code para Java.
Instale o Node.js.
Verifique se você tem as ferramentas necessárias instaladas para o desenvolvimento do .NET.
Instalar o SDK do .NET
Você precisa do SDK do .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.
Baixe o SDK do .NET na página oficial de download do .NET. Selecione o instalador apropriado para seu sistema operacional (Windows, Linux ou macOS).
Siga as instruções de instalação do seu sistema operacional.
Verifique a instalação abrindo um terminal ou prompt de comando e executando:
dotnet --versionA 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#:
- Abra o Visual Studio Code.
- Vá para o modo de exibição Extensões (Ctrl+Shift+X ou Cmd+Shift+X).
- Pesquise o Kit de Desenvolvimento em C#.
- 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 projeto .NET
Você pode criar um novo projeto do .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 a CLI do Azure e entrar
Instale a CLI do Azure e entre em seu ambiente de desenvolvimento local, de modo que você possa usar suas credenciais de usuário para chamar o Azure OpenAI nos Modelos do Microsoft Foundry.
Na maioria dos casos, você pode instalar a CLI do Azure do terminal usando o seguinte comando:
Você pode seguir as instruções Como instalar a CLI do Azure se esses comandos não funcionarem para seu sistema operacional específico ou configuração.
Depois de instalar a 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 do Azure (azd) é uma ferramenta de software livre que ajuda você a configurar e implantar recursos de aplicativo no 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 do 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 da Fábrica para 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 Foundry para VS Code.
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.
Referências: Git