Inicio rápido: análisis de texto personalizado para la salud

Nota:

El Análisis de texto personalizado para la salud (versión preliminar) se retirará el 10 de enero de 2025, realice la transición a otros servicios de entrenamiento de modelos personalizados, como el reconocimiento de entidades con nombre personalizado en Lenguaje de Azure AI, en esa fecha. A partir de ahora y hasta el 10 de enero de 2025, puede seguir usando Análisis de texto personalizado para la salud (versión preliminar) en los proyectos existentes sin interrupciones. No se pueden crear nuevos proyectos. El 10 de enero de 2025: las cargas de trabajo que se ejecutan en Análisis de texto personalizado para la salud (versión preliminar) se eliminarán y se perderán los datos del proyecto asociados.

Use este artículo para empezar a crear un proyecto personalizado de Text Analytics para la salud en el que podrá entrenar modelos personalizados sobre Text Analytics par la salud con el fin de obtener un reconocimiento de entidades personalizado. Un modelo es software de inteligencia artificial que se entrena para hacer una tarea determinada. En este sistema, los modelos extraen entidades con nombre relacionadas con la salud y se entrenan aprendiendo a partir de datos etiquetados.

En este artículo, usaremos Language Studio para demostrar los conceptos clave de Text Analytics para la salud personalizado. Por ejemplo, crearemos un modelo personalizado de Text Analytics para la salud con el fin de extraer la ubicación del centro o tratamiento a partir de notas breves de alta.

Requisitos previos

• Una suscripción a Azure: cree una cuenta gratuita

He tenido un problema

Creación de un recurso de Lenguaje de Azure AI y una cuenta de almacenamiento de Azure

Para poder usar Análisis de texto personalizado para la salud, debe crear un recurso de Lenguaje de Azure AI, que le proporcionará las credenciales necesarias para crear un proyecto y empezar a entrenar un modelo. También necesitará una cuenta de almacenamiento Azure, donde podrá cargar el conjunto de datos que se usa para crear su modelo.

Importante

Para comenzar a trabajar rápidamente, se recomienda crear un recurso de Lenguaje de Azure AI mediante los pasos que se proporcionan en este artículo. Con los pasos en este artículo podrá crear el recurso de idioma y la cuenta de almacenamiento al mismo tiempo, lo que resulta más fácil que hacerlo más tarde.

Si tiene un recurso preexistente que le gustaría usar, deberá conectarlo a la cuenta de almacenamiento. Para obtener más información, consulte Instrucciones para usar un recurso preexistente.

Creación de un nuevo recurso en Azure Portal

1. Inicie sesión en Azure Portal y cree un recurso de Lenguaje de Azure AI.

2. En la ventana que se abre, seleccione Clasificación de texto personalizado y reconocimiento de entidades con nombre personalizadas en las características personalizadas. Seleccione Continuar para crear el recurso en la parte inferior de la pantalla.

   

3. Cree un recurso de idioma con los detalles siguientes.

   Nombre	Descripción
   Suscripción	Su suscripción de Azure.
   Grupo de recursos	Grupo de recursos que contendrá su recurso. Puede elegir uno existente o crear uno.
   Region	La región del recurso de idioma. Por ejemplo, "Oeste de EE. UU. 2".
   Nombre	Nombre del recurso.
   Plan de tarifa	Plan de tarifa del recurso de idioma. Puede usar el nivel de servicio Gratis (F0) para probar el servicio.

   Nota

   Si recibe un mensaje que indica "la cuenta de inicio de sesión no es propietaria del grupo de recursos de la cuenta de almacenamiento seleccionada", la cuenta debe tener asignado un rol de propietario en el grupo de recursos para poder crear un recurso de idioma. Póngase en contacto con el propietario de la suscripción de Azure para obtener ayuda.

4. En la sección Clasificación de texto personalizado y reconocimiento de entidades con nombre personalizadas, seleccione una cuenta de almacenamiento existente o Nueva cuenta de almacenamiento. Estos valores son para ayudarle a empezar y no necesariamente los valores de la cuenta de almacenamiento que querrá usar en entornos de producción. Para evitar la latencia durante la compilación del proyecto, conéctese a cuentas de almacenamiento en la misma región que el recurso de idioma.

   Valor de la cuenta de almacenamiento	Valor recomendado
   Nombre de la cuenta de almacenamiento	Cualquier nombre
   Tipo de cuenta de almacenamiento	LRS estándar

5. Asegúrese de que el Aviso de IA responsable esté activado. Seleccione Revisar y crear en la parte inferior de la página y, luego, seleccione Crear.

He tenido un problema

Carga de los datos de ejemplo en el contenedor de blobs

Después de crear una cuenta de almacenamiento de Azure y conectarla al recurso de idioma, deberá cargar los documentos del conjunto de datos de muestra en el directorio raíz de su contenedor. Estos archivos se usarán más adelante para entrenar el modelo.

1. Descargue el conjunto de datos de ejemplo de GitHub.

2. Abra el archivo .zip y extraiga la carpeta que contiene los documentos.

3. En Azure Portal, navegue hasta la cuenta de almacenamiento que ha creado y selecciónela.

4. En la cuenta de almacenamiento, seleccione Contenedores en el menú de la izquierda, que se encuentra debajo de Almacenamiento de datos. En la pantalla que aparece, seleccione + Contenedor. Asigne al contenedor el nombre example-data y deje el Nivel de acceso público predeterminado.

   

5. Una vez creado el contenedor, haga clic en él. A continuación, seleccione el botón Cargar para seleccionar los archivos .txt y .json que descargó anteriormente.

   

El conjunto de datos de muestra proporcionado contiene 12 notas clínicas. Cada nota clínica incluye varias entidades médicas y la ubicación del tratamiento. Usaremos las entidades precreadas para extraer las entidades médicas y entrenaremos el modelo personalizado para extraer la ubicación del tratamiento usando los componentes aprendidos y de lista de la entidad.

He tenido un problema

Creación de un proyecto personalizado de Text Analytics para la salud

Una vez configurados los recursos y la cuenta de almacenamiento, cree un nuevo proyecto personalizado de Text Analytics para la salud. Un proyecto es un área de trabajo para compilar modelos de Machine Learning personalizados basados en los datos. A su proyecto solo puede acceder usted y otros usuarios que tengan acceso al recurso de idioma que se usa.

1. Inicie sesión en Language Studio. Aparecerá una ventana que le permitirá seleccionar la suscripción y el recurso de idioma. Seleccione el recurso de idioma que creó en el paso anterior.

2. En la sección Extraer información de Language Studio, seleccione Análisis de texto personalizados para la salud.

3. Seleccione Create new project (Crear proyecto) en el menú superior de la página de proyectos. La creación de un proyecto le permite etiquetar datos, entrenar, evaluar, mejorar e implementar los modelos.

   

4. Escriba la información del proyecto, incluido un nombre, una descripción y el idioma de los archivos del proyecto. Si usa el conjunto de datos de ejemplo, seleccione Inglés. No puede cambiar el nombre del proyecto posteriormente. Seleccione Siguiente.

   Sugerencia

   El conjunto de datos no tiene que estar completamente en el mismo idioma. Puede tener varios documentos, cada uno de ellos con distintos idiomas admitidos. Si el conjunto de datos contiene documentos de distintos idiomas o si espera textos en idiomas diferentes durante el tiempo de ejecución, seleccione la opción Enable multi-lingual dataset (Habilitar conjunto de datos multilingüe) al especificar la información básica del proyecto. Esta opción se puede habilitar más adelante desde la página Configuración del proyecto.

5. Después de seleccionar Crear nuevo proyecto, aparecerá una ventana que le permitirá conectar la cuenta de almacenamiento. Si ya ha conectado una cuenta de almacenamiento, verá la cuenta de almacenamiento conectada. Si no es así, elija la cuenta de almacenamiento en la lista desplegable que aparece y seleccione Conectar cuenta de almacenamiento; esto establecerá los roles necesarios para la cuenta de almacenamiento. Este paso posiblemente devolverá un error si no está asignado como propietario en la cuenta de almacenamiento.

   Nota

   • Solo debe realizar este paso una vez para cada nuevo recurso que use.
   • Este proceso es irreversible: si conecta una cuenta de almacenamiento al recurso de idioma, no podrá desconectarla más tarde.
   • Solo puede conectar el recurso de idioma a una cuenta de almacenamiento.

   

6. Seleccione el contenedor en el que ha cargado el conjunto de datos.

7. Si ya ha etiquetado los datos, asegúrese de que sigue el formato admitido y seleccione Sí, mis archivos ya están etiquetados y he formateado el archivo de etiquetas JSON y seleccione el archivo de etiquetas en el menú desplegable. Seleccione Siguiente. Si usa el conjunto de datos del inicio rápido, no es necesario revisar el formato del archivo de etiquetas JSON.

8. Revise los datos especificados y seleccione Create Project (Crear proyecto).

He tenido un problema

Entrenamiento de un modelo

Después de crear un proyecto, continúe y empiece a etiquetar los documentos que tiene en el contenedor conectado al proyecto. En este inicio rápido, importará un conjunto de datos etiquetados de muestra e inicializará el proyecto con el archivo de etiquetas JSON de muestra, por lo que no es necesario agregar etiquetas adicionales.

Para empezar a entrenar el modelo desde Language Studio:

1. Seleccione Trabajos de entrenamiento en el menú de la izquierda.

2. Seleccione Iniciar un trabajo de entrenamiento en el menú superior.

3. Seleccione Train a new model (Entrenar un nuevo modelo) y escriba el nombre del modelo en el cuadro de texto. Para sobrescribir un modelo existente, seleccione esta opción y elija el modelo que quiera sobrescribir del menú desplegable. La sobrescritura de un modelo entrenado es irreversible, pero no afectará a los modelos implementados hasta que implemente el nuevo modelo.

   

4. Seleccione el método de división de datos. Puede elegir Automatically splitting the testing set from training data (Dividir automáticamente el conjunto de pruebas de los datos de entrenamiento), y el sistema dividirá los datos etiquetados entre los conjuntos de entrenamiento y pruebas, según los porcentajes especificados. También puede usar una división manual de datos de entrenamiento y pruebas; esta opción solo está habilitada si ha agregado documentos al conjunto de pruebas. Consulte Etiquetado de datos y Entrenamiento de un modelo para obtener información sobre la división de datos.

5. Seleccione el botón Entrenar.

6. Si selecciona el id. de trabajo de entrenamiento de la lista, aparecerá un panel lateral donde podrá comprobar el progreso del entrenamiento, el estado del trabajo y otros detalles de este trabajo.

   Nota

   • Los trabajos de entrenamiento completados correctamente serán los únicos que generarán modelos.
   • El entrenamiento puede tardar entre un par de minutos y varias horas en función del tamaño de los datos etiquetados.
   • Solo puede haber un trabajo de entrenamiento ejecutándose en un momento dado. No se puede iniciar otro trabajo de entrenamiento dentro del mismo proyecto hasta que se complete el trabajo en ejecución.

He tenido un problema

Implementación del modelo

Por lo general, después de entrenar un modelo, revisaría sus detalles de evaluación y realizaría mejoras si fuera necesario. En este inicio rápido, solo implementará el modelo y lo tendrá disponible para probarlo en Language Studio, o bien puede llamar a la API de predicción.

Para implementar el modelo desde Language Studio:

1. Seleccione Implementación de un modelo en el menú de la izquierda.

2. Seleccione Agregar implementación para iniciar un nuevo trabajo de implementación.

   

3. Seleccione Crear nueva implementación para crear una nueva implementación y asignar un modelo entrenado de la lista desplegable siguiente. También puede sobrescribir una implementación existente; para ello, seleccione esta opción y el modelo entrenado que quiere asignar en la lista desplegable siguiente.

   Nota:

   La sobrescritura de una implementación existente no requiere cambios en la llamada de la API de predicción, pero los resultados que obtendrá se basarán en el modelo recién asignado.

   

4. Seleccione Implementar para iniciar el trabajo de implementación.

5. Después de que la implementación se realice correctamente, aparecerá una fecha de expiración junto a ella. La expiración de la implementación aparece cuando el modelo implementado deja de estar disponible para usarlo en la predicción, lo que suele ocurrir doce meses después de que expire una configuración de entrenamiento.

He tenido un problema

Comprobación del modelo

Una vez implementado el modelo, puede empezar a usarlo para extraer entidades del texto mediante Prediction API. En este inicio rápido, usará Language Studio para enviar la tarea personalizada de predicción de Text Analytics para la salud y visualizar los resultados. En el conjunto de datos de ejemplo que descargó anteriormente, puede encontrar algunos documentos de prueba que puede usar en este paso.

Para comprobar los modelos implementados desde Language Studio:

1. Seleccione Prueba de implementaciones en el menú lateral izquierdo.

2. Seleccione la implementación que quiere probar. Solo se pueden probar modelos que estén asignados a implementaciones.

3. Seleccione la implementación que quiera consultar/probar en la lista desplegable.

4. Puede escribir el texto que quiere enviar a la solicitud o cargar un archivo .txt para usarlo.

5. En el menú superior, seleccione Ejecutar la prueba.

6. En la pestaña Result (Resultado), puede ver las entidades extraídas del texto y sus tipos. También puede ver la respuesta JSON en la pestaña JSON.

   

He tenido un problema

Limpieza de recursos

Cuando ya no necesite el proyecto, puede eliminarlo mediante Language Studio.

1. Seleccione la característica del servicio de lenguaje que va a usar en la parte superior de la página.
2. Selección del proyecto que se quiere eliminar
3. Seleccione Eliminar en el menú.

He tenido un problema

Prerrequisitos

• Una suscripción a Azure: cree una cuenta gratuita

He tenido un problema

Creación de un recurso de Lenguaje de Azure AI y una cuenta de almacenamiento de Azure

Antes de poder usar Análisis de texto personalizado para la salud, deberá crear un recurso de Lenguaje de Azure AI, que le proporcionará las credenciales que necesita para crear un proyecto y empezar a entrenar un modelo. También necesitará una cuenta de almacenamiento de Azure, en la que pueda cargar el conjunto de datos que se usará para compilar el modelo.

Importante

Para empezar a trabajar rápidamente, se recomienda crear un recurso de Lenguaje de Azure AI mediante los pasos que se indican en este artículo, que le permitirán crear el recurso de lenguaje y crear o conectar una cuenta de almacenamiento al mismo tiempo, lo que resulta más fácil que hacerlo después.

Si tiene un recurso preexistente que le gustaría usar, deberá conectarlo a la cuenta de almacenamiento. Consulte crear proyecto para obtener más información.

Creación de un nuevo recurso en Azure Portal

1. Inicie sesión en Azure Portal y cree un recurso de Lenguaje de Azure AI.

2. En la ventana que se abre, seleccione Clasificación de texto personalizado y reconocimiento de entidades con nombre personalizadas en las características personalizadas. Seleccione Continuar para crear el recurso en la parte inferior de la pantalla.

   

3. Cree un recurso de idioma con los detalles siguientes.

   Nombre	Descripción
   Suscripción	Su suscripción de Azure.
   Grupo de recursos	Grupo de recursos que contendrá su recurso. Puede elegir uno existente o crear uno.
   Region	La región del recurso de idioma. Por ejemplo, "Oeste de EE. UU. 2".
   Nombre	Nombre del recurso.
   Plan de tarifa	Plan de tarifa del recurso de idioma. Puede usar el nivel de servicio Gratis (F0) para probar el servicio.

   Nota

   Si recibe un mensaje que indica "la cuenta de inicio de sesión no es propietaria del grupo de recursos de la cuenta de almacenamiento seleccionada", la cuenta debe tener asignado un rol de propietario en el grupo de recursos para poder crear un recurso de idioma. Póngase en contacto con el propietario de la suscripción de Azure para obtener ayuda.

4. En la sección Clasificación de texto personalizado y reconocimiento de entidades con nombre personalizadas, seleccione una cuenta de almacenamiento existente o Nueva cuenta de almacenamiento. Estos valores son para ayudarle a empezar y no necesariamente los valores de la cuenta de almacenamiento que querrá usar en entornos de producción. Para evitar la latencia durante la compilación del proyecto, conéctese a cuentas de almacenamiento en la misma región que el recurso de idioma.

   Valor de la cuenta de almacenamiento	Valor recomendado
   Nombre de la cuenta de almacenamiento	Cualquier nombre
   Tipo de cuenta de almacenamiento	LRS estándar

5. Asegúrese de que el Aviso de IA responsable esté activado. Seleccione Revisar y crear en la parte inferior de la página y, luego, seleccione Crear.

He tenido un problema

Carga de los datos de ejemplo en el contenedor de blobs

Después de crear una cuenta de almacenamiento de Azure y conectarla al recurso de idioma, deberá cargar los documentos del conjunto de datos de muestra en el directorio raíz de su contenedor. Estos archivos se usarán más adelante para entrenar el modelo.

1. Descargue el conjunto de datos de ejemplo de GitHub.

2. Abra el archivo .zip y extraiga la carpeta que contiene los documentos.

3. En Azure Portal, navegue hasta la cuenta de almacenamiento que ha creado y selecciónela.

4. En la cuenta de almacenamiento, seleccione Contenedores en el menú de la izquierda, que se encuentra debajo de Almacenamiento de datos. En la pantalla que aparece, seleccione + Contenedor. Asigne al contenedor el nombre example-data y deje el Nivel de acceso público predeterminado.

   

5. Una vez creado el contenedor, haga clic en él. A continuación, seleccione el botón Cargar para seleccionar los archivos .txt y .json que descargó anteriormente.

   

El conjunto de datos de muestra proporcionado contiene 12 notas clínicas. Cada nota clínica incluye varias entidades médicas y la ubicación del tratamiento. Usaremos las entidades precreadas para extraer las entidades médicas y entrenaremos el modelo personalizado para extraer la ubicación del tratamiento usando los componentes aprendidos y de lista de la entidad.

He tenido un problema

Obtención del punto de conexión y las claves del recurso

1. Vaya a la página de información general del recurso en Azure Portal.

2. En el menú de la izquierda, seleccione Claves y punto de conexión. Usará el punto de conexión y la clave para las solicitudes de API

   

He tenido un problema

Creación de un proyecto personalizado de Text Analytics para la salud

Una vez configurados los recursos y la cuenta de almacenamiento, cree un nuevo proyecto personalizado de Text Analytics para la salud. Un proyecto es un área de trabajo para compilar modelos de Machine Learning personalizados basados en los datos. A su proyecto solo puede acceder usted y otros usuarios que tengan acceso al recurso de idioma que se usa.

Una vez configurados el recurso y la cuenta de almacenamiento, cree un nuevo proyecto personalizado de Text Analytics para la salud.

Desencadenamiento del trabajo del proyecto de importación

Envíe una solicitud POST con la dirección URL, los encabezados y el cuerpo JSON que se incluyen a continuación para importar el archivo de etiquetas. Asegúrese de que el archivo de etiquetas siga el formato aceptado.

Si ya existe un proyecto con el mismo nombre, se reemplazan los datos de ese proyecto.

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

Marcador de posición	Valor	Ejemplo
{ENDPOINT}	Punto de conexión para autenticar la solicitud de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.	myProject
{API-VERSION}	Versión de la API a la que se llama. El valor al que se hace referencia aquí se corresponde con la versión más reciente publicada. Consulte Ciclo de vida del modelo para obtener más información sobre otras versiones de API disponibles.	2022-05-01

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Clave	Valor
Ocp-Apim-Subscription-Key	Clave para el recurso. Se usa para autenticar las solicitudes de API.

Body

Utilice el siguiente código JSON en la solicitud. Reemplace los valores de los marcadores de posición por sus propios valores.

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

Clave	Marcador de posición	Valor	Ejemplo
multilingual	true	Valor booleano que le permite tener documentos en varios idiomas del conjunto de datos y, cuando se implementa el modelo, puede consultarlo en cualquier idioma admitido (no necesariamente incluido en los documentos de entrenamiento). Consulte Compatibilidad de idiomas para obtener más información sobre la compatibilidad multilingüe.	true
projectName	{PROJECT-NAME}	Nombre de proyecto	myproject
storageInputContainerName	{CONTAINER-NAME}	Nombre del contenedor	mycontainer
entities		Matriz que contiene todos los tipos de entidad que tiene en el proyecto. Estos son los tipos de entidad que se extraerán de los documentos.
category		Nombre del tipo de entidad, que puede definir el usuario para las nuevas definiciones de entidad o ser predefinido para las entidades compiladas previamente.
compositionSetting	{COMPOSITION-SETTING}	Regla que define cómo administrar varios componentes en la entidad. Las opciones son combineComponents o separateComponents.	combineComponents
list		Matriz que contiene todas las sublistas que tiene en el proyecto para una entidad específica. Las listas se pueden agregar a entidades compiladas previamente o a nuevas entidades con componentes aprendidos.
sublists	[]	Matriz que contiene sublistas. Cada sublista es una clave y sus valores asociados.	[]
listKey	One	Valor normalizado para la lista de sinónimos a los que se va a asignar en la predicción.	One
synonyms	[]	Matriz que contiene todos los sinónimos	sinónimo
language	{LANGUAGE-CODE}	Cadena que especifica el código de idioma del sinónimo que se usa en la sublista. Si se trata de un proyecto multilingüe y desea admitir la lista de sinónimos para todos los idiomas del proyecto, debe agregar explícitamente los sinónimos a cada idioma. Consulte Compatibilidad con idiomas para obtener más información sobre los códigos de idioma admitidos.	en
values	"EntityNumberone", "FirstEntity"	Lista de cadenas separadas por comas que se buscarán exactamente para la extracción y se asignarán a la clave de la lista.	"EntityNumberone", "FirstEntity"
prebuilts	MedicationName	Nombre del componente compilado previamente que rellena la entidad compilada previamente. Las entidades compiladas previamente se cargan automáticamente en el proyecto de manera predeterminada, pero puede ampliarlas con componentes de lista en el archivo de etiquetas.	MedicationName
documents		Matriz que contiene todos los documentos del proyecto y la lista de las entidades etiquetadas en cada documento.	[]
location	{DOCUMENT-NAME}	Ubicación de los documentos en el contenedor de almacenamiento. Puesto que todos los documentos están en la raíz del contenedor, este debe ser el nombre del documento.	doc1.txt
dataset	{DATASET}	Conjunto de pruebas al que este archivo irá cuando se divida antes del entrenamiento. Los valores posibles que admite este campo son Train y Test.	Train
regionOffset		Posición del carácter inclusivo del inicio del texto.	0
regionLength		Longitud del rectángulo delimitador en términos de caracteres UTF16. El entrenamiento solo tiene en cuenta los datos de esta región.	500
category		Tipo de entidad asociada al intervalo de texto especificado.	Entity1
offset		Posición inicial del texto de la entidad.	25
length		Longitud de la entidad en términos de caracteres UTF16.	20
language	{LANGUAGE-CODE}	Una cadena que especifica el código de idioma del documento que se usa en el proyecto. Si el proyecto es un proyecto multilingüe, elija el código de idioma de la mayoría de los documentos. Consulte Compatibilidad con idiomas para obtener más información sobre los códigos de idioma admitidos.	en

Una vez que envíe la solicitud de API, recibirá una respuesta 202 que indica que el trabajo se ha enviado correctamente. En los encabezados de respuesta, extraiga el valor operation-location. Tendrá el formato siguiente:

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

{JOB-ID} se usa para identificar la solicitud, ya que esta operación es asincrónica. Usará esta dirección URL para obtener el estado del trabajo de importación.

Posibles escenarios de error de esta solicitud:

• El recurso seleccionado no tiene los permisos adecuados para la cuenta de almacenamiento.
• El valor de storageInputContainerName especificado no existe.
• Se ha usado un código de idioma no válido, o el tipo de código de idioma no es una cadena.
• El valor de multilingual es una cadena y no un valor booleano.

He tenido un problema

Obtención del estado del trabajo de importación

Use la siguiente solicitud GET para obtener el estado de la importación del proyecto. Reemplace los valores de los marcadores de posición por sus propios valores.

URL de la solicitud

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

Marcador de posición	Valor	Ejemplo
{ENDPOINT}	Punto de conexión para autenticar la solicitud de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.	myProject
{JOB-ID}	Id. para buscar el estado del entrenamiento del modelo. Este valor se encuentra en el valor de encabezado location que recibió en el paso anterior.	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}	Versión de la API a la que se llama. El valor al que se hace referencia aquí se corresponde con la versión más reciente publicada. Consulte Ciclo de vida del modelo para obtener más información sobre otras versiones de API disponibles.	2022-05-01

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Clave	Valor
Ocp-Apim-Subscription-Key	Clave para el recurso. Se usa para autenticar las solicitudes de API.

He tenido un problema

Entrenamiento de un modelo

Después de crear un proyecto, continúe y empiece a etiquetar los documentos que tiene en el contenedor conectado al proyecto. En este inicio rápido, ha importado un conjunto de datos etiquetado de ejemplo e inicializado el proyecto con el archivo de etiquetas JSON de ejemplo.

Inicio del trabajo de entrenamiento

Una vez importado el proyecto, puede empezar a entrenar el modelo.

Envíe una solicitud POST mediante la dirección URL, los encabezados y el cuerpo JSON para enviar un trabajo de entrenamiento. Reemplace los valores de los marcadores de posición por sus propios valores.

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

Marcador de posición	Valor	Ejemplo
{ENDPOINT}	Punto de conexión para autenticar la solicitud de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.	myProject
{API-VERSION}	Versión de la API a la que se llama. El valor al que se hace referencia aquí se corresponde con la versión más reciente publicada. Consulte Ciclo de vida del modelo para obtener más información sobre otras versiones de API disponibles.	2022-05-01

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Clave	Valor
Ocp-Apim-Subscription-Key	Clave para el recurso. Se usa para autenticar las solicitudes de API.

Cuerpo de la solicitud

Use el siguiente código JSON en el cuerpo de la solicitud. El modelo se denomina {MODEL-NAME} una vez completado el entrenamiento. Solo los trabajos de entrenamiento correctos generan modelos.

{
	"modelLabel": "{MODEL-NAME}",
	"trainingConfigVersion": "{CONFIG-VERSION}",
	"evaluationOptions": {
		"kind": "percentage",
		"trainingSplitPercentage": 80,
		"testingSplitPercentage": 20
	}
}

Clave	Marcador de posición	Valor	Ejemplo
modelLabel	{MODEL-NAME}	Nombre que se asigna al modelo una vez entrenado correctamente.	myModel
trainingConfigVersion	{CONFIG-VERSION}	Se trata de la versión de modelo que se usa para entrenar el modelo.	2022-05-01
evaluationOptions		Opción para dividir los datos en conjuntos de entrenamiento y pruebas.	{}
kind	percentage	Métodos de división. Los valores posibles son percentage o manual. Para más información, consulte Cómo entrenar un modelo.	percentage
trainingSplitPercentage	80	Porcentaje de los datos etiquetados que se incluirán en el conjunto de entrenamiento. El valor recomendado es 80.	80
testingSplitPercentage	20	Porcentaje de los datos etiquetados que se incluirán en el conjunto de pruebas. El valor recomendado es 20.	20

Nota

trainingSplitPercentage y testingSplitPercentage solo son necesarios si Kind está establecido en percentage y la suma de ambos porcentajes es igual a 100.

Una vez que envíe la solicitud de API, recibirá una respuesta 202 que indica que el trabajo se ha enviado correctamente. En los encabezados de respuesta, extraiga el valor location. Tendrá el formato siguiente:

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

{JOB-ID} se usa para identificar la solicitud, ya que esta operación es asincrónica. Puede usar esta dirección URL para obtener el estado del entrenamiento.

He tenido un problema

Obtención del estado del trabajo de entrenamiento

El entrenamiento puede tardar entre 10 y 30 minutos en este conjunto de datos de ejemplo. Puede usar la siguiente solicitud para mantener el sondeo del estado del trabajo de entrenamiento hasta que se complete correctamente.

Use la siguiente solicitud GET para obtener el estado del proceso de entrenamiento del modelo. Reemplace los valores de los marcadores de posición por sus propios valores.

URL de la solicitud

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

Marcador de posición	Valor	Ejemplo
{ENDPOINT}	Punto de conexión para autenticar la solicitud de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.	myProject
{JOB-ID}	Id. para buscar el estado del entrenamiento del modelo. Este valor se encuentra en el valor de encabezado location que recibió en el paso anterior.	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}	Versión de la API a la que se llama. El valor al que se hace referencia aquí se corresponde con la versión más reciente publicada. Consulte Ciclo de vida del modelo para obtener más información sobre otras versiones de API disponibles.	2022-05-01

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Clave	Valor
Ocp-Apim-Subscription-Key	Clave para el recurso. Se usa para autenticar las solicitudes de API.

Cuerpo de la respuesta

Después de enviar la solicitud, recibirá la siguiente respuesta.

{
  "result": {
    "modelLabel": "{MODEL-NAME}",
    "trainingConfigVersion": "{CONFIG-VERSION}",
    "estimatedEndDateTime": "2022-04-18T15:47:58.8190649Z",
    "trainingStatus": {
      "percentComplete": 3,
      "startDateTime": "2022-04-18T15:45:06.8190649Z",
      "status": "running"
    },
    "evaluationStatus": {
      "percentComplete": 0,
      "status": "notStarted"
    }
  },
  "jobId": "{JOB-ID}",
  "createdDateTime": "2022-04-18T15:44:44Z",
  "lastUpdatedDateTime": "2022-04-18T15:45:48Z",
  "expirationDateTime": "2022-04-25T15:44:44Z",
  "status": "running"
}

He tenido un problema

Implementación del modelo

Por lo general, después de entrenar un modelo, revisaría sus detalles de evaluación y realizaría mejoras si fuera necesario. En este inicio rápido, solo implementará el modelo y estará a su disposición para que lo pruebe en Language Studio, o bien puede llamar a la API de predicción.

Inicio del trabajo de implementación

Envíe una solicitud PUT mediante la dirección URL, los encabezados y el cuerpo JSON para enviar un trabajo de implementación. Reemplace los valores de los marcadores de posición por sus propios valores.

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

Marcador de posición	Valor	Ejemplo
{ENDPOINT}	Punto de conexión para autenticar la solicitud de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.	myProject
{DEPLOYMENT-NAME}	Nombre de la implementación. Este valor distingue mayúsculas de minúsculas.	staging
{API-VERSION}	Versión de la API a la que se llama. El valor al que se hace referencia aquí se corresponde con la versión más reciente publicada. Consulte Ciclo de vida del modelo para obtener más información sobre otras versiones de API disponibles.	2022-05-01

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Clave	Valor
Ocp-Apim-Subscription-Key	Clave para el recurso. Se usa para autenticar las solicitudes de API.

Cuerpo de la solicitud

Use el siguiente código JSON en el cuerpo de la solicitud. Use el nombre del modelo que se va a asignar a la implementación.

{
  "trainedModelLabel": "{MODEL-NAME}"
}

Clave	Marcador de posición	Valor	Ejemplo
trainedModelLabel	{MODEL-NAME}	Nombre del modelo que se asignará a la implementación. Solo puede asignar modelos entrenados correctamente. Este valor distingue mayúsculas de minúsculas.	myModel

Una vez que envíe la solicitud de API, recibirá una respuesta 202 que indica que el trabajo se ha enviado correctamente. En los encabezados de respuesta, extraiga el valor operation-location. Tendrá el formato siguiente:

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

{JOB-ID} se usa para identificar la solicitud, ya que esta operación es asincrónica. Puede usar esta dirección URL para obtener el estado de la implementación.

He tenido un problema

Obtención del estado del trabajo de implementación

Use la siguiente solicitud GET para consultar el estado del trabajo de implementación. Puede usar la dirección URL que recibió en el paso anterior o reemplazar los valores de los marcadores de posición siguientes por sus propios valores.

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

Marcador de posición	Valor	Ejemplo
{ENDPOINT}	Punto de conexión para autenticar la solicitud de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.	myProject
{DEPLOYMENT-NAME}	Nombre de la implementación. Este valor distingue mayúsculas de minúsculas.	staging
{JOB-ID}	Id. para buscar el estado del entrenamiento del modelo. Se encuentra en el valor de encabezado location que recibió en el paso anterior.	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION}	Versión de la API a la que se llama. El valor al que se hace referencia aquí se corresponde con la versión más reciente publicada. Consulte Ciclo de vida del modelo para obtener más información sobre otras versiones de API disponibles.	2022-05-01

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Clave	Valor
Ocp-Apim-Subscription-Key	Clave para el recurso. Se usa para autenticar las solicitudes de API.

Cuerpo de la respuesta

Recibirá la siguiente solicitud cuando envíe la solicitud. Siga sondeando este punto de conexión hasta que el parámetro status cambie a "succeeded". Debe obtener un código 200 para indicar el éxito de la solicitud.

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

He tenido un problema

Realización de predicciones con el modelo entrenado.

Una vez implementado el modelo, puede empezar a usarlo para extraer entidades del texto mediante Prediction API. En el conjunto de datos de ejemplo que descargó anteriormente, puede encontrar algunos documentos de prueba que puede usar en este paso.

Envíe una tarea personalizada de Text Analytics para salud

Use esta solicitud POST para iniciar una tarea personalizada de extracción de Text Analytics para la salud.

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

Marcador de posición	Valor	Ejemplo
{ENDPOINT}	Punto de conexión para autenticar la solicitud de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	Versión de la API a la que se llama. El valor al que se hace referencia aquí se corresponde con la versión más reciente publicada. Consulte Ciclo de vida del modelo para obtener más información sobre otras versiones de API disponibles.	2022-05-01

encabezados

Clave	valor
Ocp-Apim-Subscription-Key	La clave que proporciona acceso a esta API.

Body

{
  "displayName": "Extracting entities",
  "analysisInput": {
    "documents": [
      {
        "id": "1",
        "language": "{LANGUAGE-CODE}",
        "text": "Text1"
      },
      {
        "id": "2",
        "language": "{LANGUAGE-CODE}",
        "text": "Text2"
      }
    ]
  },
  "tasks": [
     {
      "kind": "CustomHealthcare",
      "taskName": "Custom TextAnalytics for Health Test",
      "parameters": {
        "projectName": "{PROJECT-NAME}",
        "deploymentName": "{DEPLOYMENT-NAME}"
      }
    }
  ]
}

Clave	Marcador de posición	Valor	Ejemplo
displayName	{JOB-NAME}	Nombre del trabajo.	MyJobName
documents	[{},{}]	Lista de documentos en los que se van a ejecutar las tareas.	[{},{}]
id	{DOC-ID}	Nombre o identificador del documento.	doc1
language	{LANGUAGE-CODE}	Cadena donde se especifica el código de idioma del documento. Si esta clave no se ha especificado, el servicio toma el idioma predeterminado del proyecto que se seleccionó durante la creación del proyecto. Consulte Compatibilidad de idiomas para ver una lista de los códigos de idioma admitidos.	en-us
text	{DOC-TEXT}	Tarea de documento en la que ejecutar las tareas.	Lorem ipsum dolor sit amet
tasks		Lista de tareas que queremos realizar.	[]
taskName	Custom Text Analytics for Health Test	Nombre de la tarea.	Custom Text Analytics for Health Test
kind	CustomHealthcare	Tipo de proyecto o tarea que estamos intentando realizar	CustomHealthcare
parameters		Lista de parámetros que se van a pasar a la tarea.
project-name	{PROJECT-NAME}	Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.	myProject
deployment-name	{DEPLOYMENT-NAME}	Nombre de la implementación. Este valor distingue mayúsculas de minúsculas.	prod

Response

Recibirá una respuesta 202, que indica que la tarea se ha enviado correctamente. En los encabezados de la respuesta, extraiga el valor de operation-location. operation-location tiene el formato siguiente:

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

Puede usar esta dirección URL para consultar el estado de finalización de la tarea y obtener los resultados cuando la tarea se complete.

He tenido un problema

Obtención de resultados de la tarea

Use la siguiente solicitud GET para consultar el estado y los resultados de la tarea de reconocimiento de entidades personalizado.

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

Marcador de posición	Valor	Ejemplo
{ENDPOINT}	Punto de conexión para autenticar la solicitud de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	Versión de la API a la que se llama. El valor al que se hace referencia aquí se corresponde con la versión más reciente publicada. Consulte Ciclo de vida del modelo para obtener más información sobre otras versiones de API disponibles.	2022-05-01

encabezados

Clave	valor
Ocp-Apim-Subscription-Key	La clave que proporciona acceso a esta API.

Cuerpo de la respuesta

La respuesta es un documento JSON con los siguientes parámetros

{
	"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": "CustomHealthcareLROResults",
				"taskName": "Custom Text Analytics for Health Test",
				"lastUpdateDateTime": "2020-10-01T15:01:03Z",
				"status": "succeeded",
				"results": {
					"documents": [
						{
							"entities": [
								{
									"entityComponentInformation": [
										{
											"entityComponentKind": "learnedComponent"
										}
									],
									"offset": 0,
									"length": 11,
									"text": "first entity",
									"category": "Entity1",
									"confidenceScore": 0.98
								},
								{
									"entityComponentInformation": [
										{
											"entityComponentKind": "listComponent"
										}
									],
									"offset": 0,
									"length": 11,
									"text": "first entity",
									"category": "Entity1.Dictionary",
									"confidenceScore": 1.0
								},
								{
									"entityComponentInformation": [
										{
											"entityComponentKind": "learnedComponent"
										}
									],
									"offset": 16,
									"length": 9,
									"text": "entity two",
									"category": "Entity2",
									"confidenceScore": 1.0
								},
								{
									"entityComponentInformation": [
										{
											"entityComponentKind": "prebuiltComponent"
										}
									],
									"offset": 37,
									"length": 9,
									"text": "ibuprofen",
									"category": "MedicationName",
									"confidenceScore": 1,
									"assertion": {
										"certainty": "negative"
									},
									"name": "ibuprofen",
									"links": [
										{
											"dataSource": "UMLS",
											"id": "C0020740"
										},
										{
											"dataSource": "AOD",
											"id": "0000019879"
										},
										{
											"dataSource": "ATC",
											"id": "M01AE01"
										},
										{
											"dataSource": "CCPSS",
											"id": "0046165"
										},
										{
											"dataSource": "CHV",
											"id": "0000006519"
										},
										{
											"dataSource": "CSP",
											"id": "2270-2077"
										},
										{
											"dataSource": "DRUGBANK",
											"id": "DB01050"
										},
										{
											"dataSource": "GS",
											"id": "1611"
										},
										{
											"dataSource": "LCH_NW",
											"id": "sh97005926"
										},
										{
											"dataSource": "LNC",
											"id": "LP16165-0"
										},
										{
											"dataSource": "MEDCIN",
											"id": "40458"
										},
										{
											"dataSource": "MMSL",
											"id": "d00015"
										},
										{
											"dataSource": "MSH",
											"id": "D007052"
										},
										{
											"dataSource": "MTHSPL",
											"id": "WK2XYI10QM"
										},
										{
											"dataSource": "NCI",
											"id": "C561"
										},
										{
											"dataSource": "NCI_CTRP",
											"id": "C561"
										},
										{
											"dataSource": "NCI_DCP",
											"id": "00803"
										},
										{
											"dataSource": "NCI_DTP",
											"id": "NSC0256857"
										},
										{
											"dataSource": "NCI_FDA",
											"id": "WK2XYI10QM"
										},
										{
											"dataSource": "NCI_NCI-GLOSS",
											"id": "CDR0000613511"
										},
										{
											"dataSource": "NDDF",
											"id": "002377"
										},
										{
											"dataSource": "PDQ",
											"id": "CDR0000040475"
										},
										{
											"dataSource": "RCD",
											"id": "x02MO"
										},
										{
											"dataSource": "RXNORM",
											"id": "5640"
										},
										{
											"dataSource": "SNM",
											"id": "E-7772"
										},
										{
											"dataSource": "SNMI",
											"id": "C-603C0"
										},
										{
											"dataSource": "SNOMEDCT_US",
											"id": "387207008"
										},
										{
											"dataSource": "USP",
											"id": "m39860"
										},
										{
											"dataSource": "USPMG",
											"id": "MTHU000060"
										},
										{
											"dataSource": "VANDF",
											"id": "4017840"
										}
									]
								},
								{
									"entityComponentInformation": [
										{
											"entityComponentKind": "prebuiltComponent"
										}
									],
									"offset": 30,
									"length": 6,
									"text": "100 mg",
									"category": "Dosage",
									"confidenceScore": 0.98
								}
							],
							"relations": [
								{
									"confidenceScore": 1,
									"relationType": "DosageOfMedication",
									"entities": [
										{
											"ref": "#/documents/0/entities/1",
											"role": "Dosage"
										},
										{
											"ref": "#/documents/0/entities/0",
											"role": "Medication"
										}
									]
								}
							],
							"id": "1",
							"warnings": []
						}
					],
					"errors": [],
					"modelVersion": "2020-04-01"
				}
			}
		]
	}
}

Clave	Valor de ejemplo	Descripción
entities	[]	Una matriz que contiene todas las entidades extraídas.
entityComponentKind	prebuiltComponent	Una variable que indica qué componente devolvió la entidad específica. Valores posibles: prebuiltComponent, learnedComponent, listComponent
offset	0	Un número que denota el punto de inicio de la entidad extraída indexando sobre los caracteres
length	10	Un número que denota la longitud de la entidad extraída en número de caracteres.
texto	first entity	Texto extraído para una entidad específica.
category	MedicationName	El nombre del tipo o categoría de entidad correspondiente al texto extraído.
ConfidenceScore	0.9	Un número que indica el nivel de certeza del modelo de la entidad extraída, de 0 a 1. Un número más alto indica mayor certeza.
assertion	certainty	Aserciones asociadas a la entidad extraída. Las aserciones solo se admiten para las entidades Text Analytics para la salud predefinidas.
name	Ibuprofen	El nombre normalizado para la vinculación de entidades asociada con la entidad extraída. La vinculación de entidades solo se admite para Text Analytics predefinidas para entidades sanitarias.
vínculos	[]	Una matriz que contiene todos los resultados de la vinculación de entidades asociada a la entidad extraída. La vinculación de entidades solo se admite para Text Analytics predefinidas para entidades sanitarias.
dataSource	UMLS	La norma de referencia resultante de la vinculación de entidades asociada a la entidad extraída. La vinculación de entidades solo se admite para Text Analytics predefinidas para entidades sanitarias.
ID	C0020740	El código de referencia resultante de la vinculación de entidades asociada a la entidad extraída perteneciente a la fuente de datos extraída. La vinculación de entidades solo se admite para Text Analytics predefinidas para entidades sanitarias.
relaciones	[]	Matriz que contiene todas las relaciones extraídas. La extracción de relaciones solo se admite para Text Analytics para entidades de salud predefinidas.
relationType	DosageOfMedication	La categoría de la relación extraída. La extracción de relaciones solo se admite para Text Analytics para entidades de salud predefinidas.
entities	"Dosage", "Medication"	Las entidades asociadas a la relación extraída. La extracción de relaciones solo se admite para Text Analytics para entidades de salud predefinidas.

He tenido un problema

Limpieza de recursos

Cuando ya no necesite el proyecto, puede eliminarlo con la siguiente solicitud DELETE. Reemplace los valores de los marcadores de posición por sus propios valores.

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

Marcador de posición	Valor	Ejemplo
{ENDPOINT}	Punto de conexión para autenticar la solicitud de API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nombre del proyecto. Este valor distingue mayúsculas de minúsculas.	myProject
{API-VERSION}	Versión de la API a la que se llama. El valor al que se hace referencia aquí se corresponde con la versión más reciente publicada. Consulte Ciclo de vida del modelo para obtener más información sobre otras versiones de API disponibles.	2022-05-01

encabezados

Use el siguiente encabezado para autenticar la solicitud.

Clave	valor
Ocp-Apim-Subscription-Key	Clave para el recurso. Se usa para autenticar las solicitudes de API.

Una vez que envíe la solicitud de API, recibirá una respuesta 202 que indica que se ha realizado correctamente, lo que significa que el proyecto se ha eliminado. Una llamada correcta devuelve un encabezado Operation-Location que se usa para comprobar el estado del trabajo.

He tenido un problema

Pasos siguientes

• Información general sobre el análisis de textos de mantenimiento

Después de crear el modelo de extracción de entidades, puede hacer lo siguiente:

• Uso de la API en tiempo de ejecución para extraer entidades

Cuando empiece a crear sus propios proyectos personalizados de Text Analytics para la salud, consulte los artículos de procedimientos para obtener más información sobre el etiquetado de datos, la formación y el consumo de su modelo con mayor detalle:

• Selección de datos y diseño de esquemas
• Etiquetado de datos
• Entrenamiento de un modelo
• Evaluación del modelo