Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Configura o teu ambiente de desenvolvimento para usar o Microsoft Foundry SDK. 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 cobre apenas pré-requisitos gerais, como ambientes de execução de linguagem, ferramentas globais e a configuração de extensões e de VS Code.
Não cobre passos específicos de cenários como instalação ou autenticação do SDK.
Quando o ambiente estiver pronto, continue para o início rápido para obter 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.
Descarregue, instale e configure o Visual Studio Code, ou o IDE à sua escolha. Para obter mais informações, consulte Baixar o código do Visual Studio.
Para criar e gerir recursos Foundry, é necessário um dos seguintes funções Azure RBAC
- Azure AI Project Manager (para gerir projetos Foundry)
- Contribuidor ou Proprietário (para permissões a nível de subscrição)
Para usar o project mas não criar novos recursos, precisa pelo menos de:
- Azure AI User nos projetos que utiliza (função de privilégio mínimo para desenvolvimento)
Para detalhes sobre as permissões de cada função, consulte Controlo de acesso baseado em funções para Microsoft Foundry.
Instale a 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 Python. Não instale pacotes em sua instalação global do Python. Use sempre um ambiente virtual ou conda ao instalar pacotes Python. Caso contrário, podes estragar a instalação global do Python.
Se necessário, instale o Python
Use Python 3.10 ou posterior, mas pelo menos Python 3.9 é obrigatório. Se você não tiver uma versão adequada do Python instalada, siga as instruções no VS Code Python Tutorial para a maneira mais fácil de instalar o Python em seu sistema operacional.
Criar um ambiente virtual
Se já tem Python 3.10 ou superior instalado, crie um ambiente virtual usando os seguintes comandos:
Quando ativas o ambiente Python, a execução python ou pip a partir da linha de comandos usa o interpretador Python na .venv pasta da tua aplicação.
Observação
Usa o deactivate comando para sair do ambiente virtual em Python. Podes reativá-lo mais tarde, quando necessário.
Instalar a extensão Python para Visual Studio Code
A extensão Python para Visual Studio Code suporta Python com IntelliSense, depuração, formatação, linting, navegação de código, refatoração, explorador de variáveis, explorador de testes e gestão de ambientes.
Instalar:
- Java Development Kit (JDK) 17 ou posterior
- Recomendamos o Microsoft Build do OpenJDK, que é uma distribuição gratuita de Suporte Long-Term (LTS) do OpenJDK
Instalar o Visual Studio Code Extension Pack para Java
O Extension Pack for Java é uma coleção de extensões populares que podem ajudar a escrever, testar e depurar aplicações Java no Visual Studio Code.
Instalar o Node.js.
Certifique-se de ter as ferramentas necessárias instaladas para o desenvolvimento .NET.
Instalar o SDK do .NET
Você precisa do .NET SDK (Software Development Kit) para criar, compilar e executar aplicativos .NET. Recomendamos instalar a versão LTS (Long Term Support) mais recente ou uma versão posterior, se exigido pelo seu projeto.
Baixe o SDK do .NET na página oficial de download do .NET. Selecione o instalador apropriado para o seu sistema operacional (Windows, Linux ou macOS).
Siga as instruções de instalação do seu sistema operativo.
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 C# Dev Kit para Visual Studio Code
Para obter a melhor experiência de desenvolvimento em C# no VS Code, instale a extensão oficial do C# Dev Kit:
- Abre Visual Studio Code.
- Vá para a visualização Extensões (Ctrl+Shift+X ou Cmd+Shift+X).
- Procure por C# Dev Kit.
- Instale a extensão publicada pela Microsoft. Isso também instalará a extensão C# base, se você ainda não a tiver.
Criar um novo projeto .NET
Você pode criar um novo projeto .NET usando o terminal integrado ao Visual Studio Code (Terminal > New 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 esta MyConsoleApp pasta no VS Code (File > Open Folder...) para começar a trabalhar em seu projeto C#. O VS Code, com a extensão C# Dev Kit, detetará automaticamente o projeto, habilitando recursos como IntelliSense, depuração e tarefas de compilação.
Instalar a CLI do Azure e entrar
Instala a CLI do Azure e inicia sessão a partir do seu ambiente de desenvolvimento local, para que possa usar as suas credenciais de utilizador para ligar ao Azure OpenAI no Microsoft Foundry Models.
Na maioria dos casos, você pode instalar a CLI do Azure a partir do seu 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 ou configuração específicos.
Depois de instalar a CLI do Azure, entre usando o az login comando e entre usando o 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 a CLI do Azure Developer
A CLI do Desenvolvedor do Azure (azd) é uma ferramenta de código aberto 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 Azure Developer para sua plataforma.
Muitos dos modelos de soluções de IA incluem uma opção de implementação usando azd.
Instalar a extensão VS Code da Foundry
A extensão Foundry para Visual Studio Code permite-lhe implementar modelos, construir aplicações de IA e trabalhar diretamente com Agentes a partir da interface do VS Code. Instale a extensão Foundry VS Code.
Instalar o Git
O git é necessário para clonar amostras do SDK do Foundry. Se você não tiver o Git instalado, siga as instruções para sua plataforma e selecione seu sistema operacional.
Referências: Git