Rychlý start: Vytvoření prostředku s více službami pro služby Azure AI

  • Článek

Zjistěte, jak vytvořit a spravovat prostředek s více službami pro služby Azure AI. Prostředek s více službami umožňuje přístup k více službám Azure AI s jedním klíčem a koncovým bodem. Konsoliduje také fakturaci ze služeb, které používáte.

Ke službám Azure AI můžete přistupovat prostřednictvím dvou různých prostředků: prostředek s více službami nebo jeden prostředek s jednou službou.

  • Prostředek s více službami:
    • Přístup k několika službám Azure AI pomocí jednoho klíče a koncového bodu
    • Konsoliduje fakturaci ze služeb, které používáte.
  • Prostředek s jednou službou:
    • Přístup k jedné službě Azure AI s jedinečným klíčem a koncovým bodem pro každou vytvořenou službu.
    • Většina služeb Azure AI nabízí bezplatnou úroveň pro vyzkoušení.

Služby Azure AI jsou prostředky Azure, které vytvoříte v rámci předplatného Azure. Po vytvoření prostředku můžete k ověření aplikací použít klíče a koncový bod vygenerovaný.

Podporované služby s prostředkem s více službami

Prostředek s více službami umožňuje přístup k následujícím službám Azure AI s jedním klíčem a koncovým bodem. Na těchto odkazech najdete články, ukázky a další články rychlého startu, které vám pomůžou začít používat váš prostředek.

Služba Popis
Ikona Content ModeratoruContent Moderator (vyřazeno) Odhalujte potenciálně urážlivý nebo nežádoucí obsah.
Ikona Custom VisionCustom Vision Přizpůsobení rozpoznávání obrázků pro vaši firmu
Ikona Funkce Document IntelligenceAnalýza dokumentů Převést dokumenty na inteligentní řešení založená na datech.
Ikona tvářeRozpoznávání tváře Detekujte a identifikujte lidi a emoce na obrázcích.
Ikona jazykaJazyk Vytvářejte aplikace s špičkovými možnostmi porozumění přirozenému jazyku.
Ikona řečiŘeč Rozpoznávání řeči na text, převod textu na řeč, překlad a rozpoznávání mluvčího
Ikona TranslatoruPřekladatel K překladu více než 100 používaných jazyků a dialektů používejte technologii překladu využívající AI.
Ikona zpracování obrazuVision Analyzujte obsah v obrázcích a videích.

Požadavky

  • Platné předplatné Azure – Vytvořte si ho zdarma.
  • Váš účet Azure musí mít přiřazenou Cognitive Services Contributor roli, abyste souhlasili s zodpovědnými podmínkami AI a vytvořili prostředek. Pokud chcete tuto roli přiřadit k vašemu účtu, postupujte podle pokynů v dokumentaci k přiřazování rolí nebo se obraťte na správce.

Vytvoření nového prostředku s více službami

Prostředek s více službami je uvedený v části Služby Azure AI služby>Azure AI na portálu s více službami. Pokud chcete vytvořit prostředek s více službami, postupujte podle těchto pokynů:

  1. Výběrem tohoto odkazu vytvořte prostředek s více službami: https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne

  2. Na stránce Vytvořit zadejte následující informace:

    Podrobnosti projektu Popis
    Předplatné Vyberte jedno z dostupných předplatných Azure.
    Skupina prostředků Skupina prostředků Azure, která bude obsahovat váš prostředek služeb Azure AI. Můžete vytvořit novou skupinu nebo ji přidat do existující skupiny.
    Oblast Umístění instance služby Azure AI. Různá umístění můžou mít latenci, ale nemají žádný vliv na dostupnost modulu runtime vašeho prostředku.
    Název Popisný název prostředku služeb Azure AI Například MyCognitiveServicesResource.
    Cenová úroveň Náklady na účet služeb Azure AI závisí na možnostech, které zvolíte, a využití. Další informace najdete v podrobnostech o cenách rozhraní API.

    Obrazovka pro vytvoření prostředků s více službami

  3. Podle potřeby nakonfigurujte další nastavení pro váš prostředek, přečtěte si a přijměte podmínky (podle potřeby) a pak vyberte Zkontrolovat a vytvořit.

Tip

Pokud vaše předplatné neumožňuje vytvořit prostředek služeb Azure AI, možná budete muset povolit oprávnění tohoto poskytovatele prostředků Azure pomocí webu Azure Portal, příkazu PowerShellu nebo příkazu Azure CLI. Pokud nejste vlastníkem předplatného, požádejte vlastníka nebo někoho s rolí správce, aby registraci dokončil za vás nebo požádal o udělení oprávnění /register/action pro váš účet.

Získání klíčů pro váš prostředek

  1. Po úspěšném nasazení prostředku vyberte Další kroky>Přejít k prostředku.

    Obrazovka Získání klíčů prostředků

  2. V podokně Rychlý start, které se otevře, můžete získat přístup ke koncovému bodu prostředku a spravovat klíče.

Konfigurace proměnné prostředí pro ověřování

Aby vaše aplikace získala přístup k prostředkům služeb Azure AI, musí být ověřená. Pokud chcete nastavit proměnnou prostředí pro klíč prostředku, otevřete okno konzoly a postupujte podle pokynů pro operační systém a vývojové prostředí. Pokud chcete nastavit proměnnou COGNITIVE_SERVICE_KEY prostředí, nahraďte your-key jedním z klíčů pro váš prostředek.

V produkčním prostředí použijte zabezpečený způsob ukládání přihlašovacích údajů a přístupu k němu, jako je trezor tajných kódů chráněný heslem. Pro účely testování je zápis do proměnné prostředí standardním postupem, ale mějte na paměti, že proměnné prostředí jsou uložené ve formátu prostého textu na místním počítači.

Tip

Nezahrňte klíč přímo do kódu a nikdy ho nesdělujte veřejně. Další možnosti ověřování, jako je Azure Key Vault, najdete v článku zabezpečení služeb Azure AI.

PowerShell obsahuje rozšiřitelné řešení, správu tajných kódů pro ukládání zabezpečených řetězců na platformách, jako je Úložiště tajných kódů nebo Azure KeyVault.

Pokud chcete nastavit úložiště tajných kódů pro hostování zabezpečených řetězců, přečtěte si článek Začínáme používat úložiště tajných kódů. Pak pomocí následujících příkladů uložte klíče rozhraní API.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

V testovacích prostředích můžete pomocí syntaxe PowerShellu $Env: nastavit proměnnou prostředí pouze pro aktuální relaci, nebo setx pomocí příkazu zachovat proměnnou napříč relacemi. Nezapomeňte, že tyto hodnoty jsou uloženy ve formátu prostého textu v klíčích registru Systému Windows.

$Env:COGNITIVE_SERVICE_KEY = your-key

setx COGNITIVE_SERVICE_KEY your-key

Po přidání proměnné prostředí pomocí setxje možné, že budete muset restartovat všechny spuštěné konzoly nebo jiné programy, které budou muset přečíst proměnnou prostředí. Pokud například jako editor používáte Sadu Visual Studio, restartujte sadu Visual Studio před spuštěním příkladu.

Pokud chcete nastavit proměnnou prostředí pro oblast prostředků služby Speech, postupujte podle stejných kroků. Nastavte COGNITIVE_SERVICE_REGION oblast vašeho prostředku. Například westus.

Vyčištění prostředků

Pokud chcete vyčistit a odebrat předplatné služeb Azure AI, můžete odstranit prostředek nebo skupinu prostředků. Odstraněním skupiny prostředků odstraníte také všechny ostatní prostředky obsažené ve skupině.

  1. Na webu Azure Portal rozbalením nabídky na levé straně otevřete nabídku služeb a zvolte Skupiny prostředků. Zobrazí se seznam skupin prostředků.
  2. Vyhledejte skupinu prostředků obsahující prostředek, který se má odstranit.
  3. Pokud chcete odstranit celou skupinu prostředků, vyberte název skupiny prostředků. Na další stránce vyberte Odstranit skupinu prostředků a potvrďte ji.
  4. Pokud chcete odstranit jenom prostředek služeb Azure AI, vyberte skupinu prostředků a zobrazte všechny prostředky v ní. Na další stránce vyberte prostředek, který chcete odstranit, vyberte nabídku se třemi tečky pro tento řádek a vyberte Odstranit.

Pomocí tohoto rychlého startu vytvoříte prostředek služeb Azure AI pomocí příkazů rozhraní příkazového řádku Azure (CLI). Po vytvoření prostředku použijte klíče a koncový bod vygenerovaný k ověření aplikací.

Služby Azure AI jsou cloudové služby umělé inteligence (AI), které vývojářům pomáhají při sestavování kognitivních inteligentních funkcí do aplikací bez přímých dovedností nebo znalostí umělé inteligence nebo datových věd. Jsou dostupné prostřednictvím rozhraní REST API a sad SDK klientské knihovny v oblíbených vývojových jazycích. Služby Azure AI umožňují vývojářům snadno přidávat kognitivní funkce do svých aplikací pomocí kognitivních řešení, která můžou vidět, slyšet, mluvit a analyzovat.

Požadavky

  • Platné předplatné Azure – Vytvořte si ho zdarma.
  • Azure CLI
  • Váš účet Azure musí mít přiřazenou Cognitive Services Contributor roli, abyste souhlasili s zodpovědnými podmínkami AI a vytvořili prostředek. Pokud chcete tuto roli přiřadit k vašemu účtu, postupujte podle pokynů v dokumentaci k přiřazování rolí nebo se obraťte na správce.
  • Pokud plánujete používat prostorovou analýzu ve službě Azure AI Vision nebo Analýza textu for Health v jazyce Azure AI, musíte na webu Azure Portal vytvořit své prostředky pro zpracování obrazu nebo jazyka, abyste mohli podmínky a ujednání zkontrolovat a potvrdit. Můžete to udělat tady: Azure AI Language, Azure AI Vision. Potom můžete vytvořit další prostředky pomocí libovolného nástroje pro nasazení (například sady SDK, rozhraní příkazového řádku nebo šablony ARM) ve stejném předplatném Azure.

Instalace Azure CLI a přihlášení

Nainstalujte rozhraní příkazového řádku Azure CLI. Pokud se chcete přihlásit k místní instalaci rozhraní příkazového řádku, spusťte příkaz az login :

az login

Pomocí zeleného tlačítka Vyzkoušet můžete tyto příkazy spustit také v prohlížeči.

Vytvoření nové skupiny prostředků služeb Azure AI

Než vytvoříte prostředek služeb Azure AI, musíte mít skupinu prostředků Azure, která prostředek bude obsahovat. Když vytvoříte nový prostředek, můžete buď vytvořit novou skupinu prostředků, nebo použít existující. Tento článek ukazuje, jak vytvořit novou skupinu prostředků.

Volba umístění skupiny prostředků

K vytvoření prostředku budete potřebovat jedno z umístění Azure dostupných pro vaše předplatné. Seznam dostupných umístění můžete načíst pomocí příkazu az account list-locations . Většina služeb Azure AI je přístupná z několika umístění. Vyberte umístění, která jsou k vám nejblíže, nebo zjistěte, která umístění jsou pro službu dostupná.

Důležité

  • Zapamatujte si umístění Azure, protože ho budete potřebovat při volání prostředků služeb Azure AI.
  • Dostupnost některých služeb Azure AI se může lišit v jednotlivých oblastech. Další informace najdete v tématu Produkty Azure podle oblastí.
az account list-locations --query "[].{Region:name}" --out table

Jakmile budete mít umístění Azure, vytvořte v Azure CLI novou skupinu prostředků pomocí příkazu az group create . V následujícím příkladu nahraďte umístění westus2 Azure jedním z umístění Azure dostupných pro vaše předplatné.

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

Vytvoření prostředku služeb Azure AI

Volba služby a cenové úrovně

Když vytvoříte nový prostředek, budete muset znát druh služby, kterou chcete použít, spolu s cenovou úrovní (nebo skladovou jednotkou), kterou chcete použít. Tyto a další informace použijete jako parametry při vytváření prostředku.

Následující tabulky obsahují informace o produktech a cenách služeb Azure AI.

Více služeb

Služba Kind
Více služeb. Další informace naleznete v části Stránka s cenami. CognitiveServices

Pohled

Služba Kind
Pohled ComputerVision
Custom Vision – předpověď CustomVision.Prediction
Custom Vision – školení CustomVision.Training
Rozpoznávání tváře Face
Analýza dokumentů FormRecognizer

Řeč

Služba Kind
Řeč SpeechServices

Jazyk

Služba Kind
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Jazyk TextAnalytics
Překlad textu TextTranslation

Rozhodnutí

Služba Kind
Detektor anomálií AnomalyDetector
Content Moderator ContentModerator
Personalizace Personalizer

Azure OpenAI

Služba Kind
Azure OpenAI OpenAI

Cenové úrovně a fakturace

Cenové úrovně (a fakturovaná částka) vycházejí z počtu transakcí, které odesíláte pomocí ověřovacích údajů. Každá cenová úroveň určuje:

  • Maximální počet povolených transakcí za sekundu (TPS).
  • Funkce služeb povolené v rámci cenové úrovně
  • Náklady na předdefinovaný počet transakcí Když přejdete nad toto číslo, bude se vám účtovat další poplatek, jak je uvedeno v podrobnostech o cenách vaší služby.

Poznámka:

Mnoho služeb Azure AI má bezplatnou úroveň, kterou můžete použít k vyzkoušení služby. Pokud chcete použít úroveň Free, použijte F0 ji jako cenovou úroveň vašeho prostředku.

Seznam dostupných služeb Azure AI můžete najít pomocí příkazu az cognitiveservices account list-kinds :

az cognitiveservices account list-kinds

Přidání nového prostředku do skupiny prostředků

Pokud chcete vytvořit a přihlásit se k odběru nového prostředku služeb Azure AI, použijte příkaz az cognitiveservices account create . Tento příkaz přidá nový fakturovatelný prostředek do skupiny prostředků, kterou jste vytvořili dříve. Při vytváření nového prostředku budete muset znát "druh" služby, kterou chcete použít, spolu s její cenovou úrovní (nebo skladovou jednotkou) a umístěním Azure:

Pomocí následujícího příkazu můžete vytvořit prostředek s více službami Standard S0 s názvem multi-service-resource .

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

Tip

Pokud vaše předplatné neumožňuje vytvořit prostředek služeb Azure AI, možná budete muset povolit oprávnění tohoto poskytovatele prostředků Azure pomocí webu Azure Portal, příkazu PowerShellu nebo příkazu Azure CLI. Pokud nejste vlastníkem předplatného, požádejte vlastníka nebo někoho s rolí správce, aby registraci dokončil za vás nebo požádal o udělení oprávnění /register/action pro váš účet.

Získání klíčů pro váš prostředek

K přihlášení k místní instalaci rozhraní příkazového řádku (CLI) použijte příkaz az login .

az login

Pomocí příkazu az cognitiveservices account keys list získejte klíče pro váš prostředek.

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

Konfigurace proměnné prostředí pro ověřování

Aby vaše aplikace získala přístup k prostředkům služeb Azure AI, musí být ověřená. Pokud chcete nastavit proměnnou prostředí pro klíč prostředku, otevřete okno konzoly a postupujte podle pokynů pro operační systém a vývojové prostředí. Pokud chcete nastavit proměnnou COGNITIVE_SERVICE_KEY prostředí, nahraďte your-key jedním z klíčů pro váš prostředek.

V produkčním prostředí použijte zabezpečený způsob ukládání přihlašovacích údajů a přístupu k němu, jako je trezor tajných kódů chráněný heslem. Pro účely testování je zápis do proměnné prostředí standardním postupem, ale mějte na paměti, že proměnné prostředí jsou uložené ve formátu prostého textu na místním počítači.

Tip

Nezahrňte klíč přímo do kódu a nikdy ho nesdělujte veřejně. Další možnosti ověřování, jako je Azure Key Vault, najdete v článku zabezpečení služeb Azure AI.

PowerShell obsahuje rozšiřitelné řešení, správu tajných kódů pro ukládání zabezpečených řetězců na platformách, jako je Úložiště tajných kódů nebo Azure KeyVault.

Pokud chcete nastavit úložiště tajných kódů pro hostování zabezpečených řetězců, přečtěte si článek Začínáme používat úložiště tajných kódů. Pak pomocí následujících příkladů uložte klíče rozhraní API.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

V testovacích prostředích můžete pomocí syntaxe PowerShellu $Env: nastavit proměnnou prostředí pouze pro aktuální relaci, nebo setx pomocí příkazu zachovat proměnnou napříč relacemi. Nezapomeňte, že tyto hodnoty jsou uloženy ve formátu prostého textu v klíčích registru Systému Windows.

$Env:COGNITIVE_SERVICE_KEY = your-key

setx COGNITIVE_SERVICE_KEY your-key

Po přidání proměnné prostředí pomocí setxje možné, že budete muset restartovat všechny spuštěné konzoly nebo jiné programy, které budou muset přečíst proměnnou prostředí. Pokud například jako editor používáte Sadu Visual Studio, restartujte sadu Visual Studio před spuštěním příkladu.

Pokud chcete nastavit proměnnou prostředí pro oblast prostředků služby Speech, postupujte podle stejných kroků. Nastavte COGNITIVE_SERVICE_REGION oblast vašeho prostředku. Například westus.

Cenové úrovně a fakturace

Cenové úrovně (a fakturovaná částka) vycházejí z počtu transakcí, které odesíláte pomocí ověřovacích údajů. Každá cenová úroveň určuje:

  • maximální počet povolených transakcí za sekundu (TPS).
  • funkce služeb povolené v rámci cenové úrovně.
  • Náklady na předdefinovaný počet transakcí. Přechod nad tuto částku způsobí dodatečné poplatky, jak je uvedeno v podrobnostech o cenách vaší služby.

Získání aktuálního využití kvóty pro váš prostředek

Pomocí příkazu az cognitiveservices account list-usage získejte využití vašeho prostředku.

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

Vyčištění prostředků

Pokud chcete vyčistit a odebrat prostředek služeb Azure AI, můžete ho odstranit nebo skupinu prostředků. Odstraněním skupiny prostředků odstraníte také všechny ostatní prostředky obsažené ve skupině.

Pokud chcete odebrat skupinu prostředků a její přidružené prostředky, použijte příkaz az group delete.

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

Pomocí tohoto rychlého startu můžete vytvořit prostředek služeb Azure AI pomocí příkazů Azure PowerShellu . Po vytvoření prostředku použijte klíče a koncový bod vygenerovaný k ověření aplikací.

Služby Azure AI jsou cloudové služby umělé inteligence (AI), které vývojářům pomáhají při sestavování kognitivních inteligentních funkcí do aplikací bez přímých dovedností nebo znalostí umělé inteligence nebo datových věd. Jsou dostupné prostřednictvím rozhraní REST API a sad SDK klientské knihovny v oblíbených vývojových jazycích. Služby Azure AI umožňují vývojářům snadno přidávat kognitivní funkce do svých aplikací pomocí kognitivních řešení, která můžou vidět, slyšet, mluvit a analyzovat.

Požadavky

  • Platné předplatné Azure – Vytvořte si ho zdarma.
  • Azure PowerShell
  • Váš účet Azure musí mít přiřazenou Cognitive Services Contributor roli, abyste souhlasili s zodpovědnými podmínkami AI a vytvořili prostředek. Pokud chcete tuto roli přiřadit k vašemu účtu, postupujte podle pokynů v dokumentaci k přiřazování rolí nebo se obraťte na správce.
  • Pokud plánujete používat prostorovou analýzu ve službě Azure AI Vision nebo Analýza textu for Health v jazyce Azure AI, musíte na webu Azure Portal vytvořit své prostředky pro zpracování obrazu nebo jazyka, abyste mohli podmínky a ujednání zkontrolovat a potvrdit. Můžete to udělat tady: Azure AI Language, Azure AI Vision. Potom můžete vytvořit další prostředky pomocí libovolného nástroje pro nasazení (například sady SDK, rozhraní příkazového řádku nebo šablony ARM) ve stejném předplatném Azure.

Instalace Azure PowerShellu a přihlášení

Nainstalujte Azure PowerShell. Pokud se chcete přihlásit, spusťte příkaz Připojení-AzAccount:

Connect-AzAccount

Pomocí zeleného tlačítka Vyzkoušet můžete tyto příkazy spustit také v prohlížeči.

Vytvoření nové skupiny prostředků služeb Azure AI

Než vytvoříte prostředek služeb Azure AI, musíte mít skupinu prostředků Azure, která prostředek bude obsahovat. Když vytvoříte nový prostředek, můžete buď vytvořit novou skupinu prostředků, nebo použít existující. Tento článek ukazuje, jak vytvořit novou skupinu prostředků.

Volba umístění skupiny prostředků

K vytvoření prostředku budete potřebovat jedno z umístění Azure dostupných pro vaše předplatné. Seznam dostupných umístění můžete načíst pomocí příkazu Get-AzLocation . Většina služeb Azure AI je přístupná z několika umístění. Vyberte umístění, která jsou k vám nejblíže, nebo zjistěte, která umístění jsou pro službu dostupná.

Důležité

  • Zapamatujte si umístění Azure, protože ho budete potřebovat při volání prostředků služeb Azure AI.
  • Dostupnost některých služeb Azure AI se může lišit v jednotlivých oblastech. Další informace najdete v tématu Produkty Azure podle oblastí.
Get-AzLocation | Select-Object -Property Location, DisplayName

Jakmile budete mít umístění Azure, vytvořte v Azure PowerShellu novou skupinu prostředků pomocí příkazu New-AzResourceGroup . V následujícím příkladu nahraďte umístění westus2 Azure jedním z umístění Azure dostupných pro vaše předplatné.

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

Vytvoření prostředku služeb Azure AI

Volba služby a cenové úrovně

Když vytvoříte nový prostředek, budete muset znát druh služby, kterou chcete použít, spolu s cenovou úrovní (nebo skladovou jednotkou), kterou chcete použít. Tyto a další informace použijete jako parametry při vytváření prostředku.

Následující tabulky obsahují informace o produktech a cenách služeb Azure AI.

Více služeb

Služba Kind
Více služeb. Další informace naleznete v části Stránka s cenami. CognitiveServices

Pohled

Služba Kind
Pohled ComputerVision
Custom Vision – předpověď CustomVision.Prediction
Custom Vision – školení CustomVision.Training
Rozpoznávání tváře Face
Analýza dokumentů FormRecognizer

Řeč

Služba Kind
Řeč SpeechServices

Jazyk

Služba Kind
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Jazyk TextAnalytics
Překlad textu TextTranslation

Rozhodnutí

Služba Kind
Detektor anomálií AnomalyDetector
Content Moderator ContentModerator
Personalizace Personalizer

Azure OpenAI

Služba Kind
Azure OpenAI OpenAI

Cenové úrovně a fakturace

Cenové úrovně (a fakturovaná částka) vycházejí z počtu transakcí, které odesíláte pomocí ověřovacích údajů. Každá cenová úroveň určuje:

  • Maximální počet povolených transakcí za sekundu (TPS).
  • Funkce služeb povolené v rámci cenové úrovně
  • Náklady na předdefinovaný počet transakcí Když přejdete nad toto číslo, bude se vám účtovat další poplatek, jak je uvedeno v podrobnostech o cenách vaší služby.

Poznámka:

Mnoho služeb Azure AI má bezplatnou úroveň, kterou můžete použít k vyzkoušení služby. Pokud chcete použít úroveň Free, použijte F0 ji jako cenovou úroveň vašeho prostředku.

Seznam dostupných služeb Azure AI můžete najít pomocí příkazu Get-AzCognitiveServicesAccountType :

Get-AzCognitiveServicesAccountType

Přidání nového prostředku do skupiny prostředků

Pokud chcete vytvořit a přihlásit se k odběru nového prostředku služeb Azure AI, použijte příkaz New-AzCognitiveServicesAccount . Tento příkaz přidá nový fakturovatelný prostředek do skupiny prostředků, kterou jste vytvořili dříve. Při vytváření nového prostředku budete muset znát "druh" služby, kterou chcete použít, spolu s její cenovou úrovní (nebo skladovou jednotkou) a umístěním Azure:

Pomocí následujícího příkazu můžete vytvořit prostředek s více službami Standard S0 s názvem multi-service-resource .

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

Tip

Pokud vaše předplatné neumožňuje vytvořit prostředek služeb Azure AI, možná budete muset povolit oprávnění tohoto poskytovatele prostředků Azure pomocí webu Azure Portal, příkazu Azure PowerShellu nebo příkazu Azure CLI. Pokud nejste vlastníkem předplatného, požádejte vlastníka nebo někoho s rolí správce, aby registraci dokončil za vás nebo požádal o udělení oprávnění /register/action pro váš účet.

Získání klíčů pro váš prostředek

Pomocí příkazu Get-AzCognitiveServicesAccountKey získejte klíče pro váš prostředek.

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

Konfigurace proměnné prostředí pro ověřování

Aby vaše aplikace získala přístup k prostředkům služeb Azure AI, musí být ověřená. Pokud chcete nastavit proměnnou prostředí pro klíč prostředku, otevřete okno konzoly a postupujte podle pokynů pro operační systém a vývojové prostředí. Pokud chcete nastavit proměnnou COGNITIVE_SERVICE_KEY prostředí, nahraďte your-key jedním z klíčů pro váš prostředek.

V produkčním prostředí použijte zabezpečený způsob ukládání přihlašovacích údajů a přístupu k němu, jako je trezor tajných kódů chráněný heslem. Pro účely testování je zápis do proměnné prostředí standardním postupem, ale mějte na paměti, že proměnné prostředí jsou uložené ve formátu prostého textu na místním počítači.

Tip

Nezahrňte klíč přímo do kódu a nikdy ho nesdělujte veřejně. Další možnosti ověřování, jako je Azure Key Vault, najdete v článku zabezpečení služeb Azure AI.

PowerShell obsahuje rozšiřitelné řešení, správu tajných kódů pro ukládání zabezpečených řetězců na platformách, jako je Úložiště tajných kódů nebo Azure KeyVault.

Pokud chcete nastavit úložiště tajných kódů pro hostování zabezpečených řetězců, přečtěte si článek Začínáme používat úložiště tajných kódů. Pak pomocí následujících příkladů uložte klíče rozhraní API.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

V testovacích prostředích můžete pomocí syntaxe PowerShellu $Env: nastavit proměnnou prostředí pouze pro aktuální relaci, nebo setx pomocí příkazu zachovat proměnnou napříč relacemi. Nezapomeňte, že tyto hodnoty jsou uloženy ve formátu prostého textu v klíčích registru Systému Windows.

$Env:COGNITIVE_SERVICE_KEY = your-key

setx COGNITIVE_SERVICE_KEY your-key

Po přidání proměnné prostředí pomocí setxje možné, že budete muset restartovat všechny spuštěné konzoly nebo jiné programy, které budou muset přečíst proměnnou prostředí. Pokud například jako editor používáte Sadu Visual Studio, restartujte sadu Visual Studio před spuštěním příkladu.

Pokud chcete nastavit proměnnou prostředí pro oblast prostředků služby Speech, postupujte podle stejných kroků. Nastavte COGNITIVE_SERVICE_REGION oblast vašeho prostředku. Například westus.

Cenové úrovně a fakturace

Cenové úrovně (a fakturovaná částka) vycházejí z počtu transakcí, které odesíláte pomocí ověřovacích údajů. Každá cenová úroveň určuje:

  • maximální počet povolených transakcí za sekundu (TPS).
  • funkce služeb povolené v rámci cenové úrovně.
  • Náklady na předdefinovaný počet transakcí. Přechod nad tuto částku způsobí dodatečné poplatky, jak je uvedeno v podrobnostech o cenách vaší služby.

Získání aktuálního využití kvóty pro váš prostředek

Pomocí příkazu Get-AzCognitiveServicesAccountUsage získejte využití vašeho prostředku.

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

Vyčištění prostředků

Pokud chcete vyčistit a odebrat prostředek služeb Azure AI, můžete ho odstranit nebo skupinu prostředků. Odstraněním skupiny prostředků odstraníte také všechny ostatní prostředky obsažené ve skupině.

Pokud chcete odebrat skupinu prostředků a její přidružené prostředky, použijte příkaz Remove-AzResourceGroup .

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

Referenční dokumentace | – ukázky balíčku zdrojového kódu | knihovny (NuGet) |

Požadavky jazyka C#

  • Platné předplatné Azure – Vytvořte si ho zdarma.
  • Aktuální verze .NET Core.
  • Váš účet Azure musí mít přiřazenou Cognitive Services Contributor roli, abyste souhlasili s zodpovědnými podmínkami AI a vytvořili prostředek. Pokud chcete tuto roli přiřadit k vašemu účtu, postupujte podle pokynů v dokumentaci k přiřazování rolí nebo se obraťte na správce.
  • Pokud plánujete používat prostorovou analýzu ve službě Azure AI Vision nebo Analýza textu for Health v jazyce Azure AI, musíte na webu Azure Portal vytvořit své prostředky pro zpracování obrazu nebo jazyka, abyste mohli podmínky a ujednání zkontrolovat a potvrdit. Můžete to udělat tady: Azure AI Language, Azure AI Vision. Potom můžete vytvořit další prostředky pomocí libovolného nástroje pro nasazení (například sady SDK, rozhraní příkazového řádku nebo šablony ARM) ve stejném předplatném Azure.

Vytvoření instančního objektu Azure

Pokud chcete, aby vaše aplikace pracovala s vaším účtem Azure, potřebujete instanční objekt Azure ke správě oprávnění. Postupujte podle pokynů v tématu Vytvoření instančního objektu Azure.

Při vytváření instančního objektu uvidíte, že má tajnou hodnotu, ID a ID aplikace. Uložte ID aplikace a tajný kód do dočasného umístění pro pozdější kroky.

Vytvoření skupiny zdrojů

Než vytvoříte prostředek služeb Azure AI, musí mít váš účet skupinu prostředků Azure, která prostředek bude obsahovat. Pokud ještě nemáte skupinu prostředků, vytvořte ji na webu Azure Portal , než budete pokračovat.

Vytvoření nové aplikace jazyka C#

Vytvořte novou aplikaci .NET Core. V okně konzoly (například cmd, PowerShell nebo Bash) pomocí dotnet new příkazu vytvořte novou konzolovou aplikaci s názvem azure-management-quickstart. Tento příkaz vytvoří jednoduchý projekt "Hello World" C# s jedním zdrojovým souborem: program.cs.

dotnet new console -n azure-management-quickstart

Změňte adresář na nově vytvořenou složku aplikace. Aplikaci můžete sestavit pomocí následujících:

dotnet build

Výstup sestavení by neměl obsahovat žádná upozornění ani chyby.

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

Instalace klientské knihovny

V adresáři aplikace nainstalujte klientskou knihovnu Azure Management pro .NET pomocí následujícího příkazu:

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

Pokud používáte integrované vývojové prostředí sady Visual Studio, je klientská knihovna k dispozici jako balíček NuGet ke stažení.

Import knihoven

Otevřete program.cs a na začátek souboru přidejte následující using příkazy:

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;

Ověření klienta

Do kořenového adresáře program.cs přidejte následující pole a vyplňte jejich hodnoty pomocí instančního objektu, který jste vytvořili, a informací o účtu Azure.

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";

Pak ve vaší Main metoda použijte tyto hodnoty k vytvoření CognitiveServicesManagementClient objektu. Tento objekt je potřeba pro všechny operace správy Azure.

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;

Metody správy volání

Přidejte do své metody Main následující kód, abyste vypsali dostupné prostředky, vytvořili ukázkový prostředek, vypsali vlastní prostředky a pak odstraňte ukázkový prostředek. Tyto metody definujete v dalších krocích.

    // 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();

Vytvoření prostředku služeb Azure AI (C#)

K vytvoření a přihlášení k odběru nového prostředku služeb Azure AI použijte metodu Create . Tato metoda přidá nový fakturovatelný prostředek do předávané skupiny prostředků. Při vytváření nového prostředku budete muset znát "druh" služby, kterou chcete použít, spolu s její cenovou úrovní (nebo skladovou jednotkou) a umístěním Azure. Následující metoda vezme všechny tyto argumenty a vytvoří prostředek.

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();
}

Volba služby a cenové úrovně

Když vytvoříte nový prostředek, budete muset znát "druh" služby, kterou chcete použít, spolu s cenovou úrovní (nebo skladovou jednotkou), kterou chcete použít. Tyto a další informace použijete jako parametry při vytváření prostředku. Seznam dostupných služeb Azure AI najdete tak, že ve skriptu zavoláte následující metodu:

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);
    };
}

Následující tabulky obsahují informace o produktech a cenách služeb Azure AI.

Více služeb

Služba Kind
Více služeb. Další informace naleznete v části Stránka s cenami. CognitiveServices

Pohled

Služba Kind
Pohled ComputerVision
Custom Vision – předpověď CustomVision.Prediction
Custom Vision – školení CustomVision.Training
Rozpoznávání tváře Face
Analýza dokumentů FormRecognizer

Řeč

Služba Kind
Řeč SpeechServices

Jazyk

Služba Kind
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Jazyk TextAnalytics
Překlad textu TextTranslation

Rozhodnutí

Služba Kind
Detektor anomálií AnomalyDetector
Content Moderator ContentModerator
Personalizace Personalizer

Azure OpenAI

Služba Kind
Azure OpenAI OpenAI

Cenové úrovně a fakturace

Cenové úrovně (a fakturovaná částka) vycházejí z počtu transakcí, které odesíláte pomocí ověřovacích údajů. Každá cenová úroveň určuje:

  • Maximální počet povolených transakcí za sekundu (TPS).
  • Funkce služeb povolené v rámci cenové úrovně
  • Náklady na předdefinovaný počet transakcí Když přejdete nad toto číslo, bude se vám účtovat další poplatek, jak je uvedeno v podrobnostech o cenách vaší služby.

Poznámka:

Mnoho služeb Azure AI má bezplatnou úroveň, kterou můžete použít k vyzkoušení služby. Pokud chcete použít úroveň Free, použijte F0 ji jako cenovou úroveň vašeho prostředku.

Zobrazení prostředků

Pokud chcete zobrazit všechny prostředky ve vašem účtu Azure (ve všech skupinách prostředků), použijte následující metodu:

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();
    }
}

Odstranění prostředku

Následující metoda odstraní zadaný prostředek z dané skupiny prostředků.

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();
}

Spuštění aplikace

Spusťte aplikaci z adresáře aplikace pomocí dotnet run příkazu.

dotnet run

Referenční dokumentace | – Balíček zdrojového kódu | knihovny (Maven)

Požadavky v Javě

  • Platné předplatné Azure – Vytvořte si ho zdarma.
  • Aktuální verze sady Java Development Kit(JDK)
  • Nástroj sestavení Gradle nebo jiný správce závislostí.
  • Váš účet Azure musí mít přiřazenou Cognitive Services Contributor roli, abyste souhlasili s zodpovědnými podmínkami AI a vytvořili prostředek. Pokud chcete tuto roli přiřadit k vašemu účtu, postupujte podle pokynů v dokumentaci k přiřazování rolí nebo se obraťte na správce.
  • Pokud plánujete používat prostorovou analýzu ve službě Azure AI Vision nebo Analýza textu for Health v jazyce Azure AI, musíte na webu Azure Portal vytvořit své prostředky pro zpracování obrazu nebo jazyka, abyste mohli podmínky a ujednání zkontrolovat a potvrdit. Můžete to udělat tady: Azure AI Language, Azure AI Vision. Potom můžete vytvořit další prostředky pomocí libovolného nástroje pro nasazení (například sady SDK, rozhraní příkazového řádku nebo šablony ARM) ve stejném předplatném Azure.

Vytvoření instančního objektu Azure

Pokud chcete, aby vaše aplikace pracovala s vaším účtem Azure, potřebujete instanční objekt Azure ke správě oprávnění. Postupujte podle pokynů v tématu Vytvoření instančního objektu Azure.

Při vytváření instančního objektu uvidíte, že má tajnou hodnotu, ID a ID aplikace. Uložte ID aplikace a tajný kód do dočasného umístění pro pozdější kroky.

Vytvoření skupiny zdrojů

Než vytvoříte prostředek služeb Azure AI, musí mít váš účet skupinu prostředků Azure, která prostředek bude obsahovat. Pokud ještě nemáte skupinu prostředků, vytvořte ji na webu Azure Portal , než budete pokračovat.

Vytvoření nové aplikace v Javě

V okně konzoly (například cmd, PowerShell nebo Bash) vytvořte pro vaši aplikaci nový adresář a přejděte do něj.

mkdir myapp && cd myapp

gradle init Spusťte příkaz z pracovního adresáře. Tento příkaz vytvoří základní soubory sestavení pro Gradle, včetně build.gradle.kts , které se používají za běhu k vytvoření a konfiguraci aplikace.

gradle init --type basic

Po zobrazení výzvy k výběru DSL vyberte Kotlin.

Z pracovního adresáře spusťte následující příkaz:

mkdir -p src/main/java

Instalace klientské knihovny

V tomto rychlém startu se používá správce závislostí Gradle. Klientskou knihovnu a informace pro další správce závislostí najdete v centrálním úložišti Maven.

Do souboru build.gradle.kts projektu zahrňte klientskou knihovnu implementation jako příkaz spolu s požadovanými moduly plug-in a nastavením.

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

Import knihoven

Přejděte do nové složky src/main/java a vytvořte soubor s názvem Management.java. Otevřete ho v preferovaném editoru nebo integrovaném vývojovém prostředí a přidejte následující import příkazy:

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.*;

Ověření klienta

Přidejte třídu do Management.java a pak do ní přidejte následující pole a jejich hodnoty. Vyplňte jejich hodnoty pomocí instančního objektu, který jste vytvořili, a dalších informací o účtu Azure.

/*
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";

Pak v hlavní metodě použijte tyto hodnoty k vytvoření objektu CognitiveServicesManager . Tento objekt je potřeba pro všechny operace správy Azure.

/* 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);

Metody správy volání

Přidejte do své metody Main následující kód, abyste vypsali dostupné prostředky, vytvořili ukázkový prostředek, vypsali vlastní prostředky a pak odstraňte ukázkový prostředek. Tyto metody definujete v dalších krocích.

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);

Vytvoření prostředku služeb Azure AI (Java)

Pokud chcete vytvořit a přihlásit se k odběru nového prostředku služeb Azure AI, použijte metodu create . Tato metoda přidá nový fakturovatelný prostředek do předávané skupiny prostředků. Při vytváření nového prostředku budete muset znát "druh" služby, kterou chcete použít, spolu s její cenovou úrovní (nebo skladovou jednotkou) a umístěním Azure. Následující metoda vezme všechny tyto argumenty a vytvoří prostředek.

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();
}

Volba služby a cenové úrovně

Když vytvoříte nový prostředek, budete muset znát "druh" služby, kterou chcete použít, spolu s cenovou úrovní (nebo skladovou jednotkou), kterou chcete použít. Tyto a další informace použijete jako parametry při vytváření prostředku. Seznam dostupných služeb Azure AI najdete tak, že zavoláte následující metodu:

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);
    }
}

Následující tabulky obsahují informace o produktech a cenách služeb Azure AI.

Více služeb

Služba Kind
Více služeb. Další informace naleznete v části Stránka s cenami. CognitiveServices

Pohled

Služba Kind
Pohled ComputerVision
Custom Vision – předpověď CustomVision.Prediction
Custom Vision – školení CustomVision.Training
Rozpoznávání tváře Face
Analýza dokumentů FormRecognizer

Řeč

Služba Kind
Řeč SpeechServices

Jazyk

Služba Kind
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Jazyk TextAnalytics
Překlad textu TextTranslation

Rozhodnutí

Služba Kind
Detektor anomálií AnomalyDetector
Content Moderator ContentModerator
Personalizace Personalizer

Azure OpenAI

Služba Kind
Azure OpenAI OpenAI

Cenové úrovně a fakturace

Cenové úrovně (a fakturovaná částka) vycházejí z počtu transakcí, které odesíláte pomocí ověřovacích údajů. Každá cenová úroveň určuje:

  • Maximální počet povolených transakcí za sekundu (TPS).
  • Funkce služeb povolené v rámci cenové úrovně
  • Náklady na předdefinovaný počet transakcí Když přejdete nad toto číslo, bude se vám účtovat další poplatek, jak je uvedeno v podrobnostech o cenách vaší služby.

Poznámka:

Mnoho služeb Azure AI má bezplatnou úroveň, kterou můžete použít k vyzkoušení služby. Pokud chcete použít úroveň Free, použijte F0 ji jako cenovou úroveň vašeho prostředku.

Zobrazení prostředků

Pokud chcete zobrazit všechny prostředky ve vašem účtu Azure (ve všech skupinách prostředků), použijte následující metodu:

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 ();
    }
}

Odstranění prostředku

Následující metoda odstraní zadaný prostředek z dané skupiny prostředků.

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 ();
}

Referenční dokumentace | – ukázky balíčku zdrojového kódu | knihovny (npm) |

Požadavky javascriptu

  • Platné předplatné Azure – Vytvořte si ho zdarma.
  • Aktuální verze Node.js
  • Váš účet Azure musí mít přiřazenou Cognitive Services Contributor roli, abyste souhlasili s zodpovědnými podmínkami AI a vytvořili prostředek. Pokud chcete tuto roli přiřadit k vašemu účtu, postupujte podle pokynů v dokumentaci k přiřazování rolí nebo se obraťte na správce.
  • Pokud plánujete používat prostorovou analýzu ve službě Azure AI Vision nebo Analýza textu for Health v jazyce Azure AI, musíte na webu Azure Portal vytvořit své prostředky pro zpracování obrazu nebo jazyka, abyste mohli podmínky a ujednání zkontrolovat a potvrdit. Můžete to udělat tady: Azure AI Language, Azure AI Vision. Potom můžete vytvořit další prostředky pomocí libovolného nástroje pro nasazení (například sady SDK, rozhraní příkazového řádku nebo šablony ARM) ve stejném předplatném Azure.

Vytvoření instančního objektu Azure

Pokud chcete, aby vaše aplikace pracovala s vaším účtem Azure, potřebujete instanční objekt Azure ke správě oprávnění. Postupujte podle pokynů v tématu Vytvoření instančního objektu Azure.

Při vytváření instančního objektu uvidíte, že má tajnou hodnotu, ID a ID aplikace. Uložte ID aplikace a tajný kód do dočasného umístění pro pozdější kroky.

Vytvoření skupiny zdrojů

Než vytvoříte prostředek služeb Azure AI, musí mít váš účet skupinu prostředků Azure, která prostředek bude obsahovat. Pokud ještě nemáte skupinu prostředků, vytvořte ji na webu Azure Portal , než budete pokračovat.

Vytvoření nové aplikace Node.js

V okně konzoly (například cmd, PowerShell nebo Bash) vytvořte pro vaši aplikaci nový adresář a přejděte do něj.

mkdir myapp && cd myapp

Spuštěním příkazu init vytvoříte aplikaci uzlu se souborem package.json.

 init

Než začnete, vytvořte soubor s názvem index.js .

Instalace klientské knihovny

Nainstalujte následující balíčky npm:

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

Soubor package.json vaší aplikace se bude aktualizovat s využitím závislostí.

Import knihoven

Otevřete skript index.js a naimportujte následující knihovny.

"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");

Ověření klienta

Do kořenového adresáře skriptu přidejte následující pole a vyplňte jejich hodnoty pomocí instančního objektu, který jste vytvořili, a informací o účtu Azure.

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";

Dále přidejte následující quickstart funkci pro zpracování hlavní práce programu. První blok kódu vytvoří objekt CognitiveServicesManagementClient pomocí proměnných přihlašovacích údajů, které jste zadali výše. Tento objekt je potřeba pro všechny operace správy Azure.

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;

Funkce správy volání

Na konec funkce quickstart přidejte následující kód pro výpis dostupných prostředků, vytvoření ukázkového prostředku, výpis vlastních prostředků a odstranění ukázkového prostředku. Tyto funkce definujete v dalších krocích.

Vytvoření prostředku služeb Azure AI (Node.js)

Pokud chcete vytvořit a přihlásit se k odběru nového prostředku služeb Azure AI, použijte funkci Create . Tato funkce přidá nový fakturovatelný prostředek do skupiny prostředků, kterou předáte. Při vytváření nového prostředku budete muset znát "druh" služby, kterou chcete použít, spolu s její cenovou úrovní (nebo skladovou jednotkou) a umístěním Azure. Následující funkce vezme všechny tyto argumenty a vytvoří prostředek.

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);
    });
}

Volba služby a cenové úrovně

Když vytvoříte nový prostředek, budete muset znát "druh" služby, kterou chcete použít, spolu s cenovou úrovní (nebo skladovou jednotkou), kterou chcete použít. Tyto a další informace použijete jako parametry při vytváření prostředku. Následující funkce uvádí dostupné služby Azure AI "druhy".

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);
  }
}

Následující tabulky obsahují informace o produktech a cenách služeb Azure AI.

Více služeb

Služba Kind
Více služeb. Další informace naleznete v části Stránka s cenami. CognitiveServices

Pohled

Služba Kind
Pohled ComputerVision
Custom Vision – předpověď CustomVision.Prediction
Custom Vision – školení CustomVision.Training
Rozpoznávání tváře Face
Analýza dokumentů FormRecognizer

Řeč

Služba Kind
Řeč SpeechServices

Jazyk

Služba Kind
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Jazyk TextAnalytics
Překlad textu TextTranslation

Rozhodnutí

Služba Kind
Detektor anomálií AnomalyDetector
Content Moderator ContentModerator
Personalizace Personalizer

Azure OpenAI

Služba Kind
Azure OpenAI OpenAI

Cenové úrovně a fakturace

Cenové úrovně (a fakturovaná částka) vycházejí z počtu transakcí, které odesíláte pomocí ověřovacích údajů. Každá cenová úroveň určuje:

  • Maximální počet povolených transakcí za sekundu (TPS).
  • Funkce služeb povolené v rámci cenové úrovně
  • Náklady na předdefinovaný počet transakcí Když přejdete nad toto číslo, bude se vám účtovat další poplatek, jak je uvedeno v podrobnostech o cenách vaší služby.

Poznámka:

Mnoho služeb Azure AI má bezplatnou úroveň, kterou můžete použít k vyzkoušení služby. Pokud chcete použít úroveň Free, použijte F0 ji jako cenovou úroveň vašeho prostředku.

Zobrazení prostředků

Pokud chcete zobrazit všechny prostředky ve vašem účtu Azure (ve všech skupinách prostředků), použijte následující funkci:

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();
  }
}

Odstranění prostředku

Následující funkce odstraní zadaný prostředek z dané skupiny prostředků.

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();
}

Spuštění aplikace

Do dolní části skriptu přidejte následující kód, který zavolá hlavní quickstart funkci s zpracováním chyb.

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

Potom v okně konzoly spusťte aplikaci pomocí node příkazu.

node index.js

Referenční dokumentace | – ukázky balíčku zdrojového kódu | knihovny (PyPi) |

Požadavky Pythonu

  • Platné předplatné Azure – Vytvořte si ho zdarma.
  • Python 3.x
  • Váš účet Azure musí mít přiřazenou Cognitive Services Contributor roli, abyste souhlasili s zodpovědnými podmínkami AI a vytvořili prostředek. Pokud chcete tuto roli přiřadit k vašemu účtu, postupujte podle pokynů v dokumentaci k přiřazování rolí nebo se obraťte na správce.
  • Pokud plánujete používat prostorovou analýzu ve službě Azure AI Vision nebo Analýza textu for Health v jazyce Azure AI, musíte na webu Azure Portal vytvořit své prostředky pro zpracování obrazu nebo jazyka, abyste mohli podmínky a ujednání zkontrolovat a potvrdit. Můžete to udělat tady: Azure AI Language, Azure AI Vision. Potom můžete vytvořit další prostředky pomocí libovolného nástroje pro nasazení (například sady SDK, rozhraní příkazového řádku nebo šablony ARM) ve stejném předplatném Azure.

Vytvoření instančního objektu Azure

Pokud chcete, aby vaše aplikace pracovala s vaším účtem Azure, potřebujete instanční objekt Azure ke správě oprávnění. Postupujte podle pokynů v tématu Vytvoření instančního objektu Azure.

Při vytváření instančního objektu uvidíte, že má tajnou hodnotu, ID a ID aplikace. Uložte ID aplikace a tajný kód do dočasného umístění pro pozdější kroky.

Vytvoření skupiny zdrojů

Než vytvoříte prostředek služeb Azure AI, musí mít váš účet skupinu prostředků Azure, která prostředek bude obsahovat. Pokud ještě nemáte skupinu prostředků, vytvořte ji na webu Azure Portal , než budete pokračovat.

Vytvoření nové aplikace v Pythonu

Vytvořte novou aplikaci Pythonu v preferovaném editoru nebo integrovaném vývojovém prostředí (IDE) a přejděte do projektu v okně konzoly.

Instalace klientské knihovny

Klientskou knihovnu můžete nainstalovat pomocí následujících:

pip install azure-mgmt-cognitiveservices

Nainstalujte také knihovnu Identit Azure pro podporu ověřování tokenů Microsoft Entra.

pip install azure-identity

Import knihoven

Otevřete skript Pythonu a naimportujte následující knihovny.

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

Ověření klienta

Do kořenového adresáře skriptu přidejte následující pole a vyplňte jejich hodnoty pomocí instančního objektu, který jste vytvořili, a informací o účtu Azure.

# 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

Pak přidejte následující kód pro vytvoření objektu CognitiveServicesManagementClient . Tento objekt je potřeba pro všechny operace správy Azure.

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

Vytvoření prostředku služeb Azure AI (Python)

Pokud chcete vytvořit a přihlásit se k odběru nového prostředku služeb Azure AI, použijte funkci Create . Tato funkce přidá nový fakturovatelný prostředek do skupiny prostředků, kterou předáte. Při vytváření nového prostředku budete muset znát "druh" služby, kterou chcete použít, spolu s její cenovou úrovní (nebo skladovou jednotkou) a umístěním Azure. Následující funkce vezme všechny tyto argumenty a vytvoří prostředek.

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()

Volba služby a cenové úrovně

Když vytvoříte nový prostředek, budete muset znát "druh" služby, kterou chcete použít, spolu s cenovou úrovní (nebo skladovou jednotkou), kterou chcete použít. Tyto a další informace použijete jako parametry při vytváření prostředku. Následující funkce uvádí dostupné služby Azure AI "druhy".

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)

Následující tabulky obsahují informace o produktech a cenách služeb Azure AI.

Více služeb

Služba Kind
Více služeb. Další informace naleznete v části Stránka s cenami. CognitiveServices

Pohled

Služba Kind
Pohled ComputerVision
Custom Vision – předpověď CustomVision.Prediction
Custom Vision – školení CustomVision.Training
Rozpoznávání tváře Face
Analýza dokumentů FormRecognizer

Řeč

Služba Kind
Řeč SpeechServices

Jazyk

Služba Kind
Language Understanding (LUIS) LUIS
QnA Maker QnAMaker
Jazyk TextAnalytics
Překlad textu TextTranslation

Rozhodnutí

Služba Kind
Detektor anomálií AnomalyDetector
Content Moderator ContentModerator
Personalizace Personalizer

Azure OpenAI

Služba Kind
Azure OpenAI OpenAI

Cenové úrovně a fakturace

Cenové úrovně (a fakturovaná částka) vycházejí z počtu transakcí, které odesíláte pomocí ověřovacích údajů. Každá cenová úroveň určuje:

  • Maximální počet povolených transakcí za sekundu (TPS).
  • Funkce služeb povolené v rámci cenové úrovně
  • Náklady na předdefinovaný počet transakcí Když přejdete nad toto číslo, bude se vám účtovat další poplatek, jak je uvedeno v podrobnostech o cenách vaší služby.

Poznámka:

Mnoho služeb Azure AI má bezplatnou úroveň, kterou můžete použít k vyzkoušení služby. Pokud chcete použít úroveň Free, použijte F0 ji jako cenovou úroveň vašeho prostředku.

Zobrazení prostředků

Pokud chcete zobrazit všechny prostředky ve vašem účtu Azure (ve všech skupinách prostředků), použijte následující funkci:

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()

Odstranění prostředku

Následující funkce odstraní zadaný prostředek z dané skupiny prostředků.

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.")

Funkce správy volání

Do dolní části skriptu přidejte následující kód, který zavolá výše uvedené funkce. Tento kód obsahuje seznam dostupných prostředků, vytvoří ukázkový prostředek, zobrazí seznam vlastních prostředků a pak odstraní ukázkový prostředek.

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)

Spuštění aplikace

Spusťte aplikaci z příkazového python řádku pomocí příkazu.

python <your-script-name>.py

Další kroky

  • Teď, když máte prostředek, můžete své požadavky rozhraní API ověřit na jedné z podporovaných služeb Azure AI.