Nasazení dotazů pro predikce záměru

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. Do nasazení se můžete dotazovat prostřednictvím kódu programu prediktivního rozhraní API 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í modelu z nástroje Language Studio

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

2. Vyberte model, který chcete otestovat. Můžete testovat pouze modely, které jsou přiřazené k nasazením.

3. V rozevíracím seznamu názvu nasazení vyberte název vašeho nasazení.

4. Do textového pole zadejte promluvu, která se má otestovat.

5. V horní nabídce 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 ve formátu JSON.

   

---

Odeslání požadavku pracovního postupu orchestrace

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. Nahraďte <YOUR_QUERY_HERE> skutečným textem, ze kterého chcete extrahovat záměry a entity.

3. 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 model pracovního postupu orchestrace.

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": {
      "text": "Text1",
      "participantId": "1",
      "id": "1"
    }
  },
  "parameters": {
    "projectName": "{PROJECT-NAME}",
    "deploymentName": "{DEPLOYMENT-NAME}",
    "directTarget": "qnaProject",
    "targetProjectParameters": {
      "qnaProject": {
        "targetProjectKind": "QuestionAnswering",
        "callingOptions": {
          "context": {
            "previousUserQuery": "Meet Surface Pro 4",
            "previousQnaId": 4
          },
          "top": 1,
          "question": "App Service overview"
        }
      }
    }
  }
}

Text odpovědi

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

{
  "kind": "ConversationResult",
  "result": {
    "query": "App Service overview",
    "prediction": {
      "projectKind": "Orchestration",
      "topIntent": "qnaTargetApp",
      "intents": {
        "qnaTargetApp": {
          "targetProjectKind": "QuestionAnswering",
          "confidenceScore": 1,
          "result": {
            "answers": [
              {
                "questions": [
                  "App Service overview"
                ],
                "answer": "The compute resources you use are determined by the *App Service plan* that you run your apps on.",
                "confidenceScore": 0.7384000000000001,
                "id": 1,
                "source": "https://learn.microsoft.com/azure/app-service/overview",
                "metadata": {},
                "dialog": {
                  "isContextOnly": false,
                  "prompts": []
                }
              }
            ]
          }
        }
      }
    }
  }
}

Klientské knihovny (Azure SDK)

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íč.

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 pracovního postupu orchestrace