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 přistupovat k vašim přihlašovacím údajům uživatele.

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

Důležité

Tento článek se zabývá pouze obecnými požadavky , jako jsou moduly runtime jazyka, globální nástroje a nastavení rozšíření VS Code.
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 tyto pokyny.

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 integrované vývojové prostředí podle vašeho výběru. Další informace viz Stažení Visual Studio Code.

  • Pokud chcete vytvářet a spravovat prostředky Foundry, musíte mít jednu z následujících RBAC rolí Azure

    • 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) Vlastník je nezbytný pro další přiřazení rolí vyžadovaných pro jiné scénáře v Foundry. Abyste měli jistotu, že jste odblokovali všechny scénáře v Foundry, je vyžadováno přiřazení role vlastníkem.

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

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

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

Instalace programovacího jazyka

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

Nejprve vytvořte nové prostředí Python. Neinstalujte balíčky do globální instalace Python. Při instalaci balíčků Python vždy používejte virtuální prostředí nebo prostředí Conda. Jinak můžete globální instalaci Python 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 Python, postupujte podle pokynů v VS Code Python Tutorial nejjednodušší způsob instalace Python do operačního systému.

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

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

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

Při aktivaci prostředí Python se z příkazového řádku spuštěním příkazu python nebo pip použije Python interpret ve složce .venv vaší aplikace.

Poznámka

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

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

Rozšíření Python pro Visual Studio Code podporuje Python pomocí Technologie IntelliSense, ladění, formátování, lintování, navigace kódu, refaktoringu, průzkumníka proměnných, průzkumníka testů a správy prostředí.

Instalujte rozšíření Python pro Visual Studio Code.

Nainstalovat:

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

Instalace balíčku rozšíření Visual Studio Code pro Java

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

Instalujte balíček rozšíření Visual Studio Code pro Java.

Nainstalujte Node.js (doporučuje se verze 20 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 váš projekt vyžaduje, doporučujeme nainstalovat nejnovější verzi LTS (dlouhodobá podpora) nebo novější verzi.

  1. Stáhněte sadu SDK pro .NET ze stránky pro stažení oficiálního .NET. Vyberte příslušný 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é Microsoft. Tím se také nainstaluje základní rozšíření C#, pokud ho ještě nemáte.

Vytvoření nového .NET Project

Nový projekt .NET 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

Tuto složku teď můžete otevřít MyConsoleApp v editoru VS Code ( > Otevřít složku souboru...), abyste mohli začít pracovat na projektu C#. VS Code s rozšířením C# Dev Kit automaticky rozpozná projekt 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í, 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 rozhraní příkazového řádku pro vývojáře Azure

Vývojářské CLI Azure (azd) je open-source nástroj, který vám pomůže konfigurovat a nasadit prostředky aplikace na Azure. Poskytuje jednoduché příkazy pro klíčové fáze vývoje, ať už používáte kanály terminálu, integrovaného vývojového prostředí nebo kanály 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.

Instalace 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í potíží

Problém Rozliš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 selže s chybou prohlížeče Místo toho spusťte az login --use-device-code, abyste se ověřili pomocí toku kódu zařízení.
Python nenalezena 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 během instalace. 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 pro Microsoft Foundry SDK
  • Referenční dokumentace k sadě SDK .NET
  • Last updated on