Déploiement de requêtes pour les prédictions d’intention

Une fois le déploiement ajouté, vous pouvez l’interroger afin de déterminer les prédictions de l’intention et des entités à partir de votre énoncé en fonction du modèle que vous avez affecté au déploiement. Vous pouvez interroger le déploiement par programmation à l’aide de l’API de prédiction ou via les bibliothèques clientes (SDK Azure).

Tester un modèle déployé

Vous pouvez utiliser Language Studio pour envoyer un énoncé, obtenir des prédictions et visualiser les résultats.

Pour tester votre modèle à partir de Language Studio

1. Sélectionnez Test des déploiements dans le menu de gauche.

2. Sélectionnez le modèle à tester. Vous pouvez uniquement tester les modèles qui sont attribués aux déploiements.

3. Dans la liste déroulante nom du déploiement, sélectionnez le nom de votre déploiement.

4. Dans la zone de texte, entrez un énoncé à tester.

5. Dans le menu supérieur, sélectionnez Exécuter le test.

6. Après avoir exécuté le test, vous devriez voir la réponse du modèle dans le résultat. Vous pouvez afficher les résultats en mode cartes d’entités ou au format JSON.

   

---

Envoyer une demande de flux de travail d’orchestration

Language Studio

1. Une fois la tâche de déploiement correctement effectuée, sélectionnez le déploiement à utiliser et, dans le menu supérieur, sélectionnez l’URL de prédiction Get.

   

2. Dans la fenêtre qui s’affiche, collez l’exemple d’URL de requête et de corps sur votre ligne de commande. Remplacez <YOUR_QUERY_HERE> par le texte duquel vous souhaitez envoyer et extraire des intentions et des entités.

3. Envoyez la demande POST cURL dans votre terminal ou invite de commandes. Si la demande a réussi, vous recevez une réponse 202 avec les résultats de l’API.

API REST

Tout d’abord, vous devez disposer de votre point de terminaison et de votre clé de ressource :

Accédez à la page de présentation de votre ressource sur le Portail Azure. Dans le menu de gauche, sélectionnez Clés et point de terminaison. Le point de terminaison et la clé servent pour les demandes d’API.

Interroger votre modèle

Créez une demande POST en utilisant l’URL, les en-têtes et le corps JSON suivants pour commencer le test d’un modèle de flux de travail d’orchestration.

URL de la demande

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

Espace réservé	Valeur	Exemple
{ENDPOINT}	Point de terminaison pour l’authentification de votre demande d’API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	La version de l’API que vous appelez.	2023-04-01

headers

Utilisez l’en-tête suivant pour authentifier votre demande.

Clé	Valeur
Ocp-Apim-Subscription-Key	Clé de votre ressource. Utilisée pour authentifier vos demandes d’API.

Corps de la demande

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

Corps de la réponse

Une fois que vous avez envoyé la demande, vous recevez la réponse suivante comme prédiction.

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

Bibliothèques clientes (SDK Azure)

Tout d’abord, vous devez disposer de votre point de terminaison et de votre clé de ressource :

Accédez à la page de présentation de votre ressource sur le Portail Azure. Dans le menu de gauche, sélectionnez Clés et point de terminaison. Le point de terminaison et la clé servent pour les demandes d’API.

Utiliser des bibliothèques de client (Kit de développement logiciel [SDK] Azure)

Vous pouvez également utiliser les bibliothèques de client fournies par le SDK Azure pour envoyer des requêtes à votre modèle.

Notes

La bibliothèque de client pour la compréhension du langage courant est disponible uniquement pour les langages suivants :

• .NET
• Python

1. Accédez à la page de vue d’ensemble de votre ressource dans le portail Azure

2. Dans le menu de gauche, sélectionnez Clés et point de terminaison. Utilisez le point de terminaison pour les demandes d’API et la clé pour l’en-tête Ocp-Apim-Subscription-Key.

   

3. Téléchargez et installez le package de bibliothèque de clients pour le langage de votre choix :

   Langage	Version du package
   .NET	1.0.0
   Python	1.0.0

4. Une fois que vous avez installé la bibliothèque cliente, utilisez les exemples suivants sur GitHub pour démarrer l’appel de l’API.

   • C#
   • Python

5. Pour plus d’informations, consultez la documentation de référence ci-dessous :

   • C#
   • Python

Étapes suivantes

• Vue d’ensemble du flux de travail d’orchestration