Inviare richieste di classificazione del testo al modello

Dopo aver distribuito correttamente un modello, è possibile eseguire una query sulla distribuzione per classificare il testo in base al modello assegnato alla distribuzione. È possibile eseguire query sull'API stima a livello di codice o tramite le librerie client (Azure SDK).

Testare il modello distribuito

È possibile usare Language Studio per inviare l'attività di classificazione del testo personalizzata e visualizzare i risultati.

Per testare i modelli distribuiti da Language Studio:

1. Selezionare Test delle distribuzioni dal menu a sinistra.

2. Selezionare la distribuzione da testare. È possibile testare solo i modelli assegnati alle distribuzioni.

3. Per i progetti multilingue, nell'elenco a discesa lingua selezionare la lingua del testo di cui si esegue il test.

4. Selezionare la distribuzione da eseguire query/test dall'elenco a discesa.

5. È possibile immettere il testo da inviare alla richiesta o caricare un .txt file da usare.

6. Selezionare Esegui il test dal menu in alto.

7. Nella scheda Risultato è possibile visualizzare le entità estratte dal testo e dai relativi tipi. È anche possibile visualizzare la risposta JSON nella scheda JSON .

Inviare una richiesta di classificazione del testo al modello

Suggerimento

È possibile testare il modello in Language Studio inviando testo di esempio per classificarlo.

Language Studio

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

   

2. Nella finestra visualizzata, sotto il pivot Invia , copiare l'URL e il corpo della richiesta di esempio. Sostituire i valori segnaposto, YOUR_DOCUMENT_HERE ad esempio e YOUR_DOCUMENT_LANGUAGE_HERE con il testo e la lingua effettivi da elaborare.

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

4. Nell'intestazione della risposta che si riceve l'estrazione {JOB-ID} da operation-location, che ha il formato : {ENDPOINT}/language/analyze-text/jobs/<JOB-ID}>

5. Torna a Language Studio; selezionare Recupera pivot dalla stessa finestra ottenuta la richiesta di esempio ottenuta in precedenza e copiare la richiesta di esempio in un editor di testo.

6. Aggiungere l'ID processo dopo /jobs/ all'URL usando l'ID estratto dal passaggio precedente.

7. Inviare la GET richiesta cURL nel terminale o nel prompt dei comandi.

REST API

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

1. Passare alla pagina di panoramica delle risorse nel portale di Azure

2. Dal menu a sinistra selezionare Chiavi ed Endpoint. Si useranno l'endpoint e la chiave per le richieste API

   

Inviare un'attività di classificazione del testo personalizzata

Usare questa richiesta POST per avviare un'attività di classificazione del testo.

{ENDPOINT}/language/analyze-text/jobs?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. Il valore a cui viene fatto riferimento è relativo alla versione più recente rilasciata. Per altre informazioni sulle altre versioni dell'API disponibili, vedere Ciclo di vita del modello .	2022-05-01

Intestazioni

Chiave	Valore
Ocp-Apim-Subscription-Key	La chiave che fornisce l'accesso a questa API.

Corpo

Classificazione con più etichette

{
  "displayName": "Classifying documents",
  "analysisInput": {
    "documents": [
      {
        "id": "1",
        "language": "{LANGUAGE-CODE}",
        "text": "Text1"
      },
      {
        "id": "2",
        "language": "{LANGUAGE-CODE}",
        "text": "Text2"
      }
    ]
  },
  "tasks": [
     {
      "kind": "CustomMultiLabelClassification",
      "taskName": "Multi Label Classification",
      "parameters": {
        "projectName": "{PROJECT-NAME}",
        "deploymentName": "{DEPLOYMENT-NAME}"
      }
    }
  ]
}

Chiave	Segnaposto	Valore	Esempio
displayName	{JOB-NAME}	Nome del processo.	MyJobName
documents	[{},{}]	Elenco di documenti su cui eseguire attività.	[{},{}]
id	{DOC-ID}	Nome o ID del documento.	doc1
language	{LANGUAGE-CODE}	Stringa che specifica il codice della lingua per il documento. Se questa chiave non viene specificata, il servizio presuppone la lingua predefinita del progetto selezionato durante la creazione del progetto. Per un elenco dei codici linguistici supportati, vedere Supporto per la lingua .	en-us
text	{DOC-TEXT}	Attività documento in cui eseguire le attività.	Lorem ipsum dolor sit amet
tasks		Elenco di attività da eseguire.	[]
taskName	CustomMultiLabelClassification	Nome dell'attività	CustomMultiLabelClassification
parameters		Elenco di parametri da passare all'attività.
project-name	{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	myProject
deployment-name	{DEPLOYMENT-NAME}	Nome della distribuzione. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	prod

Classificazione con etichetta singola

{
  "displayName": "Classifying documents",
  "analysisInput": {
    "documents": [
      {
        "id": "1",
        "language": "{LANGUAGE-CODE}",
        "text": "Text1"
      },
      {
        "id": "2",
        "language": "{LANGUAGE-CODE}",
        "text": "Text2"
      }
    ]
  },
  "tasks": [
    {
      "kind": "CustomSingleLabelClassification",
      "taskName": "Single Classification Label",
      "parameters": {
        "projectName": "{PROJECT-NAME}",
        "deploymentName": "{DEPLOYMENT-NAME}"
      }
    }
  ]
}

Chiave	Segnaposto	Valore	Esempio
displayName	{JOB-NAME}	Nome del processo.	MyJobName
documenti		Elenco di documenti su cui eseguire attività.
id	{DOC-ID}	Nome o ID del documento.	doc1
language	{LANGUAGE-CODE}	Stringa che specifica il codice della lingua per il documento. Se questa chiave non viene specificata, il servizio presuppone la lingua predefinita del progetto selezionato durante la creazione del progetto. Per un elenco dei codici linguistici supportati, vedere Supporto per la lingua .	en-us
text	{DOC-TEXT}	Attività documento in cui eseguire le attività.	Lorem ipsum dolor sit amet
taskName	CustomSingleLabelClassification	Nome dell'attività	CustomSingleLabelClassification
tasks	[]	Matrice di attività da eseguire.	[]
parameters		Elenco di parametri da passare all'attività.
project-name	{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	myProject
deployment-name	{DEPLOYMENT-NAME}	Nome della distribuzione. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	prod

Risposta

Si riceverà una risposta 202 che indica l'esito positivo. Nelle intestazioni di risposta estrarre operation-location. operation-location è formattato come segue:

{ENDPOINT}/language/analyze-text/jobs/{JOB-ID}?api-version={API-VERSION}

È possibile usare questo URL per eseguire una query sullo stato di completamento dell'attività e ottenere i risultati al termine dell'attività.

Ottenere i risultati delle attività

Usare la richiesta GET seguente per eseguire una query sullo stato o sui risultati dell'attività di classificazione del testo.

{ENDPOINT}/language/analyze-text/jobs/{JOB-ID}?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. Il valore a cui viene fatto riferimento è per la versione più recente del modello rilasciato.	2022-05-01

Intestazioni

Chiave	Valore
Ocp-Apim-Subscription-Key	La chiave che fornisce l'accesso a questa API.

Corpo della risposta

La risposta sarà un documento JSON con i parametri seguenti.

Classificazione con più etichette

{
  "createdDateTime": "2021-05-19T14:32:25.578Z",
  "displayName": "MyJobName",
  "expirationDateTime": "2021-05-19T14:32:25.578Z",
  "jobId": "xxxx-xxxxxx-xxxxx-xxxx",
  "lastUpdateDateTime": "2021-05-19T14:32:25.578Z",
  "status": "succeeded",
  "tasks": {
    "completed": 1,
    "failed": 0,
    "inProgress": 0,
    "total": 1,
    "items": [
      {
        "kind": "customMultiClassificationTasks",
        "taskName": "Classify documents",
        "lastUpdateDateTime": "2020-10-01T15:01:03Z",
        "status": "succeeded",
        "results": {
          "documents": [
            {
              "id": "{DOC-ID}",
              "classes": [
                  {
                      "category": "Class_1",
                      "confidenceScore": 0.0551877357
                  }
              ],
              "warnings": []
            }
          ],
          "errors": [],
          "modelVersion": "2020-04-01"
        }
      }
    ]
  }
}

Classificazione con etichetta singola

{
  "createdDateTime": "2021-05-19T14:32:25.578Z",
  "displayName": "MyJobName",
  "expirationDateTime": "2021-05-19T14:32:25.578Z",
  "jobId": "xxxx-xxxxxx-xxxxx-xxxx",
  "lastUpdateDateTime": "2021-05-19T14:32:25.578Z",
  "status": "succeeded",
  "tasks": {
    "completed": 1,
    "failed": 0,
    "inProgress": 0,
    "total": 1,
    "items": [
      {
        "kind": "customSingleClassificationTasks",
        "taskName": "Classify documents",
        "lastUpdateDateTime": "2020-10-01T15:01:03Z",
        "status": "succeeded",
        "results": {
          "documents": [
            {
              "id": "{DOC-ID}",
              "class": [
                  {
                      "category": "Class_1",
                      "confidenceScore": 0.0551877357
                  }
              ],
              "warnings": []
            }
          ],
          "errors": [],
          "modelVersion": "2020-04-01"
        }
      }
    ]
  }
}

Librerie client (Azure SDK)

Per prima cosa è necessario ottenere la chiave e l'endpoint della risorsa:

• Passare alla pagina di panoramica delle risorse nel portale di Azure

• Dal menu a sinistra selezionare Chiavi ed Endpoint. Si useranno l'endpoint e la chiave per le richieste API

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

   Linguaggio	Versione pacchetto
   .NET	5.2.0-beta.3
   Java	5.2.0-beta.3
   JavaScript	6.0.0-beta.1
   Python	5.2.0b4

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

   Classificazione con etichetta singola:

   • C#
   • Java
   • JavaScript
   • Python

   Classificazione con più etichette:

   • C#
   • Java
   • JavaScript
   • Python

5. Per altre informazioni sul client e sull'oggetto restituito, vedere la documentazione di riferimento seguente:

   • C#
   • Java
   • JavaScript
   • Python

Passaggi successivi

• Panoramica della classificazione del testo personalizzata