Distribuzione di query per le stime della finalità

1. Al termine del processo di distribuzione, selezionare la distribuzione da usare e nel menu in alto selezionare Ottieni URL di previsione.

   

2. Nella finestra visualizzata copiare l'URL della richiesta di esempio e il corpo nella riga di comando. Sostituire <YOUR_QUERY_HERE> con il testo effettivo che si desidera inviare per estrarre finalità ed entità.

3. Inviare la richiesta cURL POST nel terminale o nel prompt dei comandi. Se la richiesta ha esito positivo, si riceverà una risposta 202 con i risultati dell'API.

Prima di tutto, è necessario ottenere la chiave e l'endpoint della risorsa:

Accedere alla pagina di panoramica della risorsa nel portale di Azure. Nel menu a sinistra scegliere Chiavi ed endpoint. Sarà necessario usare l'endpoint e la chiave per le richieste API.

Eseguire query sul modello

Creare una richiesta POST usando l'URL, le intestazioni e il corpo JSON seguenti per iniziare a sottoporre a test un modello del flusso di lavoro di orchestrazione.

Richiesta URL

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

Intestazioni

Usare l'intestazione seguente per autenticare la richiesta.

Corpo della richiesta

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

Testo della risposta

Dopo aver inviato la richiesta, si otterrà la risposta seguente per la stima.

{
  "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://video2.skills-academy.com/azure/app-service/overview",
                "metadata": {},
                "dialog": {
                  "isContextOnly": false,
                  "prompts": []
                }
              }
            ]
          }
        }
      }
    }
  }
}

Prima di tutto, è necessario ottenere la chiave e l'endpoint della risorsa:

Accedere alla pagina di panoramica della risorsa nel portale di Azure. Nel menu a sinistra scegliere Chiavi ed endpoint. Sarà necessario usare l'endpoint e la chiave per le richieste API.

Usare le librerie client (Azure SDK)

È anche possibile usare le librerie client fornite da Azure SDK per inviare richieste al modello.

1. Accedere alla pagina di panoramica della risorsa nel portale di Azure

2. Nel menu sul lato sinistro, scegliere Chiavi ed endpoint. Usare l'endpoint per le richieste API e sarà necessaria la chiave per l'intestazione Ocp-Apim-Subscription-Key.

   

3. Scaricare e installare il pacchetto della libreria client per la lingua preferita:

   Lingua	Versione pacchetto
   .NET	1.0.0
   Python	1.0.0

4. Dopo aver installato la libreria client, usare gli esempi seguenti in GitHub per iniziare a chiamare l'API.

   • C#
   • Python

5. Per altre informazioni, vedere la documentazione di riferimento seguente:

   • C#
   • Python