Eseguire query sul modello personalizzato

Dopo aver aggiunto correttamente la distribuzione, è possibile eseguire una query sulla distribuzione per estrarre entità di testo dal 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 il modello distribuito

È possibile usare Language Studio per inviare l'attività di riconoscimento dell’entità personalizzata e visualizzare i risultati.

Per testare i modelli distribuiti in 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 dall'elenco a discesa la distribuzione di cui si intende eseguire la query/il test.

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

6. Selezionare Esegui il test dal menu in alto.

7. 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 riconoscimento delle entità al modello

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, 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.

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.

4. Nell'intestazione della risposta ricevuta, estrarre {JOB-ID} da operation-location, il cui formato è: {ENDPOINT}/language/analyze-text/jobs/<JOB-ID}>

5. 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.

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

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

REST API

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

1. Accedere alla pagina di panoramica della risorsa nel portale di Azure

2. Dal menu a sinistra selezionare Chiavi ed endpoint. L'endpoint e la chiave verranno usati per le richieste API

   

Inviare un'attività di riconoscimento di entità denominate personalizzate

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.

Corpo

{
  "displayName": "Extracting entities",
  "analysisInput": {
    "documents": [
      {
        "id": "1",
        "language": "{LANGUAGE-CODE}",
        "text": "Text1"
      },
      {
        "id": "2",
        "language": "{LANGUAGE-CODE}",
        "text": "Text2"
      }
    ]
  },
  "tasks": [
     {
      "kind": "CustomEntityRecognition",
      "taskName": "Entity Recognition",
      "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	CustomEntityRecognition	Il nome dell’attività	CustomEntityRecognition
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

Se l’attività è stata inviata correttamente, si riceverà una risposta 202. 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/sui risultati dell'attività di riconoscimento di entità personalizzate.

{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 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.

Testo della risposta

La risposta sarà un documento JSON con i parametri seguenti

{
  "createdDateTime": "2021-05-19T14:32:25.578Z",
  "displayName": "MyJobName",
  "expirationDateTime": "2021-05-19T14:32:25.578Z",
  "jobId": "xxxx-xxxx-xxxxx-xxxxx",
  "lastUpdateDateTime": "2021-05-19T14:32:25.578Z",
  "status": "succeeded",
  "tasks": {
    "completed": 1,
    "failed": 0,
    "inProgress": 0,
    "total": 1,
    "items": [
      {
        "kind": "EntityRecognitionLROResults",
        "taskName": "Recognize Entities",
        "lastUpdateDateTime": "2020-10-01T15:01:03Z",
        "status": "succeeded",
        "results": {
          "documents": [
            {
              "entities": [
                {
                  "category": "Event",
                  "confidenceScore": 0.61,
                  "length": 4,
                  "offset": 18,
                  "text": "trip"
                },
                {
                  "category": "Location",
                  "confidenceScore": 0.82,
                  "length": 7,
                  "offset": 26,
                  "subcategory": "GPE",
                  "text": "Seattle"
                },
                {
                  "category": "DateTime",
                  "confidenceScore": 0.8,
                  "length": 9,
                  "offset": 34,
                  "subcategory": "DateRange",
                  "text": "last week"
                }
              ],
              "id": "1",
              "warnings": []
            }
          ],
          "errors": [],
          "modelVersion": "2020-04-01"
        }
      }
    ]
  }
}

Librerie client (Azure SDK)

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

Ottenere la chiave e l'endpoint

La chiave e l'endpoint ottenuti dalla risorsa saranno necessari per connettere l'applicazione all'API. La chiave e l'endpoint verranno incollati nel codice più avanti nell'avvio rapido.

1. Dopo aver distribuito correttamente la risorsa linguistica, fare clic sul pulsante Vai alla risorsa sotto a Passaggi successivi.

   

2. Nella schermata della risorsa selezionare Chiavi ed endpoint nel menu di spostamento a sinistra. Nei passaggi seguenti si useranno una delle chiavi e l'endpoint.

   

3. 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

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

   • C#
   • Java
   • JavaScript
   • Python

5. Per altre informazioni sul client e l’oggetto di ritorno, vedere la documentazione di riferimento seguente:

   • C#
   • Java
   • JavaScript
   • Python

Passaggi successivi

• Domande frequenti