Skicka frågor till din anpassade Textanalys för hälsomodell

När distributionen har lagts till kan du fråga distributionen för att extrahera entiteter från din text baserat på den modell som du tilldelade distributionen. Du kan köra frågor mot distributionen programmatiskt med hjälp av FÖRUTSÄGELSE-API:et.

Testa distribuerad modell

Du kan använda Language Studio för att skicka anpassade Textanalys för hälsouppgiften och visualisera resultatet.

Så här testar du dina distribuerade modeller från Language Studio:

1. Välj Testa distributioner på menyn till vänster.

2. Välj den distribution som du vill testa. Du kan bara testa modeller som har tilldelats distributioner.

3. För flerspråkiga projekt går du till listrutan språk och väljer språket för den text som du testar.

4. Välj den distribution som du vill köra frågor mot/testa i listrutan.

5. Du kan ange den text som du vill skicka till begäran eller ladda upp en .txt fil som ska användas.

6. Välj Kör testet på den översta menyn.

7. På fliken Resultat kan du se de extraherade entiteterna från din text och deras typer. Du kan också visa JSON-svaret under fliken JSON .

Skicka en anpassad textanalys för hälsobegäran till din modell

Language Studio

1. När distributionsjobbet har slutförts väljer du den distribution som du vill använda och på den översta menyn väljer du Hämta förutsägelse-URL.

   

2. I fönstret som visas under pivoten Skicka kopierar du exempelbegärans URL och brödtext. Ersätt platshållarvärdena, till exempel YOUR_DOCUMENT_HERE och YOUR_DOCUMENT_LANGUAGE_HERE med den faktiska text och det språk som du vill bearbeta.

3. POST Skicka cURL-begäran i terminalen eller kommandotolken. Du får ett 202-svar med API-resultatet om begäran lyckades.

4. I svarshuvudet får du extrahering {JOB-ID} från operation-location, som har formatet: {ENDPOINT}/language/analyze-text/jobs/<JOB-ID}>

5. Tillbaka till Language Studio; välj Hämta pivot från samma fönster som du fick exempelbegäran du fick tidigare och kopiera exempelbegäran till en textredigerare.

6. Lägg till ditt jobb-ID efter /jobs/ i URL:en med hjälp av det ID som du extraherade från föregående steg.

7. GET Skicka cURL-begäran i terminalen eller kommandotolken.

REST-API

Först måste du hämta resursnyckeln och slutpunkten:

1. Gå till resursöversiktssidan i Azure Portal

2. På menyn till vänster väljer du Nycklar och Slutpunkt. Du använder slutpunkten och nyckeln för API-begäranden

   

Skicka en anpassad Textanalys för hälsoaktivitet

Använd den här POST-begäran om du vill starta en anpassad Textanalys för hälsoextrahering.

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

Platshållare	Värde	Exempel
{ENDPOINT}	Slutpunkten för att autentisera din API-begäran.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	Den version av API:et som du anropar. Värdet som refereras här är för den senaste versionen som släppts. Mer information om andra tillgängliga API-versioner finns i Modelllivscykel .	2022-05-01

Sidhuvuden

Tangent	Värde
Ocp-Apim-Subscription-Key	Din nyckel som ger åtkomst till det här API:et.

Brödtext

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

Nyckel	Platshållare	Värde	Exempel
displayName	{JOB-NAME}	Ditt jobbnamn.	MyJobName
documents	[{},{}]	Lista över dokument som aktiviteter ska köras på.	[{},{}]
id	{DOC-ID}	Dokumentnamn eller ID.	doc1
language	{LANGUAGE-CODE}	En sträng som anger språkkoden för dokumentet. Om den här nyckeln inte anges förutsätter tjänsten standardspråket för projektet som valdes när projektet skapades. Se språkstöd för en lista över språkkoder som stöds.	en-us
text	{DOC-TEXT}	Dokumentuppgift som aktiviteterna ska köras på.	Lorem ipsum dolor sit amet
tasks		Lista över uppgifter som vi vill utföra.	[]
taskName	Custom Text Analytics for Health Test	Uppgiftsnamnet	Custom Text Analytics for Health Test
kind	CustomHealthcare	Den typ av projekt eller uppgift som vi försöker utföra	CustomHealthcare
parameters		Lista över parametrar som ska skickas till uppgiften.
project-name	{PROJECT-NAME}	Namnet på projektet. Det här värdet är skiftlägeskänsligt.	myProject
deployment-name	{DEPLOYMENT-NAME}	Namnet på distributionen. Det här värdet är skiftlägeskänsligt.	prod

Response

Du får ett 202-svar som anger att din uppgift har skickats. I svarshuvudena extraherar du operation-location. operation-location är formaterad så här:

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

Du kan använda den här URL:en för att fråga efter uppgiftens slutförandestatus och få resultatet när aktiviteten har slutförts.

Hämta aktivitetsresultat

Använd följande GET-begäran för att fråga efter status/resultat för den anpassade entitetsigenkänningsaktiviteten.

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

Platshållare	Värde	Exempel
{ENDPOINT}	Slutpunkten för att autentisera din API-begäran.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{API-VERSION}	Den version av API:et som du anropar. Värdet som refereras här är för den senaste versionen som släppts. Mer information om andra tillgängliga API-versioner finns i Modelllivscykel .	2022-05-01

Sidhuvuden

Tangent	Värde
Ocp-Apim-Subscription-Key	Din nyckel som ger åtkomst till det här API:et.

Svarstext

Svaret är ett JSON-dokument med följande parametrar

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

Nyckel	Exempelvärde	beskrivning
entiteter	[]	En matris som innehåller alla extraherade entiteter.
entityComponentKind	prebuiltComponent	En variabel som anger vilken komponent som returnerade den specifika entiteten. Möjliga värden: prebuiltComponent, learnedComponent, listComponent
förskjutning	0	Ett tal som anger startpunkten för den extraherade entiteten genom att indexera över tecknen
längd	10	Ett tal som anger längden på den extraherade entiteten i antal tecken.
text	first entity	Texten som extraherades för en specifik entitet.
category	MedicationName	Namnet på entitetstypen eller kategorin som motsvarar den extraherade texten.
confidenceScore	0.9	Ett tal som anger modellens säkerhetsnivå för den extraherade entiteten från 0 till 1 med högre tal som anger högre säkerhet.
assertion	certainty	Intyg som är associerade med den extraherade entiteten. Kontroller stöds endast för fördefinierade Textanalys för hälsoentiteter.
name	Ibuprofen	Det normaliserade namnet för den entitetslänkning som är associerad med den extraherade entiteten. Entitetslänkning stöds endast för fördefinierade Textanalys för hälsoentiteter.
länkar	[]	En matris som innehåller alla resultat från entitetslänkningen som är associerad med den extraherade entiteten. Entitetslänkning stöds endast för fördefinierade Textanalys för hälsoentiteter.
dataSource	UMLS	Referensstandarden som är resultatet av entitetslänkningen som är associerad med den extraherade entiteten. Entitetslänkning stöds endast för fördefinierade Textanalys för hälsoentiteter.
ID	C0020740	Referenskoden som är resultatet av entitetens länkning som är associerad med den extraherade entiteten som tillhör den extraherade datakällan. Entitetslänkning stöds endast för fördefinierade Textanalys för hälsoentiteter.
släkt	[]	Matris som innehåller alla extraherade relationer. Relationsextrahering stöds endast för fördefinierade Textanalys för hälsoentiteter.
relationType	DosageOfMedication	Kategorin för den extraherade relationen. Relationsextrahering stöds endast för fördefinierade Textanalys för hälsoentiteter.
entiteter	"Dosage", "Medication"	Entiteterna som är associerade med den extraherade relationen. Relationsextrahering stöds endast för fördefinierade Textanalys för hälsoentiteter.

Nästa steg

• Anpassad textanalys för hälsa