Frågedistribution för avsiktsförutsägelser

När distributionen har lagts till kan du fråga distributionen efter avsikts- och entitetsförutsägelser från ditt yttrande baserat på den modell som du tilldelade distributionen. Du kan fråga distributionen programmatiskt förutsägelse-API:et eller via klientbiblioteken (Azure SDK).

Testa distribuerad modell

Du kan använda Language Studio för att skicka ett yttrande, hämta förutsägelser och visualisera resultaten.

Testa din modell från Language Studio

1. Välj Testa distributioner på menyn till vänster.

2. Välj den modell som du vill testa. Du kan bara testa modeller som har tilldelats distributioner.

3. I listrutan distributionsnamn väljer du ditt distributionsnamn.

4. I textrutan anger du ett yttrande som ska testas.

5. Välj Kör testet på den översta menyn.

6. När du har kört testet bör du se svaret från modellen i resultatet. Du kan visa resultatet i entitetskortvyn eller visa det i JSON-format.

   

---

Skicka en begäran om orkestreringsarbetsflöde

Language Studio

1. När distributionsjobbet har slutförts väljer du den distribution som du vill använda och på den översta menyn väljer du Hämta förutsägelse-URL.

   

2. I fönstret som visas kopierar du exempelbegärans URL och brödtext till kommandoraden. Ersätt <YOUR_QUERY_HERE> med den faktiska text som du vill skicka för att extrahera avsikter och entiteter från.

3. POST Skicka cURL-begäran i terminalen eller kommandotolken. Du får ett 202-svar med API-resultatet om begäran lyckades.

REST API:er

Först måste du hämta resursnyckeln och slutpunkten:

Gå till resursöversiktssidan i Azure-portalen. På menyn till vänster väljer du Nycklar och Slutpunkt. Du använder slutpunkten och nyckeln för API-begäranden.

Fråga din modell

Skapa en POST-begäran med hjälp av följande URL, rubriker och JSON-brödtext för att börja testa en arbetsflödesmodell för orkestrering.

Begärans-URL

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

Platshållare	Värde	Exempel
{ENDPOINT}	Slutpunkten för att autentisera din API-begäran.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	Den version av API:et som du anropar.	2023-04-01

Sidhuvuden

Använd följande rubrik för att autentisera din begäran.

Tangent	Värde
Ocp-Apim-Subscription-Key	Nyckeln till resursen. Används för att autentisera dina API-begäranden.

Begärandetext

{
  "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"
        }
      }
    }
  }
}

Svarstext

När du har skickat begäran får du följande svar för förutsägelsen!

{
  "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": []
                }
              }
            ]
          }
        }
      }
    }
  }
}

Klientbibliotek (Azure SDK)

Först måste du hämta resursnyckeln och slutpunkten:

Gå till resursöversiktssidan i Azure-portalen. På menyn till vänster väljer du Nycklar och Slutpunkt. Du använder slutpunkten och nyckeln för API-begäranden.

Använda klientbiblioteken (Azure SDK)

Du kan också använda klientbiblioteken som tillhandahålls av Azure SDK för att skicka begäranden till din modell.

Kommentar

Klientbiblioteket för förståelse av konversationsspråk är endast tillgängligt för:

• .NET
• Python

1. Gå till resursöversiktssidan i Azure-portalen

2. På menyn till vänster väljer du Nycklar och Slutpunkt. Använd slutpunkten för API-begäranden och du behöver nyckeln för Ocp-Apim-Subscription-Key huvudet.

   

3. Ladda ned och installera klientbibliotekspaketet för valfritt språk:

   Språk	Paketversion
   .NET	1.0.0
   Python	1.0.0

4. När du har installerat klientbiblioteket använder du följande exempel på GitHub för att börja anropa API:et.

   • C#
   • Python

5. Mer information finns i följande referensdokumentation:

   • C#
   • Python

Nästa steg

• Översikt över arbetsflöde för orkestrering