Nasazení dotazů na predikce záměru

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í. Rozhraní API pro predikce nasazení můžete dotazovat prostřednictvím kódu programu 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 ze sady Language Studio

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

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

3. V rozevíracím seznamu s názvem nasazení vyberte název 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 je zobrazit ve formátu JSON.

   

---

Odeslání žádosti o pracovní postup 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 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. 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 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 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, 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": {
      "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:

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

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