Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Prepare o seu ambiente de desenvolvimento para construir com o Microsoft Foundry. Precisas de uma linguagem de programação suportada, o Git, e as ferramentas de desenvolvimento Foundry que se adaptem ao teu fluxo de trabalho.
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 cobre pré-requisitos gerais e ferramentas para programadores. 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.
- Aceder ao recurso ou projeto da Foundry que planeia usar. Para orientações sobre configuração, consulte Atribuições mínimas de funções para começar.
Instalar o Foundry DevPack
O Foundry DevPack instala as ferramentas de desenvolvimento do Foundry para o seu terminal, editor e agente de programação. Selecione o seu sistema operativo.
O DevPack instala as suas ferramentas principais e adiciona extensões de host apenas quando as suas aplicações estão presentes:
| Tool | O que pode fazer |
|---|---|
azd e azd ai |
Cria a estrutura, faz a implementação, avalia e automatiza no terminal. |
| Skill do Microsoft Foundry | Dê aos agentes de codificação orientações reutilizáveis para os fluxos de trabalho do Foundry. |
| Microsoft Foundry Toolkit para Visual Studio Code | Instalado apenas quando o Visual Studio Code está presente. Construo, testa, avalia e implementa a partir do editor. |
| Foundry Canvas (prévia) | Instalado apenas quando a aplicação GitHub Copilot está presente. Conceber e implementar agentes alojados num painel guiado. |
O DevPack não instala o Visual Studio Code nem a aplicação GitHub Copilot.
Continue com as secções seguintes para configurar a sua linguagem de programação e instalar o Git.
Trabalho com uma linguagem de programação
Use a linguagem que a sua candidatura exige. Selecione um separador para instalar o respetivo runtime ou a extensão do Visual Studio Code.
Instala Python 3.10 ou posterior. Python 3.10 é 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.
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 as ferramentas de desenvolvimento separadamente
Se não usares o Foundry DevPack, seleciona um separador para instalar apenas as ferramentas de que precisas.
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 Azure Developer CLI Foundry.
Para uma gestão direta e granular de recursos individuais do Azure, utilize a CLI do Azure (az). Veja Azure Developer CLI vs CLI do Azure.
Resolução de problemas
| Problema | Resolução |
|---|---|
| Comando não encontrado após a instalação | Feche e reabra o terminal. Se usares Visual Studio Code, reinicia-o para que as alterações do PATH tenham efeito. |
| Python não é encontrado | Usa python3 em vez de python no macOS ou Linux, ou instala Python 3.10 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. |