Az Microsoft Foundry Toolkit használata Visual Studio Code bővítményhez

Ebből a cikkből megtudhatja, hogyan telepítheti és használhatja a Microsoft Foundry Toolkit for Visual Studio Code bővítményt. Projektek létrehozása, modellek üzembe helyezése az Foundry-modellkatalógusból, valamint a VS Code-on belüli modelljátszóterek használata.

Előfeltételek

• Egy Azure előfizetés. Hozzon létre egyet ingyen.
• Visual Studio Code telepítve.
• A cikkben szereplő új modell üzembe helyezéséhez az előfizetésnek a kvótakorlát alatt kell lennie. Ha már elérte a kvótakorlátot, üzembe helyezett csevegőmodellt kell használnia.
• Az Öntödei erőforrások létrehozásához és kezeléséhez szükséges RBAC-engedélyek. További információ: A Foundry szerepköralapú hozzáférés-vezérlése.

A bővítmény telepítése

Az Öntödei képességek VS Code-ban való használatához telepítse a Microsoft Foundry Toolkit for Visual Studio Code bővítményt. Telepítse a Visual Studio Code Marketplace-ről vagy közvetlenül a VS Code-ból.

Telepítés a Visual Studio Code Marketplace-ről

A bővítmény telepítése a piactéren a VS Code megnyitása nélkül.

1. Nyissa meg a Microsoft Foundry Toolkit for Visual Studio Code extension lapot.
2. Válassza a Telepítés gombot.
3. Az utasításokat követve telepítse a bővítményt a Visual Studio Code.
4. A telepítés után nyissa meg a Visual Studio Code, és ellenőrizze, hogy a bővítmény sikeresen telepítve van-e az állapotüzenetekből.
5. Az Foundry Toolkit ikon megjelenik a VS Code bal oldalán található elsődleges navigációs sávon.

Telepítés a Visual Studio Code belsejéből

Másik lehetőségként keresse meg a bővítményt közvetlenül a VS Code bővítmények nézetéből.

1. Nyissa meg a VS Code-ot.

2. Válassza a Bővítmények lehetőséget a bal oldali panelen.

3. Válassza a Beállítások ikont a bővítmények panel jobb felső sarkában.

4. Keresse meg, és válassza ki a(z) Foundry Toolkit for VS Code elemet.

5. Válassza a Telepítés lehetőséget.

6. A telepítés befejezése után egy állapotüzenet megerősíti, hogy a bővítmény telepítve van. Az Foundry Toolkit ikon megjelenik a bal oldali navigációs sávon.

Csatlakozás a Azure-erőforrásokhoz

A bővítmény telepítése után jelentkezzen be a Azure-előfizetésbe, és nyisson meg egy Foundry-projektet a modellek, ügynökök és játszóterek használatának megkezdéséhez.

Megjegyzés

A bővítményben elérhető funkciók teljes listájához használja a parancskatalógust. Válassza az F1 lehetőséget a parancskatalógus megnyitásához és a Foundry Toolkitben való kereséshez. Az alábbi képernyőképen néhány elérhető parancs látható.

Bejelentkezés az erőforrásokba

Jelentkezzen be a Azure-előfizetésbe, hogy a bővítmény hozzáférhessen a Foundry-projektekhez és az üzembe helyezett modellekhez.

1. Válassza a Azure ikont a VS Code navigációs sávján.

2. Válassza a Jelentkezzen be az Azure-ra... az Azure Erőforrások nézetben.

3. A Forrás szakaszban válassza ki Azure előfizetését és erőforráscsoportját.

4. Válassza az Foundry lehetőséget, és kattintson a jobb gombbal a projektre.

5. Válassza a Megnyitás az Öntödei eszközkészlet bővítményben lehetőséget.

   Az Foundry-projekt erőforrásai a bővítmény nézetben jelennek meg, az Foundry ikon pedig a VS Code navigációs sávján.

Navigálás a bővítőfelületen

A Visual Studio Code bővítményhez készült Microsoft Foundry Toolkit három fő szakaszba rendezi a munkaterületet.

Szakasz	Mit tartalmaz?	Mikor érdemes használni?
Saját erőforrások	Üzembe helyezett modellek, deklaratív ügynökök, üzemeltetett ügynökök, kapcsolatok és vektortárolók az Foundry-projekthez.	A projekt erőforrásainak megtekintése és kezelése.
Fejlesztői eszközök	Modellkatalógus, Modelljátszótér, Ügynök-játszóterek (távoli és helyi), Helyi vizualizáció és Üzemeltetett ügynökök üzembe helyezése.	Új modellek üzembe helyezése, tesztelési kérések és ügynökökkel való interakció.
Súgó és visszajelzés	Dokumentáció, GitHub adattár, Microsoft adatvédelmi nyilatkozat és közösségi hivatkozások.	Segítség kérése vagy visszajelzés küldése.

Projekt létrehozása

Hozzon létre egy új Foundry-projektet közvetlenül a bővítményből a modellek és erőforrások rendszerezéséhez.

1. Válassza a + Create Project lehetőséget a My Resources szakaszában a Microsoft Foundry Toolkit for Visual Studio Code extension view nézetben.

   Létrehozhat egy új erőforráscsoportot, vagy kiválaszthat egy meglévőt.

2. Új erőforráscsoport létrehozása:

   1. Válassza az Új erőforráscsoport létrehozása lehetőséget, és nyomja le az Enter billentyűt.

   2. Írja be a Azure erőforráscsoport nevét a A következő új erőforráscsoport szövegmezőbe, és nyomja le az Enter billentyűt.

   3. Válassza ki a használni kívánt helyet az elérhető helyek listájából, és nyomja le az Enter billentyűt.

3. Meglévő erőforráscsoport használata:

   • Válassza ki a használni kívánt erőforráscsoportot az elérhető erőforráscsoportok listájából, és nyomja le az Enter billentyűt.

4. Írja be az Foundry projekt nevét az Enter projektnév szövegmezőbe, és nyomja le az Enter billentyűt.

A projekt üzembe helyezése után megjelenik egy előugró ablak, amelyen az üzenet A projekt sikeresen üzembe helyezve.

Ha egy modellt szeretne üzembe helyezni az újonnan létrehozott projektben, válassza a Modell üzembe helyezése gombot az előugró ablakban. Ez a művelet megnyitja a Modellkatalógus lapot, ahol kiválaszthatja a telepíteni kívánt modellt.

Az alapértelmezett projekt váltása

Amikor megnyit egy projektet a Microsoft Foundry Toolkit for Visual Studio Code bővítményben, az a projekt lesz az alapértelmezett projekt. Az alapértelmezett projekt váltása:

1. Kattintson a jobb gombbal a Foundry projektre, és válassza a Switch alapértelmezett projekt az Azure bővítményben opciót.

2. Válassza ki a használni kívánt Foundry-projektet az elérhető projektek listájából, és nyomja le az Enter billentyűt.

A kijelölt projekt ekkor megjeleníti az Alapértelmezett értéket a projekt neve után.

Tipp

Kattintson a jobb gombbal a projekt nevére a projektvégpont vagy a projekt API-kulcsának eléréséhez.

Modellek kezelése

A Microsoft Foundry Toolkit for Visual Studio Code bővítmény lehetővé teszi a modellek felderítését, üzembe helyezését és használatát a Foundry modellkatalógusból közvetlenül a VS Code-ban.

Tallózás a modellkatalógusban

A modellkatalógus hozzáférést biztosít Microsoft, OpenAI, Meta, DeepSeek és más szolgáltatók modelljeihez. A modellkatalógus többféleképpen is megnyitható:

• Futtassa a Foundry Toolkit: Show model catalog parancsot a parancspalettáról.
• Válassza a Microsoft Foundry Toolkit for Visual Studio Code bővítmény nézetének Saját erőforrások szakaszában a Modellek melletti plus ikont.
• Válassza a Modellkatalógus hivatkozást a Developer Tools szakaszában a Microsoft Foundry Toolkit for Visual Studio Code bővítménynézetben.

A modellkatalógus megnyitása a parancskatalógusból

A parancskatalógus használatával a bővítménynézet navigálása nélkül nyithatja meg a modellkatalógust.

1. Válassza az F1 lehetőséget a parancskatalógus megnyitásához.

2. Írja be az Foundry Toolkit parancsot: jelenítse meg a modellkatalógust , és nyomja le az Enter billentyűt.

3. Megnyílik a Modellkatalógus lap.

   

4. Szűrje a Modellkatalógust a Tárolja, a Kiadó, a Jellemző vagy a Modell típusa alapján a lap tetején található legördülő listák használatával. Válassza a Fine-Tuning Támogatási kapcsolót a finomhangolást támogató modellek szűréséhez.

5. Keressen egy adott modellt a lap tetején található keresősáv használatával.

A modellkatalógus megnyitása az Erőforrások szakaszból

A Visual Studio Code-hoz készült Microsoft Foundry Toolkit bővítmény nézetében válassza a plus ikont a Models mellett a modellkatalógus megnyitásához.

Tipp

A modellekre a jobb gombbal kattintva az Új AI-modell üzembe helyezése lehetőséget választva közvetlenül az üzembe helyezési folyamatra léphet.

A modellkatalógus megnyitása az Eszközök szakaszban

A Developer Tools Microsoft Foundry Toolkit for Visual Studio Code extension view szakaszában kattintson duplán a Modellkatalógus hivatkozásra.

Modell üzembe helyezése a modellkatalógusból

Miután megtalálta a modellt a katalógusban, helyezze üzembe azt a Foundry-projektben, hogy az alkalmazásokban használhassa.

1. Válassza a Kiválasztott modell neve melletti Üzembe helyezés gombot.

2. Megnyílik a Modell üzembehelyezési lapja.

3. Írja be a modell üzembe helyezésének nevét az Enter deployment name (Üzembe helyezés neve ) szövegmezőbe, és nyomja le az Enter billentyűt.

4. Válassza ki az üzembehelyezési típust az Üzembe helyezés típusa legördülő listában.

5. Válassza ki a modellverziót a Modellverzió legördülő listában.

6. (Nem kötelező) Állítsa be a jelölők percenkénti számát a Tokens per minute csúszka segítségével.

7. Válassza az Üzembe helyezés az Öntödében gombot a bal alsó sarokban.

8. A megerősítést kérő párbeszédpanelen válassza az Üzembe helyezés lehetőséget.

9. Az üzembe helyezés befejezése után a modell üzembe helyezési név alapján jelenik meg a projekt Modellek szakaszában.

Üzembe helyezett modellek megtekintése és kezelése

Bontsa ki a Modellek szakaszt a Microsoft Foundry Toolkit for Visual Studio Code bővítménynézetében, hogy az összes üzembe helyezett modell megjelenjen a projektben.

Modellkártya adatainak megtekintése

Az üzembe helyezett modell kiválasztásával nyisson meg egy panelt az alábbi részletekkel:

• Üzembehelyezési információk: Név, kiépítési állapot, üzembe helyezés típusa, sebességkorlát, verzióinformációk, modellnév és modellverzió.
• Végpontadatok: Cél URI-hivatkozás, hitelesítési típus és kulcs.
• Hasznos hivatkozások: Kódminta-adattár és oktatóanyagok az AI-alkalmazások fejlesztéséhez.

Modell központi telepítési beállításainak frissítése

Az üzembehelyezési beállítások, például a sebességkorlátok frissítése:

1. Válassza a modellkártya jobb felső sarkában található Szerkesztés gombot.
2. Frissítse a szerkeszthető mezőket.
3. A módosítások alkalmazásához kattintson a Mentés gombra.

Mintakód létrehozása modellhez

Hozzon létre egy kezdőkódfájlt az üzembe helyezett modellhez az alkalmazásfejlesztés felgyorsítása érdekében.

1. Kattintson a jobb gombbal az üzembe helyezett modellre, és válassza a Kódfájl megnyitása lehetőséget.

2. Válassza ki az előnyben részesített SDK-t az Előnyben részesített SDK kiválasztása legördülő listában.

3. Válassza ki az előnyben részesített nyelvet a Nyelv kiválasztása legördülő listában.

4. Válassza ki az előnyben részesített hitelesítési módszert a Hitelesítési módszer kiválasztása legördülő menüben.

5. Megnyílik egy mintakódfájl egy új lapon a VS Code-ban.

Az alábbi képernyőképen egy létrehozott Python minta látható, amely szinkron hívást indít a válasz API-ra:

Modellekkel való interakció a játszótéren

A modell játszóterével interaktívan cseveghet az üzembe helyezett modellel, módosíthatja a beállításokat és módosíthatja a rendszer utasításait.

A játszótér megnyitásához kattintson duplán a Modell játszótér hivatkozásra a Developer Tools Visual Studio Code bővítménynézet Microsoft Foundry Toolkit szakaszában. Másik lehetőségként kattintson a jobb gombbal az üzembe helyezett modellre, és válassza a Megnyitás a játszótéren lehetőséget.

1. Megnyílik a Játszótér lap.

2. Írja be a parancssort, és tekintse át a kimenetet.

3. A jobb felső sarokban válassza a Kód megtekintése lehetőséget a modell üzembe helyezésének programozott módon való eléréséhez.

4. A játszótér bal felső sarkában található Előzmények hivatkozásra kattintva megtekintheti a csevegési előzményeket.

Gyakori problémák elhárítása

Ha problémákba ütközik a Microsoft Foundry Toolkit Visual Studio Code bővítményhez való használata során, ellenőrizze az alábbi gyakori problémákat:

Kérdés	Felbontás
A bővítmény nem jelenik meg a telepítés után	Indítsa újra a VS Code-ot, és ellenőrizze, hogy a bővítmény engedélyezve van-e a Bővítmények nézetben.
A bejelentkezés sikertelen, vagy az előfizetések nem töltődnek be	Ellenőrizze, hogy a Azure fiókja rendelkezik-e a megfelelő engedélyekkel. Próbáljon meg kijelentkezni, és jelentkezzen be újra a Azure Erőforrások nézetből.
A modell üzembe helyezése kvótahiba miatt meghiúsul	Ellenőrizze az előfizetési kvótát , és kérje a nem használt üzemelő példányok növelését vagy törlését.

Erőforrások törlése

A cikkben létrehozott Azure erőforrások számlázása a Azure-előfizetésbe kerül. Ha a jövőben nem lesz szüksége ezekre az erőforrásokra, törölje őket, hogy elkerülje a további költségek felmerülését.

Modellek törlése

1. A VS Code navigációs sávjában frissítse a Microsoft Foundry Toolkit for Visual Studio Code bővítményt. A Saját erőforrások szakaszban bontsa ki a Modellek alszakaszt.

2. Kattintson a jobb gombbal az eltávolítani kívánt üzembe helyezett modellre, és válassza a Törlés lehetőséget.

Azure-erőforrások törlése

Az erőforráscsoport és a benne lévő összes erőforrás törléséhez:

Figyelmeztetés

Az erőforráscsoport törlése véglegesen eltávolítja az összes erőforrást, beleértve a Foundry-projektet és az üzembe helyezett modelleket is. Ez a művelet nem vonható vissza.

1. Nyissa meg a Azure portált.
2. Lépjen a Foundry-projektet tartalmazó erőforráscsoportra.
3. Válassza az Erőforráscsoport törlése lehetőséget, és erősítse meg a törlést.

Következő lépések

• Fedezze fel a Foundry modelleket
• Modellek üzembe helyezése a Foundryvel