Inviare richieste di stima a una distribuzione

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 sulla distribuzione a livello di codice 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 i modelli distribuiti dall'interno di Language Studio:

1. Selezionare Test delle distribuzioni dal menu a sinistra.

2. Per i progetti multilingue, nell'elenco a discesa Seleziona lingua di testo selezionare la lingua dell'espressione testata.

3. Nell'elenco a discesa Nome distribuzione selezionare il nome della distribuzione corrispondente al modello da testare. È possibile testare solo i modelli assegnati alle distribuzioni.

4. Nella casella di testo immettere un'espressione da testare. Ad esempio, se è stata creata un'applicazione per espressioni correlate alla posta elettronica, è possibile immettere Elimina questo messaggio di posta elettronica.

5. Verso la parte superiore della pagina selezionare Esegui il test.

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

---

Inviare una richiesta di comprensione del linguaggio di conversazione

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.

3. Sostituire <YOUR_QUERY_HERE> con il testo effettivo da cui si desidera inviare l'estrazione di finalità ed entità.

4. 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 comprensione del linguaggio di conversazione.

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.

Testo della richiesta

{
  "kind": "Conversation",
  "analysisInput": {
    "conversationItem": {
      "id": "1",
      "participantId": "1",
      "text": "Text 1"
    }
  },
  "parameters": {
    "projectName": "{PROJECT-NAME}",
    "deploymentName": "{DEPLOYMENT-NAME}",
    "stringIndexType": "TextElement_V8"
  }
}

Chiave	Segnaposto	Valore	Esempio
participantId	{JOB-NAME}		"MyJobName
id	{JOB-NAME}		"MyJobName
text	{TEST-UTTERANCE}	Espressione da cui si vuole stimare la finalità ed estrarre entità.	"Read Matt's email
projectName	{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	myProject
deploymentName	{DEPLOYMENT-NAME}	Nome della distribuzione. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	staging

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

Corpo della risposta

{
  "kind": "ConversationResult",
  "result": {
    "query": "Text1",
    "prediction": {
      "topIntent": "inten1",
      "projectKind": "Conversation",
      "intents": [
        {
          "category": "intent1",
          "confidenceScore": 1
        },
        {
          "category": "intent2",
          "confidenceScore": 0
        },
        {
          "category": "intent3",
          "confidenceScore": 0
        }
      ],
      "entities": [
        {
          "category": "entity1",
          "text": "text1",
          "offset": 29,
          "length": 12,
          "confidenceScore": 1
        }
      ]
    }
  }
}

Chiave	Valore di esempio	Descrizione
query	"Leggere il messaggio di posta elettronica di Matt"	il testo inviato per la query.
topIntent	"Lettura"	Finalità stimata con punteggio di attendibilità più alto.
intents	[]	Elenco di tutte le finalità stimate per il testo della query ognuna di esse con un punteggio di attendibilità.
entities	[]	matrice contenente l'elenco di entità estratte dal testo della query.

Risposta API per un progetto di conversazioni

In un progetto di conversazioni si otterranno stime sia per le finalità che per le entità presenti all'interno del progetto.

• Le finalità e le entità includono un punteggio di attendibilità compreso tra 0,0 e 1.0 associato al modo in cui il modello prevede una stima di un determinato elemento nel progetto.
• La finalità di punteggio superiore è contenuta nel proprio parametro.
• Verranno visualizzate solo le entità stimate nella risposta.
• Le entità indicano:
  • Testo dell'entità estratta
  • Percorso iniziale denotato da un valore di offset
  • Lunghezza del testo dell'entità denotata da un valore di lunghezza.

Librerie client (Azure SDK)

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 della comprensione del linguaggio conversazionale