Lekérdezéstelepítés szándék-előrejelzésekhez

Az üzembe helyezés sikeres hozzáadása után lekérdezheti az üzembe helyezés szándék- és entitás-előrejelzéseit a kimondott szövegből az üzembe helyezéshez hozzárendelt modell alapján. Az üzembe helyezést programozott előrejelzési API-val vagy az ügyfélkódtárak (Azure SDK) használatával kérdezheti le.

Üzembe helyezett modell tesztelése

A Language Studióval kimondott szöveget küldhet be, előrejelzéseket kaphat, és megjelenítheti az eredményeket.

A modell tesztelése a Language Studióból

1. A bal oldali menüben válassza az Üzemelő példányok tesztelése lehetőséget.

2. Válassza ki a tesztelni kívánt modellt. Csak az üzemelő példányokhoz rendelt modelleket tesztelheti.

3. Az Üzembe helyezés neve legördülő listában válassza ki az üzembe helyezés nevét.

4. A szövegmezőbe írjon be egy tesztelni kívánt kimondott szöveget.

5. A felső menüben válassza a Teszt futtatása lehetőséget.

6. A teszt futtatása után látnia kell a modell válaszát az eredményben. Az eredményeket megtekintheti entitáskártyák nézetben vagy JSON formátumban.

   

---

Vezénylési munkafolyamat-kérelem küldése

Language Studio

1. Az üzembe helyezési feladat sikeres befejezése után válassza ki a használni kívánt üzemelő példányt, majd a felső menüben válassza az Előrejelzési URL-cím lekérése lehetőséget.

   

2. A megjelenő ablakban másolja a mintakérés URL-címét és törzsét a parancssorba. Cserélje le a elemet <YOUR_QUERY_HERE> arra a tényleges szövegre, amelyből szándékokat és entitásokat szeretne kinyerni.

3. Küldje el a POST cURL-kérést a terminálban vagy a parancssorban. Ha a kérés sikeres volt, 202-ben kap választ az API-eredményekre.

REST API-k

Először le kell kérnie az erőforráskulcsot és a végpontot:

Nyissa meg az erőforrás áttekintési lapját a Azure Portal. A bal oldali menüben válassza a Kulcsok és végpont lehetőséget. Az API-kérésekhez a végpontot és a kulcsot fogja használni.

A modell lekérdezése

Hozzon létre egy POST-kérést a következő URL-cím, fejlécek és JSON-törzs használatával egy vezénylési munkafolyamat-modell tesztelésének megkezdéséhez.

URL-cím kérése

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

Helyőrző	Érték	Példa
{ENDPOINT}	Az API-kérelem hitelesítésének végpontja.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	A hívott API verziója .	2023-04-01

Fejlécek

A kérés hitelesítéséhez használja az alábbi fejlécet.

Kulcs	Érték
Ocp-Apim-Subscription-Key	Az erőforrás kulcsa. Az API-kérések hitelesítésére szolgál.

Kérelem törzse

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

Válasz törzse

A kérés elküldése után a következő választ kapja az előrejelzéshez!

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

Ügyfélkódtárak (Azure SDK)

Először le kell kérnie az erőforráskulcsot és a végpontot:

Nyissa meg az erőforrás áttekintési lapját a Azure Portal. A bal oldali menüben válassza a Kulcsok és végpont lehetőséget. Az API-kérésekhez a végpontot és a kulcsot fogja használni.

Az ügyfélkódtárak (Azure SDK) használata

Az Azure SDK által biztosított ügyfélkódtárak használatával kéréseket küldhet a modellnek.

Megjegyzés

A beszélgetési nyelvfelismerés ügyfélkódtára csak a következő célokra érhető el:

• .NET
• Python

1. Nyissa meg az erőforrás áttekintési lapját a Azure Portal

2. A bal oldali menüben válassza a Kulcsok és végpont lehetőséget. Használja a végpontot az API-kérésekhez, és szüksége lesz a fejléc kulcsára Ocp-Apim-Subscription-Key .

   

3. Töltse le és telepítse az ügyféloldali kódtárcsomagot a választott nyelvhez:

   Nyelv	Csomag verziója
   .NET	1.0.0
   Python	1.0.0

4. Az ügyfélkódtár telepítése után használja az alábbi mintákat a GitHubon az API meghívásához.

   • C#
   • Python

5. További információért tekintse meg az alábbi referenciadokumentációt:

   • C#
   • Python

Következő lépések

• Vezénylési munkafolyamat áttekintése