Sdílet prostřednictvím

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

Nastavte vývojové prostředí tak, aby používalo sadu Microsoft Foundry SDK. K ověřování potřebujete také Azure CLI, aby váš kód mohl access přihlašovací údaje uživatele.

V tomto článku nainstalujete jazykové runtime, Azure CLI, Azure Developer CLI, rozšíření Foundry VS Code a Git.

Důležité

Tento článek se věnuje pouze obecným požadavkům, jako jsou runtime jazyka, globální nástroje a nastavení programu Visual Studio Code a jeho rozšíření.
Nevztahuje se na kroky specifické pro konkrétní scénáře, jako je instalace sady SDK nebo ověřování.
Až bude vaše prostředí připravené, pokračujte k rychlému startu pro pokyny uvedené tam.

Předpoklady

  • Úč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 integrované vývojové prostředí (IDE) podle vašeho výběru. Další informace najdete v tématu Stažení Visual Studio Code.

  • Chcete-li vytvářet a spravovat prostředky Foundry, vyberte jednu z následujících rolí Azure RBAC.

    • Azure AI Project Manager (pro správu projektů Foundry)
    • Vlastník (pro oprávnění na úrovni předplatného) Vlastník je nezbytný pro další přidělení rolí požadované pro jiné případy použití ve Foundry. Abyste měli jistotu, že jste odblokováni pro všechny scénáře v Foundry, je vyžadováno přiřazení role Vlastník.

  • Pokud chcete použít project, ale ne vytvářet nové prostředky, potřebujete alespoň:

    • Azure AI uživatel v projektech, které používáte (role s nejnižšími oprávněními pro vývoj)

    Podrobnosti o oprávnění jednotlivých rolí viz Řízení přístupu na základě role pro Microsoft Foundry.

Instalace programovacího jazyka

V Visual Studio Code vytvořte novou složku pro project. Otevřete okno terminálu v této složce.

Nejprve vytvořte nové prostředí Pythonu. Neinstalujte balíčky do globální instalace Pythonu. Při instalaci balíčků Pythonu vždy používejte virtuální prostředí nebo prostředí Conda. Jinak můžete globální instalaci Pythonu přerušit.

V případě potřeby nainstalujte Python.

Použijte Python 3.10 nebo novější, ale vyžaduje se alespoň Python 3.9. Pokud nemáte nainstalovanou vhodnou verzi Pythonu, postupujte podle pokynů v kurzu VS Code Python pro nejjednodušší způsob instalace Pythonu ve vašem operačním systému.

Vytvoření virtuálního prostředí

Pokud už máte nainstalovaný Python 3.10 nebo novější, vytvořte virtuální prostředí pomocí následujících příkazů:

py -3 -m venv .venv
.venv\scripts\activate

Když aktivujete prostředí Pythonu, spuštěním python nebo pip z příkazového řádku se použije interpret Pythonu ve složce .venv vašeho programu.

Poznámka:

deactivate Pomocí příkazu ukončete virtuální prostředí Pythonu. Později ho můžete v případě potřeby znovu aktivovat.

Instalace rozšíření Pythonu pro Visual Studio Code

Rozšíření Pythonu pro Visual Studio Code podporuje Python s technologií IntelliSense, laděním, formátováním, lintingem, procházením kódu, refaktoringem, průzkumníkem proměnných, průzkumníkem testů a správou prostředí.

Instalujte rozšíření Pythonu pro kód Visual Studio.

Nainstalovat:

  • Java Development Kit (JDK) 17 nebo novější

Instalace balíčku rozšíření kódu Visual Studio pro Javu

Balíček rozšíření pro Javu je kolekce oblíbených rozšíření, která vám pomůžou psát, testovat a ladit aplikace Java v Visual Studio Code.

Instalujte balíček rozšíření kódu Visual Studio pro Javu.

Nainstalujte Node.js (doporučuje se verze 18 nebo novější).

Ujistěte se, že máte nainstalované potřebné nástroje pro .NET vývoj.

Instalace sady .NET SDK

K vytváření, sestavování a spouštění aplikací .NET potřebujete sadu .NET SDK (Software Development Kit). Pokud to vaše project vyžaduje, doporučujeme nainstalovat nejnovější verzi LTS (dlouhodobá podpora) nebo novější verzi.

  1. Stáhněte sadu .NET SDK z oficiální stránky ke stažení .NET. Vyberte odpovídající instalační program pro váš operační systém (Windows, Linux nebo macOS).

  2. Postupujte podle pokynů k instalaci operačního systému.

  3. Ověřte instalaci tak, že otevřete terminál nebo příkazový řádek a spustíte:

    dotnet --version

    Odpověď by měla být nainstalovaná verze sady SDK.

Nainstalujte sadu C# Dev Kit pro Visual Studio Code

Pro nejlepší vývojové prostředí jazyka C# ve VS Code nainstalujte oficiální rozšíření C# Dev Kit:

  1. Otevřete Visual Studio Code.
  2. Přejděte do zobrazení Rozšíření (Ctrl+Shift+X nebo Cmd+Shift+X).
  3. Vyhledejte C# Dev Kit.
  4. Nainstalujte rozšíření publikované Microsoftem. Tím se také nainstaluje základní rozšíření C#, pokud ho ještě nemáte.

Vytvoření nového .NET Project

Nový .NET project můžete vytvořit pomocí terminálu integrovaného do Visual Studio Code (Terminál > Nový terminál).

Pokud chcete například vytvořit novou konzolovou aplikaci:

# 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

Teď můžete tuto složku MyConsoleApp otevřít ve VS Code (Soubor > Otevřít složku...) a začít pracovat na project C#. VS Code s rozšířením C# Dev Kit automaticky rozpozná project a povolí funkce, jako je IntelliSense, ladění a úlohy sestavení.

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í, abyste mohli pomocí svých přihlašovacích údajů volat Azure OpenAI v modelech Microsoft 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 rozhraní příkazového řádku pro vývojáře Azure

Rozhraní příkazového řádku pro vývojáře Azure (azd) je opensourcový nástroj, který vám pomůže nastavit a nasadit prostředky aplikace na Azure. Poskytuje jednoduché příkazy pro klíčové fáze vývoje, ať už používáte terminál, integrované vývojové prostředí nebo pipelines CI/CD. Instalujte rozhraní příkazového řádku pro vývojáře Azure pro vaši platformu.

Mnoho šablon řešení AI zahrnuje možnost nasazení pomocí azd.

Instalace rozšíření Foundry VS Code

Rozšíření Foundry pro Visual Studio Code umožňuje nasazovat modely, sestavovat aplikace AI a pracovat s agenty přímo z rozhraní VS Code. Nainstalujte rozšíření Foundry VS Code.

Nainstalujte Git

Git se vyžaduje ke klonování ukázek sady Foundry SDK. Pokud nemáte nainstalovaný Git, postupujte podle pokynů pro vaši platformu a vyberte operační systém.

Řešení problémů

Problém Řešení
Příkaz nebyl po instalaci nalezen. Zavřete a znovu otevřete terminál nebo restartujte VS Code, aby se změny PATH projevily.
az login dojde k chybě prohlížeče Spusťte az login --use-device-code, abyste místo toho použili ověření pomocí toku kódu zařízení.
Python nebyl nalezen. Používejte python3 místo python v systému macOS/Linux nebo nainstalujte podporovanou verzi (3.9 nebo novější).
Oprávnění bylo odepřeno při instalaci. V systému macOS/Linux nepoužívejte sudo pip install. Místo toho použijte virtuální prostředí .

Související obsah

  • Referenční dokumentace sady SDK .NET
  • Referenční dokumentace k sadě Java SDK
  • Last updated on