Distribuzione di query per le stime della finalità

Dopo aver aggiunto correttamente la distribuzione, è possibile eseguire una query sulla distribuzione per ottenere le stime di finalità ed entità dall'espressione in base al modello assegnato alla distribuzione. È possibile eseguire query sulla distribuzione a livello di programmazione tramite l'API di stima o tramite le librerie client (Azure SDK).

Testare il modello distribuito

È possibile usare Language Studio per inviare un'espressione, ottenere stime e visualizzare i risultati.

Per testare il modello da Language Studio

1. Selezionare Test delle distribuzioni dal menu a sinistra.

2. Selezionare il modello da testare. È possibile testare solo i modelli assegnati alle distribuzioni.

3. Nell'elenco a discesa Nome distribuzione selezionare il nome della distribuzione.

4. Nella casella di testo immettere un'espressione da testare.

5. Nel menu in alto, selezionare Esegui il test.

6. Dopo aver eseguito il test, nel risultato dovrebbe essere visualizzata la risposta del modello. È possibile visualizzare i risultati nella visualizzazione schede delle entità o visualizzarlo in formato JSON.

   

---

Inviare una richiesta del flusso di lavoro di orchestrazione

Language Studio

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.

API REST

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}

Segnaposto	Valore	Esempio
{ENDPOINT}	Endpoint per l'autenticazione della richiesta API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	La versione dell'API che viene richiamata.	2023-04-01

Intestazioni

Usare l'intestazione seguente per autenticare la richiesta.

Chiave	valore
Ocp-Apim-Subscription-Key	La chiave della risorsa. È usata per l’autenticazione delle richieste API.

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

Librerie client (Azure SDK)

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.

Nota

La libreria client per la comprensione del linguaggio di conversazione è disponibile solo per:

• .NET
• Python

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

Passaggi successivi

• Panoramica del flusso di lavoro di orchestrazione