Odeslání žádostí o predikce do nasazení

Po úspěšném přidání nasazení můžete dotazovat nasazení na predikce záměru a entit z promluvy na základě modelu, který jste přiřadili k nasazení. Nasazení můžete dotazovat programově prostřednictvím rozhraní API pro predikce nebo prostřednictvím klientských knihoven (Azure SDK).

Test nasazený model

Pomocí nástroje Language Studio můžete odeslat promluvu, získat předpovědi a vizualizovat výsledky.

Testování nasazených modelů v sadě Language Studio:

1. V nabídce na levé straně vyberte Testovací nasazení .

2. V případě vícejazyčných projektů v rozevíracím seznamu Vybrat jazyk textu vyberte jazyk promluvy, kterou testujete.

3. V rozevíracím seznamu Název nasazení vyberte název nasazení odpovídající modelu, který chcete testovat. Můžete testovat jenom modely, které jsou přiřazené k nasazením.

4. Do textového pole zadejte promluvu, která se má otestovat. Pokud jste například vytvořili aplikaci pro promluvy související s e-mailem, můžete zadat odstranit tento e-mail.

5. V horní části stránky vyberte Spustit test.

6. Po spuštění testu by se ve výsledku měla zobrazit odpověď modelu. Výsledky můžete zobrazit v zobrazení karet entit nebo je zobrazit ve formátu JSON.

---

Odeslání žádosti o porozumění konverzačnímu jazyku

Language Studio

1. Po úspěšném dokončení úlohy nasazení vyberte nasazení, které chcete použít, a v horní nabídce vyberte Získat adresu URL předpovědi.

   

2. V zobrazeném okně zkopírujte adresu URL a text ukázkového požadavku do příkazového řádku.

3. Nahraďte <YOUR_QUERY_HERE> skutečným textem, ze kterého chcete extrahovat záměry a entity.

4. POST Odešlete požadavek cURL v terminálu nebo příkazovém řádku. Pokud byl požadavek úspěšný, obdržíte odpověď 202 s výsledky rozhraní API.

Rozhraní REST API

Nejprve budete muset získat klíč prostředku a koncový bod:

Na webu Azure Portal přejděte na stránku přehledu prostředků. V nabídce na levé straně vyberte Klíče a koncový bod. Pro požadavky rozhraní API použijete koncový bod a klíč.

Dotazování modelu

Vytvořte požadavek POST pomocí následující adresy URL, hlaviček a textu JSON, abyste mohli začít testovat konverzační model pro porozumění jazyku.

Adresa URL požadavku

{ENDPOINT}/language/:analyze-conversations?api-version={API-VERSION}

Zástupný symbol	Hodnota	Příklad
{ENDPOINT}	Koncový bod pro ověření požadavku rozhraní API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	Verze rozhraní API, které voláte.	2023-04-01

Hlavičky

K ověření požadavku použijte následující hlavičku.

Key	Hodnota
Ocp-Apim-Subscription-Key	Klíč k vašemu prostředku. Používá se k ověřování požadavků rozhraní API.

Text požadavku

{
  "kind": "Conversation",
  "analysisInput": {
    "conversationItem": {
      "id": "1",
      "participantId": "1",
      "text": "Text 1"
    }
  },
  "parameters": {
    "projectName": "{PROJECT-NAME}",
    "deploymentName": "{DEPLOYMENT-NAME}",
    "stringIndexType": "TextElement_V8"
  }
}

Klíč	Zástupný symbol	Hodnota	Příklad
participantId	{JOB-NAME}		"MyJobName
id	{JOB-NAME}		"MyJobName
text	{TEST-UTTERANCE}	Promluva, ze které chcete předpovědět svůj záměr a extrahovat entity.	"Read Matt's email
projectName	{PROJECT-NAME}	Název projektu. U této hodnoty se rozlišují malá a velká písmena.	myProject
deploymentName	{DEPLOYMENT-NAME}	Název nasazení. U této hodnoty se rozlišují malá a velká písmena.	staging

Po odeslání požadavku získáte následující odpověď pro predikci.

Text odpovědi

{
  "kind": "ConversationResult",
  "result": {
    "query": "Text1",
    "prediction": {
      "topIntent": "inten1",
      "projectKind": "Conversation",
      "intents": [
        {
          "category": "intent1",
          "confidenceScore": 1
        },
        {
          "category": "intent2",
          "confidenceScore": 0
        },
        {
          "category": "intent3",
          "confidenceScore": 0
        }
      ],
      "entities": [
        {
          "category": "entity1",
          "text": "text1",
          "offset": 29,
          "length": 12,
          "confidenceScore": 1
        }
      ]
    }
  }
}

Klíč	Ukázková hodnota	Popis
query	"Přečtěte si Mattův e-mail"	text, který jste odeslali pro dotaz.
TopIntent	"Číst"	Predikovaný záměr s nejvyšším skóre spolehlivosti.
záměry	[]	Seznam všech záměrů, které byly předpovězeny pro text dotazu, každý z nich s skóre spolehlivosti.
entities	[]	pole obsahující seznam extrahovaných entit z textu dotazu.

Odpověď rozhraní API pro projekt konverzací

V projektu konverzací získáte předpovědi pro záměry i entity, které jsou přítomné v rámci projektu.

• Záměry a entity zahrnují skóre spolehlivosti od 0,0 do 1,0 přidružené k tomu, jak je model přesvědčený o předpovídání určitého prvku v projektu.
• Záměr nejvyššího bodování je obsažený ve vlastním parametru.
• V odpovědi se zobrazí jenom předpovězené entity.
• Entity označují:
  • Text extrahované entity
  • Počáteční umístění označené hodnotou posunu
  • Délka textu entity označeného hodnotou délky.

Klientské knihovny (Azure SDK)

Použití klientských knihoven (Azure SDK)

K odesílání požadavků do modelu můžete použít také klientské knihovny poskytované sadou Azure SDK.

Poznámka:

Klientská knihovna pro porozumění konverzačnímu jazyku je dostupná jenom pro:

• .NET
• Python

1. Na webu Azure Portal přejděte na stránku přehledu prostředků.

2. V nabídce na levé straně vyberte Klíče a koncový bod. Použijte koncový bod pro požadavky rozhraní API a budete potřebovat klíč pro Ocp-Apim-Subscription-Key hlavičku.

   

3. Stáhněte a nainstalujte balíček klientské knihovny pro jazyk podle vašeho výběru:

   Jazyk	Verze balíčku
   .NET	1.0.0
   Python	1.0.0

4. Po instalaci klientské knihovny pomocí následujících ukázek na GitHubu začněte volat rozhraní API.

   • C#
   • Python

5. Další informace najdete v následující referenční dokumentaci:

   • C#
   • Python

Další kroky

• Přehled porozumění konverzačnímu jazyku