@azure/ai-text-analytics package

بيانات اعتماد مستندة إلى مفتاح ثابت تدعم تحديث قيمة المفتاح الأساسي.

عميل للتفاعل مع ميزات تحليل النص في Azure Cognitive Language Service.

يحتاج العميل إلى نقطة نهاية مورد Language وطريقة مصادقة مثل مفتاح API أو AAD. يمكن العثور على مفتاح واجهة برمجة التطبيقات ونقطة النهاية في صفحة مورد اللغة في مدخل Microsoft Azure. سيتم تحديد موقعها في صفحة مفاتيح المورد ونقطة النهاية، ضمن إدارة الموارد.

أمثلة للمصادقة:

مفتاح واجهة برمجة التطبيقات

import { TextAnalysisClient, AzureKeyCredential } from "@azure/ai-text-analytics";

const endpoint = "https://<resource name>.cognitiveservices.azure.com";
const credential = new AzureKeyCredential("<api key>");

const client = new TextAnalysisClient(endpoint, credential);

Azure Active Directory

راجع حزمة @azure/identity لمزيد من المعلومات حول المصادقة باستخدام Azure Active Directory.

import { TextAnalysisClient } from "@azure/ai-text-analytics";
import { DefaultAzureCredential } from "@azure/identity";

const endpoint = "https://<resource name>.cognitiveservices.azure.com";
const credential = new DefaultAzureCredential();

const client = new TextAnalysisClient(endpoint, credential);

التكوين الشائع لكافة الإجراءات.

بيانات تعريف الإجراء.

الخيارات الشائعة في جميع إجراءات الدفعات.

بدأت بيانات التعريف للعمليات طويلة الأمد بواسطة beginAnalyzeBatch.

حالة بدء تحليل عملية الاستقصاء.

كائن يحتوي على التوجه المتوقع ودرجات الثقة ومعلومات أخرى حول تقييم الهدف. على سبيل المثال، في الجملة "الطعام جيد"، يكون تقييم "الطعام" الهدف "جيدا".

خطأ إجراء تحليل الدفعة.

حالة إجراء مجمع

حالة إجراء تم دفعه بنجاح.

خيارات لبدء عملية تحليل الإجراءات.

نتيجة تصنيف من إجراء فئة مفردة لمستند مخصص

بيانات تعريف الإجراء المخصص.

خيارات لإجراء دفعة التعرف على الكيان المخصص.

نتيجة عملية التعرف على الكيانات المخصصة على مستند واحد، والتي تحتوي على مجموعة من الكيانات المحددة في هذا المستند.

خيارات لإجراء دفعة تصنيف متعددة التسميات مخصصة.

نتيجة تصنيف عملية فئات المستندات المتعددة المخصصة على مستند متعدد، تحتوي على نتيجة التصنيف.

خيارات لإجراء دفعة تصنيف تسمية واحدة مخصصة.

نتيجة تصنيف عملية فئة واحدة للمستند المخصص على مستند واحد، تحتوي على نتيجة التصنيف.

معلومات حول لغة المستند كما هو محدد بواسطة خدمة Language.

يمثل تحذيرا تمت مواجهته أثناء معالجة مستند.

كلمة أو عبارة تم تعريفها ككيان مصنف ضمن تصنيف من الأنواع. يتم وصف مجموعة الفئات التي تعرفها خدمة Language في https://docs.microsoft.com/azure/cognitive-services/language-service/named-entity-recognition/concepts/named-entity-categories .

نوع يمثل مرجعا للكيان الصحي في كتالوج كيان معين.

خيارات كيان يربط إجراء الدفعة.

نتيجة إجراء ربط كيان على مستند واحد، يحتوي على مجموعة من LinkedEntity العناصر المحددة في هذا المستند.

خيارات لإجراء دفعة التعرف على الكيان.

نتيجة إجراء التعرف على الكيان على مستند واحد، يحتوي على مجموعة من عناصر Entity المحددة في هذا المستند.

خيارات لإجراء دفعة تلخيص استخراجي.

كائن يصف بيانات التعريف حول كيان الرعاية الصحية مثل ما إذا كان افتراضيا أو شرطيا.

خيارات لإجراء دفعة الرعاية الصحية.

يمثل كيان الرعاية الصحية كعقدة في رسم بياني موجه حيث تكون الحواف نوعا معينا من العلاقة بين العقد المصدر والهدف.

علاقة بين كيانين أو أكثر من كيانات الرعاية الصحية.

كيان الرعاية الصحية الذي يلعب دورا محددا في العلاقة.

نتائج عملية الرعاية الصحية الناجحة لمستند واحد.

خيارات لإجراء دفعة استخراج العبارة الرئيسية.

نتيجة إجراء استخراج العبارة الرئيسية على مستند واحد، يحتوي على مجموعة من العبارات الرئيسية المحددة في هذا المستند.

إدخال في عملية الكشف عن اللغة. يحدد هذا الكائن معرف مستند فريد، بالإضافة إلى النص الكامل للمستند وتلميح يشير إلى بلد أصل المستند لمساعدة النموذج التنبؤي للغة في الكشف عن لغة المستند.

نتيجة إجراء الكشف عن اللغة على مستند واحد، يحتوي على تنبؤ باللغة المكتوبة في المستند.

كلمة أو عبارة تم تعريفها ككيان معروف داخل قاعدة بيانات، بما في ذلك اسمها الرسمي (المبهم) وارتباط لمعلومات الكيان داخل قاعدة البيانات المصدر.

تفاصيل حول السلسلة الفرعية المحددة في مستند يشير إلى كيان مرتبط تم تحديده بواسطة نموذج اللغة.

عنصر رأي ملغم يمثل رأيا استخرجناه من جملة. وهي تتكون من هدف تتعلق به هذه التقييمات، والتقييمات الفعلية نفسها.

خيارات لإجراء دفعة التعرف على كيان pii.

نتيجة إجراء التعرف على كيان pii على مستند واحد، يحتوي على مجموعة كائنات Entity المحددة في هذا المستند.

خيارات لبدء عملية تحليل الإجراءات.

التوجه المتوقع لنص معين. لمزيد من المعلومات حول توجه النص، راجع https://docs.microsoft.com//azure/cognitive-services/language-service/sentiment-opinion-mining/overview.

خيارات لإجراء دفعة تحليل التوجه.

نتيجة إجراء تحليل المشاعر على مستند واحد، يحتوي على التوجه المتوقع لكل جملة وكذلك للمستند الكامل.

يمثل درجات الثقة بين 0 و1 عبر جميع فئات المشاعر: إيجابية ومحايدة وسلبية.

نتيجة إجراء استخراج التلخيص على مستند واحد، يحتوي على مجموعة من الملخص المحدد في ذلك المستند.

جملة تعد جزءا من الملخص المستخرج.

يمثل درجات الثقة عبر جميع فئات المشاعر: إيجابية ومحايدة وسالبة.

يحتوي TargetSentiment على التوجه المتوقع ودرجات الثقة ومعلومات أخرى حول هدف منتج. الهدف من المنتج/الخدمة هو مكون رئيسي لهذا المنتج/الخدمة. على سبيل المثال في "الطعام في فندق فو جيد"، "الطعام" هو الهدف من "فندق فو".

خيارات التكوين TextAnalysisClient.

اكتب وصف خطأ واجهة برمجة التطبيقات.

النوع الأساسي لنتائج الخطأ لإجراء مطابق لمستند واحد.

الخيارات الشائعة في جميع العمليات.

النوع الأساسي لنتائج إجراء يتوافق مع مستند إدخال واحد.

إذا تم تحديد includeStatistics=true في الطلب، فسيحتوي هذا الحقل على معلومات حول حمولة الطلب.

كائن يمثل مستندا نصيا فرديا ليتم تحليله بواسطة خدمة Language. يحتوي المستند على معرف مستند فريد ونص كامل للمستند ولغة نص المستند.

إذا تم تحديد includeStatistics=true في الطلب، فسيحتوي هذا الحقل على معلومات حول حمولة المستند.

كائن المعلمات لمهمة تحليل نص باستخدام نماذج مخصصة.

التكوين الشائع لكافة الإجراءات التي تستخدم النماذج التي تم إنشاؤها مسبقا.

نوع الإجراءات التي يدعمها أسلوب لتحليل.

نوع المعلمات لكل إجراء في $AnalyzeActionNames.

مجموعة من الإجراءات.

نوع الإجراءات التي يدعمها أسلوب beginAnalyzeBatch.

قام الاستقصاء باستقصاء العمليات طويلة الأمد التي بدأتها beginAnalyzeBatch.

نتائج مجموعة من الإجراءات.

نوع نتائج كل إجراء في $AnalyzeActionNames.

نتيجة إجراء مجمع.

المعلمات المدعومة لمهمة كيانات مخصصة.

نتيجة إجراء دفعة التعرف على الكيان المخصص.

نتيجة خطأ من عملية التعرف على الكيانات المخصصة على مستند واحد.

نتيجة عملية التعرف المخصص على الكيانات على مستند واحد.

خيارات إجراء مخصص لتصنيف متعدد التسميات

نتيجة إجراء دفعي مخصص لتصنيف متعدد التسميات.

نتيجة خطأ من عملية تصنيف المستندات متعددة الفئات المخصصة على مستند متعدد.

نتيجة عملية تصنيف فئات المستندات المتعددة المخصصة على مستند متعدد.

خيارات إجراء مخصص لتصنيف تسمية واحدة

نتيجة إجراء دفعة تصنيف تسمية واحدة مخصصة.

نتيجة خطأ من عملية تصنيف فئة واحدة للمستند المخصص على مستند واحد.

نتيجة تصنيف عملية فئة واحدة للمستند المخصص على مستند واحد.

تعريف قيم DocumentSentimentLabel.

تعريف قيم EntityAssociation.

تعريف قيم EntityCertainty.

تعريف قيم EntityConditionality.

خيارات إجراء ربط كيان.

نتيجة إجراء الدفعة لربط الكيان.

نتيجة خطأ من إجراء ربط كيان على مستند واحد.

نتيجة إجراء ربط كيان على مستند واحد.

خيارات لإجراء التعرف على الكيان.

نتيجة إجراء دفعة التعرف على الكيان.

نتيجة خطأ من إجراء التعرف على الكيان على مستند واحد.

نتيجة إجراء التعرف على الكيان على مستند واحد.

المعلمات المدعومة لمهمة تلخيص استخراجي.

نتيجة إجراء دفعة تلخيص استخراجي.

تعريف قيم ExtractiveSummarizationOrderingCriteria.
KnownExtractiveSummarizationOrderingCriteria يمكن استخدامها بالتبادل مع ExtractiveSummarizationOrderingCriteria، يحتوي هذا التعداد على القيم المعروفة التي تدعمها الخدمة.

القيم المعروفة التي تدعمها الخدمة

إزاحة: يشير إلى أنه يجب فرز النتائج بترتيب المظهر في النص.
ترتيب: يشير إلى أنه يجب فرز النتائج بترتيب الأهمية (أي درجة الرتبة) وفقا للنموذج.

تعريف قيم FhirVersion.
يمكن استخدام KnownFhirVersion بالتبادل مع FhirVersion، يحتوي هذا التعداد على القيم المعروفة التي تدعمها الخدمة.

القيم المعروفة التي تدعمها الخدمة

4.0.1

المعلمات المدعومة لمهمة الرعاية الصحية.

نتيجة إجراء دفعة الرعاية الصحية.

تعريف قيم HealthcareEntityCategory.
يمكن استخدام <xref:KnownHealthcareEntityCategory> بالتبادل مع HealthcareEntityCategory، يحتوي هذا التعداد على القيم المعروفة التي تدعمها الخدمة.

القيم المعروفة التي تدعمها الخدمة

BODY_STRUCTURE
العمر
الجنس
EXAMINATION_NAME
التاريخ
اتجاه
تردد
MEASUREMENT_VALUE
MEASUREMENT_UNIT
RELATIONAL_OPERATOR
الوقت
GENE_OR_PROTEIN
متغير
ADMINISTRATIVE_EVENT
CARE_ENVIRONMENT
HEALTHCARE_PROFESSION
التشخيص
SYMPTOM_OR_SIGN
CONDITION_QUALIFIER
MEDICATION_CLASS
MEDICATION_NAME
الجرعة
MEDICATION_FORM
MEDICATION_ROUTE
FAMILY_RELATION
TREATMENT_NAME

نوع الأدوار المختلفة التي يمكن أن يلعبها كيان الرعاية الصحية في العلاقة.

نتيجة خطأ من عملية الرعاية الصحية على مستند واحد.

نتيجة عملية الرعاية الصحية على مستند واحد.

خيارات لإجراء التعرف على العبارة الرئيسية.

نتيجة إجراء دفعة استخراج العبارة الرئيسية.

نتيجة خطأ من إجراء استخراج عبارة رئيسية في مستند واحد.

نتيجة إجراء تحليل المشاعر على مستند واحد.

خيارات لإجراء الكشف عن اللغة.

نتيجة خطأ من إجراء الكشف عن اللغة على مستند واحد.

نتيجة إجراء الكشف عن اللغة على مستند واحد.

تعريف قيم OperationStatus.

نتائج صفحة لعملية beginAnalyzeBatch.

تعريف قيم PiiEntityCategory.
يمكن استخدام KnownPiiEntityCategory بالتبادل مع PiiEntityCategory، يحتوي هذا التعداد على القيم المعروفة التي تدعمها الخدمة.

القيم المعروفة التي تدعمها الخدمة

ABARoutingNumber
ARNationalIdentityNumber
AUBankAccountNumber
AUDriversLicenseNumber
AUMedicalAccountNumber
AUPassportNumber
AUTaxFileNumber
AUBusinessNumber
AUCompanyNumber
ATIdentityCard
ATTaxIdentificationNumber
ATValueaddedTaxNumber
AzureDocumentDBAuthKey
AzureIAASDatabaseConnectionAndSQLString
AzureIoTConnectionString
AzurePublishSettingPassword
AzureRedisCacheString
AzureSAS
AzureServiceBusString
AzureStorageAccountKey
AzureStorageAccountGeneric
BENationalNumber
BENationalNumberV2
BEValueaddedTaxNumber
BRCPFNumber
BRLegalEntityNumber
BRNationalIDRG
BGUniformCivilNumber
CABankAccountNumber
CADriversLicenseNumber
CAHealthServiceNumber
CAPassportNumber
CAPersonalHealthIdentification
CASocialInsuranceNumber
CLIdentityCardNumber
CNResidentIdentityCardNumber
CreditCardNumber
HRIdentityCardNumber
HRNationalIDNumber
HRPersonalIdentificationNumber
HRPersonalIdentificationOIBNumberV2
CYIdentityCard
CYTaxIdentificationNumber
CZPersonalIdentityNumber
CZPersonalIdentityV2
DKPersonalIdentificationNumber
DKPersonalIdentificationV2
DrugEnforcementAgencyNumber
EEPersonalIdentificationCode
EUDebitCardNumber
EUDriversLicenseNumber
EUGPSCoordinates
EUNationalIdentificationNumber
EUPassportNumber
EUSocialSecurityNumber
EUTaxIdentificationNumber
FIEuropeanHealthNumber
FINationalID
FINationalIDV2
FIPassportNumber
FRDriversLicenseNumber
FRHealthInsuranceNumber
FRNationalID
FRPassportNumber
FRSocialSecurityNumber
FRTaxIdentificationNumber
FRValueaddedTaxNumber
DEDriversLicenseNumber
DEPassportNumber
DEIdentityCardNumber
DETaxIdentificationNumber
DEValueAddedNumber
GRNationalIDCard
GRNationalIDV2
GRTaxIdentificationNumber
HKIdentityCardNumber
HUValueAddedNumber
HUPersonalIdentificationNumber
HUTaxIdentificationNumber
INPermanentAccount
inUniqueIdentificationNumber
IDIdentityCardNumber
InternationalBankingAccountNumber
IEPersonalPublicServiceNumber
IEPersonalPublicServiceNumberV2
ILBankAccountNumber
ILNationalID
ITDriversLicenseNumber
ITFiscalCode
ITValueaddedTaxNumber
JPBankAccountNumber
JPDriversLicenseNumber
JPPassportNumber
JPResidentRegistrationNumber
JPSocialInsuranceNumber
JPMyNumberCorporate
JPMyNumberPersonal
JPResidenceCardNumber
LVPersonalCode
LTPersonalCode
LUNationalIdentificationNumberNatural
LUNationalIdentificationNumberNonNatural
MYIdentityCardNumber
MTIdentityCardNumber
MTTaxIDNumber
NLCitizensServiceNumber
NLCitizensServiceNumberV2
NLTaxIdentificationNumber
NLValueaddedTaxNumber
NZBankAccountNumber
NZDriversLicenseNumber
NZInlandRevenueNumber
NZMinistryOfHealthNumber
NZSocialWelfareNumber
NOIdentityNumber
PHUnifiedMultiPurposeIDNumber
PLIdentityCard
PLNationalID
PLNationalIDV2
PLPassportNumber
PLTaxIdentificationNumber
PLREGONNumber
PTCitizenCardNumber
PTCitizenCardNumberV2
PTTaxIdentificationNumber
ROPersonalNumericalCode
RUPassportNumberDomestic
RUPassportNumberInternational
SANationalID
SGNationalRegistrationIdentityCardNumber
SKPersonalNumber
SITaxIdentificationNumber
SIUniqueMasterCitizenNumber
ZAIdentificationNumber
KRResidentRegistrationNumber
ESDNI
ESSocialSecurityNumber
ESTaxIdentificationNumber
SQLServerConnectionString
SENationalID
SENationalIDV2
SEPassportNumber
SETaxIdentificationNumber
SWIFTCode
CHSocialSecurityNumber
TWNationalID
TWPassportNumber
TWResidentCertificate
THPopulationIdentificationCode
TRNationalIdentificationNumber
UKDriversLicenseNumber
UKElectoralRollNumber
UKNationalHealthNumber
UKNationalInsuranceNumber
UKUniqueTaxpayerNumber
USUKPassportNumber
USBankAccountNumber
USDriversLicenseNumber
USIndividualTaxpayerIdentification
USSocialSecurityNumber
UAPassportNumberDomestic
UAPassportNumberInternational
منظمة
البريد الإلكتروني
عنوان URL
العمر
PhoneNumber
IPAddress
تاريخ
شخص
عنوان
جميع
الافتراضي

تعريف قيم PiiEntityDomain.
يمكن استخدام KnownPiiEntityDomain بالتبادل مع PiiEntityDomain، يحتوي هذا التعداد على القيم المعروفة التي تدعمها الخدمة.

القيم المعروفة التي تدعمها الخدمة

phi: يشير إلى أنه يجب تنقيح الكيانات الموجودة في مجال معلومات الصحة الشخصية.
بلا: يشير إلى عدم تحديد مجال.

خيارات لإجراء التعرف على كيان Pii.

نتيجة إجراء دفعة التعرف على كيان pii.

نتيجة خطأ من إجراء التعرف على كيان pii على مستند واحد.

نتيجة إجراء التعرف على الكيان على مستند واحد.

تعريف قيم RelationType.
يمكن استخدام <xref:KnownRelationType> بالتبادل مع RelationType، يحتوي هذا التعداد على القيم المعروفة التي تدعمها الخدمة.

القيم المعروفة التي تدعمها الخدمة

الاختصار
DirectionOfBodyStructure
DirectionOfCondition
DirectionOfExamination
DirectionOfTreatment
DosageOfMedication
FormOfMedication
FrequencyOfMedication
FrequencyOfTreatment
QualifierOfCondition
RelationOfExamination
RouteOfMedication
TimeOfCondition
TimeOfEvent
TimeOfExamination
TimeOfMedication
timeOfTreatment
UnitOfCondition
UnitOfExamination
ValueOfCondition
ValueOfExamination

تعريف قيم SentenceSentimentLabel.

خيارات لإجراء تحليل المشاعر.

نتيجة إجراء دفعة تحليل التوجه.

نتيجة خطأ من إجراء تحليل المشاعر على مستند واحد.

نتيجة إجراء تحليل المشاعر على مستند واحد.

تعريف قيم StringIndexType.
KnownStringIndexType يمكن استخدامها بالتبادل مع StringIndexType، يحتوي هذا التعداد على القيم المعروفة التي تدعمها الخدمة.

القيم المعروفة التي تدعمها الخدمة

TextElements_v8: ستتوافق قيم الإزاحة والطول التي تم إرجاعها مع TextElements (مجموعات Graphemes وGrapheme) التي تؤكد معيار Unicode 8.0.0. استخدم هذا الخيار إذا كان التطبيق الخاص بك مكتوبا في .Net Framework أو .Net Core وستستخدم StringInfo.
UnicodeCodePoint: ستتوافق قيم الإزاحة والطول التي تم إرجاعها مع نقاط رمز Unicode. استخدم هذا الخيار إذا كان التطبيق الخاص بك مكتوبا بلغة تدعم Unicode، على سبيل المثال Python.
Utf16CodeUnit: ستتوافق قيم الإزاحة والطول التي تم إرجاعها مع وحدات التعليمات البرمجية UTF-16. استخدم هذا الخيار إذا كان التطبيق الخاص بك مكتوبا بلغة تدعم Unicode، على سبيل المثال Java وJavaScript.

نتيجة خطأ من عملية ملخص الاستخراج على مستند واحد.

نتيجة عملية ملخص الاستخراج على مستند واحد.

تعريف قيم TokenSentimentLabel.

تعريف قيم WarningCode.
يمكن استخدام <xref:KnownWarningCode> بالتبادل مع WarningCode، يحتوي هذا التعداد على القيم المعروفة التي تدعمها الخدمة.

القيم المعروفة التي تدعمها الخدمة

LongWordsInDocument
DocumentTruncated

القيم المعروفة KnownErrorCode التي تقبلها الخدمة.

القيم المعروفة ExtractiveSummarizationOrderingCriteria تقبلها الخدمة.

القيم المعروفة للمعلمة <xref:HealthcareAction.fhirVersion>.

القيم المعروفة KnownInnerErrorCode التي تقبلها الخدمة.

القيم المعروفة PiiEntityCategory التي تقبلها الخدمة.

القيم المعروفة PiiEntityDomain التي تقبلها الخدمة.

القيم المعروفة StringIndexType التي تقبلها الخدمة.

نوع الإجراءات التي يدعمها أسلوب لتحليل.

نوع الإجراءات التي يدعمها أسلوب beginAnalyzeBatch.

عدد من رموز الأخطاء المحتملة لتحليل نصي.