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 till distributionen. Du kan fråga 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, få 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 den i JSON-format.

---

Skicka en begäran om förståelse för 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 exempelförfrågans 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 Portal. På menyn till vänster väljer du Nycklar och slutpunkt. Du kommer att använda 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 din resurs. 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}	Det yttrande 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	Description
query	"Läs Matts e-post"	den text som du skickade för frågan.
topIntent	"Läs"	Den förutsagda avsikten med högsta förtroendepoäng.
Avseenden	[]	En lista över alla avsikter som förutsagts för frågetexten var och en av dem med en förtroendepoäng.
Enheter	[]	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 förtroendepoä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ögst poäng finns i en egen parameter.
• Endast förutsagda entiteter visas i ditt svar.
• Entiteter anger:
  • Texten för entiteten som extraherades
  • Startplatsen som anges av ett förskjutningsvärde
  • Längden på entitetstexten som anges av 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.

Anteckning

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

• .NET
• Python

1. Gå till resursöversiktssidan i Azure Portal

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