Najpierw musisz uzyskać klucz zasobu i punkt końcowy:
Przejdź do strony przeglądu zasobu w witrynie Azure Portal
Z menu po lewej stronie wybierz pozycję Klucze i punkt końcowy. Użyjesz punktu końcowego i klucza dla żądań interfejsu API
Przesyłanie niestandardowego analiza tekstu dla zadania kondycji
Użyj tego żądania POST, aby uruchomić niestandardowe analiza tekstu na potrzeby wyodrębniania kondycji.
{ENDPOINT}/language/analyze-text/jobs?api-version={API-VERSION}
Symbol zastępczy |
Wartość |
Przykład |
{ENDPOINT} |
Punkt końcowy do uwierzytelniania żądania interfejsu API. |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{API-VERSION} |
Wersja wywoływanego interfejsu API. Wartość, do których odwołuje się tutaj, dotyczy najnowszej wersji wydanej. Zobacz Cykl życia modelu, aby dowiedzieć się więcej o innych dostępnych wersjach interfejsu API. |
2022-05-01 |
Key |
Wartość |
Ocp-Apim-Subscription-Key |
Klucz, który zapewnia dostęp do tego interfejsu API. |
Treść
{
"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}"
}
}
]
}
Klucz |
Symbol zastępczy |
Wartość |
Przykład |
displayName |
{JOB-NAME} |
Nazwa zadania. |
MyJobName |
documents |
[{},{}] |
Lista dokumentów do uruchamiania zadań podrzędnych. |
[{},{}] |
id |
{DOC-ID} |
Nazwa lub identyfikator dokumentu. |
doc1 |
language |
{LANGUAGE-CODE} |
Ciąg określający kod języka dokumentu. Jeśli ten klucz nie zostanie określony, usługa przyjmie domyślny język projektu wybranego podczas tworzenia projektu. Aby uzyskać listę obsługiwanych kodów języków, zobacz Obsługa języków. |
en-us |
text |
{DOC-TEXT} |
Dokumentowanie zadania podrzędnego do uruchamiania zadań podrzędnych. |
Lorem ipsum dolor sit amet |
tasks |
|
Lista zadań, które chcemy wykonać. |
[] |
taskName |
Custom Text Analytics for Health Test |
Nazwa zadania |
Custom Text Analytics for Health Test |
kind |
CustomHealthcare |
Rodzaj projektu lub zadania, który próbujemy wykonać |
CustomHealthcare |
parameters |
|
Lista parametrów do przekazania do zadania. |
|
project-name |
{PROJECT-NAME} |
Nazwa projektu. Ta wartość jest uwzględniana w wielkości liter. |
myProject |
deployment-name |
{DEPLOYMENT-NAME} |
Nazwa wdrożenia. Ta wartość jest uwzględniana w wielkości liter. |
prod |
Response
Otrzymasz odpowiedź z 202 r. wskazującą, że zadanie zostało pomyślnie przesłane. W nagłówkach odpowiedzi wyodrębnij element operation-location
.
operation-location
jest sformatowany w następujący sposób:
{ENDPOINT}/language/analyze-text/jobs/{JOB-ID}?api-version={API-VERSION}
Możesz użyć tego adresu URL, aby wykonać zapytanie dotyczące stanu ukończenia zadania i uzyskać wyniki po zakończeniu zadania.
Pobieranie wyników zadania
Użyj następującego żądania GET , aby wykonać zapytanie dotyczące stanu/wyników zadania niestandardowego rozpoznawania jednostek.
{ENDPOINT}/language/analyze-text/jobs/{JOB-ID}?api-version={API-VERSION}
Symbol zastępczy |
Wartość |
Przykład |
{ENDPOINT} |
Punkt końcowy do uwierzytelniania żądania interfejsu API. |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{API-VERSION} |
Wersja wywoływanego interfejsu API. Wartość, do których odwołuje się tutaj, dotyczy najnowszej wersji wydanej. Zobacz Cykl życia modelu, aby dowiedzieć się więcej o innych dostępnych wersjach interfejsu API. |
2022-05-01 |
Key |
Wartość |
Ocp-Apim-Subscription-Key |
Klucz, który zapewnia dostęp do tego interfejsu API. |
Treść odpowiedzi
Odpowiedź jest dokumentem JSON z następującymi parametrami
{
"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"
}
}
]
}
}
Klucz |
Przykładowa wartość |
opis |
encje |
[] |
Tablica zawierająca wszystkie wyodrębnione jednostki. |
entityComponentKind |
prebuiltComponent |
Zmienna wskazująca, który składnik zwrócił określoną jednostkę. Możliwe wartości: prebuiltComponent , , learnedComponent listComponent |
offset |
0 |
Liczba określająca punkt początkowy wyodrębnionej jednostki przez indeksowanie znaków |
length |
10 |
Liczba oznaczającą długość wyodrębnionej jednostki w liczbie znaków. |
text |
first entity |
Tekst wyodrębniony dla określonej jednostki. |
category |
MedicationName |
Nazwa typu jednostki lub kategorii odpowiadającej wyodrębnionemu tekstowi. |
confidenceScore |
0.9 |
Liczba oznacza poziom pewności wyodrębnionej jednostki z zakresu od 0 do 1 z wyższą liczbą oznaczającą większą pewność. |
assertion |
certainty |
Asercja skojarzona z wyodrębnianą jednostką. Asercji są obsługiwane tylko w przypadku wstępnie utworzonych analiza tekstu dla jednostek kondycji. |
name |
Ibuprofen |
Znormalizowana nazwa połączenia jednostki skojarzonej z wyodrębnianą jednostką. Łączenie jednostek jest obsługiwane tylko w przypadku wstępnie utworzonych analiza tekstu dla jednostek kondycji. |
połączenia |
[] |
Tablica zawierająca wszystkie wyniki z jednostki łączącej się z wyodrębnianą jednostką. Łączenie jednostek jest obsługiwane tylko w przypadku wstępnie utworzonych analiza tekstu dla jednostek kondycji. |
dataSource |
UMLS |
Standard referencyjny wynikający z powiązania jednostki skojarzonej z wyodrębnianą jednostką. Łączenie jednostek jest obsługiwane tylko w przypadku wstępnie utworzonych analiza tekstu dla jednostek kondycji. |
ID |
C0020740 |
Kod referencyjny wynikający z połączenia jednostki skojarzonej z wyodrębnioną jednostką należącą do wyodrębnionego źródła danych. Łączenie jednostek jest obsługiwane tylko w przypadku wstępnie utworzonych analiza tekstu dla jednostek kondycji. |
Stosunków |
[] |
Tablica zawierająca wszystkie wyodrębnione relacje. Wyodrębnianie relacji jest obsługiwane tylko w przypadku wstępnie utworzonych analiza tekstu dla jednostek kondycji. |
relationType |
DosageOfMedication |
Kategoria wyodrębnionej relacji. Wyodrębnianie relacji jest obsługiwane tylko w przypadku wstępnie utworzonych analiza tekstu dla jednostek kondycji. |
encje |
"Dosage", "Medication" |
Jednostki skojarzone z wyodrębnianą relacją. Wyodrębnianie relacji jest obsługiwane tylko w przypadku wstępnie utworzonych analiza tekstu dla jednostek kondycji. |