Rövid útmutató: Többszolgáltatásos erőforrás létrehozása az Azure AI-szolgáltatásokhoz

  • Cikk

Megtudhatja, hogyan hozhat létre és kezelhet többszolgáltatásos erőforrást az Azure AI-szolgáltatásokhoz. A többszolgáltatásos erőforrás lehetővé teszi több Azure AI-szolgáltatás elérését egyetlen kulccsal és végponttal. Emellett konszolidálja a számlázást a használt szolgáltatásokból.

Az Azure AI-szolgáltatásokat két különböző erőforráson keresztül érheti 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 AI-szolgáltatás elérése egyetlen kulccsal és végponttal.
    • Összesíti a számlázást a használt szolgáltatásokból.
  • Egyszolgáltatásos erőforrás:
    • Egyetlen Azure AI-szolgáltatás elérése egyedi kulccsal és végponttal minden létrehozott szolgáltatáshoz.
    • A legtöbb Azure AI-szolgáltatás ingyenes szintet kínál a kipróbálásához.

Az Azure AI-szolgáltatások olyan Azure-erőforrások, amelyeket az Azure-előfizetése alatt hoz létre. Miután létrehozott egy erőforrást, a létrehozott kulcsokkal és végpontokkal hitelesítheti az alkalmazásokat.

Támogatott szolgáltatások többszolgáltatásos erőforrással

A többszolgáltatásos erőforrás egyetlen kulccsal és végponttal teszi lehetővé az alábbi Azure AI-szolgáltatások elérését. Ezekkel a hivatkozásokkal rövid útmutató cikkeket, mintákat és egyebeket találhat az erőforrás használatának megkezdéséhez.

Szolgáltatás Leírás
Content Moderator iconContent Moderator (kivezetve) Potenciálisan sértő vagy kéretlen tartalmakat azonosíthat.
Custom Vision ikonCustom Vision Testre szabhatja a vállalat képfelismerését.
Dokumentumintelligencia ikonDokumentumintelligencia Dokumentumok átalakítása intelligens, adatvezérelt megoldásokká.
Arc ikonFace Észlelheti és azonosíthatja a képeken szereplő embereket és érzelmeket.
Nyelv ikonNyelv Alkalmazások készítése iparágvezető természetes nyelvfelismerési képességekkel.
Beszéd ikonBeszédfelismerés Beszéd a szöveghez, szövegről beszédre, fordítás és beszélőfelismerés.
Translator ikonFordító Az AI-alapú fordítási technológia segítségével több mint 100 használaton belüli, veszélyeztetett és veszélyeztetett nyelvet és dialektust fordíthat le.
Vision iconLátás Képek és videók tartalmainak elemzése.

Előfeltételek

  • Érvényes Azure-előfizetés – Hozzon létre egyet ingyenesen.
  • Az Azure-fióknak rendelkeznie kell egy Cognitive Services Contributor szerepkörrel ahhoz, hogy elfogadja a felelős AI-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 többszolgáltatásos erőforrás létrehozása

A többszolgáltatásos erőforrás az Azure AI-szolgáltatások>Azure AI-szolgáltatások többszolgáltatásos fiókjában található a portálon. Többszolgáltatásos erőforrás létrehozásához kövesse az alábbi utasításokat:

  1. Ezt a hivatkozást választva többszolgáltatásos erőforrást hozhat létre: https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne

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

    Projekt részletei Leírás
    Előfizetés Válasszon egyet az elérhető Azure-előfizetései közül.
    Erőforráscsoport Az Azure AI-szolgáltatási erőforrást tartalmazó Azure-erőforráscsoport. Létrehozhat egy új csoportot, vagy hozzáadhatja egy már meglévő csoporthoz.
    Régió Az Azure AI-szolgáltatáspé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 Az Azure AI-szolgáltatások erőforrásának leíró neve. Például: MyCognitiveServicesResource.
    Tarifacsomag Az Azure AI-szolgáltatásfió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ásának részleteit.

    Többszolgáltatásos erőforrás-létrehozási képernyő

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

Tipp.

Ha az előfizetése nem teszi lehetővé az Azure AI-szolgáltatások erőforrásának létrehozását, előfordulhat, hogy engedélyeznie kell az Azure-erőforrás-szolgáltató jogosultságát az Azure Portal, a PowerShell vagy egy Azure CLI-parancs használatával. Ha nem Ön az előfizetés tulajdonosa, kérje meg a tulajdonost vagy egy rendszergazdai jogosultsággal rendelkező személyt a regisztráció elvégzésére, vagy igényeljen a regisztrálási/műveleti jogosultságokat a fiókjához.

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.

    Erőforráskulcsok lekérése képernyő

  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ásnak hitelesítenie kell az Azure AI-szolgáltatások erőforrásainak eléréséhez. Az erőforráskulcs környezeti változójának beállításához nyisson meg egy konzolablakot, és kövesse az operációs rendszer és a fejlesztési környezet utasításait. A COGNITIVE_SERVICE_KEY környezeti változó beállításához cserélje le your-key az erőforrás egyik kulcsára.

Éles környezetben használja a hitelesítő adatok biztonságos tárolásának és elérésének biztonságos módját, például egy jelszóval védett titkos tárolót. A teszteléshez a környezeti változók írása általános gyakorlat, de ne feledje, hogy a környezeti változók a helyi gépen világos szövegben vannak tárolva.

Tipp.

Ne vegye fel közvetlenül a kulcsot a kódba, és soha ne tegye közzé nyilvánosan. Az Azure AI-szolgáltatások biztonsági cikkében további hitelesítési lehetőségeket talál, például az Azure Key Vaultot.

A PowerShell tartalmaz egy bővíthető megoldást, a Secret Managementet, amely biztonságos sztringeket tárol olyan platformokon, mint a Secret Store vagy az Azure KeyVault.

Ha biztonságos sztringek tárolására szeretne titkos tárat beállítani, olvassa el a Titkos tár használatának első lépései című cikket. Ezután használja az alábbi példákat az API-kulcsok tárolásához.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

Tesztkörnyezetek esetén a PowerShell szintaxisával $Env: beállíthatja, hogy csak az aktuális munkamenethez állítson be környezeti változót, vagy a setx parancs segítségével megtartsa a változót a munkamenetek között. Ne feledje, hogy ezek az értékek világos szövegben vannak tárolva a Windows beállításkulcsaiban.

$Env:COGNITIVE_SERVICE_KEY = your-key

setx COGNITIVE_SERVICE_KEY your-key

Miután hozzáadta a környezeti változót, setxelőfordulhat, hogy újra kell indítania a futó konzolokat vagy más programokat, amelyeknek be kell olvasniuk a környezeti változót. 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.

A Speech erőforrásrégió környezeti változójának beállításához kövesse az alábbi lépéseket. Állítsa be COGNITIVE_SERVICE_REGION az erőforrás régióját. Például: westus.

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

Ha törölni és eltávolítani szeretne egy Azure AI-szolgáltatási 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 törölni szeretné a teljes erőforráscsoportot, 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.
  4. Ha csak az Azure AI-szolgáltatások erőforrását szeretné törölni, válassza 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, válassza a sor három pont menüjét, majd válassza a Törlés lehetőséget.

Ezzel a rövid útmutatóval Azure AI-szolgáltatási erőforrást hozhat létre az Azure Parancssori felület (CLI) parancsaival. Az erőforrás létrehozása után használja a létrehozott kulcsokat és végpontokat az alkalmazások hitelesítéséhez.

Az Azure AI-szolgáltatások felhőalapú mesterségesintelligencia-szolgáltatások, amelyek segítenek a fejlesztőknek a kognitív intelligenciát alkalmazásokba építeni anélkül, hogy közvetlen AI- vagy adatelemzési ismeretekkel vagy ismeretekkel kellene rendelkezniük. A rest API-k és az ügyféloldali kódtár SDK-k segítségével népszerű fejlesztési nyelveken érhetők el. Az Azure AI-szolgáltatások lehetővé teszik a fejlesztők számára, hogy könnyen hozzáadjanak kognitív funkciókat alkalmazásaikhoz olyan kognitív megoldásokkal, amelyek képesek látni, hallani, beszélni és elemezni.

Előfeltételek

  • Érvényes Azure-előfizetés – Hozzon létre egyet ingyenesen.
  • Az Azure CLI
  • Az Azure-fióknak rendelkeznie kell egy Cognitive Services Contributor szerepkörrel ahhoz, hogy elfogadja a felelős AI-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.
  • Ha az Azure AI Visionben vagy a Text Analytics for Healthben szeretné használni a térinformatikai elemzést az Azure AI-nyelven, akkor létre kell hoznia az első Vision- vagy Nyelvi erőforrásokat az Azure Portalról, hogy áttekinthesse és elismerhesse a használati feltételeket. Ezt itt teheti meg: Azure AI Language, Azure AI Vision. Ezt követően bármilyen üzembe helyezési eszközzel (például SDK, CLI vagy ARM-sablon) létrehozhat további erőforrásokat ugyanazon Azure-előfizetés alatt.

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

Telepítse az Azure CLI-t. A parancssori felület helyi telepítésébe való bejelentkezéshez futtassa az az login parancsot:

az login

A zöld Kipróbálás gombbal is futtathatja ezeket a parancsokat a böngészőben.

Új Azure AI-szolgáltatások erőforráscsoportjának létrehozása

Mielőtt létrehoz egy Azure AI-szolgáltatási erőforrást, rendelkeznie kell egy Azure-erőforráscsoporttel, amely tartalmazza az erőforrást. Új erőforrás létrehozásakor létrehozhat egy új erőforráscsoportot, vagy használhat egy meglévőt. Ez a cikk bemutatja, hogyan hozhat létre új erőforráscsoportot.

Az erőforráscsoport helyének kiválasztása

Erőforrás létrehozásához szüksége lesz az előfizetéséhez elérhető Azure-helyek egyikére. Az az account list-locations paranccsal lekérheti az elérhető helyek listáját. A legtöbb Azure AI-szolgáltatás több helyről is elérhető. Válassza ki az Önhöz legközelebbit, vagy nézze meg, hogy mely helyek érhetők el a szolgáltatáshoz.

Fontos

  • Az Azure AI-szolgáltatások erőforrásainak meghívásakor ne feledje az Azure-beli helyét, mivel szüksége lesz rá.
  • Egyes Azure AI-szolgáltatások elérhetősége régiónként eltérő lehet. További információ: Azure-termékek régiónként.
az account list-locations --query "[].{Region:name}" --out table

Az Azure-hely létrehozása után hozzon létre egy új erőforráscsoportot az Azure CLI-ben az az group create paranccsal. Az alábbi példában cserélje le az Azure-helyet westus2 az előfizetéséhez elérhető Azure-helyek egyikére.

az group create --name ai-services-resource-group --location westus2

Azure AI-szolgáltatási erőforrás létrehozása

Szolgáltatás- és tarifacsomag kiválasztása

Új erőforrás létrehozásakor ismernie kell a használni kívánt szolgáltatástípust, valamint a használni kívánt tarifacsomagot (vagy termékváltozatot). Az erőforrás létrehozásakor ezt és más információkat fogja paraméterként használni.

Az alábbi táblázatok az Azure AI-szolgáltatások termékeivel és díjszabásával kapcsolatos információkat tartalmaznak.

Többszolgáltatásos

Szolgáltatás Erőforrás
Több szolgáltatás. További tájékoztatás a díjszabási oldalon olvasható. CognitiveServices

Látás

Szolgáltatás Erőforrás
Látás ComputerVision
Custom Vision – Előrejelzés CustomVision.Prediction
Custom Vision – Oktatás CustomVision.Training
Face Face
Dokumentumintelligencia FormRecognizer

Beszédfelismerés

Szolgáltatás Erőforrás
Beszédfelismerés SpeechServices

Nyelv

Szolgáltatás Erőforrás
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Nyelv TextAnalytics
Szövegfordítás TextTranslation

Döntés

Szolgáltatás Erőforrás
Anomaly Detector AnomalyDetector
Content Moderator ContentModerator
Personalizer Personalizer

Azure OpenAI

Szolgáltatás Erőforrás
Azure OpenAI OpenAI

Tarifacsomagok és számlázás

A tarifacsomagok (és a számlázott összeg) a hitelesítési adatokkal küldött tranzakciók számán alapulnak. Minden tarifacsomag a következőt határozza meg:

  • A másodpercenként engedélyezett tranzakciók maximális száma (TPS).
  • A tarifacsomagon belül engedélyezett szolgáltatásfunkciók.
  • Előre meghatározott számú tranzakció költsége. Ha ezt a számot meghaladja, az a szolgáltatás díjszabási részleteiben megadott díjat számít fel.

Feljegyzés

Számos Azure AI-szolgáltatás rendelkezik ingyenes szinttel, amellyel kipróbálhatja a szolgáltatást. Az ingyenes szint használatához használja F0 az erőforrás tarifacsomagját.

Az elérhető Azure AI-szolgáltatások "típusainak" listáját az az cognitiveservices account list-kinds paranccsal találja:

az cognitiveservices account list-kinds

Új erőforrás hozzáadása az erőforráscsoporthoz

Új Azure AI-szolgáltatási erőforrás létrehozásához és előfizetéséhez használja az az cognitiveservices account create parancsot. Ez a parancs hozzáad egy új számlázható erőforrást a korábban létrehozott erőforráscsoporthoz. Az új erőforrás létrehozásakor ismernie kell a használni kívánt szolgáltatás "fajtáját", valamint a tarifacsomagot (vagy termékváltozatot) és egy Azure-helyet:

Az alábbi paranccsal létrehozhat egy Standard S0 többszolgáltatásos erőforrást multi-service-resource .

az cognitiveservices account create --name multi-service-resource --resource-group ai-services-resource-group  --kind CognitiveServices --sku F0 --location westus2 --yes

Tipp.

Ha az előfizetése nem teszi lehetővé az Azure AI-szolgáltatások erőforrásának létrehozását, előfordulhat, hogy engedélyeznie kell az Azure-erőforrás-szolgáltató jogosultságát az Azure Portal, a PowerShell vagy egy Azure CLI-parancs használatával. Ha nem Ön az előfizetés tulajdonosa, kérje meg a tulajdonost vagy egy rendszergazdai jogosultsággal rendelkező személyt a regisztráció elvégzésére, vagy igényeljen a regisztrálási/műveleti jogosultságokat a fiókjához.

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

A parancssori felület (CLI) helyi telepítésébe való bejelentkezéshez használja az az login parancsot.

az login

Az erőforrás kulcsainak lekéréséhez használja az az cognitiveservices-fiókkulcsok listaparancsát .

az cognitiveservices account keys list  --name multi-service-resource --resource-group ai-services-resource-group

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

Az alkalmazásnak hitelesítenie kell az Azure AI-szolgáltatások erőforrásainak eléréséhez. Az erőforráskulcs környezeti változójának beállításához nyisson meg egy konzolablakot, és kövesse az operációs rendszer és a fejlesztési környezet utasításait. A COGNITIVE_SERVICE_KEY környezeti változó beállításához cserélje le your-key az erőforrás egyik kulcsára.

Éles környezetben használja a hitelesítő adatok biztonságos tárolásának és elérésének biztonságos módját, például egy jelszóval védett titkos tárolót. A teszteléshez a környezeti változók írása általános gyakorlat, de ne feledje, hogy a környezeti változók a helyi gépen világos szövegben vannak tárolva.

Tipp.

Ne vegye fel közvetlenül a kulcsot a kódba, és soha ne tegye közzé nyilvánosan. Az Azure AI-szolgáltatások biztonsági cikkében további hitelesítési lehetőségeket talál, például az Azure Key Vaultot.

A PowerShell tartalmaz egy bővíthető megoldást, a Secret Managementet, amely biztonságos sztringeket tárol olyan platformokon, mint a Secret Store vagy az Azure KeyVault.

Ha biztonságos sztringek tárolására szeretne titkos tárat beállítani, olvassa el a Titkos tár használatának első lépései című cikket. Ezután használja az alábbi példákat az API-kulcsok tárolásához.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

Tesztkörnyezetek esetén a PowerShell szintaxisával $Env: beállíthatja, hogy csak az aktuális munkamenethez állítson be környezeti változót, vagy a setx parancs segítségével megtartsa a változót a munkamenetek között. Ne feledje, hogy ezek az értékek világos szövegben vannak tárolva a Windows beállításkulcsaiban.

$Env:COGNITIVE_SERVICE_KEY = your-key

setx COGNITIVE_SERVICE_KEY your-key

Miután hozzáadta a környezeti változót, setxelőfordulhat, hogy újra kell indítania a futó konzolokat vagy más programokat, amelyeknek be kell olvasniuk a környezeti változót. 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.

A Speech erőforrásrégió környezeti változójának beállításához kövesse az alábbi lépéseket. Állítsa be COGNITIVE_SERVICE_REGION az erőforrás régióját. Például: westus.

Tarifacsomagok és számlázás

A tarifacsomagok (és a számlázott összeg) a hitelesítési adatokkal küldött tranzakciók számán alapulnak. Minden tarifacsomag a következőt határozza meg:

  • az engedélyezett tranzakciók maximális száma másodpercenként (TPS).
  • a tarifacsomagon belül engedélyezett szolgáltatásfunkciók.
  • Előre meghatározott számú tranzakció költsége. Ha ezt az összeget meghaladja, az a szolgáltatás díjszabási részleteiben meghatározott többletköltséget okoz.

Az erőforrás aktuális kvótahasználatának lekérése

Az az cognitiveservices-fiók listahasználati parancsával lekérheti az erőforrás használati adatait.

az cognitiveservices account list-usage --name multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name

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

Ha törölni és eltávolítani szeretne egy Azure AI-szolgáltatási erőforrást, törölheti azt vagy az erőforráscsoportot. Az erőforráscsoport törlése a csoport többi erőforrását is törli.

Az erőforráscsoport és a hozzá tartozó erőforrások eltávolításához használja az az group delete parancsot.

az group delete --name ai-services-resource-group

Ezzel a rövid útmutatóval Azure AI-szolgáltatási erőforrást hozhat létre Azure PowerShell-parancsokkal . Az erőforrás létrehozása után használja a létrehozott kulcsokat és végpontokat az alkalmazások hitelesítéséhez.

Az Azure AI-szolgáltatások felhőalapú mesterségesintelligencia-szolgáltatások, amelyek segítenek a fejlesztőknek a kognitív intelligenciát alkalmazásokba építeni anélkül, hogy közvetlen AI- vagy adatelemzési ismeretekkel vagy ismeretekkel kellene rendelkezniük. A rest API-k és az ügyféloldali kódtár SDK-k segítségével népszerű fejlesztési nyelveken érhetők el. Az Azure AI-szolgáltatások lehetővé teszik a fejlesztők számára, hogy könnyen hozzáadjanak kognitív funkciókat alkalmazásaikhoz olyan kognitív megoldásokkal, amelyek képesek látni, hallani, beszélni és elemezni.

Előfeltételek

  • Érvényes Azure-előfizetés – Hozzon létre egyet ingyenesen.
  • Azure PowerShell
  • Az Azure-fióknak rendelkeznie kell egy Cognitive Services Contributor szerepkörrel ahhoz, hogy elfogadja a felelős AI-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.
  • Ha az Azure AI Visionben vagy a Text Analytics for Healthben szeretné használni a térinformatikai elemzést az Azure AI-nyelven, akkor létre kell hoznia az első Vision- vagy Nyelvi erőforrásokat az Azure Portalról, hogy áttekinthesse és elismerhesse a használati feltételeket. Ezt itt teheti meg: Azure AI Language, Azure AI Vision. Ezt követően bármilyen üzembe helyezési eszközzel (például SDK, CLI vagy ARM-sablon) létrehozhat további erőforrásokat ugyanazon Azure-előfizetés alatt.

Az Azure PowerShell telepítése és bejelentkezés

Telepítse az Azure PowerShellt. A bejelentkezéshez futtassa az Csatlakozás-AzAccount parancsot:

Connect-AzAccount

A zöld Kipróbálás gombbal is futtathatja ezeket a parancsokat a böngészőben.

Új Azure AI-szolgáltatások erőforráscsoportjának létrehozása

Mielőtt létrehoz egy Azure AI-szolgáltatási erőforrást, rendelkeznie kell egy Azure-erőforráscsoporttel, amely tartalmazza az erőforrást. Új erőforrás létrehozásakor létrehozhat egy új erőforráscsoportot, vagy használhat egy meglévőt. Ez a cikk bemutatja, hogyan hozhat létre új erőforráscsoportot.

Az erőforráscsoport helyének kiválasztása

Erőforrás létrehozásához szüksége lesz az előfizetéséhez elérhető Azure-helyek egyikére. A Get-AzLocation paranccsal lekérheti az elérhető helyek listáját. A legtöbb Azure AI-szolgáltatás több helyről is elérhető. Válassza ki az Önhöz legközelebbit, vagy nézze meg, hogy mely helyek érhetők el a szolgáltatáshoz.

Fontos

  • Az Azure AI-szolgáltatások erőforrásainak meghívásakor ne feledje az Azure-beli helyét, mivel szüksége lesz rá.
  • Egyes Azure AI-szolgáltatások elérhetősége régiónként eltérő lehet. További információ: Azure-termékek régiónként.
Get-AzLocation | Select-Object -Property Location, DisplayName

Az Azure-hely létrehozása után hozzon létre egy új erőforráscsoportot az Azure PowerShellben a New-AzResourceGroup paranccsal. Az alábbi példában cserélje le az Azure-helyet westus2 az előfizetéséhez elérhető Azure-helyek egyikére.

New-AzResourceGroup -Name ai-services-resource-group -Location westus2

Azure AI-szolgáltatási erőforrás létrehozása

Szolgáltatás- és tarifacsomag kiválasztása

Új erőforrás létrehozásakor ismernie kell a használni kívánt szolgáltatástípust, valamint a használni kívánt tarifacsomagot (vagy termékváltozatot). Az erőforrás létrehozásakor ezt és más információkat fogja paraméterként használni.

Az alábbi táblázatok az Azure AI-szolgáltatások termékeivel és díjszabásával kapcsolatos információkat tartalmaznak.

Többszolgáltatásos

Szolgáltatás Erőforrás
Több szolgáltatás. További tájékoztatás a díjszabási oldalon olvasható. CognitiveServices

Látás

Szolgáltatás Erőforrás
Látás ComputerVision
Custom Vision – Előrejelzés CustomVision.Prediction
Custom Vision – Oktatás CustomVision.Training
Face Face
Dokumentumintelligencia FormRecognizer

Beszédfelismerés

Szolgáltatás Erőforrás
Beszédfelismerés SpeechServices

Nyelv

Szolgáltatás Erőforrás
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Nyelv TextAnalytics
Szövegfordítás TextTranslation

Döntés

Szolgáltatás Erőforrás
Anomaly Detector AnomalyDetector
Content Moderator ContentModerator
Personalizer Personalizer

Azure OpenAI

Szolgáltatás Erőforrás
Azure OpenAI OpenAI

Tarifacsomagok és számlázás

A tarifacsomagok (és a számlázott összeg) a hitelesítési adatokkal küldött tranzakciók számán alapulnak. Minden tarifacsomag a következőt határozza meg:

  • A másodpercenként engedélyezett tranzakciók maximális száma (TPS).
  • A tarifacsomagon belül engedélyezett szolgáltatásfunkciók.
  • Előre meghatározott számú tranzakció költsége. Ha ezt a számot meghaladja, az a szolgáltatás díjszabási részleteiben megadott díjat számít fel.

Feljegyzés

Számos Azure AI-szolgáltatás rendelkezik ingyenes szinttel, amellyel kipróbálhatja a szolgáltatást. Az ingyenes szint használatához használja F0 az erőforrás tarifacsomagját.

A Get-AzCognitiveServicesAccountType paranccsal megtalálhatja az elérhető Azure AI-szolgáltatások "típusainak" listáját:

Get-AzCognitiveServicesAccountType

Új erőforrás hozzáadása az erőforráscsoporthoz

Új Azure AI-szolgáltatási erőforrás létrehozásához és előfizetéséhez használja a New-AzCognitiveServicesAccount parancsot. Ez a parancs hozzáad egy új számlázható erőforrást a korábban létrehozott erőforráscsoporthoz. Az új erőforrás létrehozásakor ismernie kell a használni kívánt szolgáltatás "fajtáját", valamint a tarifacsomagot (vagy termékváltozatot) és egy Azure-helyet:

Az alábbi paranccsal létrehozhat egy Standard S0 többszolgáltatásos erőforrást multi-service-resource .

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name multi-service-resource -Type CognitiveServices -SkuName F0 -Location westus2

Tipp.

Ha az előfizetése nem teszi lehetővé az Azure AI-szolgáltatások erőforrásának létrehozását, előfordulhat, hogy engedélyeznie kell az Adott Azure-erőforrás-szolgáltató jogosultságát az Azure Portal, egy Azure PowerShell-parancs vagy egy Azure CLI-parancs használatával. Ha nem Ön az előfizetés tulajdonosa, kérje meg a tulajdonost vagy egy rendszergazdai jogosultsággal rendelkező személyt a regisztráció elvégzésére, vagy igényeljen a regisztrálási/műveleti jogosultságokat a fiókjához.

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

Az erőforrás kulcsainak lekéréséhez használja a Get-AzCognitiveServicesAccountKey parancsot.

Get-AzCognitiveServicesAccountKey -Name multi-service-resource -ResourceGroupName ai-services-resource-group

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

Az alkalmazásnak hitelesítenie kell az Azure AI-szolgáltatások erőforrásainak eléréséhez. Az erőforráskulcs környezeti változójának beállításához nyisson meg egy konzolablakot, és kövesse az operációs rendszer és a fejlesztési környezet utasításait. A COGNITIVE_SERVICE_KEY környezeti változó beállításához cserélje le your-key az erőforrás egyik kulcsára.

Éles környezetben használja a hitelesítő adatok biztonságos tárolásának és elérésének biztonságos módját, például egy jelszóval védett titkos tárolót. A teszteléshez a környezeti változók írása általános gyakorlat, de ne feledje, hogy a környezeti változók a helyi gépen világos szövegben vannak tárolva.

Tipp.

Ne vegye fel közvetlenül a kulcsot a kódba, és soha ne tegye közzé nyilvánosan. Az Azure AI-szolgáltatások biztonsági cikkében további hitelesítési lehetőségeket talál, például az Azure Key Vaultot.

A PowerShell tartalmaz egy bővíthető megoldást, a Secret Managementet, amely biztonságos sztringeket tárol olyan platformokon, mint a Secret Store vagy az Azure KeyVault.

Ha biztonságos sztringek tárolására szeretne titkos tárat beállítani, olvassa el a Titkos tár használatának első lépései című cikket. Ezután használja az alábbi példákat az API-kulcsok tárolásához.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

Tesztkörnyezetek esetén a PowerShell szintaxisával $Env: beállíthatja, hogy csak az aktuális munkamenethez állítson be környezeti változót, vagy a setx parancs segítségével megtartsa a változót a munkamenetek között. Ne feledje, hogy ezek az értékek világos szövegben vannak tárolva a Windows beállításkulcsaiban.

$Env:COGNITIVE_SERVICE_KEY = your-key

setx COGNITIVE_SERVICE_KEY your-key

Miután hozzáadta a környezeti változót, setxelőfordulhat, hogy újra kell indítania a futó konzolokat vagy más programokat, amelyeknek be kell olvasniuk a környezeti változót. 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.

A Speech erőforrásrégió környezeti változójának beállításához kövesse az alábbi lépéseket. Állítsa be COGNITIVE_SERVICE_REGION az erőforrás régióját. Például: westus.

Tarifacsomagok és számlázás

A tarifacsomagok (és a számlázott összeg) a hitelesítési adatokkal küldött tranzakciók számán alapulnak. Minden tarifacsomag a következőt határozza meg:

  • az engedélyezett tranzakciók maximális száma másodpercenként (TPS).
  • a tarifacsomagon belül engedélyezett szolgáltatásfunkciók.
  • Előre meghatározott számú tranzakció költsége. Ha ezt az összeget meghaladja, az a szolgáltatás díjszabási részleteiben meghatározott többletköltséget okoz.

Az erőforrás aktuális kvótahasználatának lekérése

Az erőforrás használatának lekéréséhez használja a Get-AzCognitiveServicesAccountUsage parancsot.

Get-AzCognitiveServicesAccountUsage -ResourceGroupName ai-services-resource-group -Name multi-service-resource

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

Ha törölni és eltávolítani szeretne egy Azure AI-szolgáltatási erőforrást, törölheti azt vagy az erőforráscsoportot. Az erőforráscsoport törlése a csoport többi erőforrását is törli.

Az erőforráscsoport és a hozzá tartozó erőforrások eltávolításához használja a Remove-AzResourceGroup parancsot.

Remove-AzResourceGroup -Name ai-services-resource-group

Referenciadokumentáció Kódtár forráskódcsomagja | (NuGet) | -minták |

C# előfeltételek

  • Érvényes Azure-előfizetés – Hozzon létre egyet ingyenesen.
  • A .NET Core aktuális verziója.
  • Az Azure-fióknak rendelkeznie kell egy Cognitive Services Contributor szerepkörrel ahhoz, hogy elfogadja a felelős AI-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.
  • Ha az Azure AI Visionben vagy a Text Analytics for Healthben szeretné használni a térinformatikai elemzést az Azure AI-nyelven, akkor létre kell hoznia az első Vision- vagy Nyelvi erőforrásokat az Azure Portalról, hogy áttekinthesse és elismerhesse a használati feltételeket. Ezt itt teheti meg: Azure AI Language, Azure AI Vision. Ezt követően bármilyen üzembe helyezési eszközzel (például SDK, CLI vagy ARM-sablon) létrehozhat további erőforrásokat ugyanazon Azure-előfizetés alatt.

Azure-szolgáltatásnév létrehozása

Ahhoz, hogy az alkalmazás kommunikáljon az Azure-fiókjával, szüksége van egy Azure-szolgáltatásnévre az engedélyek kezeléséhez. Kövesse az Azure-szolgáltatásnév létrehozása című témakör utasításait.

Szolgáltatásnév létrehozásakor látni fogja, hogy titkos érték, azonosító és alkalmazásazonosító tartozik hozzá. Mentse az alkalmazásazonosítót és a titkos kulcsot egy ideiglenes helyre a későbbi lépésekhez.

Erőforráscsoport létrehozása

Mielőtt létrehoz egy Azure AI-szolgáltatási erőforrást, a fióknak rendelkeznie kell egy Azure-erőforráscsoporttel, amely tartalmazza az erőforrást. Ha még nincs erőforráscsoportja, a folytatás előtt hozzon létre egyet az Azure Portalon .

Új C#-alkalmazás létrehozása

Hozzon létre egy új .NET Core-alkalmazást. Egy konzolablakban (például parancsmag, PowerShell vagy Bash) a dotnet new paranccsal hozzon létre egy új konzolalkalmazást a névvel azure-management-quickstart. Ez a parancs létrehoz egy egyszerű ""Helló világ!" alkalmazás" C#-projektet egyetlen forrásfájllal: program.cs.

dotnet new console -n azure-management-quickstart

Módosítsa a könyvtárat az újonnan létrehozott alkalmazásmappára. Az alkalmazást a következőkkel hozhatja létre:

dotnet build

A buildkimenet nem tartalmazhat figyelmeztetést vagy hibát.

...
Build succeeded.
 0 Warning(s)
 0 Error(s)
...

Telepítse az ügyfélkódtárat

Az alkalmazáskönyvtárban telepítse a .NET-hez készült Azure Management ügyfélkódtárat a következő paranccsal:

dotnet add package Azure.ResourceManager.CognitiveServices
dotnet add package Microsoft.Azure.Management.Fluent
dotnet add package Microsoft.Azure.Management.ResourceManager.Fluent

Ha a Visual Studio IDE-t használja, az ügyfélkódtár letölthető NuGet-csomagként érhető el.

Kódtárak importálása

Nyissa meg program.cs , és adja hozzá a következő using utasításokat a fájl elejéhez:

using System;
using Microsoft.Azure.Management.Fluent;
using Microsoft.Azure.Management.ResourceManager.Fluent;
using Microsoft.Azure.Management.ResourceManager.Fluent.Authentication;
using Microsoft.Azure.Management.CognitiveServices;
using Microsoft.Azure.Management.CognitiveServices.Models;

Az ügyfél hitelesítése

Adja hozzá a következő mezőket a program.cs gyökeréhez, és töltse ki az értékeiket a létrehozott szolgáltatásnév és az Azure-fiók adatai alapján.

const string  service_principal_application_id = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
const string  service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
const string  subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
const string  tenant_id = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
const string  resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names. */
const string subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Ezután a Main metódusban ezeket az értékeket használva hozzon létre egy CognitiveServicesManagementClient objektumot. Ez az objektum az összes Azure felügyeleti művelethez szükséges.

var service_principal_credentials = new ServicePrincipalLoginInformation ();
service_principal_credentials.ClientId = service_principal_application_id;
service_principal_credentials.ClientSecret = service_principal_secret;

var credentials = SdkContext.AzureCredentialsFactory.FromServicePrincipal(service_principal_application_id, service_principal_secret, tenant_id, AzureEnvironment.AzureGlobalCloud);
var client = new CognitiveServicesManagementClient(credentials);
client.SubscriptionId = subscription_id;

Híváskezelési módszerek

Adja hozzá a következő kódot a Fő metódushoz az elérhető erőforrások listázásához, egy mintaerőforrás létrehozásához, a saját erőforrások listázásához, majd a mintaerőforrás törléséhez. Ezeket a metódusokat a következő lépésekben fogjuk meghatározni.

    // Uncomment to list all available resource kinds, SKUs, and locations for your Azure account:
    //list_available_kinds_skus_locations(client);

    // Create a resource with kind TextTranslation, F0 (free tier), location global.
    create_resource(client, "test_resource", "TextTranslation", "F0", "Global");

    // List all resources for your Azure account and resource group:
    list_resources(client);

    // Delete the resource.
    delete_resource(client, "test_resource");

    Console.WriteLine("Press any key to exit.");
    Console.ReadKey();

Azure AI-szolgáltatási erőforrás létrehozása (C#)

Új Azure AI-szolgáltatási erőforrás létrehozásához és előfizetéséhez használja a Létrehozás metódust. Ez a metódus egy új számlázható erőforrást ad hozzá a megadott erőforráscsoporthoz. Az új erőforrás létrehozásakor ismernie kell a használni kívánt szolgáltatás "fajtáját", valamint annak tarifacsomagját (vagy termékváltozatát) és egy Azure-helyet. Az alábbi módszer argumentumként veszi fel ezeket, és létrehoz egy erőforrást.

static void create_resource(CognitiveServicesManagementClient client, string resource_name, string kind, string account_tier, string location)
{
    Console.WriteLine("Creating resource: " + resource_name + "...");
    /* NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
    property from CognitiveServicesAccountProperties. */
    CognitiveServicesAccount parameters = 
        new CognitiveServicesAccount(null, null, kind, location, resource_name, new CognitiveServicesAccountProperties(customSubDomainName : subdomain_name), new Sku(account_tier));
    var result = client.Accounts.Create(resource_group_name, resource_name, parameters);
    Console.WriteLine("Resource created.");
    Console.WriteLine("ID: " + result.Id);
    Console.WriteLine("Kind: " + result.Kind);
    Console.WriteLine();
}

Szolgáltatás- és tarifacsomag kiválasztása

Új erőforrás létrehozásakor ismernie kell a használni kívánt szolgáltatás "fajtáját", valamint a használni kívánt tarifacsomagot (vagy termékváltozatot). Az erőforrás létrehozásakor ezt és más információkat fogja paraméterként használni. Az elérhető Azure AI-szolgáltatások "fajtáinak" listáját az alábbi metódus meghívásával találja meg a szkriptben:

static void list_available_kinds_skus_locations(CognitiveServicesManagementClient client)
{

    Console.WriteLine("Available SKUs:");
    var result = client.ResourceSkus.List();
    Console.WriteLine("Kind\tSKU Name\tSKU Tier\tLocations");
    foreach (var x in result) {
        var locations = "";
        foreach (var region in x.Locations)
        {
            locations += region;
        }
        Console.WriteLine(x.Kind + "\t" + x.Name + "\t" + x.Tier + "\t" + locations);
    };
}

Az alábbi táblázatok az Azure AI-szolgáltatások termékeivel és díjszabásával kapcsolatos információkat tartalmaznak.

Többszolgáltatásos

Szolgáltatás Erőforrás
Több szolgáltatás. További tájékoztatás a díjszabási oldalon olvasható. CognitiveServices

Látás

Szolgáltatás Erőforrás
Látás ComputerVision
Custom Vision – Előrejelzés CustomVision.Prediction
Custom Vision – Oktatás CustomVision.Training
Face Face
Dokumentumintelligencia FormRecognizer

Beszédfelismerés

Szolgáltatás Erőforrás
Beszédfelismerés SpeechServices

Nyelv

Szolgáltatás Erőforrás
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Nyelv TextAnalytics
Szövegfordítás TextTranslation

Döntés

Szolgáltatás Erőforrás
Anomaly Detector AnomalyDetector
Content Moderator ContentModerator
Personalizer Personalizer

Azure OpenAI

Szolgáltatás Erőforrás
Azure OpenAI OpenAI

Tarifacsomagok és számlázás

A tarifacsomagok (és a számlázott összeg) a hitelesítési adatokkal küldött tranzakciók számán alapulnak. Minden tarifacsomag a következőt határozza meg:

  • A másodpercenként engedélyezett tranzakciók maximális száma (TPS).
  • A tarifacsomagon belül engedélyezett szolgáltatásfunkciók.
  • Előre meghatározott számú tranzakció költsége. Ha ezt a számot meghaladja, az a szolgáltatás díjszabási részleteiben megadott díjat számít fel.

Feljegyzés

Számos Azure AI-szolgáltatás rendelkezik ingyenes szinttel, amellyel kipróbálhatja a szolgáltatást. Az ingyenes szint használatához használja F0 az erőforrás tarifacsomagját.

Erőforrások megtekintése

Az Azure-fiókban (az összes erőforráscsoportban) lévő összes erőforrás megtekintéséhez használja a következő módszert:

static void list_resources(CognitiveServicesManagementClient client)
{
    Console.WriteLine("Resources in resource group: " + resource_group_name);
    var result = client.Accounts.ListByResourceGroup(resource_group_name);
    foreach (var x in result)
    {
        Console.WriteLine("ID: " + x.Id);
        Console.WriteLine("Name: " + x.Name);
        Console.WriteLine("Type: " + x.Type);
        Console.WriteLine("Kind: " + x.Kind);
        Console.WriteLine();
    }
}

Erőforrások törlése

A következő metódus törli a megadott erőforrást az adott erőforráscsoportból.

static void delete_resource(CognitiveServicesManagementClient client, string resource_name)
{
    Console.WriteLine("Deleting resource: " + resource_name + "...");
    client.Accounts.Delete (resource_group_name, resource_name);

    Console.WriteLine("Resource deleted.");
    Console.WriteLine();
}

Az alkalmazás futtatása

Futtassa az alkalmazást az alkalmazáskönyvtárból a dotnet run paranccsal.

dotnet run

Referenciadokumentáció Kódtár forráskódcsomagja | (Maven) |

Java-előfeltételek

  • Érvényes Azure-előfizetés – Hozzon létre egyet ingyenesen.
  • A Java Development Kit (JDK) jelenlegi verziója
  • A Gradle buildelési eszköz vagy egy másik függőségkezelő.
  • Az Azure-fióknak rendelkeznie kell egy Cognitive Services Contributor szerepkörrel ahhoz, hogy elfogadja a felelős AI-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.
  • Ha az Azure AI Visionben vagy a Text Analytics for Healthben szeretné használni a térinformatikai elemzést az Azure AI-nyelven, akkor létre kell hoznia az első Vision- vagy Nyelvi erőforrásokat az Azure Portalról, hogy áttekinthesse és elismerhesse a használati feltételeket. Ezt itt teheti meg: Azure AI Language, Azure AI Vision. Ezt követően bármilyen üzembe helyezési eszközzel (például SDK, CLI vagy ARM-sablon) létrehozhat további erőforrásokat ugyanazon Azure-előfizetés alatt.

Azure-szolgáltatásnév létrehozása

Ahhoz, hogy az alkalmazás kommunikáljon az Azure-fiókjával, szüksége van egy Azure-szolgáltatásnévre az engedélyek kezeléséhez. Kövesse az Azure-szolgáltatásnév létrehozása című témakör utasításait.

Szolgáltatásnév létrehozásakor látni fogja, hogy titkos érték, azonosító és alkalmazásazonosító tartozik hozzá. Mentse az alkalmazásazonosítót és a titkos kulcsot egy ideiglenes helyre a későbbi lépésekhez.

Erőforráscsoport létrehozása

Mielőtt létrehoz egy Azure AI-szolgáltatási erőforrást, a fióknak rendelkeznie kell egy Azure-erőforráscsoporttel, amely tartalmazza az erőforrást. Ha még nincs erőforráscsoportja, a folytatás előtt hozzon létre egyet az Azure Portalon .

Új Java-alkalmazás létrehozása

Egy konzolablakban (pl. cmd, PowerShell vagy Bash) hozzon létre egy új mappát az alkalmazásnak, majd navigáljon oda.

mkdir myapp && cd myapp

Futtassa a gradle init parancsot a munkakönyvtárból. Ez a parancs alapvető buildfájlokat hoz létre a Gradle-hez, beleértve a build.gradle.kts fájlt, amelyet futásidőben használnak az alkalmazás létrehozásához és konfigurálásához.

gradle init --type basic

Amikor a rendszer kéri, hogy válasszon egy DSL-t, válassza a Kotlin lehetőséget.

Futtassa a következő parancsot a munkakönyvtárban:

mkdir -p src/main/java

Telepítse az ügyfélkódtárat

Ez a rövid útmutató a Gradle függőségkezelőt használja. A Maven Central-adattárban megtalálhatja a többi függőségkezelő ügyfélkódtárát és információit.

A projekt build.gradle.kts fájljában adja meg az ügyfélkódtárat utasításkéntimplementation, valamint a szükséges beépülő modulokat és beállításokat.

plugins {
    java
    application
}
application {
    mainClass.set("FormRecognizer")
}
repositories {
    mavenCentral()
}
dependencies {
    implementation(group = "com.microsoft.azure", name = "azure-mgmt-cognitiveservices", version = "1.10.0-beta")
}

Kódtárak importálása

Lépjen az új src/main/java mappára, és hozzon létre egy Management.java nevű fájlt. Nyissa meg a kívánt szerkesztőben vagy IDE-ben, és adja hozzá a következő import utasításokat:

import com.azure.core.management.*;
import com.azure.core.management.profile.*;
import com.azure.identity.*;
import com.azure.resourcemanager.cognitiveservices.*;
import com.azure.resourcemanager.cognitiveservices.implementation.*;
import com.azure.resourcemanager.cognitiveservices.models.*;

import java.io.*;
import java.lang.Object.*;
import java.util.*;
import java.net.*;

Az ügyfél hitelesítése

Adjon hozzá egy osztályt Management.java, majd adja hozzá a következő mezőket és azok értékeit. Töltse ki az értékeiket a létrehozott szolgáltatásnév és a többi Azure-fiók adatai alapján.

/*
Be sure to use the service pricipal application ID, not simply the ID. 
*/

private static String applicationId = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
private static String applicationSecret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
private static String subscriptionId = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
private static String tenantId = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
private static String resourceGroupName = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names. */
private static String subDomainName = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Ezután a fő módszerben ezeket az értékeket használva hozzon létre egy CognitiveServicesManager objektumot. Ez az objektum az összes Azure felügyeleti művelethez szükséges.

/* For more information see:
https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md
*/

ClientSecretCredential credential = new ClientSecretCredentialBuilder()
    .clientId(applicationId)
    .clientSecret(applicationSecret)
    .tenantId(tenantId)
    .build();
AzureProfile profile = new AzureProfile(tenantId, subscriptionId, AzureEnvironment.AZURE);

CognitiveServicesManager client = CognitiveServicesManager.authenticate(credential, profile);

Híváskezelési módszerek

Adja hozzá a következő kódot a Fő metódushoz az elérhető erőforrások listázásához, egy mintaerőforrás létrehozásához, a saját erőforrások listázásához, majd a mintaerőforrás törléséhez. Ezeket a metódusokat a következő lépésekben fogjuk meghatározni.

String resourceName = "test_resource";
String resourceKind = "TextTranslation";
String resourceSku = "F0";
Region resourceRegion = Region.US_WEST;

// Uncomment to list all available resource kinds, SKUs, and locations for your Azure account.
// list_available_kinds_skus_locations (client);

// Create a resource with kind Text Translation, SKU F0 (free tier), location US West.
String resourceId = create_resource (client, resourceName, resourceGroupName, resourceKind, resourceSku, resourceRegion);

// Uncomment this to list all resources for your Azure account.
// list_resources (client, resourceGroupName);

// Delete the resource.
delete_resource (client, resourceId);

/* NOTE: When you delete a resource, it is only soft-deleted. You must also purge it. Otherwise, if you try to create another
resource with the same name or custom subdomain, you will receive an error stating that such a resource already exists. */
purge_resource (client, resourceName, resourceGroupName, resourceRegion);

Azure AI-szolgáltatási erőforrás létrehozása (Java)

Új Azure AI-szolgáltatási erőforrás létrehozásához és előfizetéséhez használja a létrehozási módszert. Ez a metódus egy új számlázható erőforrást ad hozzá a megadott erőforráscsoporthoz. Az új erőforrás létrehozásakor ismernie kell a használni kívánt szolgáltatás "fajtáját", valamint annak tarifacsomagját (vagy termékváltozatát) és egy Azure-helyet. Az alábbi módszer argumentumként veszi fel ezeket, és létrehoz egy erőforrást.

public static String create_resource (CognitiveServicesManager client, String resourceName, String resourceGroupName, String resourceKind, String resourceSku, Region resourceRegion) {
    System.out.println ("Creating resource: " + resourceName + "...");

    /* NOTE: If you do not want to use a custom subdomain name, remove the withCustomSubDomainName
    setter from the AccountProperties object. */
    Account result = client.accounts().define(resourceName)
        .withExistingResourceGroup(resourceGroupName)
        // Note: Do not call withRegion() first, as it does not exist on the Blank interface returned by define().
        .withRegion(resourceRegion)
        .withKind(resourceKind)
        .withSku(new Sku().withName(resourceSku))
        .withProperties(new AccountProperties().withCustomSubDomainName(subDomainName))
        .create();

    System.out.println ("Resource created.");
    System.out.println ("ID: " + result.id());
    System.out.println ("Provisioning state: " + result.properties().provisioningState().toString());
    System.out.println ();

    return result.id();
}

Szolgáltatás- és tarifacsomag kiválasztása

Új erőforrás létrehozásakor ismernie kell a használni kívánt szolgáltatás "fajtáját", valamint a használni kívánt tarifacsomagot (vagy termékváltozatot). Az erőforrás létrehozásakor ezt és más információkat fogja paraméterként használni. Az elérhető Azure AI-szolgáltatások "típusainak" listáját az alábbi metódus meghívásával találja:

public static void list_available_kinds_skus_locations (CognitiveServicesManager client) {
    System.out.println ("Available SKUs:");
    System.out.println("Kind\tSKU Name\tSKU Tier\tLocations");
    ResourceSkus skus = client.resourceSkus();
    for (ResourceSku sku : skus.list()) {
        String locations = String.join (",", sku.locations());
        System.out.println (sku.kind() + "\t" + sku.name() + "\t" + sku.tier() + "\t" + locations);
    }
}

Az alábbi táblázatok az Azure AI-szolgáltatások termékeivel és díjszabásával kapcsolatos információkat tartalmaznak.

Többszolgáltatásos

Szolgáltatás Erőforrás
Több szolgáltatás. További tájékoztatás a díjszabási oldalon olvasható. CognitiveServices

Látás

Szolgáltatás Erőforrás
Látás ComputerVision
Custom Vision – Előrejelzés CustomVision.Prediction
Custom Vision – Oktatás CustomVision.Training
Face Face
Dokumentumintelligencia FormRecognizer

Beszédfelismerés

Szolgáltatás Erőforrás
Beszédfelismerés SpeechServices

Nyelv

Szolgáltatás Erőforrás
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Nyelv TextAnalytics
Szövegfordítás TextTranslation

Döntés

Szolgáltatás Erőforrás
Anomaly Detector AnomalyDetector
Content Moderator ContentModerator
Personalizer Personalizer

Azure OpenAI

Szolgáltatás Erőforrás
Azure OpenAI OpenAI

Tarifacsomagok és számlázás

A tarifacsomagok (és a számlázott összeg) a hitelesítési adatokkal küldött tranzakciók számán alapulnak. Minden tarifacsomag a következőt határozza meg:

  • A másodpercenként engedélyezett tranzakciók maximális száma (TPS).
  • A tarifacsomagon belül engedélyezett szolgáltatásfunkciók.
  • Előre meghatározott számú tranzakció költsége. Ha ezt a számot meghaladja, az a szolgáltatás díjszabási részleteiben megadott díjat számít fel.

Feljegyzés

Számos Azure AI-szolgáltatás rendelkezik ingyenes szinttel, amellyel kipróbálhatja a szolgáltatást. Az ingyenes szint használatához használja F0 az erőforrás tarifacsomagját.

Erőforrások megtekintése

Az Azure-fiókban (az összes erőforráscsoportban) lévő összes erőforrás megtekintéséhez használja a következő módszert:

public static void list_resources (CognitiveServicesManager client, String resourceGroupName) {
    System.out.println ("Resources in resource group: " + resourceGroupName);
    // Note Azure resources are also sometimes referred to as accounts.
    Accounts accounts = client.accounts();
    for (Account account : accounts.listByResourceGroup(resourceGroupName)) {
        System.out.println ("ID: " + account.id());
        System.out.println ("Kind: " + account.kind ());
        System.out.println ("SKU Name: " + account.sku().name());
        System.out.println ("Custom subdomain name: " + account.properties().customSubDomainName());
        System.out.println ();
    }
}

Erőforrások törlése

A következő metódus törli a megadott erőforrást az adott erőforráscsoportból.

public static void delete_resource (CognitiveServicesManager client, String resourceId) {
    System.out.println ("Deleting resource: " + resourceId + "...");
    client.accounts().deleteById (resourceId);
    System.out.println ("Resource deleted.");
    System.out.println ();
}

Referenciadokumentáció Kódtár forráskódcsomagja | (npm)Minták | |

JavaScript-előfeltételek

  • Érvényes Azure-előfizetés – Hozzon létre egyet ingyenesen.
  • A Node.js aktuális verziója
  • Az Azure-fióknak rendelkeznie kell egy Cognitive Services Contributor szerepkörrel ahhoz, hogy elfogadja a felelős AI-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.
  • Ha az Azure AI Visionben vagy a Text Analytics for Healthben szeretné használni a térinformatikai elemzést az Azure AI-nyelven, akkor létre kell hoznia az első Vision- vagy Nyelvi erőforrásokat az Azure Portalról, hogy áttekinthesse és elismerhesse a használati feltételeket. Ezt itt teheti meg: Azure AI Language, Azure AI Vision. Ezt követően bármilyen üzembe helyezési eszközzel (például SDK, CLI vagy ARM-sablon) létrehozhat további erőforrásokat ugyanazon Azure-előfizetés alatt.

Azure-szolgáltatásnév létrehozása

Ahhoz, hogy az alkalmazás kommunikáljon az Azure-fiókjával, szüksége van egy Azure-szolgáltatásnévre az engedélyek kezeléséhez. Kövesse az Azure-szolgáltatásnév létrehozása című témakör utasításait.

Szolgáltatásnév létrehozásakor látni fogja, hogy titkos érték, azonosító és alkalmazásazonosító tartozik hozzá. Mentse az alkalmazásazonosítót és a titkos kulcsot egy ideiglenes helyre a későbbi lépésekhez.

Erőforráscsoport létrehozása

Mielőtt létrehoz egy Azure AI-szolgáltatási erőforrást, a fióknak rendelkeznie kell egy Azure-erőforráscsoporttel, amely tartalmazza az erőforrást. Ha még nincs erőforráscsoportja, a folytatás előtt hozzon létre egyet az Azure Portalon .

Új Node.js-alkalmazás létrehozása

Egy konzolablakban (pl. cmd, PowerShell vagy Bash) hozzon létre egy új mappát az alkalmazásnak, majd navigáljon oda.

mkdir myapp && cd myapp

Futtassa az init parancsot egy Node-alkalmazás package.json fájllal való létrehozásához.

 init

Mielőtt továbblépne, hozzon létre egy index.js nevű fájlt.

Telepítse az ügyfélkódtárat

Telepítse a következő npm-csomagokat:

npm install @azure/arm-cognitiveservices
npm install @azure/identity

Az alkalmazás package.json fájlja frissül a függőségekkel.

Kódtárak importálása

Nyissa meg a index.js szkriptet, és importálja a következő kódtárakat.

"use strict";

/* To run this sample, install the following modules.
 * npm install @azure/arm-cognitiveservices @azure/identity
 */
var Arm = require("@azure/arm-cognitiveservices");
var Identity = require("@azure/identity");

Az ügyfél hitelesítése

Adja hozzá a következő mezőket a szkript gyökeréhez, és töltse ki az értékeiket a létrehozott szolgáltatásnév és az Azure-fiók adatainak használatával.

const service_principal_application_id =
  "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
const service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
const subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
const tenant_id = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
const resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names.
*/
const subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Ezután adja hozzá a következő quickstart függvényt a program fő munkájának kezeléséhez. Az első kódblokk egy CognitiveServicesManagementClient objektumot hoz létre a fent megadott hitelesítőadat-változók használatával. Ez az objektum az összes Azure felügyeleti művelethez szükséges.

async function quickstart() {
  /* For more information see:
https://www.npmjs.com/package/@azure/arm-cognitiveservices/v/6.0.0
https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/identity/identity/samples/AzureIdentityExamples.md#authenticating-a-service-principal-with-a-client-secret
*/
  const credentials = new Identity.ClientSecretCredential(
    tenant_id,
    service_principal_application_id,
    service_principal_secret
  );
  const client = new Arm.CognitiveServicesManagementClient(
    credentials,
    subscription_id
  );
  // Note Azure resources are also sometimes referred to as accounts.
  const accounts_client = client.accounts;
  const resource_skus_client = client.resourceSkus;
  const deleted_accounts_client = client.deletedAccounts;

Híváskezelési függvények

Adja hozzá a következő kódot a függvény végéhez quickstart az elérhető erőforrások listázásához, egy mintaerőforrás létrehozásához, a saját erőforrások listázásához, majd a mintaerőforrás törléséhez. Ezeket a függvényeket a következő lépésekben fogjuk meghatározni.

Azure AI-szolgáltatási erőforrás létrehozása (Node.js)

Új Azure AI-szolgáltatási erőforrás létrehozásához és előfizetéséhez használja a Create függvényt. Ez a függvény új számlázható erőforrást ad hozzá a megadott erőforráscsoporthoz. Az új erőforrás létrehozásakor ismernie kell a használni kívánt szolgáltatás "fajtáját", valamint a tarifacsomagot (vagy termékváltozatot) és egy Azure-helyet. Az alábbi függvény az összes argumentumot figyelembe veszi, és létrehoz egy erőforrást.

async function create_resource(
  client,
  resource_name,
  resource_kind,
  resource_sku,
  resource_region
) {
  console.log("Creating resource: " + resource_name + "...");
  /* NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
property from the properties object. */
  var parameters = {
    sku: { name: resource_sku },
    kind: resource_kind,
    location: resource_region,
    properties: { customSubDomainName: subdomain_name },
  };
  return client
    .beginCreateAndWait(resource_group_name, resource_name, parameters)
    .then((result) => {
      console.log("Resource created.");
      console.log();
      console.log("ID: " + result.id);
      console.log("Kind: " + result.kind);
      console.log();
    })
    .catch((err) => {
      console.log(err);
    });
}

Szolgáltatás- és tarifacsomag kiválasztása

Új erőforrás létrehozásakor ismernie kell a használni kívánt szolgáltatás "fajtáját", valamint a használni kívánt tarifacsomagot (vagy termékváltozatot). Az erőforrás létrehozásakor ezt és más információkat fogja paraméterként használni. Az alábbi függvény az elérhető Azure AI-szolgáltatások "típusait" sorolja fel.

async function list_available_kinds_skus_locations(client) {
  console.log("Available SKUs:");
  var result = client.list();
  console.log("Kind\tSKU Name\tSKU Tier\tLocations");
  for await (let item of result) {
    var locations = item.locations.join(",");
    console.log(item.kind + "\t" + item.name + "\t" + item.tier + "\t" + locations);
  }
}

Az alábbi táblázatok az Azure AI-szolgáltatások termékeivel és díjszabásával kapcsolatos információkat tartalmaznak.

Többszolgáltatásos

Szolgáltatás Erőforrás
Több szolgáltatás. További tájékoztatás a díjszabási oldalon olvasható. CognitiveServices

Látás

Szolgáltatás Erőforrás
Látás ComputerVision
Custom Vision – Előrejelzés CustomVision.Prediction
Custom Vision – Oktatás CustomVision.Training
Face Face
Dokumentumintelligencia FormRecognizer

Beszédfelismerés

Szolgáltatás Erőforrás
Beszédfelismerés SpeechServices

Nyelv

Szolgáltatás Erőforrás
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Nyelv TextAnalytics
Szövegfordítás TextTranslation

Döntés

Szolgáltatás Erőforrás
Anomaly Detector AnomalyDetector
Content Moderator ContentModerator
Personalizer Personalizer

Azure OpenAI

Szolgáltatás Erőforrás
Azure OpenAI OpenAI

Tarifacsomagok és számlázás

A tarifacsomagok (és a számlázott összeg) a hitelesítési adatokkal küldött tranzakciók számán alapulnak. Minden tarifacsomag a következőt határozza meg:

  • A másodpercenként engedélyezett tranzakciók maximális száma (TPS).
  • A tarifacsomagon belül engedélyezett szolgáltatásfunkciók.
  • Előre meghatározott számú tranzakció költsége. Ha ezt a számot meghaladja, az a szolgáltatás díjszabási részleteiben megadott díjat számít fel.

Feljegyzés

Számos Azure AI-szolgáltatás rendelkezik ingyenes szinttel, amellyel kipróbálhatja a szolgáltatást. Az ingyenes szint használatához használja F0 az erőforrás tarifacsomagját.

Erőforrások megtekintése

Az Azure-fiókban (az összes erőforráscsoportban) található összes erőforrás megtekintéséhez használja a következő függvényt:

async function list_resources(client) {
  console.log("Resources in resource group: " + resource_group_name);
  var result = client.listByResourceGroup(resource_group_name);
  for await (let item of result) {
    console.log(item);
    console.log();
  }
}

Erőforrások törlése

Az alábbi függvény törli a megadott erőforrást az adott erőforráscsoportból.

async function delete_resource(client, resource_name) {
  console.log("Deleting resource: " + resource_name + "...");
  await client.beginDeleteAndWait(resource_group_name, resource_name);
  console.log("Resource deleted.");
  console.log();
}

Az alkalmazás futtatása

Adja hozzá a következő kódot a szkript aljára, hogy hibakezeléssel hívja meg a fő quickstart függvényt.

try {
  quickstart();
} catch (error) {
  console.log(error);
}

Ezután a konzolablakban futtassa az alkalmazást a node paranccsal.

node index.js

Referenciadokumentáció Kódtár forráskódcsomagja | (PyPi) | -minták |

Python-előfeltételek

  • Érvényes Azure-előfizetés – Hozzon létre egyet ingyenesen.
  • Python 3.x
  • Az Azure-fióknak rendelkeznie kell egy Cognitive Services Contributor szerepkörrel ahhoz, hogy elfogadja a felelős AI-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.
  • Ha az Azure AI Visionben vagy a Text Analytics for Healthben szeretné használni a térinformatikai elemzést az Azure AI-nyelven, akkor létre kell hoznia az első Vision- vagy Nyelvi erőforrásokat az Azure Portalról, hogy áttekinthesse és elismerhesse a használati feltételeket. Ezt itt teheti meg: Azure AI Language, Azure AI Vision. Ezt követően bármilyen üzembe helyezési eszközzel (például SDK, CLI vagy ARM-sablon) létrehozhat további erőforrásokat ugyanazon Azure-előfizetés alatt.

Azure-szolgáltatásnév létrehozása

Ahhoz, hogy az alkalmazás kommunikáljon az Azure-fiókjával, szüksége van egy Azure-szolgáltatásnévre az engedélyek kezeléséhez. Kövesse az Azure-szolgáltatásnév létrehozása című témakör utasításait.

Szolgáltatásnév létrehozásakor látni fogja, hogy titkos érték, azonosító és alkalmazásazonosító tartozik hozzá. Mentse az alkalmazásazonosítót és a titkos kulcsot egy ideiglenes helyre a későbbi lépésekhez.

Erőforráscsoport létrehozása

Mielőtt létrehoz egy Azure AI-szolgáltatási erőforrást, a fióknak rendelkeznie kell egy Azure-erőforráscsoporttel, amely tartalmazza az erőforrást. Ha még nincs erőforráscsoportja, a folytatás előtt hozzon létre egyet az Azure Portalon .

Új Python-alkalmazás létrehozása

Hozzon létre egy új Python-alkalmazást az előnyben részesített szerkesztőben vagy IDE-ben, és navigáljon a projekthez egy konzolablakban.

Telepítse az ügyfélkódtárat

Az ügyfélkódtárat a következőkkel telepítheti:

pip install azure-mgmt-cognitiveservices

Telepítse az Azure Identity-kódtárat is a Microsoft Entra-jogkivonat-hitelesítés támogatásához.

pip install azure-identity

Kódtárak importálása

Nyissa meg a Python-szkriptet, és importálja a következő kódtárakat.

import time
from azure.identity import ClientSecretCredential
from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
from azure.mgmt.cognitiveservices.models import Account, Sku

Az ügyfél hitelesítése

Adja hozzá a következő mezőket a szkript gyökeréhez, és töltse ki az értékeiket a létrehozott szolgáltatásnév és az Azure-fiók adatainak használatával.

# Be sure to use the service pricipal application ID, not simply the ID. 
service_principal_application_id = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE"
service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE"

# The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions.
subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE"

# The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory.
tenant_id = "PASTE_YOUR_TENANT_ID_HERE"

# The name of the Azure resource group in which you want to create the resource.
# You can find resource groups in the Azure Dashboard under Home > Resource groups.
resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE"

# The name of the custom subdomain to use when you create the resource. This is optional.
# For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
# your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
# Note not all Cognitive Services allow custom subdomain names.
subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE"

# How many seconds to wait between checking the status of an async operation.
wait_time = 10

Ezután adja hozzá a következő kódot egy CognitiveServicesManagementClient objektum létrehozásához. Ez az objektum az összes Azure felügyeleti művelethez szükséges.

credential = ClientSecretCredential(tenant_id, service_principal_application_id, service_principal_secret)
client = CognitiveServicesManagementClient(credential, subscription_id)

Azure AI-szolgáltatási erőforrás létrehozása (Python)

Új Azure AI-szolgáltatási erőforrás létrehozásához és előfizetéséhez használja a Create függvényt. Ez a függvény új számlázható erőforrást ad hozzá a megadott erőforráscsoporthoz. Az új erőforrás létrehozásakor ismernie kell a használni kívánt szolgáltatás "fajtáját", valamint a tarifacsomagot (vagy termékváltozatot) és egy Azure-helyet. Az alábbi függvény az összes argumentumot figyelembe veszi, és létrehoz egy erőforrást.

def create_resource (resource_name, kind, sku_name, location) :
    print("Creating resource: " + resource_name + "...")

# NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
# property from the properties object.
    parameters = Account(sku=Sku(name=sku_name), kind=kind, location=location, properties={ 'custom_sub_domain_name' : subdomain_name })

    poller = client.accounts.begin_create(resource_group_name, resource_name, parameters)
    while (False == poller.done ()) :
        print ("Waiting {wait_time} seconds for operation to finish.".format (wait_time = wait_time))
        time.sleep (wait_time)
# This will raise an exception if the server responded with an error.
    result = poller.result ()

    print("Resource created.")
    print()
    print("ID: " + result.id)
    print("Name: " + result.name)
    print("Type: " + result.type)
    print()

Szolgáltatás- és tarifacsomag kiválasztása

Új erőforrás létrehozásakor ismernie kell a használni kívánt szolgáltatás "fajtáját", valamint a használni kívánt tarifacsomagot (vagy termékváltozatot). Az erőforrás létrehozásakor ezt és más információkat fogja paraméterként használni. Az alábbi függvény az elérhető Azure AI-szolgáltatások "típusait" sorolja fel.

def list_available_kinds_skus_locations():
    print("Available SKUs:")
    result = client.resource_skus.list()
    print("Kind\tSKU Name\tSKU Tier\tLocations")
    for x in result:
        locations = ",".join(x.locations)
        print(x.kind + "\t" + x.name + "\t" + x.tier + "\t" + locations)

Az alábbi táblázatok az Azure AI-szolgáltatások termékeivel és díjszabásával kapcsolatos információkat tartalmaznak.

Többszolgáltatásos

Szolgáltatás Erőforrás
Több szolgáltatás. További tájékoztatás a díjszabási oldalon olvasható. CognitiveServices

Látás

Szolgáltatás Erőforrás
Látás ComputerVision
Custom Vision – Előrejelzés CustomVision.Prediction
Custom Vision – Oktatás CustomVision.Training
Face Face
Dokumentumintelligencia FormRecognizer

Beszédfelismerés

Szolgáltatás Erőforrás
Beszédfelismerés SpeechServices

Nyelv

Szolgáltatás Erőforrás
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Nyelv TextAnalytics
Szövegfordítás TextTranslation

Döntés

Szolgáltatás Erőforrás
Anomaly Detector AnomalyDetector
Content Moderator ContentModerator
Personalizer Personalizer

Azure OpenAI

Szolgáltatás Erőforrás
Azure OpenAI OpenAI

Tarifacsomagok és számlázás

A tarifacsomagok (és a számlázott összeg) a hitelesítési adatokkal küldött tranzakciók számán alapulnak. Minden tarifacsomag a következőt határozza meg:

  • A másodpercenként engedélyezett tranzakciók maximális száma (TPS).
  • A tarifacsomagon belül engedélyezett szolgáltatásfunkciók.
  • Előre meghatározott számú tranzakció költsége. Ha ezt a számot meghaladja, az a szolgáltatás díjszabási részleteiben megadott díjat számít fel.

Feljegyzés

Számos Azure AI-szolgáltatás rendelkezik ingyenes szinttel, amellyel kipróbálhatja a szolgáltatást. Az ingyenes szint használatához használja F0 az erőforrás tarifacsomagját.

Erőforrások megtekintése

Az Azure-fiókban (az összes erőforráscsoportban) található összes erőforrás megtekintéséhez használja a következő függvényt:

def list_resources():
    print("Resources in resource group: " + resource_group_name)
    result = client.accounts.list_by_resource_group(resource_group_name)
    for x in result:
        print(x.name)
        print(x)
        print()

Erőforrások törlése

Az alábbi függvény törli a megadott erőforrást az adott erőforráscsoportból.

def delete_resource(resource_name) :
    print("Deleting resource: " + resource_name + "...")

    poller = client.accounts.begin_delete(resource_group_name, resource_name)
    while (False == poller.done ()) :
        print ("Waiting {wait_time} seconds for operation to finish.".format (wait_time = wait_time))
        time.sleep (wait_time)
# This will raise an exception if the server responded with an error.
    result = poller.result ()

    print("Resource deleted.")

Híváskezelési függvények

Adja hozzá a következő kódot a szkript aljára a fenti függvények meghívásához. Ez a kód felsorolja az elérhető erőforrásokat, létrehoz egy mintaerőforrást, listázza a saját erőforrásait, majd törli a mintaerőforrást.

resource_name = "test_resource"
resource_kind = "TextTranslation"
resource_sku = "F0"
resource_location = "Global"

# Uncomment this to list all available resource kinds, SKUs, and locations for your Azure account.
#list_available_kinds_skus_locations ()

# Create a resource with kind Text Translation, SKU F0 (free tier), location global.
create_resource(resource_name, resource_kind, resource_sku, resource_location)

# Uncomment this to list all resources for your Azure account.
#list_resources()

# Delete the resource.
delete_resource(resource_name)

# NOTE: Deleting a resource only soft-deletes it. To delete it permanently, you must purge it.
# Otherwise, if you later try to create a resource with the same name, you will receive the following error:
# azure.core.exceptions.ResourceExistsError: (FlagMustBeSetForRestore) An existing resource with ID '<your resource ID>' has been soft-deleted. To restore the resource, you must specify 'restore' to be 'true' in the property. If you don't want to restore existing resource, please purge it first.
# Code: FlagMustBeSetForRestore

# Purge the resource.
purge_resource(resource_name, resource_location)

Az alkalmazás futtatása

Futtassa az alkalmazást a parancssorból a python paranccsal.

python <your-script-name>.py

Következő lépések