Distribuzione di query per stime finalità

Dopo aver aggiunto correttamente la distribuzione, è possibile eseguire query sulla distribuzione per stime di finalità ed entità dall'espressione in base al modello assegnato alla distribuzione. È possibile eseguire query sull'API di stima a livello di codice 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. Dal menu in alto selezionare Esegui il test.

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

   

---

Inviare una richiesta del flusso di lavoro di orchestrazione

Language Studio

1. Al termine del processo di distribuzione, selezionare la distribuzione che si vuole usare e dal menu in alto selezionare Recupera URL stima.

   

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 da cui si desidera inviare l'estrazione di finalità ed entità.

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

API REST

Prima di tutto sarà necessario ottenere la chiave di risorsa e l'endpoint:

Passare alla pagina panoramica della risorsa nella portale di Azure. Dal menu a sinistra selezionare Chiavi ed Endpoint. Si userà 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 avviare il test di un modello di flusso di lavoro di orchestrazione.

URL richiesta

{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}	Versione dell'API che si sta chiamando.	2023-04-01

Intestazioni

Usare l'intestazione seguente per autenticare la richiesta.

Chiave	Valore
Ocp-Apim-Subscription-Key	Chiave della risorsa. Usato per autenticare le 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"
        }
      }
    }
  }
}

Corpo 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 sarà necessario ottenere la chiave di risorsa e l'endpoint:

Passare alla pagina panoramica della risorsa nella portale di Azure. Dal menu a sinistra selezionare Chiavi ed Endpoint. Si userà 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. Passare alla pagina di panoramica delle risorse nella portale di Azure

2. Dal menu a sinistra selezionare Chiavi ed Endpoint. Usare l'endpoint per le richieste API e sarà necessaria la chiave per Ocp-Apim-Subscription-Key l'intestazione.

   

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

   Linguaggio	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