A fejlesztési környezet előkészítése

Készítse elő fejlesztési környezetét a Microsoft Foundryvel való buildeléshez. Szüksége van egy támogatott programozási nyelvre, a hitelesítéshez az Azure CLI-re, a Gitre és a Foundry fejlesztői eszközeire.

Tip

A Foundry DevPack a fejlesztői eszközök egyetlen parancsba való telepítésének ajánlott módja. Az egyes eszközöket külön is telepítheti.

Fontos

Ez a cikk általános előfeltételeket, globális eszközöket és Visual Studio Code beállítását ismerteti. Nem terjed ki a forgatókönyv-specifikus SDK-csomagokra vagy hitelesítési kódra. Ha a környezet készen áll, folytassa a rövid útmutatóval.

Előfeltételek

  • Aktív előfizetéssel rendelkező Azure fiók. Ha nem rendelkezik ilyen fiókkal, hozzon létre egy free Azure fiókot, amely ingyenes próbaverziós előfizetést tartalmaz.

  • Töltse le, telepítse és konfigurálja a Visual Studio Code, vagy használja a választott IDE-t.

  • Az Foundry-erőforrások létrehozásához és kezeléséhez használja az alábbi Azure RBAC-szerepkörök egyikét:

    • Foundry Project Manager a Foundry projektek kezeléséhez.

    Fontos

    Az Foundry RBAC-szerepköröket nemrég átnevezték. Foundry user, Foundry Owner, Foundry-fióktulajdonos és Foundry Project Manager korábban Azure AI-felhasználónak, Azure AI-tulajdonosnak, Azure AI-fióktulajdonosnak és Azure AI-Project-kezelőnek hívták. Előfordulhat, hogy egyes helyeken továbbra is a korábbi elnevezések jelennek meg, amíg az átnevezés fokozatosan bevezetésre kerül. A szerepkör-azonosítók és az alapvető jogosultságok az átnevezés ellenére változatlanok maradnak.

    • Bizonyos forgatókönyvek által megkövetelt előfizetési szintű engedélyek és szerepkör-hozzárendelések tulajdonosa.

  • Egy meglévő projekt erőforrások létrehozása nélküli használatához legalább Foundry User szerepkörrel kell rendelkeznie a projektben.

Az egyes szerepkörökkel kapcsolatos részletekért tekintse meg Microsoft Foundry szerepköralapú hozzáférés-vezérlését.

Az Foundry DevPack telepítése

A Foundry DevPack telepíti az Foundry fejlesztői eszközeit a szerkesztőhöz, a terminálhoz és a kódolási ügynökhöz. Az operációs rendszerének megfelelő parancsot futtassa.

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

A DevPack a következő eszközöket telepíti:

Eszköz Mit lehet tenni
Microsoft Foundry Toolkit for Visual Studio Code Fordítson, teszteljen, értékeljen és telepítsen a Visual Studio Code-ból.
azd és azd ai Állványzat, üzembe helyezés, kiértékelés és automatizálás a terminálból.
Foundry Canvas (előzetes verzió) Tervezzen és helyezzen üzembe hosztolt ügynököket egy Copilot-vezérelt felületen.
Microsoft Foundry Skill Adjon újrahasználható útmutatót a kódolóügynököknek az Foundry-munkafolyamatokhoz.

Folytassa a következő szakaszokkal a programozási nyelv beállításához, a Azure CLI való bejelentkezéshez és a Git telepítéséhez.

Programozási nyelvvel végzett munka

Használja az alkalmazás által igényelt nyelvet. Bontson ki egy szakaszt, ha telepítenie kell a hozzá tartozó futtatókörnyezetet vagy a Visual Studio Code-bővítményt.

Piton

Telepítse a Python 3.10-et vagy újabb verziót. Python 3.9 a minimálisan támogatott verzió. Hozzon létre egy virtuális környezetet a projekthez a csomagok globális telepítése helyett.

Windows

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

macOS és Linux

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

A szerkesztő támogatásához telepítse a Visual Studio Code Python bővítményét.

Java

Telepítse a JDK 17-et vagy újabb verzióját. A Microsoft Build – OpenJDK egy ingyenes, hosszú távú támogatású kiadás. A szerkesztő támogatásához telepítse a Visual Studio Code bővítménycsomagot Java.

JavaScript/TypeScript

A Node.js telepítése. A 20-es vagy újabb verzió használata ajánlott.

C#

Telepítse a .NET SDK legújabb Long-Term támogatási verzióját. A szerkesztő támogatásához telepítse a Visual Studio Code-hoz készült C# Dev Kitet.

A Azure CLI telepítése és bejelentkezés

Telepítse a Azure CLI és jelentkezzen be a helyi fejlesztési környezetből, hogy a kód a felhasználói hitelesítő adatokkal meghívhassa Azure szolgáltatásokat a Foundryn keresztül.

A legtöbb esetben az alábbi paranccsal telepítheti Azure CLI a terminálról:

winget install -e --id Microsoft.AzureCLI

Ha ezek a parancsok nem működnek az ön operációs rendszerén vagy beállításain, kövesse az Azure CLI telepítési útmutatóját.

A Azure CLI telepítése után jelentkezzen be a az login paranccsal, és jelentkezzen be a böngészőben:

az login

Másik lehetőségként manuálisan is bejelentkezhet a böngészőben egy eszközkóddal.

az login --use-device-code

A bejelentkezés után a szkriptek futtatásához tartsa nyitva ezt a terminált.

A Git telepítése

Az Foundry SDK-minták klónozásához Gitre van szükség. Ha nincs telepítve a Git, töltse le és telepítse a Git webhelyéről.

Fejlesztői eszközök telepítése egyenként

Ha nem a Foundry DevPackot használja, telepítse az egyes fejlesztői eszközöket külön:

  1. Telepítse az Azure Developer CLI-t.
  2. Telepítse az összes Foundry-bővítményt a következőhöz azd: 
    azd ext install microsoft.foundry
    Az egyes bővítmények telepítéséhez lásd: A Azure Developer CLI Foundry-bővítmények telepítése.
  3. Telepítse a szerkesztő és a kódolási ügynök eszközeit:

Számos AI-megoldássablon támogatja az üzembe helyezést.azd

Hibaelhárítás

Kérdés Felbontás
A parancs nem található a telepítés után Zárja be és nyissa meg újra a terminált, vagy indítsa újra Visual Studio Code, hogy a PATH-módosítások érvénybe léphessenek.
az login böngészőhiba miatt meghiúsul Futtassa a(z) az login --use-device-code parancsot az eszközkóddal történő hitelesítéshez.
Python nem található MacOS python3 vagy Linux helyett python használja, vagy telepítse a Python 3.9-et vagy újabb verziót.
Engedély megtagadva Python csomag telepítése során MacOS vagy Linux rendszeren ne használja sudo pip install. Használjon inkább virtuális környezetet.

Kapcsolódó tartalom

  • Last updated on