İlk olarak kaynak anahtarınızı ve uç noktanızı almanız gerekir:
Azure portalında kaynağınıza genel bakış sayfasına gidin
Sol taraftaki menüden Anahtarlar ve Uç Nokta'yı seçin. API istekleri için uç noktayı ve anahtarı kullanacaksınız
Sistem durumu görevi için özel Metin Analizi gönderme
Sistem durumu ayıklama görevi için özel bir Metin Analizi başlatmak için bu POST isteğini kullanın.
{ENDPOINT}/language/analyze-text/jobs?api-version={API-VERSION}
Yer tutucu |
Değer |
Örnek |
{ENDPOINT} |
API isteğinizin kimliğini doğrulamak için uç nokta. |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{API-VERSION} |
Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüme yöneliktir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinmek için bkz . Model yaşam döngüsü . |
2022-05-01 |
Anahtar |
Değer |
Ocp-Apim-Subscription-Key |
Bu API'ye erişim sağlayan anahtarınız. |
Gövde
{
"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}"
}
}
]
}
Anahtar |
Yer tutucu |
Değer |
Örnek |
displayName |
{JOB-NAME} |
İş adınız. |
MyJobName |
documents |
[{},{}] |
Görevlerin çalıştırılacak belgelerin listesi. |
[{},{}] |
id |
{DOC-ID} |
Belge adı veya kimliği. |
doc1 |
language |
{LANGUAGE-CODE} |
Belgenin dil kodunu belirten bir dize. Bu anahtar belirtilmezse, hizmet proje oluşturma sırasında seçilen projenin varsayılan dilini kabul eder. Desteklenen dil kodlarının listesi için bkz . dil desteği . |
en-us |
text |
{DOC-TEXT} |
Görevlerin çalıştırılacak belge görevi. |
Lorem ipsum dolor sit amet |
tasks |
|
Gerçekleştirmek istediğimiz görevlerin listesi. |
[] |
taskName |
Custom Text Analytics for Health Test |
Görev adı |
Custom Text Analytics for Health Test |
kind |
CustomHealthcare |
Gerçekleştirmeye çalıştığımız proje veya görev türü |
CustomHealthcare |
parameters |
|
Göreve geçirecek parametrelerin listesi. |
|
project-name |
{PROJECT-NAME} |
Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır. |
myProject |
deployment-name |
{DEPLOYMENT-NAME} |
Dağıtımınızın adı. Bu değer büyük/küçük harfe duyarlıdır. |
prod |
Response
Görevinizin başarıyla gönderildiğini belirten bir 202 yanıtı alırsınız. Yanıt üst bilgilerinde ayıklayın operation-location
.
operation-location
şu şekilde biçimlendirilir:
{ENDPOINT}/language/analyze-text/jobs/{JOB-ID}?api-version={API-VERSION}
Görev tamamlanma durumunu sorgulamak ve görev tamamlandığında sonuçları almak için bu URL'yi kullanabilirsiniz.
Görev sonuçlarını alma
Özel varlık tanıma görevinin durumunu/sonuçlarını sorgulamak için aşağıdaki GET isteğini kullanın.
{ENDPOINT}/language/analyze-text/jobs/{JOB-ID}?api-version={API-VERSION}
Yer tutucu |
Değer |
Örnek |
{ENDPOINT} |
API isteğinizin kimliğini doğrulamak için uç nokta. |
https://<your-custom-subdomain>.cognitiveservices.azure.com |
{API-VERSION} |
Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüme yöneliktir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinmek için bkz . Model yaşam döngüsü . |
2022-05-01 |
Anahtar |
Değer |
Ocp-Apim-Subscription-Key |
Bu API'ye erişim sağlayan anahtarınız. |
Yanıt Gövdesi
Yanıt, aşağıdaki parametrelere sahip bir JSON belgesidir
{
"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"
}
}
]
}
}
Anahtar |
Örnek Değer |
Açıklama |
varlıklar |
[] |
Ayıklanan tüm varlıkları içeren bir dizi. |
entityComponentKind |
prebuiltComponent |
Belirli bir varlığı döndüren bileşeni gösteren değişken. Olası değerler: prebuiltComponent , learnedComponent , listComponent |
fark |
0 |
Karakterler üzerinde dizin oluşturarak ayıklanan varlığın başlangıç noktasını belirten bir sayı |
uzunluk |
10 |
Ayıklanan varlığın uzunluğunu karakter sayısıyla belirten bir sayı. |
text |
first entity |
Belirli bir varlık için ayıklanan metin. |
category |
MedicationName |
Ayıklanan metne karşılık gelen varlık türünün veya kategorinin adı. |
confidenceScore |
0.9 |
Modelin ayıklanan varlığın kesinlik düzeyini belirten ve 0 ile 1 arasında değişen ve daha yüksek bir sayıyla daha yüksek kesinlik belirten bir sayı. |
assertion |
certainty |
Ayıklanan varlıkla ilişkili onaylar . Onaylar yalnızca sistem durumu varlıkları için önceden oluşturulmuş Metin Analizi için desteklenir. |
Adı |
Ibuprofen |
Ayıklanan varlıkla ilişkili varlık bağlaması için normalleştirilmiş ad. Varlık bağlama yalnızca sistem durumu varlıkları için önceden oluşturulmuş Metin Analizi için desteklenir. |
bağlantılar |
[] |
Ayıklanan varlıkla ilişkili varlık bağlantısındaki tüm sonuçları içeren bir dizi. Varlık bağlama yalnızca sistem durumu varlıkları için önceden oluşturulmuş Metin Analizi için desteklenir. |
Datasource |
UMLS |
Ayıklanan varlıkla ilişkili varlık bağlamasından kaynaklanan başvuru standardı. Varlık bağlama yalnızca sistem durumu varlıkları için önceden oluşturulmuş Metin Analizi için desteklenir. |
Kimlik |
C0020740 |
Ayıklanan veri kaynağına ait ayıklanan varlıkla ilişkili varlık bağlamasından kaynaklanan başvuru kodu. Varlık bağlama yalnızca sistem durumu varlıkları için önceden oluşturulmuş Metin Analizi için desteklenir. |
Ilişkiler |
[] |
Ayıklanan tüm ilişkileri içeren dizi. İlişki ayıklama yalnızca sistem durumu varlıkları için önceden oluşturulmuş Metin Analizi için desteklenir. |
relationType |
DosageOfMedication |
Ayıklanan ilişkinin kategorisi. İlişki ayıklama yalnızca sistem durumu varlıkları için önceden oluşturulmuş Metin Analizi için desteklenir. |
varlıklar |
"Dosage", "Medication" |
Ayıklanan ilişkiyle ilişkili varlıklar. İlişki ayıklama yalnızca sistem durumu varlıkları için önceden oluşturulmuş Metin Analizi için desteklenir. |