Kurz: vytvoření modelu tenanta (Preview)

Model tenanta (Custom Speech s daty Microsoft 365) je služba pro Microsoft 365 podnikovým zákazníkům, která automaticky generuje vlastní Model rozpoznávání řeči z Microsoft 365ch dat vaší organizace. Model je optimalizovaný pro technické výrazy, žargonu a jména lidí, a to vše bezpečným a kompatibilním způsobem.

V tomto kurzu se naučíte:

Zaregistrujte se do služby modelu tenanta.

Než budete moct nasadit model tenanta, musíte být zaregistrované ve službě modelu tenanta. registrace se dokončila v Centrum pro správu Microsoftu 365 a může ji udělat jenom správce.

1. Přihlaste se k Centru pro správu Microsoftu 365.

2. v levém podokně vyberte Nastavení, vyberte Nastavení z vnořené nabídky a potom v hlavním okně vyberte Azure Speech Services .

   

3. Zaškrtněte políčko pro Povolení jazykových modelů v rámci organizace a pak vyberte Uložit změny.

   

Postup vypnutí instance modelu tenanta:

1. Opakujte předchozí kroky 1 a 2.
2. Zrušte zaškrtnutí políčka pro Povolení jazykových modelů v rámci organizace a pak vyberte Uložit změny.

Získat klíč předplatného pro rozpoznávání řeči

Pokud chcete model tenanta použít se sadou Speech SDK, potřebujete prostředek pro rozpoznávání řeči a jeho přidružený klíč předplatného.

1. Přihlaste se k webu Azure Portal.

2. Vyberte Vytvořit prostředek.

3. Do vyhledávacího pole zadejte Speech.

4. V seznamu výsledků vyberte řeč a pak vyberte vytvořit.

5. Pokud chcete vytvořit prostředek, postupujte podle pokynů na obrazovce. Ujistěte se, že:

   • Umístění je nastaveno na hodnotu eastus nebo westus.
   • Cenová úroveň je nastavená na S0.

6. Vyberte Vytvořit.

   Po několika minutách se prostředek vytvoří. Klíč předplatného je k dispozici v části Přehled pro váš prostředek.

Vytvoření jazykového modelu

až správce povolí Model tenanta pro vaši organizaci, můžete vytvořit jazykový model založený na datech Microsoft 365.

1. Přihlaste se ke službě Speech Studio.

2. v pravém horním rohu vyberte Nastavení (ikona ozubeného kolečka) a pak vyberte nastavení modelu tenanta.

   

   Speech Studio zobrazí zprávu, která vám umožní zjistit, jestli máte v úmyslu vytvořit model tenanta.

   Poznámka

   Enterprise zákazníci v Severní Amerika mají nárok na vytvoření modelu tenanta (anglicky). pokud jste Customer Lockbox, klíč zákazníka nebo Office 365 Government zákazníkem, tato funkce není k dispozici. Pokud chcete zjistit, jestli Customer Lockbox jste zákazníkem zákaznického zákazníka, přečtěte si téma:

   • Customer Lockbox
   • Klíč zákazníka
   • Office 365 Government

3. Zvolte Přihlásit.

   Až bude model tenanta připravený, obdržíte e-mailovou zprávu s potvrzením s dalšími pokyny.

Nasazení modelu tenanta

Když je vaše instance modelu tenanta připravená, nasaďte ji následujícím způsobem:

1. V potvrzovací e-mailové zprávě vyberte tlačítko Zobrazit model . Nebo se přihlaste ke službě Speech Studio.

2. v pravém horním rohu vyberte Nastavení (ikona ozubeného kolečka) a pak vyberte nastavení modelu tenanta.

   

3. Vyberte Nasadit.

   Po nasazení modelu se stav změní na nasazeno.

Použití modelu tenanta se sadou Speech SDK

Teď, když jste model nasadili, ho můžete použít se sadou Speech SDK. v této části použijete vzorový kód pro volání služby Speech pomocí ověřování Azure Active Directory (Azure AD).

Pojďme se podívat na kód, který použijete pro volání sady Speech SDK v jazyce C#. V tomto příkladu provedete rozpoznávání řeči pomocí modelu tenanta. Tato příručka předpokládá, že už máte nastavenou platformu. Pokud potřebujete pomocníka s nastavením, přečtěte si rychlý Start: rozpoznávání řeči, C# (.NET Core).

Zkopírujte do svého projektu tento kód:

namespace PrincetonSROnly.FrontEnd.Samples
{
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Net.Http;
    using System.Text;
    using System.Text.RegularExpressions;
    using System.Threading.Tasks;
    using Microsoft.CognitiveServices.Speech;
    using Microsoft.CognitiveServices.Speech.Audio;
    using Microsoft.IdentityModel.Clients.ActiveDirectory;
    using Newtonsoft.Json.Linq;

    // ServiceApplicationId is a fixed value. No need to change it.

    public class TenantLMSample
    {
        private const string EndpointUriArgName = "EndpointUri";
        private const string SubscriptionKeyArgName = "SubscriptionKey";
        private const string UsernameArgName = "Username";
        private const string PasswordArgName = "Password";
        private const string ClientApplicationId = "f87bc118-1576-4097-93c9-dbf8f45ef0dd";
        private const string ServiceApplicationId = "18301695-f99d-4cae-9618-6901d4bdc7be";

        public static async Task ContinuousRecognitionWithTenantLMAsync(Uri endpointUri, string subscriptionKey, string audioDirPath, string username, string password)
        {
            var config = SpeechConfig.FromEndpoint(endpointUri, subscriptionKey);

            // Passing client specific information for obtaining LM
            if (string.IsNullOrEmpty(username) || string.IsNullOrEmpty(password))
            {
                config.AuthorizationToken = await AcquireAuthTokenWithInteractiveLoginAsync().ConfigureAwait(false);
            }
            else
            {
                config.AuthorizationToken = await AcquireAuthTokenWithUsernamePasswordAsync(username, password).ConfigureAwait(false);
            }

            var stopRecognition = new TaskCompletionSource<int>();

            // Creates a speech recognizer using file as audio input.
            // Replace with your own audio file name.
            using (var audioInput = AudioConfig.FromWavFileInput(audioDirPath))
            {
                using (var recognizer = new SpeechRecognizer(config, audioInput))
                {
                    // Subscribes to events
                    recognizer.Recognizing += (s, e) =>
                    {
                        Console.WriteLine($"RECOGNIZING: Text={e.Result.Text}");
                    };

                    recognizer.Recognized += (s, e) =>
                    {
                        if (e.Result.Reason == ResultReason.RecognizedSpeech)
                        {
                            Console.WriteLine($"RECOGNIZED: Text={e.Result.Text}");
                        }
                        else if (e.Result.Reason == ResultReason.NoMatch)
                        {
                            Console.WriteLine($"NOMATCH: Speech could not be recognized.");
                        }
                    };

                    recognizer.Canceled += (s, e) =>
                    {
                        Console.WriteLine($"CANCELED: Reason={e.Reason}");
                        if (e.Reason == CancellationReason.Error)
                        {
                            Exception exp = new Exception(string.Format("Error Code: {0}\nError Details{1}\nIs your subscription information updated?", e.ErrorCode, e.ErrorDetails));
                            throw exp;
                        }

                        stopRecognition.TrySetResult(0);
                    };

                    recognizer.SessionStarted += (s, e) =>
                    {
                        Console.WriteLine("\n    Session started event.");
                    };

                    recognizer.SessionStopped += (s, e) =>
                    {
                        Console.WriteLine("\n    Session stopped event.");
                        Console.WriteLine("\nStop recognition.");
                        stopRecognition.TrySetResult(0);
                    };

                    // Starts continuous recognition. Uses StopContinuousRecognitionAsync() to stop recognition.
                    await recognizer.StartContinuousRecognitionAsync().ConfigureAwait(false);

                    // Waits for completion.
                    // Use Task.WaitAny to keep the task rooted.
                    Task.WaitAny(new[] { stopRecognition.Task });

                    // Stops recognition.
                    await recognizer.StopContinuousRecognitionAsync().ConfigureAwait(false);
                }
            }
        }

        public static void Main(string[] args)
        {
            var arguments = new Dictionary<string, string>();
            string inputArgNamePattern = "--";
            Regex regex = new Regex(inputArgNamePattern);
            if (args.Length > 0)
            {
                foreach (var arg in args)
                {
                    var userArgs = arg.Split("=");
                    arguments[regex.Replace(userArgs[0], string.Empty)] = userArgs[1];
                }
            }

            var endpointString = arguments.GetValueOrDefault(EndpointUriArgName, $"wss://westus.online.princeton.customspeech.ai/msgraphcustomspeech/conversation/v1");
            var endpointUri = new Uri(endpointString);

            if (!arguments.ContainsKey(SubscriptionKeyArgName))
            {
                Exception exp = new Exception("Subscription Key missing! Please pass in a Cognitive services subscription Key using --SubscriptionKey=\"your_subscription_key\"" +
                    "Find more information on creating a Cognitive services resource and accessing your Subscription key here: https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows");
                throw exp;
            }

            var subscriptionKey = arguments[SubscriptionKeyArgName];
            var username = arguments.GetValueOrDefault(UsernameArgName, null);
            var password = arguments.GetValueOrDefault(PasswordArgName, null);

            var audioDirPath = Path.Combine(Path.GetDirectoryName(System.Reflection.Assembly.GetExecutingAssembly().Location), "../../../AudioSamples/DictationBatman.wav");
            if (!File.Exists(audioDirPath))
            {
                Exception exp = new Exception(string.Format("Audio File does not exist at path: {0}", audioDirPath));
                throw exp;
            }

            ContinuousRecognitionWithTenantLMAsync(endpointUri, subscriptionKey, audioDirPath, username, password).GetAwaiter().GetResult();
        }

        private static async Task<string> AcquireAuthTokenWithUsernamePasswordAsync(string username, string password)
        {
            var tokenEndpoint = "https://login.microsoftonline.com/common/oauth2/token";
            var postBody = $"resource={ServiceApplicationId}&client_id={ClientApplicationId}&grant_type=password&username={username}&password={password}";
            var stringContent = new StringContent(postBody, Encoding.UTF8, "application/x-www-form-urlencoded");
            using (HttpClient httpClient = new HttpClient())
            {
                var response = await httpClient.PostAsync(tokenEndpoint, stringContent).ConfigureAwait(false);

                if (response.IsSuccessStatusCode)
                {
                    var result = await response.Content.ReadAsStringAsync().ConfigureAwait(false);

                    JObject jobject = JObject.Parse(result);
                    return jobject["access_token"].Value<string>();
                }
                else
                {
                    throw new Exception($"Requesting token from {tokenEndpoint} failed with status code {response.StatusCode}: {await response.Content.ReadAsStringAsync().ConfigureAwait(false)}");
                }
            }
        }

        private static async Task<string> AcquireAuthTokenWithInteractiveLoginAsync()
        {
            var authContext = new AuthenticationContext("https://login.windows.net/microsoft.onmicrosoft.com");
            var deviceCodeResult = await authContext.AcquireDeviceCodeAsync(ServiceApplicationId, ClientApplicationId).ConfigureAwait(false);

            Console.WriteLine(deviceCodeResult.Message);

            var authResult = await authContext.AcquireTokenByDeviceCodeAsync(deviceCodeResult).ConfigureAwait(false);

            return authResult.AccessToken;
        }
    }
}

Dále je nutné znovu sestavit a spustit projekt z příkazového řádku. Před spuštěním příkazu aktualizujte několik parametrů provedením následujícího postupu:

1. <Username>Hodnoty a nahraďte <Password> platným uživatelem tenanta.

2. Nahraďte <Subscription-Key> klíčem předplatného pro váš prostředek řeči. Tato hodnota je k dispozici v části Přehled prostředku rozpoznávání řeči v Azure Portal.

3. Nahraďte <Endpoint-Uri> následujícím koncovým bodem. Ujistěte se, že jste nahradili {your region} oblast, ve které byl prostředek řeči vytvořen. Tyto oblasti jsou podporované: westus , westus2 a eastus . Informace o vaší oblasti jsou k dispozici v části Přehled prostředku rozpoznávání řeči v Azure Portal.

   "wss://{your region}.online.princeton.customspeech.ai/msgraphcustomspeech/conversation/v1".
   

4. Spusťte následující příkaz:

   dotnet TenantLMSample.dll --Username=<Username> --Password=<Password> --SubscriptionKey=<Subscription-Key> --EndpointUri=<Endpoint-Uri>
   

v tomto kurzu jste se naučili, jak pomocí Microsoft 365ch dat vytvořit vlastní model rozpoznávání řeči, nasadit ho a použít ho v sadě speech SDK.

Další kroky

• Speech Studio
• Speech SDK