Příprava vývojového prostředí

Připravte vývojové prostředí na sestavení pomocí Microsoft Foundry. Potřebujete podporovaný programovací jazyk, Azure CLI pro vývojářské nástroje, Git a Foundry.

Tip

Foundry DevPack je doporučený způsob instalace vývojářských nástrojů v jednom příkazu. Každý nástroj můžete nainstalovat také samostatně.

Důležité

Tento článek se zabývá obecnými požadavky, globálními nástroji a nastavením Visual Studio Code. Nevztahuje se na balíčky sdk specifické pro konkrétní scénáře ani ověřovací kód. Až bude vaše prostředí připravené, pokračujte k rychlému startu.

Požadavky

  • Účet Azure s aktivním předplatným. Pokud ho nemáte, vytvořte si účet free Azure, který zahrnuje bezplatné zkušební předplatné.

  • Stáhněte, nainstalujte a nakonfigurujte Visual Studio Code nebo použijte integrované vývojové prostředí podle vašeho výběru.

  • Pokud chcete vytvářet a spravovat prostředky Foundry, použijte jednu z těchto Azure rolí RBAC:

    • Foundry Project Manager pro správu projektů Foundry.

    Důležité

    Nedávno byly přejmenovány role Foundry RBAC. Foundry User, Foundry Owner, Foundry Account Owner a Foundry Project Manager se dříve nazývaly Uživatel Azure AI, Vlastník Azure AI, Vlastník účtu Azure AI a Správce projektů Azure AI. Během zavádění přejmenování se stále můžou zobrazovat předchozí názvy na některých místech. ID rolí a základní oprávnění se při přejmenování nezmění.

    • Vlastník pro oprávnění na úrovni předplatného a přiřazení rolí vyžadovaná některými scénáři

  • Pokud chcete použít existující projekt bez vytváření zdrojů, potřebujete v projektu alespoň uživatele Foundry .

Podrobnosti o jednotlivých rolích najdete v tématu Řízení přístupu na základě role pro Microsoft Foundry.

Instalace Foundry DevPacku

Foundry DevPack nainstaluje vývojářské nástroje Foundry pro váš editor, terminál a agenta kódování. Spusťte příkaz pro váš operační systém.

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

DevPack nainstaluje tyto nástroje:

nástroj Co můžete dělat
Microsoft Foundry Toolkit for Visual Studio Code Sestavení, testování, vyhodnocení a nasazení z Visual Studio Code
azd a azd ai Vytvářejte, nasazujte, vyhodnocujte a automatizujte z příkazového řádku.
Foundry Canvas (Preview) Navrhujte a nasazujte hostované agenty v průvodcovaném plátně Copilotu.
Microsoft Foundry Skill Poskytněte programovacím agentům opakovaně použitelné pokyny pro pracovní postupy ve Foundry.

Pokračujte v následujících částech a nastavte si programovací jazyk, přihlaste se pomocí Azure CLI a nainstalujte Git.

Práce s programovacím jazykem

Použijte jazyk, který vaše aplikace vyžaduje. Rozbalte část, pokud potřebujete nainstalovat její běhové prostředí nebo rozšíření pro Visual Studio Code.

Python

Nainstalujte Python 3.10 nebo novější. Python 3.9 je minimální podporovaná verze. Místo globální instalace balíčků vytvořte pro svůj projekt virtuální prostředí.

Windows

py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1

macOS a Linux

python3 -m venv .venv
source .venv/bin/activate

Pro podporu editoru nainstalujte rozšíření Python pro Visual Studio Code.

Java

Nainstalujte JDK 17 nebo novější. Microsoft Build pro OpenJDK je bezplatná distribuce s dlouhodobou podporou. Pro podporu editoru nainstalujte rozšíření Visual Studio Code Extension Pack for Java.

JavaScript/TypeScript

Nainstalujte Node.js. Doporučuje se verze 20 nebo novější.

C#

Nainstalujte nejnovější verzi s dlouhodobou podporou .NET SDK. Pro podporu editoru nainstalujte C# Dev Kit for Visual Studio Code.

Instalace Azure CLI a přihlášení

Nainstalujete Azure CLI a přihlásíte se z místního vývojového prostředí, aby kód mohl pomocí přihlašovacích údajů uživatele volat služby Azure přes Foundry.

Ve většině případů můžete z terminálu nainstalovat Azure CLI pomocí následujícího příkazu:

winget install -e --id Microsoft.AzureCLI

Pokud tyto příkazy nefungují pro váš konkrétní operační systém nebo nastavení, můžete postupovat podle pokynů jak nainstalovat Azure CLI.

Po instalaci Azure CLI se přihlaste pomocí příkazu az login a přihlaste se pomocí prohlížeče:

az login

Alternativně se můžete přihlásit ručně pomocí prohlížeče pomocí kódu zařízení.

az login --use-device-code

Nechte tento terminál otevřený, aby po přihlášení spouštěl skripty.

Instalace Git

K klonování ukázek sady Foundry SDK potřebujete Git. Pokud nemáte nainstalovaný Git, stáhněte si ho a nainstalujte z webu Git.

Instalace vývojářských nástrojů jednotlivě

Pokud nepoužíváte Foundry DevPack, nainstalujte každý vývojářský nástroj samostatně:

  1. Nainstalujte Azure Developer CLI.
  2. Nainstalujte všechna rozšíření Foundry pro azd: 
    azd ext install microsoft.foundry
    Pokud chcete nainstalovat jednotlivá rozšíření, přečtěte si téma Instalace rozšíření Azure Developer CLI Foundry.
  3. Nainstalujte editor a nástroje agenta pro programování:

Mnoho šablon řešení AI podporuje nasazení s azd.

Řešení potíží

Problém Rozlišení
Příkaz nebyl po instalaci nalezen. Zavřete a znovu otevřete terminál nebo restartujte Visual Studio Code, aby se změny PATH projevily.
az login selže s chybou prohlížeče Spusťte az login --use-device-code pro ověření pomocí kódu zařízení.
Python se nenašel Používejte python3 místo python v systému macOS nebo Linux nebo nainstalujte Python 3.9 nebo novější.
Během instalace balíčku Python došlo k odepření oprávnění V systému macOS nebo Linux nepoužívejte sudo pip install. Místo toho použijte virtuální prostředí.

Související obsah

  • Last updated on