Odeslání požadavků na predikci do nasazení

Po úspěšném přidání nasazení se můžete dotázat nasazení na předpovědi záměru a entit z promluvy na základě modelu, který jste k nasazení přiřadili. Nasazení můžete dotazovat programově prostřednictvím rozhraní API pro predikce nebo 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 rámci sady Language Studio:

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

2. U vícejazyčných projektů vyberte z rozevíracího seznamu Vybrat jazyk textu 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 pouze 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 na kartách 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 prediktivní adresu URL.

   

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

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 do terminálu nebo příkazového řá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:

V 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 a začněte testovat konverzační model 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, kterou voláte.	2023-04-01

Hlavičky

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

Klíč	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 její záměr a extrahovat entity.	"Read Matt's email
projectName	{PROJECT-NAME}	Název projektu. V této hodnotě se rozlišují malá a velká písmena.	myProject
deploymentName	{DEPLOYMENT-NAME}	Název vašeho nasazení. V této hodnotě se rozlišují malá a velká písmena.	staging

Po odeslání požadavku získáte následující odpověď na 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	Description
query	"Read Matt's email" (Přečtěte si Mattův e-mail)	text, který jste odeslali k dotazu.
Hlavní část	"Číst"	Predikovaný záměr s nejvyšším skóre spolehlivosti.
Záměry	[]	Seznam všech záměrů, které byly predikovány pro text dotazu, každý z nich se skóre spolehlivosti.
Entity	[]	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 vaše záměry i entity, které se v projektu nacházejí.

• Záměry a entity zahrnují skóre spolehlivosti mezi 0,0 a 1,0 spojené s tím, jak je model sebevědomý při předpovídání určitého prvku ve vašem projektu.
• Záměr s nejvyšším skóre je obsažený ve svém vlastním parametru.
• V odpovědi se zobrazí pouze předpovězené entity.
• Entity označují:
  • Text extrahované entity
  • Jeho počáteční umístění označené hodnotou posunu
  • Délka textu entity označená hodnotou délky.

Klientské knihovny (Azure SDK)

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

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

Poznámka

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

• .NET
• Python

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

2. V nabídce na levé straně vyberte Klíče a koncový bod. Pro požadavky rozhraní API použijte koncový bod 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 použijte následující ukázky na GitHubu a 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