Oktatóanyag: 1. rész – Erőforrások létrehozása egyéni csevegőalkalmazás létrehozásához a prompt flow SDK használatával

Ebben az oktatóanyagban a prompt flow SDK-val (és más kódtárakval) hozhat létre, konfigurálhat, értékelhet és helyezhet üzembe egy csevegőalkalmazást a Contoso Trek nevű kiskereskedelmi vállalat számára. A kereskedelmi cég specializálódott kültéri kemping felszerelés és ruházat. A csevegőalkalmazásnak válaszolnia kell a termékekre és szolgáltatásokra vonatkozó kérdésekre. A csevegőalkalmazás például megválaszolhat olyan kérdéseket, mint a "melyik sátor a leghidegebb?", vagy "mi a legjobb hálózsák a hideg időjáráshoz?".

Ez az oktatóanyag egy háromrészes oktatóanyag első része. Ez az első rész bemutatja, hogyan hozza létre és konfigurálja egy Azure-előfizetés rendszergazdája az oktatóanyag-sorozat második és harmadik részében szükséges erőforrásokat. A második és a harmadik rész bemutatja, hogyan használja a fejlesztő az erőforrásokat. Számos szervezetben ugyanez a személy mindkét szerepkört átveheti. Ebben az első részben megtanulhatja, hogyan:

• Azure AI Studio-központ létrehozása
• Projekt létrehozása
• Azure AI Search-index létrehozása
• Az Azure AI Studio és az Azure AI Search erőforrásaihoz való hozzáférés konfigurálása

Ha végzett más oktatóanyagokkal vagy rövid útmutatókkal, előfordulhat, hogy már létrehozott néhány erőforrást az oktatóanyaghoz. Ha van, nyugodtan hagyja ki ezeket a lépéseket itt.

Ez az oktatóanyag egy háromrészes oktatóanyag első része.

Előfeltételek

• Egy Azure-fiók, aktív előfizetéssel. Ha nem rendelkezik ilyen fiókkal, hozzon létre ingyenes fiókot.

Fontos

Rendelkeznie kell a szerepkör-hozzárendelések Azure-előfizetésben való hozzáadásához szükséges engedélyekkel. Az engedélyek szerepkör-hozzárendelés alapján történő megadását csak az adott Azure-erőforrások tulajdonosa engedélyezi. Előfordulhat, hogy meg kell kérnie az Azure-előfizetés tulajdonosát (aki lehet az informatikai rendszergazdája), hogy végezze el önnek ezt az oktatóanyagot.

Az Azure AI Studio és az Azure Portal

Ebben az oktatóanyagban Azure-erőforrásokat használ a csevegőalkalmazás létrehozásához. Ezeket az erőforrásokat az Azure AI Studio és az Azure Portal használatával is létrehozhatja és konfigurálhatja.

• Rendszergazdaként az Azure Portallal konfigurálhatja az erőforrásokhoz való hozzáférést.
• Fejlesztőként az Azure AI Studióval csoportosíthatja a csevegőalkalmazás létrehozásához, kiértékeléséhez és üzembe helyezéséhez szükséges erőforrásokat. A modelleket és az üzembe helyezéseket az AI Studióban is használhatja.

Azure AI Studio-központ létrehozása

Feljegyzés

Az Azure AI Studióban található központ egy egyablakos üzlet, ahol kezelheti az AI-projekthez szükséges összes igényt, például a biztonságot és az erőforrásokat, így gyorsabban fejleszthet és tesztelhet. Ha többet szeretne megtudni arról, hogy a központok hogyan segíthetnek Önnek, tekintse meg a Hubs és a projektek áttekintési cikkét.

Ha hubot szeretne létrehozni az Azure AI Studióban, kövesse az alábbi lépéseket:

1. Nyissa meg az Azure AI Studio kezdőlapját, és jelentkezzen be az Azure-fiókjával.

2. Válassza az Összes erőforrás lehetőséget a bal oldali panelen. Ha nem látja ezt a lehetőséget, a felső sávon válassza a Minden erőforrás > projekt lehetőséget. Ezután válassza az + Új központ lehetőséget.

   

3. Az Új központ létrehozása párbeszédpanelen adja meg a központ nevét (például contoso-hub). Ha nincs erőforráscsoportja, a rendszer létrehoz egy új erőforráscsoportot a megadott előfizetéshez csatolva. Hagyja bejelölve az Alapértelmezett Azure AI-szolgáltatások csatlakoztatása beállítást.

4. Válassza a Tovább lehetőséget. Ha nem újrafelhasznált egy meglévő erőforráscsoportot, létrejön egy új erőforráscsoport (rg-contoso). Emellett létrejön egy Azure AI-szolgáltatás (ai-contoso-hub) is a központhoz.

   

   Feljegyzés

   Ha nem jelenik meg (új) az erőforráscsoport előtt, és az Azure AI Services-bejegyzések összekapcsolása, akkor a rendszer egy meglévő erőforrást használ. Az oktatóanyag alkalmazásában hozzon létre egy külön entitást új erőforráscsoport létrehozásával és új AI-szolgáltatások létrehozásával. Ez lehetővé teszi, hogy megakadályozza a váratlan díjakat, ha törli az entitásokat az oktatóanyag után.

5. Tekintse át az információkat, és válassza a Létrehozás lehetőséget.

   

6. A varázslóban megtekintheti a központ létrehozásának folyamatát.

   

Projekt létrehozása

Ha projektet szeretne létrehozni az Azure AI Studióban, kövesse az alábbi lépéseket:

1. Nyissa meg az Azure AI Studio kezdőlapját.
2. Válassza az + Új projekt lehetőséget.
3. Adjon meg a projekt nevét.
4. Válassza ki az előző lépésben létrehozott központot.

A projekt létrehozása után a bal oldali navigációs panelen elérheti a játszóteret, az eszközöket és más eszközöket.

Azure AI Search-index létrehozása

Ezzel az alkalmazással az a cél, hogy a modellválaszokat az egyéni adatokban is felhasználja. A keresési index a releváns dokumentumok lekérésére szolgál a felhasználó kérdése alapján.

Keresési index létrehozásához Azure AI-Search szolgáltatás és kapcsolat szükséges.

Feljegyzés

Az Azure AI-Search szolgáltatás és az azt követő keresési indexek létrehozása költségekkel jár. Az Azure AI-Search szolgáltatás díjszabásával és tarifacsomagjaival kapcsolatos részleteket a létrehozási oldalon tekintheti meg, hogy megerősítse a költségeket az erőforrás létrehozása előtt.

Azure AI-Search szolgáltatás létrehozása

Ha már rendelkezik Azure AI-Search szolgáltatás, ugorjon a következő szakaszra.

Ellenkező esetben létrehozhat egy Azure AI-Search szolgáltatás az Azure Portalon.

1. Azure AI-Search szolgáltatás létrehozása az Azure Portalon.
2. Válassza ki az erőforráscsoport és a példány adatait. A díjszabási és tarifacsomagokkal kapcsolatos részleteket ezen az oldalon tekintheti meg.
3. Folytassa a varázslót, és válassza a Véleményezés + hozzárendelés lehetőséget az erőforrás létrehozásához.
4. Ellenőrizze az Azure AI-Search szolgáltatás részleteit, beleértve a becsült költséget is.
5. Válassza a Létrehozás lehetőséget az Azure AI-Search szolgáltatás létrehozásához.

Az Azure AI Search csatlakoztatása a projekthez

Ha már rendelkezik Azure AI Search-kapcsolattal a projektben, kihagyhatja az Azure AI-Search szolgáltatás hozzáférésének konfigurálását.

Az Azure AI Studióban keressen egy Azure AI Searchhez csatlakoztatott erőforrást.

1. Az AI Studióban nyissa meg a projektet, és válassza a Beállítások lehetőséget a bal oldali panelen.
2. A Csatlakoztatott erőforrások szakaszban ellenőrizze, hogy rendelkezik-e Azure AI Search típusú kapcsolattal.
3. Ha Azure AI Search-kapcsolattal rendelkezik, továbbléphet az erőforrásokhoz való hozzáférés konfigurálásához.
4. Ellenkező esetben válassza az Új kapcsolat , majd az Azure AI Search lehetőséget.
5. Keresse meg az Azure AI-Search szolgáltatás a beállítások között, és válassza a Kapcsolat hozzáadása lehetőséget.
6. A kapcsolat létrehozásához folytassa a varázslóval. A kapcsolatok hozzáadásával kapcsolatos további információkért tekintse meg ezt az útmutatót.

Erőforrásokhoz való hozzáférés konfigurálása

Ez a szakasz bemutatja, hogyan konfigurálhatja az előző szakaszokban létrehozott erőforrásokhoz szükséges különböző hozzáférési vezérlőket.

Az API-kulcsok használata helyett a Microsoft Entra ID használatát javasoljuk. A hitelesítés használatához be kell állítania a megfelelő hozzáférés-vezérlőket, és hozzá kell rendelnie a megfelelő szerepköröket a szolgáltatásokhoz.

Hozzáférés konfigurálása az Azure AI-szolgáltatásokhoz

Kezdje a projekttel az AI-szolgáltatások erőforrásának megkereséséhez:

1. Az AI Studióban nyissa meg a projektet, és válassza a Beállítások lehetőséget a bal oldali panelen.
2. Válassza a Csatlakoztatott erőforrások lehetőséget.
3. Válassza ki az AI-szolgáltatások vagy az Azure OpenAI nevét a csatlakoztatott erőforrások listájában az erőforrás részletei lap megnyitásához. Ezután válassza ki ismét az erőforrás nevét a Kapcsolat részletei lapon, amely megnyitja az erőforrást az Azure Portalon.

Adja meg a hozzáférés-vezérlést az Azure Portalon:

1. Az Azure Portal bal oldalán válassza a Hozzáférés-vezérlés (IAM)>+ Szerepkör-hozzárendelés hozzáadása>lehetőséget.
2. Keresse meg a Cognitive Services OpenAI-felhasználó szerepkört, majd válassza ki. Ezután válassza a Tovább gombra.
3. Válassza a Felhasználó, csoport vagy szolgáltatásnév lehetőséget. Ezután válassza a Tagok kijelölése lehetőséget.
4. A megnyíló Tagok kijelölése panelen keresse meg annak a felhasználónak a nevét, akihez hozzá szeretné adni a szerepkör-hozzárendelést. Jelölje ki a felhasználót, majd válassza a Kiválasztás lehetőséget.
5. Folytassa a varázslót, és válassza a Véleményezés + hozzárendelés lehetőséget a szerepkör-hozzárendelés hozzáadásához.

Hozzáférés konfigurálása az Azure AI Search szolgáltatáshoz

Most térjen vissza az AI Studio Beállításaihoz>csatlakoztatott erőforrásokhoz. Ezúttal válassza ki az Azure AI Search nevét a csatlakoztatott erőforrások listájában az erőforrás részletei lap megnyitásához. Ezután válassza ki ismét az erőforrás nevét a Kapcsolat részletei lapon, amely megnyitja az erőforrást az Azure Portalon.

Az Azure AI-Search szolgáltatás szerepköralapú hozzáférés-vezérlésének engedélyezéséhez kövesse az alábbi lépéseket:

1. Az Azure AI-Search szolgáltatás az Azure Portalon válassza a beállításokat > a bal oldali panelen.

2. A Mindkettő lehetőséget választva biztosíthatja, hogy az API-kulcsok és a szerepköralapú hozzáférés-vezérlés egyaránt engedélyezve legyen az Azure AI-Search szolgáltatás.

   

Figyelmeztetés

A szerepköralapú hozzáférés-vezérlést helyileg is használhatja, mert az oktatóanyag-sorozat későbbi részében fut az login . Ha azonban az alkalmazást az oktatóanyag 3. részében helyezi üzembe, az üzembe helyezést az Azure AI-Search szolgáltatás API-kulcsaival hitelesíti a rendszer. Hamarosan elérhető az üzembe helyezés Microsoft Entra ID-hitelesítésének támogatása. Egyelőre engedélyeznie kell a kulcsokat és a végpontokat is.

Ezután adja meg a felhasználói identitást (vagy annak a fejlesztőnek az identitását, aki elvégzi a második és a harmadik részt) az Azure AI-Search szolgáltatás keresési index adat-közreműködői és keresési szolgáltatás közreműködői szerepköreinek. Ezek a szerepkörök lehetővé teszik az Azure AI meghívását a társított felhasználói identitás Search szolgáltatás.

Továbbra is az Azure Portalon az Azure AI-Search szolgáltatás, rendelje hozzá a keresési index adatszolgáltatói szerepkörét az Azure AI-Search szolgáltatás. (Ezek ugyanazok a lépések, amelyeket korábban az Azure OpenAI szolgáltatás esetében tett.)

1. Az Azure Portal bal oldalán válassza a Hozzáférés-vezérlés (IAM)>+ Szerepkör-hozzárendelés hozzáadása>lehetőséget.
2. Keresse meg a keresési index adatszolgáltatói szerepkörét, majd válassza ki. Ezután válassza a Tovább gombra.
3. Válassza a Felhasználó, csoport vagy szolgáltatásnév lehetőséget. Ezután válassza a Tagok kijelölése lehetőséget.
4. A megnyíló Tagok kijelölése panelen keresse meg annak a felhasználónak a nevét, akihez hozzá szeretné adni a szerepkör-hozzárendelést. Jelölje ki a felhasználót, majd válassza a Kiválasztás lehetőséget.
5. Folytassa a varázslót, és válassza a Véleményezés + hozzárendelés lehetőséget a szerepkör-hozzárendelés hozzáadásához.

Ismételje meg ezeket a lépéseket, és adja hozzá a keresési szolgáltatás közreműködői szerepkörét az Azure AI-Search szolgáltatás.

Most már készen áll arra, hogy átadja a projektet egy fejlesztőnek a csevegőalkalmazás létrehozásához. A fejlesztő a parancssori folyamat SDK-val hozza létre, konfigurálja, kiértékeli és üzembe helyezi a Contoso Trek nevű kereskedelmi vállalat csevegőalkalmazását.

Az erőforrások eltávolítása

A szükségtelen Azure-költségek elkerülése érdekében törölnie kell az oktatóanyagban létrehozott erőforrásokat, ha már nincs rájuk szükség. Az erőforrások kezeléséhez használhatja az Azure Portalt.

De még ne törölje őket, ha csevegőalkalmazást szeretne létrehozni az oktatóanyag-sorozat következő részében.

Következő lépés

2. rész: Egyéni csevegőalkalmazás létrehozása a prompt flow SDK használatával