Comment créer un projet Analyse de texte personnalisée pour la santé

Votre ressource Language doit disposer de la gestion des identités. Pour l’activer à l’aide du Portail Azure :

1. Accéder à votre ressource de langue
2. Dans le menu de gauche, sous la section Gestion des ressources, sélectionnez Identité
3. Sous l’onglet Attribuée par le système, veillez à définir État sur Activé

Votre ressource de langue doit disposer de la gestion des identités. Pour l’activer à l’aide de Language Studio :

1. Sélectionnez l’icône Paramètres dans le coin supérieur droit de l’écran
2. Sélectionnez Ressources
3. Cochez la case Identité managée pour votre ressource Azure AI Language.

1. Connectez-vous à Language Studio. Une fenêtre apparaît pour vous permettre de sélectionner votre abonnement et votre ressource Language. Sélectionnez la ressource de langue que vous avez créée à l’étape ci-dessus.

2. Sous la section Extraire les informations de Language Studio, sélectionnez Analyse de texte personnalisée pour la santé.

3. Sélectionnez Créer un projet dans le menu supérieur de la page des projets. La création d’un projet vous permet d’étiqueter les données, et d’entraîner, évaluer, améliorer et déployer vos modèles.

   

4. Entrez les informations relatives au projet, notamment son nom, sa description et la langue des fichiers qu’il contient. Si vous utilisez l’exemple de jeu de données, sélectionnez Anglais. Vous ne pouvez pas changer ultérieurement le nom de votre projet. Sélectionnez Suivant.

   Conseil

   Votre jeu de données n’a pas besoin d’être entièrement dans la même langue. Vous pouvez avoir plusieurs fichiers comportant des langues prises en charge différentes. Si votre jeu de données contient des documents en différentes langues ou si vous prévoyez des textes en d’autres langues au moment de l’exécution, sélectionnez l’option Activer un jeu de données multilingue quand vous entrez les informations de base de votre projet. Cette option peut être activée ultérieurement dans la page des Paramètres du projet.

5. Une fois que vous avez sélectionné Créer un projet, une fenêtre apparaît pour vous permettre de connecter votre compte de stockage. Si vous avez déjà connecté un compte de stockage, celui-ci s’affiche. Si ce n’est pas le cas, choisissez votre compte de stockage dans la liste déroulante qui s’affiche, puis sélectionnez Connecter le compte de stockage. Cette opération définit les rôles nécessaires pour votre compte de stockage. Cette étape peut retourner une erreur si le rôle propriétaire ne vous est pas attribué sur le compte de stockage.

   Notes

   • Vous ne devez effectuer cette étape qu’une seule fois pour chaque nouvelle ressource utilisée.
   • Ce processus est irréversible. Si vous connectez un compte de stockage à votre ressource de langue, il n’est pas possible de le déconnecter ultérieurement.
   • Vous pouvez connecter votre ressource de langue à un seul compte de stockage.

   

6. Sélectionnez le conteneur dans lequel vous avez chargé votre jeu de données.

7. Si vous avez déjà étiqueté les données, vérifiez qu’elles respectent le format pris en charge, puis sélectionnez Oui, mes fichiers comportent déjà des étiquettes et j’ai mis en forme le fichier d’étiquettes JSON. Sélectionnez ensuite le fichier d’étiquettes dans le menu déroulant. Sélectionnez Suivant. Si vous utilisez le jeu de données du guide de démarrage rapide, il n’est pas nécessaire de passer en revue la mise en forme du fichier d’étiquettes JSON.

8. Passez en revue les données entrées, puis sélectionnez Créer un projet.

Pour commencer à créer un modèle Analyse de texte personnalisée pour la santé, vous devez créer un projet. La création d’un projet vous permet d’étiqueter les données, et d’entraîner, évaluer, améliorer et déployer vos modèles.

Créez une requête PATCH en utilisant l’URL, les en-têtes et le corps JSON suivants pour créer votre projet.

URL de la demande

Utilisez l’URL suivante pour créer un projet. Remplacez les valeurs d’espace réservé suivantes par vos valeurs :

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

headers

Utilisez l’en-tête suivant pour authentifier votre demande.

body

Utilisez le code JSON suivant dans votre demande. Remplacez les valeurs d’espace réservé suivantes par vos valeurs :

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

Cette requête retourne une réponse 201, qui signifie que le projet est créé.

Cette demande renvoie une erreur si :

• La ressource sélectionnée n’a pas les autorisations appropriées pour le compte de stockage.

1. Connectez-vous à Language Studio. Une fenêtre apparaît pour vous permettre de sélectionner votre abonnement et votre ressource Language. Sélectionnez votre ressource Language.

2. Sous la section Extraire les informations de Language Studio, sélectionnez Analyse de texte personnalisée pour la santé.

3. Sélectionnez Créer un projet dans le menu supérieur de la page des projets. La création d’un projet vous permet d’étiqueter des données, d’entraîner, d’évaluer, d’améliorer et de déployer vos modèles.

4. Une fois que vous avez sélectionné Créer un projet, un écran apparaît pour vous permettre de connecter votre compte de stockage. Si vous ne trouvez pas votre compte de stockage, vérifiez que vous avez créé une ressource en suivant les étapes recommandées. Si vous avez déjà connecté un compte de stockage à votre ressource de langue, vous verrez votre compte de stockage connecté.

   Notes

   • Vous ne devez effectuer cette étape qu’une seule fois pour chaque nouvelle ressource de langue utilisée.
   • Ce processus est irréversible. Si vous connectez un compte de stockage à votre ressource de langue, il n’est pas possible de le déconnecter ultérieurement.
   • Vous pouvez connecter votre ressource de langue à un seul compte de stockage.

   

5. Entrez les informations relatives au projet, notamment son nom, sa description et la langue des fichiers qu’il contient. Vous ne pourrez plus changer le nom de votre projet. Sélectionnez Suivant.

   Conseil

   Votre jeu de données n’a pas besoin d’être entièrement dans la même langue. Vous pouvez avoir plusieurs fichiers comportant des langues prises en charge différentes. Si votre jeu de données contient des documents en différentes langues ou si vous prévoyez des textes en d’autres langues au moment de l’exécution, sélectionnez l’option Activer un jeu de données multilingue quand vous entrez les informations de base de votre projet. Cette option peut être activée ultérieurement dans la page des Paramètres du projet.

6. Sélectionnez le conteneur dans lequel vous avez chargé votre jeu de données.

7. Sélectionnez Oui, mes fichiers sont déjà étiquetés et j’ai mis en forme le fichier d’étiquettes JSON et sélectionnez le fichier d’étiquettes dans le menu déroulant ci-dessous pour importer votre fichier d’étiquettes JSON. Vérifiez que le fichier respecte le format pris en charge.

8. Cliquez sur Suivant.

9. Passez en revue les données entrées, puis sélectionnez Créer un projet.

Soumettez une demande POST en utilisant l’URL, les en-têtes et le corps JSON suivants pour importer votre fichier d’étiquettes. Vérifiez que votre fichier d’étiquettes respecte le format accepté.

Si un projet portant le même nom existe déjà, les données de ce projet sont remplacées.

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

headers

Utilisez l’en-tête suivant pour authentifier votre demande.

body

Utilisez le code JSON suivant dans votre demande. Remplacez les valeurs d’espace réservé suivantes par vos valeurs :

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

Une fois que vous avez envoyé votre requête API, vous recevez une réponse 202 indiquant que le travail a été envoyé correctement. Dans les en-têtes de réponse, extrayez la valeur operation-location. Elle est au format suivant :

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

{JOB-ID} est utilisé pour identifier votre demande, car cette opération est asynchrone. Vous utilisez cette URL à l’étape suivante pour obtenir l’état du travail d’importation.

Scénarios d’erreur possibles pour cette requête :

• La ressource sélectionnée n’a pas les autorisations appropriées pour le compte de stockage.
• Le storageInputContainerName spécifié n’existe pas.
• Le code de langue utilisé est non valide ou si le type de code de langue n’est pas une chaîne.
• La valeur multilingual est une chaîne et non pas une valeur booléenne.

1. Accédez à la page des paramètres de votre projet dans Language Studio.

2. Vous pouvez voir les détails du projet.

3. Dans cette page, vous pouvez mettre à jour la description du projet et activer/désactiver le jeu de données multilingue dans les paramètres du projet.

4. Vous pouvez également afficher le compte de stockage et le conteneur connectés à votre ressource de langue.

5. Vous pouvez également récupérer votre clé de ressource primaire à partir de cette page.

   

Utilisez la requête GET suivante pour obtenir les détails de votre projet. Remplacez les valeurs d’espace réservé suivantes par vos valeurs :

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

headers

Utilisez l’en-tête suivant pour authentifier votre demande.

Response body

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

Une fois que vous avez envoyé votre demande d’API, vous recevrez une réponse 200 confirmant la réussite et un corps de réponse JSON avec les détails de votre projet.

Une fois que vous n’avez plus besoin de votre projet, vous pouvez le supprimer à l’aide de Language Studio.

1. Sélectionnez la fonctionnalité Service de langage que vous utilisez en haut de la page.
2. Sélectionnez le projet à supprimer.
3. Sélectionnez Supprimer dans le menu du haut.

Quand vous n’avez plus besoin de votre projet, vous pouvez le supprimer avec la demande DELETE suivante. Remplacez les valeurs d’espace réservé par vos propres valeurs.

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

headers

Utilisez l’en-tête suivant pour authentifier votre demande.

Une fois que vous avez envoyé votre requête API, vous recevez une réponse 202 indiquant la réussite, ce qui signifie que votre projet a été supprimé. Un appel réussi donne un en-tête Operation-Location utilisé pour vérifier l’état du travail.