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

Állítsa be a fejlesztési környezetet a Microsoft Foundry SDK használatára. A hitelesítéshez Azure CLI is szüksége van, hogy a kód hozzáférhessen a felhasználói hitelesítő adatokhoz.

Ebben a cikkben nyelvi futtatókörnyezeteket, Azure CLI, Azure fejlesztői parancssori felületet, Microsoft Foundry Toolkit for Visual Studio Code bővítményt és Gitet telepít.

Fontos

Ez a cikk csak az általános előfeltételeket ismerteti, például a nyelvi futtatókörnyezeteket, a globális eszközöket, valamint a VS Code-ot és a bővítmények beállítását.
Nem foglalkozik forgatókönyvspecifikus lépésekkel, például az SDK telepítésével vagy hitelesítésével.
Amikor a környezet készen áll, folytassa a rövid útmutatóval az ott található utasításokért.

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 a választott IDE-t. További információ: Letöltés Visual Studio Code.

  • Az Öntödei erőforrások létrehozása és kezelése érdekében az alábbi Azure RBAC-szerepkörök egyikére van szükség

    • Foundry Project Manager (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.

    • Tulajdonos (előfizetési szintű engedélyek esetén). A tulajdonos szükséges a Foundry más forgatókönyveihez szükséges további szerepkör-hozzárendelésekhez. Annak érdekében, hogy a Foundry minden forgatókönyvében biztosítva legyen a hozzáférés, a Tulajdonos szerepkör hozzárendelése szükséges.

  • A projekt használatához, de nem új erőforrások létrehozásához legalább a következőkre van szükség:

    • Foundry-felhasználó az Ön által használt projektekben (a fejlesztéshez szükséges minimális jogosultságú szerepkör)

    Az egyes szerepkörök engedélyeinek részleteiért lásd: Szerepkör-alapú hozzáférés-vezérlés Microsoft Foundry.

A programozási nyelv telepítése

A Visual Studio Code-ban hozz létre egy új mappát a projekthez. Nyisson meg egy terminálablakot a mappában.

Először hozzon létre egy új Python környezetet. Ne telepítsen csomagokat a globális Python telepítésébe. Mindig használjon virtuális vagy conda környezetet Python csomagok telepítésekor. Ellenkező esetben megszakíthatja a Python globális telepítését.

Szükség esetén telepítse a Python

Használja a Python 3.10-et vagy újabb verziót, de legalább Python 3.9 szükséges. Ha nincs telepítve a Python megfelelő verziója, kövesse az VS Code Python oktatóanyag utasításait az operációs rendszerre való Python legegyszerűbb telepítéséhez.

Virtuális környezet létrehozása

Ha már telepítette a Python 3.10-et vagy újabb verziót, hozzon létre egy virtuális környezetet az alábbi parancsokkal:

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

A Python környezet aktiválásakor a parancssorból futó python vagy pip az alkalmazás .venv mappájában található Python értelmezőt használja.

Megjegyzés

A Python virtuális környezetből a deactivate paranccsal léphet ki. Később szükség esetén újraaktiválhatja.

A Visual Studio Code-hoz a Python bővítmény telepítése

A Visual Studio Code Python kiterjesztése támogatja a Python IntelliSense-t, hibakeresést, formázást, lintinget, kódnavigációt, átalakítást, változóböngészőt, tesztböngészőt és környezetkezelést.

Az Visual Studio Code.

Telepíteni:

  • Java Development Kit (JDK) 17 vagy újabb

A Visual Studio Code bővítménycsomag telepítése Java

A Java Bővítménycsomag népszerű bővítmények gyűjteménye, amelyek segíthetnek a Java alkalmazások írásában, tesztelésében és hibakeresésében a "Visual Studio Code" környezetében.

A Java Visual Studio Code bővítménycsomagjának telepítése.

Telepítse Node.js (a 20-es vagy újabb verzió ajánlott).

Győződjön meg arról, hogy telepítve vannak .NET fejlesztéshez szükséges eszközök.

A .NET SDK telepítése

A .NET-alkalmazások létrehozásához, létrehozásához és futtatásához szüksége van a .NET SDK-ra (Software Development Kit). Ha a projekt megköveteli, javasoljuk, hogy telepítse a legújabb LTS-verziót (hosszú távú támogatás) vagy egy újabb verziót.

  1. Töltse le a .NET SDK-t a official .NET letöltési oldaláról. Válassza ki az operációs rendszer (Windows, Linux vagy macOS) megfelelő telepítőt.

  2. Kövesse az operációs rendszer telepítési utasításait.

  3. A telepítés ellenőrzéséhez nyissa meg a terminált vagy a parancssort, és futtassa a következőt:

    dotnet --version

    A válasznak a telepített SDK-verziónak kell lennie.

C# Dev Kit telepítése a Visual Studio Code-hoz

A VS Code legjobb C#-fejlesztési élményéhez telepítse a hivatalos C# Dev Kit-bővítményt:

  1. Nyissa meg a Visual Studio Code.
  2. Lépjen a Bővítmények nézetre (Ctrl+Shift+X vagy Cmd+Shift+X).
  3. Keressen C# Fejlesztőkészletet.
  4. Telepítse a Microsoft által közzétett bővítményt. Ez az alap C# bővítményt is telepíti, ha még nem rendelkezik vele.

Új .NET Project létrehozása

Létrehozhat egy új .NET projektet a Visual Studio Code integrált terminállal (Terminál > Új terminál).

Új konzolalkalmazás létrehozása például:

# 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

Most már megnyithatja ezt a MyConsoleApp mappát a VS Code-ban (fájlmegnyitási > mappa...) a C# projekten való munka megkezdéséhez. A VS Code a C# Dev Kit bővítménnyel automatikusan észleli a projektet, lehetővé téve az olyan funkciókat, mint az IntelliSense, a hibakeresés és a buildelési feladatok.

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

Hagyja nyitva ezt a terminált, hogy szkripteket futtasson a bejelentkezés után.

A Azure fejlesztői parancssori felületének telepítése

A Azure fejlesztői parancssori felület (azd) egy nyílt forráskódú eszköz, amellyel alkalmazáserőforrásokat állíthat be és helyezhet üzembe Azure. Egyszerű parancsokat biztosít a fejlesztés kulcsfontosságú szakaszaihoz, akár terminált, IDE-t vagy CI/CD-folyamatokat használ. A platform Azure fejlesztői parancssori felületének telepítése.

Az AI-megoldássablonok közül sok tartalmaz egy üzembe helyezési lehetőséget a használatával azd.

A Microsoft Foundry Toolkit telepítése Visual Studio Code bővítményhez

Az Foundry Toolkit lehetővé teszi modellek üzembe helyezését, AI-alkalmazások készítését és az ügynökökkel való munkát közvetlenül a VS Code felületéről.

Kövesse a részletes utasításokat az Foundry Toolkit telepítéséhez és beállításához .

A Git telepítése

A Git szükséges az Foundry SDK-minták klónozásához. Ha nincs telepítve a Git, kövesse a platformra vonatkozó utasításokat , és válassza ki az operációs rendszert.

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 a VS Code-ot, így a PATH-módosítások érvénybe lépnek.
az login böngészőhiba miatt meghiúsul Futtassa az login --use-device-code, hogy eszközkód-alapú folyamat segítségével hitelesítsen.
Python nem található MacOS/Linux helyett python3 használjonpython, vagy telepítsen egy támogatott verziót (3.9-es vagy újabb verziót).
Engedély megtagadva a telepítés során MacOS/Linux rendszeren kerülje a sudo pip install. Használjon inkább virtuális környezetet .

Kapcsolódó tartalom

Az Microsoft Öntödei képesség elsajátítása kódolási ügynökökben

  • Last updated on