Inviare richieste di classificazione del testo al modello

Articolo
10/16/2024

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 sulla distribuzione a livello di programmazione tramite l'API di stima o tramite le librerie client (Azure SDK).

Testare un modello distribuito

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

Per testare i modelli distribuiti in Language Studio:

Selezionare Test delle distribuzioni dal menu a sinistra.
Selezionare la distribuzione da testare. È possibile testare solo i modelli assegnati alle distribuzioni.
Per i progetti multilingue, nell'elenco a discesa lingua selezionare la lingua del testo di cui si esegue il test.
Selezionare dall'elenco a discesa la distribuzione di cui si intende eseguire la query/il test.
È possibile immettere il testo da inviare alla richiesta o caricare un file .txt da usare.
Selezionare Esegui il test dal menu in alto.
Nella scheda Risultato, è possibile visualizzare le entità estratte dal testo e i relativi tipi. È anche possibile visualizzare la risposta JSON nella scheda JSON.

Inviare una richiesta di classificazione del testo a un modello

Suggerimento

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

Al termine del processo di distribuzione, selezionare la distribuzione da usare e nel menu in alto selezionare Ottieni URL di stima.
Nella finestra visualizzata, sotto al pivot Invia, copiare l'URL e il corpo della richiesta di esempio. Sostituire i valori segnaposto, ad esempio YOUR_DOCUMENT_HERE e YOUR_DOCUMENT_LANGUAGE_HERE, con il testo e la lingua effettivi da elaborare.
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.
Nell'intestazione della risposta ricevuta, estrarre {JOB-ID} da operation-location, il cui formato è: {ENDPOINT}/language/analyze-text/jobs/<JOB-ID}>
Tornare a Language Studio; selezionare il pivot Recupera dalla stessa finestra in cui è stata ottenuta la richiesta di esempio ottenuta in precedenza e copiare la richiesta di esempio in un editor di testo.
Aggiungere l'ID del processo dopo /jobs/ all'URL usando l'ID estratto nel passaggio precedente.
Inviare la richiesta cURL GET nel terminale o nel prompt dei comandi.

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

Accedere alla pagina di panoramica della risorsa nel portale di Azure
Dal menu a sinistra selezionare Chiavi ed endpoint. L'endpoint e la chiave verranno usati per le richieste API

Inviare un’attività di classificazione personalizzata del testo

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}`	La versione dell'API che si sta chiamando. Il valore a cui si fa riferimento qui è 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 all’API.

{
  "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}`	Il nome del processo.	`MyJobName`
`documents`	[{},{}]	Elenco di documenti per cui eseguire le attività.	`[{},{}]`
`id`	`{DOC-ID}`	Nome o ID del documento.	`doc1`
`language`	`{LANGUAGE-CODE}`	Una stringa che specifica il codice lingua per il documento. Se questa chiave non è specificata, il servizio presuppone la lingua predefinita del progetto selezionata durante la creazione del progetto. Per un elenco dei codici lingua supportati, vedere Supporto lingua.	`en-us`
`text`	`{DOC-TEXT}`	Attività del documento per cui eseguire le attività.	`Lorem ipsum dolor sit amet`
`tasks`		Elenco di attività da eseguire.	`[]`
`taskName`	CustomMultiLabelClassification	Il 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}`	Il nome della distribuzione. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	`prod`

{
  "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}`	Il nome del processo.	`MyJobName`
documenti		Elenco di documenti per cui eseguire le attività.
`id`	`{DOC-ID}`	Nome o ID del documento.	`doc1`
`language`	`{LANGUAGE-CODE}`	Una stringa che specifica il codice lingua per il documento. Se questa chiave non è specificata, il servizio presuppone la lingua predefinita del progetto selezionata durante la creazione del progetto. Per un elenco dei codici lingua supportati, vedere Supporto lingua.	`en-us`
`text`	`{DOC-TEXT}`	Attività del documento per cui eseguire le attività.	`Lorem ipsum dolor sit amet`
`taskName`	CustomSingleLabelClassification	Il nome dell’attività	CustomSingleLabelClassification
`tasks`	[]	Array 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}`	Il nome della distribuzione. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	`prod`

Response

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

{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 dell’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}`	La versione dell'API che si sta richiamando. Il valore a cui fa riferimento qui è relativo all’ultima versione del modello rilasciata.	`2022-05-01`

Intestazioni

Chiave	valore
Ocp-Apim-Subscription-Key	La chiave che fornisce l'accesso all’API.

Corpo della risposta

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

Classificazione multietichetta
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": "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"
        }
      }
    ]
  }
}

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

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

Accedere alla pagina di panoramica della risorsa nel portale di Azure
Dal menu a sinistra selezionare Chiavi ed endpoint. Si useranno l'endpoint e la chiave per le richieste API

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

Lingua Versione pacchetto

.NET 5.2.0-beta.3

Java 5.2.0-beta.3

JavaScript 6.0.0-beta.1

Python 5.2.0b4
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 multietichetta:
- C#
- Java
- JavaScript
- Python
Per altre informazioni sul client e l’oggetto di ritorno, vedere la documentazione di riferimento seguente:
- C#
- Java
- JavaScript
- Python

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

Passaggi successivi

Panoramica sulla classificazione personalizzata del testo

Condividi tramite

Inviare richieste di classificazione del testo al modello

Testare un modello distribuito

Inviare una richiesta di classificazione del testo a un modello

Inviare un’attività di classificazione personalizzata del testo

Intestazioni

Corpo

Response

Ottenere i risultati dell’attività

Intestazioni

Corpo della risposta

Passaggi successivi

Commenti e suggerimenti

Risorse aggiuntive