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.
Prepare seu ambiente de desenvolvimento para criar com Microsoft Foundry. Você precisa de uma linguagem de programação com suporte, o Git e as ferramentas de desenvolvedor do Foundry que se ajustem ao fluxo de trabalho.
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 os pré-requisitos gerais e as ferramentas de desenvolvedor. 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.
- Acesso ao recurso ou projeto do Foundry que você planeja usar. Para obter diretrizes de configuração, consulte Atribuições mínimas de função para começar.
Instalar o Foundry DevPack
O Foundry DevPack instala as ferramentas de desenvolvedor do Foundry para seu terminal, editor e agente de codificação. Selecione o sistema operacional.
O DevPack instala suas principais ferramentas e adiciona extensões de host somente quando seus aplicativos estão presentes:
| Tool | O que você pode fazer |
|---|---|
azd e azd ai |
Crie, implemente, avalie e automatize a partir do terminal. |
| Habilidade do Microsoft Foundry | Forneça diretrizes reutilizáveis aos agentes de codificação para fluxos de trabalho do Foundry. |
| Microsoft Foundry Toolkit for Visual Studio Code | Instalado somente quando Visual Studio Code estiver presente. Compilar, testar, avaliar e implantar por meio do editor. |
| Canvas do Foundry (versão prévia) | Instalado somente quando GitHub Copilot App estiver presente. Crie e implante agentes hospedados em uma interface guiada. |
O DevPack não instala Visual Studio Code ou GitHub Copilot App.
Continue com as seções a seguir para configurar sua linguagem de programação e instalar o Git.
Trabalhar com uma linguagem de programação
Use o idioma necessário para seu aplicativo. Selecione uma aba para instalar o runtime correspondente ou a extensão do Visual Studio Code.
Instale Python 3.10 ou posterior. Python 3.10 é 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.
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 separadamente
Se você não usar o Foundry DevPack, selecione uma guia para instalar apenas as ferramentas de que você precisa.
Instale as extensões do Foundry:
azd ext install microsoft.foundry
Para instalar extensões individuais em vez do pacote completo, consulte Instalar as extensões da CLI do desenvolvedor do Azure.
Para gerenciamento direto e granular de recursos de Azure individuais, use o CLI do Azure (az). Consulte Azure Developer CLI vs. CLI do Azure.
Solucionando problemas
| Questão | Resolução |
|---|---|
| Comando não encontrado após a instalação | Feche e reabra o terminal. Se você usar Visual Studio Code, reinicie-o para que as alterações path entrem em vigor. |
| Python não foi encontrado | Use python3 em vez de python no macOS ou Linux ou instale Python 3.10 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. |