Skicka förutsägelsebegäranden till en distribution

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 köra frågor mot distributionen programmatiskt via 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.

Så här testar du dina distribuerade modeller från Language Studio:

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

2. För flerspråkiga projekt går du till listrutan Välj textspråk och väljer språket för det yttrande som du testar.

3. I listrutan Distributionsnamn väljer du det distributionsnamn som motsvarar den modell som du vill testa. Du kan bara testa modeller som har tilldelats distributioner.

4. I textrutan anger du ett yttrande som ska testas. Om du till exempel har skapat ett program för e-postrelaterade yttranden kan du ange Ta bort det här e-postmeddelandet.

5. Längst upp på sidan väljer du Kör testet.

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 förfrågan om att förstå konversationsspråk

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.

3. Ersätt <YOUR_QUERY_HERE> med den faktiska text som du vill skicka för att extrahera avsikter och entiteter från.

4. 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 modell för förståelse av konversationsspråk.

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": {
      "id": "1",
      "participantId": "1",
      "text": "Text 1"
    }
  },
  "parameters": {
    "projectName": "{PROJECT-NAME}",
    "deploymentName": "{DEPLOYMENT-NAME}",
    "stringIndexType": "TextElement_V8"
  }
}

Nyckel	Platshållare	Värde	Exempel
participantId	{JOB-NAME}		"MyJobName
id	{JOB-NAME}		"MyJobName
text	{TEST-UTTERANCE}	Yttrandet som du vill förutsäga dess avsikt och extrahera entiteter från.	"Read Matt's email
projectName	{PROJECT-NAME}	Namnet på projektet. Det här värdet är skiftlägeskänsligt.	myProject
deploymentName	{DEPLOYMENT-NAME}	Namnet på distributionen. Det här värdet är skiftlägeskänsligt.	staging

När du skickar begäran får du följande svar för förutsägelsen

Själva svaret

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

Nyckel	Exempelvärde	beskrivning
query	"Läs Matts e-post"	texten som du skickade för frågan.
topIntent	"Läs"	Den förutsagda avsikten med högsta konfidenspoäng.
Avseenden	[]	En lista över alla avsikter som förutsagts för frågetexten var och en av dem med en konfidenspoäng.
entiteter	[]	matris som innehåller en lista över extraherade entiteter från frågetexten.

API-svar för ett konversationsprojekt

I ett konversationsprojekt får du förutsägelser för både dina avsikter och entiteter som finns i projektet.

• Avsikterna och entiteterna innehåller en konfidenspoäng mellan 0,0 och 1,0 som är associerade med hur säker modellen är på att förutsäga ett visst element i projektet.
• Avsikten med högsta poäng finns i den egna parametern.
• Endast förutsagda entiteter visas i ditt svar.
• Entiteter anger:
  • Texten för entiteten som extraherades
  • Startplatsen anges med ett förskjutningsvärde
  • Längden på entitetstexten som anges med ett längdvärde.

Klientbibliotek (Azure SDK)

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 förståelse av konversationsspråk