Come creare Analisi del testo personalizzate per il progetto di integrità

Usare questo articolo per informazioni su come configurare i requisiti per iniziare con l'analisi del testo personalizzata per l'integrità e creare un progetto.

Prerequisiti

Prima di iniziare a usare l'analisi del testo personalizzata per l'integrità, è necessario:

• Una sottoscrizione di Azure: crearne una gratuitamente.

Creare una risorsa del servizio Lingua

Prima di iniziare a usare l'analisi del testo personalizzata per l'integrità, è necessaria una risorsa del linguaggio di intelligenza artificiale di Azure. È consigliabile creare la risorsa lingua e connetterla all'account di archiviazione nel portale di Azure. La creazione di una risorsa nella portale di Azure consente di creare contemporaneamente un account di archiviazione di Azure, con tutte le autorizzazioni necessarie preconfigurate. È anche possibile leggere altre informazioni nell'articolo per informazioni su come usare una risorsa preesistente e configurarla per l'uso con l'analisi del testo personalizzata per l'integrità.

Sarà necessario anche un account di archiviazione di Azure in cui verranno caricati i .txt documenti che verranno usati per eseguire il training di un modello per estrarre le entità.

Nota

• Per creare una risorsa lingua, è necessario avere un ruolo di proprietario assegnato nel gruppo di risorse.
• Se si connetterà un account di archiviazione preesistente, è necessario assegnare un ruolo di proprietario.

Creare una risorsa lingua e connettere l'account di archiviazione

È possibile creare una risorsa nei modi seguenti:

• Ilportale di Azure
• Language Studio
• PowerShell

Nota

Non è consigliabile spostare l'account di archiviazione in un gruppo di risorse o una sottoscrizione diverso dopo che è collegato alla risorsa Lingua.

Creare una nuova risorsa dal portale di Azure

1. Passare alla portale di Azure per creare una nuova risorsa del linguaggio di intelligenza artificiale di Azure.

2. Nella finestra visualizzata selezionare questo servizio dalle funzionalità personalizzate. Selezionare Continua per creare la risorsa nella parte inferiore della schermata .

   

3. Creare una risorsa lingua con i dettagli seguenti.

   Nome	Descrizione
   Abbonamento	La sottoscrizione di Azure.
   Gruppo di risorse	Gruppo di risorse che conterrà la risorsa. È possibile usare uno esistente o crearne uno nuovo.
   Area	Area per la risorsa lingua. Ad esempio, "Stati Uniti occidentali 2".
   Nome	Nome della risorsa.
   Piano tariffario	Piano tariffario per la risorsa Lingua. È possibile usare il livello Gratuito (F0) per provare il servizio.

   Nota

   Se viene visualizzato un messaggio che indica che l'account di accesso non è un proprietario del gruppo di risorse dell'account di archiviazione selezionato, l'account deve avere un ruolo di proprietario assegnato nel gruppo di risorse prima di poter creare una risorsa lingua. Per assistenza, contattare il proprietario della sottoscrizione di Azure.

4. Nella sezione del servizio selezionare un account di archiviazione esistente o selezionare Nuovo account di archiviazione. Questi valori consentono di iniziare e non necessariamente i valori dell'account di archiviazione da usare negli ambienti di produzione. Per evitare la latenza durante la compilazione del progetto, connettersi agli account di archiviazione nella stessa area della risorsa lingua.

   Archiviazione valore dell'account	Valore consigliato
   Nome account di archiviazione	Qualsiasi nome
   Storage account type	LRS Standard

5. Assicurarsi che sia selezionata l'informativa sull'intelligenza artificiale responsabile. Selezionare Rivedi e crea nella parte inferiore della pagina e quindi selezionare Crea.

Creare una nuova risorsa lingua da Language Studio

Se è la prima volta che si accede, verrà visualizzata una finestra in Language Studio che consentirà di scegliere una risorsa lingua esistente o crearne una nuova. È anche possibile creare una risorsa facendo clic sull'icona delle impostazioni nell'angolo in alto a destra, selezionando Risorse e quindi facendo clic su Crea una nuova risorsa.

Creare una risorsa lingua con i dettagli seguenti.

Dettagli dell'istanza	Valore obbligatorio
Sottoscrizione di Azure	la propria sottoscrizione di Azure
Gruppo di risorse di Azure	Gruppo di risorse di Azure
Nome risorsa di Azure	Nome della risorsa di Azure
Ufficio	Area geografica
Piano tariffario	Piano tariffario della risorsa Lingua.

Importante

• Assicurarsi di abilitare l'identità gestita quando si crea una risorsa lingua.
• Leggere e confermare l'avviso di IA responsabile

Per usare questo servizio, è necessario creare un account di archiviazione di Azure, se non ne è già disponibile uno.

Creare una nuova risorsa del linguaggio con PowerShell

È possibile creare una nuova risorsa e un account di archiviazione usando il modello e i file di parametri dell'interfaccia della riga di comando seguenti, ospitati in GitHub.

Modificare i valori seguenti nel file dei parametri:

Nome parametro	Descrizione valore
name	Nome della risorsa lingua
location	Area in cui è ospitata la risorsa.
sku	Piano tariffario della risorsa.
storageResourceName	Nome dell'account di archiviazione
storageLocation	Area in cui è ospitato l'account di archiviazione.
storageSkuType	SKU dell'account di archiviazione.
storageResourceGroupName	Gruppo di risorse dell'account di archiviazione

Usare il comando di PowerShell seguente per distribuire il modello di Azure Resource Manager (ARM) con i file modificati.

New-AzResourceGroupDeployment -Name ExampleDeployment -ResourceGroupName ExampleResourceGroup `
  -TemplateFile <path-to-arm-template> `
  -TemplateParameterFile <path-to-parameters-file>

Per informazioni sulla distribuzione di modelli e file di parametri, vedere la documentazione del modello di Resource Manager.

Nota

• Il processo di connessione di un account di archiviazione alla risorsa lingua è irreversibile e non può essere disconnesso in un secondo momento.
• È possibile connettere la risorsa di lingua solo a un account di archiviazione.

Uso di una risorsa language preesistente

È possibile usare una risorsa lingua esistente per iniziare a usare NER personalizzato, purché questa risorsa soddisfi i requisiti seguenti:

Requisito	Descrizione
Aree geografiche	Assicurarsi che il provisioning della risorsa esistente venga eseguito in una delle aree supportate. In caso contrario, sarà necessario creare una nuova risorsa in una di queste aree.
Piano tariffario	Il piano tariffario per la risorsa.
Identità gestita	Assicurarsi che l'impostazione dell'identità gestita della risorsa sia abilitata. In caso contrario, leggere la sezione successiva.

Per usare l'analisi del testo personalizzata per l'integrità, è necessario creare un account di archiviazione di Azure, se non ne è già disponibile uno.

Abilitare la gestione delle identità per la risorsa

Azure portal

La risorsa lingua deve avere la gestione delle identità. Per abilitarlo usando il portale di Azure:

1. Passare alla risorsa lingua
2. Nel menu a sinistra, nella sezione Gestione risorse selezionare Identità
3. Dalla scheda Assegnata dal sistema assicurarsi di impostare Stato su Sì

Language Studio

La risorsa lingua deve avere la gestione delle identità per abilitarla tramite Language Studio:

1. Selezionare l'icona delle impostazioni nell'angolo superiore destro della schermata
2. Selezionare risorse
3. Selezionare la casella di controllo Identità gestita per la risorsa del linguaggio di intelligenza artificiale di Azure.

Abilitare l'analisi del testo personalizzata per l'integrità

Assicurarsi di abilitare la classificazione di testo personalizzata/Riconoscimento di entità denominate personalizzate/Analisi del testo personalizzata per la funzionalità di integrità da portale di Azure.

1. Passare alla risorsa Lingua nel portale di Azure.
2. Nel menu a sinistra, nella sezione Gestione risorse selezionare Funzionalità
3. Abilitare la funzionalità Di classificazione testo personalizzata/Riconoscimento entità denominata personalizzata/Analisi del testo personalizzata
4. Connessione l'account di archiviazione
5. Selezionare Applica.

Importante

• Assicurarsi che alla risorsa di linguaggio sia assegnato il ruolo collaboratore ai dati dei BLOB di archiviazione nell'account di archiviazione che si connette.

Aggiungere ruoli obbligatori

Usare la procedura seguente per impostare i ruoli necessari per la risorsa lingua e l'account di archiviazione.

Ruoli per la risorsa del linguaggio di intelligenza artificiale di Azure

1. Passare alla risorsa dell'account di archiviazione o della lingua nel portale di Azure.

2. Selezionare Controllo di accesso (IAM) nel menu di spostamento a sinistra.

3. Selezionare Aggiungi per aggiungere assegnazioni di ruolo e scegliere il ruolo appropriato per l'account.

   È necessario avere il ruolo di proprietario o collaboratore assegnato nella risorsa Lingua.

4. In Assegna accesso a selezionare Utente, gruppo o entità servizio

5. Selezionare Seleziona membri

6. Selezionare il nome utente. È possibile cercare i nomi utente nel campo Seleziona . Ripetere questa operazione per tutti i ruoli.

7. Ripetere questi passaggi per tutti gli account utente che devono accedere a questa risorsa.

Ruoli per l'account di archiviazione

1. Passare alla pagina dell'account di archiviazione nel portale di Azure.
2. Selezionare Controllo di accesso (IAM) nel menu di spostamento a sinistra.
3. Selezionare Aggiungi per aggiungere assegnazioni di ruolo e scegliere il ruolo collaboratore ai dati BLOB Archiviazione nell'account di archiviazione.
4. In Assegna accesso a selezionare Identità gestita.
5. Selezionare Seleziona membri
6. Selezionare la sottoscrizione e Lingua come identità gestita. È possibile cercare i nomi utente nel campo Seleziona .

Importante

Se si dispone di una rete virtuale o di un endpoint privato, assicurarsi di selezionare Consenti ai servizi di Azure nell'elenco dei servizi attendibili di accedere a questo account di archiviazione nel portale di Azure.

Abilitare CORS per l'account di archiviazione

Assicurarsi di consentire i metodi (GET, PUT, DELETE) quando si abilita la condivisione di risorse tra le origini (CORS). Impostare il campo origini consentite su https://language.cognitive.azure.com. Consenti tutte le intestazioni aggiungendo * ai valori di intestazione consentiti e impostando la validità massima su 500.

Creare un Analisi del testo personalizzato per il progetto di integrità

Dopo aver configurato la risorsa e il contenitore di archiviazione, creare una nuova analisi del testo personalizzata per il progetto di integrità. Un progetto è un'area di lavoro per la creazione di modelli di intelligenza artificiale personalizzati basati sui dati. È possibile accedere al progetto solo dall'utente e da altri utenti che hanno accesso alla risorsa di Azure usata. Se sono stati etichettati dati, è possibile usarli per iniziare importando un progetto.

Language Studio

1. Accedere a Language Studio. Verrà visualizzata una finestra che consente di selezionare la sottoscrizione e la risorsa lingua. Selezionare la risorsa Lingua creata nel passaggio precedente.

2. Nella sezione Estrarre informazioni di Language Studio selezionare Analisi del testo personalizzato per l'integrità.

3. Selezionare Crea nuovo progetto dal menu in alto nella pagina dei progetti. La creazione di un progetto consente di etichettare i dati, eseguire il training, valutare, migliorare e distribuire i modelli.

   

4. Immettere le informazioni sul progetto, inclusi un nome, una descrizione e la lingua dei file nel progetto. Se si usa il set di dati di esempio, selezionare Inglese. Non è possibile modificare il nome del progetto in un secondo momento. Selezionare Avanti.

   Suggerimento

   Il set di dati non deve essere interamente nello stesso linguaggio. È possibile avere più documenti, ognuno con lingue supportate diverse. Se il set di dati contiene documenti di lingue diverse o se si prevede testo da lingue diverse durante il runtime, selezionare l'opzione Abilita set di dati multilingue quando si immettono le informazioni di base per il progetto. Questa opzione può essere abilitata in un secondo momento dalla pagina Impostazioni progetto.

5. Dopo aver selezionato Crea nuovo progetto, verrà visualizzata una finestra per consentire la connessione dell'account di archiviazione. Se è già stato connesso un account di archiviazione, verrà visualizzato l'account di archiviazione connesso. In caso contrario, scegliere l'account di archiviazione dall'elenco a discesa visualizzato e selezionare Connessione account di archiviazione. Verranno impostati i ruoli necessari per l'account di archiviazione. Questo passaggio restituirà un errore se non si è assegnati come proprietario nell'account di archiviazione.

   Nota

   • È necessario eseguire questo passaggio una sola volta per ogni nuova risorsa usata.
   • Questo processo è irreversibile, se si connette un account di archiviazione alla risorsa lingua, non è possibile disconnetterlo in un secondo momento.
   • È possibile connettere la risorsa lingua solo a un account di archiviazione.

   

6. Selezionare il contenitore in cui è stato caricato il set di dati.

7. Se i dati sono già stati etichettati, assicurarsi che seguano il formato supportato e selezionare Sì, i miei file sono già etichettati e ho formattato il file di etichette JSON e selezionare il file delle etichette dal menu a discesa. Selezionare Avanti. Se si usa il set di dati della guida introduttiva, non è necessario esaminare la formattazione del file di etichette JSON.

8. Esaminare i dati immessi e selezionare Crea progetto.

API REST

Per iniziare a creare un Analisi del testo personalizzato per il modello di integrità, è necessario creare un progetto. La creazione di un progetto consentirà di etichettare i dati, eseguire il training, valutare, migliorare e distribuire i modelli.

Nota

Il nome del progetto fa distinzione tra maiuscole e minuscole per tutte le operazioni.

Creare una richiesta PATCH usando l'URL, le intestazioni e il corpo JSON seguenti per creare il progetto.

Richiesta URL

Usare l'URL seguente per creare un progetto. Sostituire i valori segnaposto seguenti con i propri valori.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}?api-version={API-VERSION}

Segnaposto	Valore	Esempio
{ENDPOINT}	Endpoint per l'autenticazione della richiesta API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	myProject
{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

Usare l'intestazione seguente per autenticare la richiesta.

Chiave	valore
Ocp-Apim-Subscription-Key	Chiave della risorsa. Usato per l'autenticazione delle richieste API.

Corpo

Usare il codice JSON seguente nella richiesta. Sostituire i valori segnaposto seguenti con i propri valori.

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "CustomHealthcare",
  "description": "Project description",
  "multilingual": "True",
  "storageInputContainerName": "{CONTAINER-NAME}"
}

Chiave	Segnaposto	Valore	Esempio
projectName	{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	myProject
lingua	{LANGUAGE-CODE}	Stringa che specifica il codice della lingua per i documenti usati nel progetto. Se il progetto è un progetto multilingue, scegliere il codice linguistico della maggior parte dei documenti. Per altre informazioni sui codici linguistici supportati, vedere Supporto linguistico.	en-us
projectKind	CustomHealthcare	Tipo di progetto.	CustomHealthcare
Multilingue	true	Valore booleano che consente di avere documenti in più lingue nel set di dati e quando il modello viene distribuito, è possibile eseguire query sul modello in qualsiasi linguaggio supportato (non necessariamente quelli inclusi nei documenti di training). Per altre informazioni sul supporto multilingue, vedere Supporto linguistico.	true
storageInputContainerName	{CONTAINER-NAME	Nome del contenitore di archiviazione di Azure in cui sono stati caricati i documenti.	myContainer

Questa richiesta restituirà una risposta 201, il che significa che il progetto viene creato.

Questa richiesta restituirà un errore se:

• La risorsa selezionata non dispone dell'autorizzazione appropriata per l'account di archiviazione.

Importare il progetto

Se i dati sono già etichettati, è possibile usarli per iniziare a usare il servizio. Assicurarsi che i dati etichettati seguano i formati di dati accettati.

Language Studio

1. Accedere a Language Studio. Verrà visualizzata una finestra che consente di selezionare la sottoscrizione e la risorsa lingua. Selezionare la risorsa Lingua.

2. Nella sezione Estrarre informazioni di Language Studio selezionare Analisi del testo personalizzata per l'integrità.

3. Selezionare Crea nuovo progetto dal menu in alto nella pagina dei progetti. La creazione di un progetto consentirà di contrassegnare i dati, eseguire il training, valutare, migliorare e distribuire i modelli.

4. Dopo aver selezionato Crea nuovo progetto, verrà visualizzata una schermata che consente di connettere l'account di archiviazione. Se non è possibile trovare l'account di archiviazione, assicurarsi di aver creato una risorsa usando la procedura consigliata. Se è già stato connesso un account di archiviazione alla risorsa lingua, verrà visualizzato l'account di archiviazione connesso.

   Nota

   • È necessario eseguire questo passaggio una sola volta per ogni nuova risorsa di lingua usata.
   • Questo processo è irreversibile, se si connette un account di archiviazione alla risorsa lingua, non è possibile disconnetterlo in un secondo momento.
   • È possibile connettere la risorsa lingua solo a un account di archiviazione.

   

5. Immettere le informazioni sul progetto, inclusi un nome, una descrizione e la lingua dei file nel progetto. Non sarà possibile modificare il nome del progetto in un secondo momento. Selezionare Avanti.

   Suggerimento

   Il set di dati non deve essere interamente nello stesso linguaggio. È possibile avere più documenti, ognuno con lingue supportate diverse. Se il set di dati contiene documenti di lingue diverse o se si prevede testo da lingue diverse durante il runtime, selezionare l'opzione Abilita set di dati multilingue quando si immettono le informazioni di base per il progetto. Questa opzione può essere abilitata in un secondo momento dalla pagina Impostazioni progetto.

6. Selezionare il contenitore in cui è stato caricato il set di dati.

7. Selezionare Sì, i file sono già etichettati e ho formattato il file delle etichette JSON e selezionare il file delle etichette dal menu a discesa seguente per importare il file delle etichette JSON. Assicurarsi che segua il formato supportato.

8. Selezionare Avanti.

9. Esaminare i dati immessi e selezionare Crea progetto.

API REST

Inviare una richiesta POST usando l'URL, le intestazioni e il corpo JSON seguenti per importare il file di etichette. Assicurarsi che il file delle etichette segua il formato accettato.

Se esiste già un progetto con lo stesso nome, i dati del progetto vengono sostituiti.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}/:import?api-version={API-VERSION}

Segnaposto	Valore	Esempio
{ENDPOINT}	Endpoint per l'autenticazione della richiesta API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	myProject
{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

Usare l'intestazione seguente per autenticare la richiesta.

Chiave	valore
Ocp-Apim-Subscription-Key	Chiave della risorsa. Usato per l'autenticazione delle richieste API.

Corpo

Usare il codice JSON seguente nella richiesta. Sostituire i valori segnaposto seguenti con i propri valori.

{
	"projectFileVersion": "{API-VERSION}",
	"stringIndexType": "Utf16CodeUnit",
	"metadata": {
		"projectName": "{PROJECT-NAME}",
		"projectKind": "CustomHealthcare",
		"description": "Trying out custom Text Analytics for health",
		"language": "{LANGUAGE-CODE}",
		"multilingual": true,
		"storageInputContainerName": "{CONTAINER-NAME}",
		"settings": {}
	},
	"assets": {
		"projectKind": "CustomHealthcare",
		"entities": [
			{
				"category": "Entity1",
				"compositionSetting": "{COMPOSITION-SETTING}",
				"list": {
					"sublists": [
						{
							"listKey": "One",
							"synonyms": [
								{
									"language": "en",
									"values": [
										"EntityNumberOne",
										"FirstEntity"
									]
								}
							]
						}
					]
				}
			},
			{
				"category": "Entity2"
			},
			{
				"category": "MedicationName",
				"list": {
					"sublists": [
						{
							"listKey": "research drugs",
							"synonyms": [
								{
									"language": "en",
									"values": [
										"rdrug a",
										"rdrug b"
									]
								}
							]

						}
					]
				}
				"prebuilts": "MedicationName"
			}
		],
		"documents": [
			{
				"location": "{DOCUMENT-NAME}",
				"language": "{LANGUAGE-CODE}",
				"dataset": "{DATASET}",
				"entities": [
					{
						"regionOffset": 0,
						"regionLength": 500,
						"labels": [
							{
								"category": "Entity1",
								"offset": 25,
								"length": 10
							},
							{
								"category": "Entity2",
								"offset": 120,
								"length": 8
							}
						]
					}
				]
			},
			{
				"location": "{DOCUMENT-NAME}",
				"language": "{LANGUAGE-CODE}",
				"dataset": "{DATASET}",
				"entities": [
					{
						"regionOffset": 0,
						"regionLength": 100,
						"labels": [
							{
								"category": "Entity2",
								"offset": 20,
								"length": 5
							}
						]
					}
				]
			}
		]
	}
}

Chiave	Segnaposto	Valore	Esempio
multilingual	true	Valore booleano che consente di avere documenti in più lingue nel set di dati e quando il modello viene distribuito, è possibile eseguire query sul modello in qualsiasi linguaggio supportato (non necessariamente incluso nei documenti di training). Per altre informazioni sul supporto multilingue, vedere Supporto linguistico.	true
projectName	{PROJECT-NAME}	Nome progetto	myproject
storageInputContainerName	{CONTAINER-NAME}	Nome contenitore	mycontainer
entities		Matrice contenente tutti i tipi di entità presenti nel progetto. Questi sono i tipi di entità che verranno estratti dai documenti in.
category		Nome del tipo di entità, che può essere definito dall'utente per le nuove definizioni di entità o predefinito per le entità predefinite.
compositionSetting	{COMPOSITION-SETTING}	Regola che definisce come gestire più componenti nell'entità. Le opzioni sono combineComponents o separateComponents.	combineComponents
list		Matrice contenente tutti gli elenchi secondari presenti nel progetto per un'entità specifica. Gli elenchi possono essere aggiunti alle entità predefinite o alle nuove entità con componenti appresi.
sublists	[]	Matrice contenente sottoliste. Ogni sottolista è una chiave e i relativi valori associati.	[]
listKey	One	Valore normalizzato per l'elenco di sinonimi a cui eseguire il mapping nella stima.	One
synonyms	[]	Matrice contenente tutti i sinonimi	sinonimo
language	{LANGUAGE-CODE}	Stringa che specifica il codice della lingua per il sinonimo nell'elenco secondario. Se il progetto è un progetto multilingue e si vuole supportare l'elenco di sinonimi per tutte le lingue del progetto, è necessario aggiungere in modo esplicito i sinonimi a ogni lingua. Per altre informazioni sui codici linguistici supportati, vedere Supporto della lingua.	en
values	"EntityNumberone", "FirstEntity"	Elenco di stringhe separate da virgole corrispondenti esattamente per l'estrazione e il mapping alla chiave di elenco.	"EntityNumberone", "FirstEntity"
prebuilts	MedicationName	Nome del componente predefinito che popola l'entità predefinita. Le entità predefinite vengono caricate automaticamente nel progetto per impostazione predefinita, ma è possibile estenderle con i componenti elenco nel file delle etichette.	MedicationName
documents		Matrice contenente tutti i documenti nel progetto e l'elenco delle entità etichettate all'interno di ogni documento.	[]
location	{DOCUMENT-NAME}	Posizione dei documenti nel contenitore di archiviazione. Poiché tutti i documenti si trovano nella radice del contenitore, questo deve essere il nome del documento.	doc1.txt
dataset	{DATASET}	Set di test su cui verrà eseguito il file quando verrà suddiviso prima del training. I valori possibili per questo campo sono Train e Test.	Train
regionOffset		Posizione del carattere inclusivo dell'inizio del testo.	0
regionLength		Lunghezza del rettangolo di selezione in termini di caratteri UTF16. Il training considera solo i dati in questa area.	500
category		Tipo di entità associata all'intervallo di testo specificato.	Entity1
offset		Posizione iniziale per il testo dell'entità.	25
length		Lunghezza dell'entità in termini di caratteri UTF16.	20
language	{LANGUAGE-CODE}	Stringa che specifica il codice della lingua per il documento usato nel progetto. Se il progetto è un progetto multilingue, scegliere il codice linguistico della maggior parte dei documenti. Per altre informazioni sui codici linguistici supportati, vedere Supporto della lingua.	en

Dopo aver inviato la richiesta API, si riceverà una 202 risposta che indica che il processo è stato inviato correttamente. Nelle intestazioni della risposta estrarre il operation-location valore. Il formato sarà simile al seguente:

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}

{JOB-ID} viene usato per identificare la richiesta, poiché questa operazione è asincrona. Questo URL verrà usato per ottenere lo stato del processo di importazione.

Possibili scenari di errore per questa richiesta:

• La risorsa selezionata non dispone delle autorizzazioni appropriate per l'account di archiviazione.
• L'oggetto storageInputContainerName specificato non esiste.
• Viene usato codice linguistico non valido o se il tipo di codice della lingua non è stringa.
• multilingual value è una stringa e non un valore booleano.

Ottenere i dettagli del progetto

Language Studio

1. Passare alla pagina delle impostazioni del progetto in Language Studio.

2. È possibile visualizzare i dettagli del progetto.

3. In questa pagina è possibile aggiornare la descrizione del progetto e abilitare/disabilitare il set di dati multilingue nelle impostazioni del progetto.

4. È anche possibile visualizzare l'account di archiviazione connesso e il contenitore alla risorsa Lingua.

5. È anche possibile recuperare la chiave di risorsa primaria da questa pagina.

   

API REST

Usare la richiesta GET seguente per ottenere i dettagli del progetto. Sostituire i valori segnaposto seguenti con i propri valori.

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}?api-version={API-VERSION}

Segnaposto	Valore	Esempio
{ENDPOINT}	Endpoint per l'autenticazione della richiesta API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	myProject
{API-VERSION}	Versione dell'API che si sta chiamando. Per altre informazioni sulle altre versioni dell'API disponibili, vedere Ciclo di vita del modello.	2022-05-01

Intestazioni

Usare l'intestazione seguente per autenticare la richiesta.

Chiave	valore
Ocp-Apim-Subscription-Key	Chiave della risorsa. Usato per l'autenticazione delle richieste API.

Corpo della risposta

    {
        "createdDateTime": "2021-10-19T23:24:41.572Z",
        "lastModifiedDateTime": "2021-10-19T23:24:41.572Z",
        "lastTrainedDateTime": "2021-10-19T23:24:41.572Z",
        "lastDeployedDateTime": "2021-10-19T23:24:41.572Z",
        "projectKind": "CustomHealthcare",
        "storageInputContainerName": "{CONTAINER-NAME}",
        "projectName": "{PROJECT-NAME}",
        "multilingual": false,
        "description": "Project description",
        "language": "{LANGUAGE-CODE}"
    }

Valore	Segnaposto	Descrizione	Esempio
projectKind	CustomHealthcare	Tipo di progetto.	CustomHealthcare
storageInputContainerName	{CONTAINER-NAME}	Nome del contenitore di archiviazione di Azure in cui sono stati caricati i documenti.	myContainer
projectName	{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	myProject
multilingual	true	Valore booleano che consente di avere documenti in più lingue nel set di dati e quando il modello viene distribuito, è possibile eseguire query sul modello in qualsiasi linguaggio supportato (non necessariamente quelli inclusi nei documenti di training). Per altre informazioni sul supporto multilingue, vedere Supporto linguistico.	true
language	{LANGUAGE-CODE}	Stringa che specifica il codice della lingua per i documenti usati nel progetto. Se il progetto è un progetto multilingue, scegliere il codice linguistico della maggior parte dei documenti.	en

Dopo aver inviato la richiesta API, si riceverà una 200 risposta che indica l'esito positivo e il corpo della risposta JSON con i dettagli del progetto.

Eliminare un progetto

Language Studio

Quando il progetto non è più necessario, è possibile eliminare il progetto usando Language Studio.

1. Selezionare la funzionalità del servizio di linguaggio in uso nella parte superiore della pagina,
2. Selezionare il progetto da eliminare
3. Selezionare Elimina nel menu in alto.

API REST

Quando il progetto non è più necessario, è possibile eliminarlo con la richiesta DELETE seguente. Sostituire i valori segnaposto con i propri valori.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}?api-version={API-VERSION}

Segnaposto	Valore	Esempio
{ENDPOINT}	Endpoint per l'autenticazione della richiesta API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	myProject
{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

Usare l'intestazione seguente per autenticare la richiesta.

Chiave	valore
Ocp-Apim-Subscription-Key	Chiave della risorsa. Usato per l'autenticazione delle richieste API.

Dopo aver inviato la richiesta API, si riceverà una 202 risposta che indica l'esito positivo, il che significa che il progetto è stato eliminato. Risultati di una chiamata con esito positivo con un'intestazione Operation-Location usata per controllare lo stato del processo.

Passaggi successivi

• È necessario avere un'idea dello schema del progetto che verrà usato per etichettare i dati.

• Dopo aver definito lo schema, è possibile iniziare a etichettare i dati, che verranno usati per il training, la valutazione del modello e infine l'esecuzione di stime.