Rövid útmutató: Cognitive Services-erőforrás létrehozása az Azure Portal használatával

  • Cikk
  • 6 perc alatt elolvasható

Ezzel a rövid útmutatóval létrehozhat egy Cognitive Services-erőforrást. Miután létrehozott egy Cognitive Service-erőforrást az Azure Portalon, kap egy végpontot és egy kulcsot az alkalmazások hitelesítéséhez.

Az Azure Cognitive Services REST API-kat és ügyfélkódtári SDK-kat tartalmazó felhőalapú szolgáltatások, amelyek segítségével a fejlesztők közvetlen mesterséges intelligencia (AI) vagy adatelemzési készségek vagy ismeretek nélkül építhetnek be kognitív intelligenciát az alkalmazásokba. Az Azure Cognitive Services lehetővé teszi a fejlesztők számára, hogy könnyen hozzáadjanak kognitív funkciókat alkalmazásaikhoz olyan kognitív megoldásokkal, amelyek láthatják, hallhatják, beszélhetnek, megérthetik és akár okokat is kezdhetnek.

A Cognitive Services-erőforrástípusok

Az Azure Cognitive Services két különböző erőforráson keresztül érhető el: egy többszolgáltatásos vagy egyszolgáltatásos erőforráson keresztül.

  • Többszolgáltatásos erőforrás:
    • Több Azure Cognitive Services elérése egyetlen kulccsal és végponttal.
    • A használt szolgáltatások számlázásának összesítése.
  • Egyszolgáltatásos erőforrás:
    • Egyetlen Azure Cognitive Service-szolgáltatás elérése minden létrehozott szolgáltatáshoz egy egyedi kulccsal és végponttal.
    • A szolgáltatás kipróbálásához használja az ingyenes szintet.

Előfeltételek

  • Érvényes Azure-előfizetés – Hozzon létre egyet ingyen.
  • Az Azure-fiókján rendelkeznie kell egy hozzárendelt Cognitive Services-közreműködői szerepkörrel, hogy elfogadhassa a felelősségteljes MI-használatra vonatkozó feltételeket, és létrehozhasson egy erőforrást. Ha hozzá szeretné rendelni ezt a szerepkört a fiókjához, kövesse a Szerepkörök hozzárendelése dokumentáció lépéseit, vagy forduljon a rendszergazdához.

Új Azure Cognitive Services-erőforrás létrehozása

A többszolgáltatásos erőforrás neve Cognitive Services a portálon. A többszolgáltatásos erőforrás a következő Cognitive Services-szolgáltatásokhoz biztosít hozzáférést:

  • Decision – Content Moderator
  • Language – Language, Translator
  • Speech – Speech
  • Vision – Computer Vision, Custom Vision, Face

  1. Ezt a hivatkozást választva létrehozhat egy Többszolgáltatású Azure Cognitive Services-erőforrást: Cognitive Services-erőforrás létrehozása.

  2. A Létrehozás lapon adja meg a következő információkat:

    Projekt részletei Leírás
    Előfizetés Válassza ki az elérhető Azure-előfizetések egyikét.
    Erőforráscsoport A Cognitive Services-erőforrást tartalmazó Azure-erőforráscsoport. Létrehozhat egy új csoportot, vagy hozzáadhatja egy már meglévő csoporthoz.
    Régió A Cognitive Service-példány helye. A különböző helyek késést okozhatnak, de nincs hatással az erőforrás futásidejű rendelkezésre állására.
    Név A Cognitive Services-erőforrás leíró neve. Például : MyCognitiveServicesResource.
    Tarifacsomag A Cognitive Services-fiók költsége a választott lehetőségektől és a használattól függ. További információkért tekintse meg az API díjszabási részleteit.

    Multi-service resource creation screen

  3. Szükség szerint konfigurálja az erőforrás további beállításait, olvassa el és fogadja el a feltételeket (adott esetben), majd válassza a Felülvizsgálat + létrehozás lehetőséget.

Tipp

Ha előfizetése nem teszi lehetővé Cognitive Service-erőforrás létrehozását, előfordulhat, hogy engedélyeznie kell az Azure-erőforrás-szolgáltató ezt a képességét az Azure Portal, a PowerShell-parancs vagy egy Azure CLI-paranccsal. Ha nem Ön az előfizetés tulajdonosa, kérje meg az előfizetés tulajdonosát vagy egy rendszergazdai szerepkörrel rendelkező felhasználót, hogy végezze el a regisztrációt Ön helyett, vagy kérje meg a fiókja számára biztosított /register/action jogosultságokat.

Az erőforrás kulcsainak lekérése

  1. Az erőforrás sikeres üzembe helyezése után válassza a Következő lépések>ugrás az erőforrásra lehetőséget.

    Get resource keys screen

  2. A megnyíló gyorsútmutató panelen elérheti az erőforrásvégpontot, és kezelheti a kulcsokat.

Környezeti változó konfigurálása hitelesítéshez

Az alkalmazásoknak hitelesíteniük kell az általuk használt Cognitive Services-hozzáféréseket. A hitelesítéshez javasoljuk, hogy hozzon létre egy környezeti változót az Azure-erőforrások kulcsainak tárolásához.

Miután megvan a kulcs, írja be egy új környezeti változóba az alkalmazást futtató helyi gépen. A környezeti változó megadásához nyisson meg egy konzolablakot, és kövesse az operációs rendszerének megfelelő utasításokat. Cserélje le your-key az erőforrás egyik kulcsára.

setx COGNITIVE_SERVICE_KEY "your-key"

Miután hozzáadta a környezeti változót, előfordulhat, hogy újra kell indítania minden futó programot, amelynek szüksége lehet a környezeti változó beolvasására, beleértve a konzolablakot is. Ha például a Visual Studiót használja szerkesztőként, indítsa újra a Visual Studiót a példa futtatása előtt.

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

Ha törölni és eltávolítani szeretne egy Cognitive Services-előfizetést, törölheti az erőforrást vagy az erőforráscsoportot. Az erőforráscsoport törlése a csoport többi erőforrását is törli.

  1. Az Azure Portalon bontsa ki a bal oldalon a szolgáltatásmenüt, és válassza az Erőforráscsoportok lehetőséget az erőforráscsoportok listájának megjelenítéséhez.
  2. Keresse meg a törölni kívánt erőforrást tartalmazó erőforráscsoportot.
  3. Ha a teljes erőforráscsoportot törölni szeretné, válassza ki az erőforráscsoport nevét. A következő lapon válassza az Erőforráscsoport törlése lehetőséget, és erősítse meg a műveletet.
  4. Ha csak a Cognitive Service-erőforrást szeretné törölni, jelölje ki az erőforráscsoportot a benne lévő összes erőforrás megtekintéséhez. A következő lapon válassza ki a törölni kívánt erőforrást, kattintson a sor három pont menüjére, és válassza a Törlés lehetőséget.

Ha egy törölt erőforrást kell helyreállítania, olvassa el a Törölt Cognitive Services-erőforrások helyreállítása című témakört.

Lásd még