مشاركة عبر

مكتبة عميل Azure Text Analysis ل JavaScript - الإصدار 1.1.0

  • مقالة

خدمة Azure المعرفية للغة هي خدمة مستندة إلى السحابة توفر معالجة متقدمة للغة الطبيعية عبر النص الخام، وتتضمن الميزات الرئيسية التالية:

ملاحظه: تستهدف SDK هذه خدمة Azure المعرفية لإصدار واجهة برمجة تطبيقات اللغة 2023-04-01.

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

استخدم مكتبة العميل من أجل:

  • اكتشف نص إدخال اللغة المكتوب فيه.
  • حدد رأي العملاء في علامتك التجارية أو موضوعك من خلال تحليل النص الخام للحصول على أدلة حول التوجه الإيجابي أو السلبي.
  • استخراج العبارات الرئيسية تلقائيا لتحديد النقاط الرئيسية بسرعة.
  • حدد الكيانات في النص وصنفها كأشخاص وأماكن ومنظمات وتاريخ/وقت وكميات ونسب مئوية وعملات وعناية صحية خاصة والمزيد.
  • قم بتنفيذ العديد من المهام المذكورة أعلاه في وقت واحد.

الروابط الرئيسية:

الترحيل من @azure/ai-text-analytics الاستشارات⚠️

يرجى الاطلاع على دليل الترحيل للحصول على إرشادات مفصلة حول كيفية تحديث التعليمات البرمجية للتطبيق من الإصدار 5.x من مكتبة عميل الذكاء الاصطناعي Text Analytics إلى مكتبة عميل الذكاء الاصطناعي Language Text الجديدة.

ما الجديد

الشروع في العمل

البيئات المعتمدة حاليًا

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

المتطلبات الأساسية

إذا كنت تستخدم Azure CLI، فاستبدل <your-resource-group-name> وأسماءك <your-resource-name> الفريدة الخاصة:

az cognitiveservices account create --kind TextAnalytics --resource-group <your-resource-group-name> --name <your-resource-name> --sku <your-sku-name> --location <your-location>

تثبيت @azure/ai-language-textالحزمة

قم بتثبيت مكتبة عميل Azure Text Analysis ل JavaScript باستخدام npm:

npm install @azure/ai-language-text

إنشاء ومصادقة TextAnalysisClient

لإنشاء كائن عميل للوصول إلى واجهة برمجة تطبيقات اللغة، ستحتاج إلى endpoint مورد اللغة الخاص بك و credential. يمكن لعميل تحليل النص استخدام بيانات اعتماد Azure Active Directory أو بيانات اعتماد مفتاح API للمصادقة.

يمكنك العثور على نقطة النهاية لمورد اللغة إما في مدخل Microsoft Azure أو باستخدام قصاصة برمجية Azure CLI أدناه:

az cognitiveservices account show --name <your-resource-name> --resource-group <your-resource-group-name> --query "properties.endpoint"

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

استخدم مدخل Microsoft Azure للاستعراض وصولا إلى مورد اللغة واسترداد مفتاح API، أو استخدم قصاصة Azure CLI أدناه:

ملاحظه: في بعض الأحيان يشار إلى مفتاح واجهة برمجة التطبيقات باسم "مفتاح الاشتراك" أو "مفتاح واجهة برمجة تطبيقات الاشتراك".

az cognitiveservices account keys list --resource-group <your-resource-group-name> --name <your-resource-name>

بمجرد أن يكون لديك مفتاح واجهة برمجة التطبيقات ونقطة النهاية، يمكنك استخدام AzureKeyCredential الفئة لمصادقة العميل كما يلي:

const { TextAnalysisClient, AzureKeyCredential } = require("@azure/ai-language-text");

const client = new TextAnalysisClient("<endpoint>", new AzureKeyCredential("<API key>"));

استخدام بيانات اعتماد Azure Active Directory

يتم استخدام مصادقة مفتاح واجهة برمجة تطبيقات العميل في معظم الأمثلة، ولكن يمكنك أيضا المصادقة مع Azure Active Directory باستخدام مكتبة هوية Azure. لاستخدام موفر DefaultAzureCredential الموضح أدناه، أو موفري بيانات الاعتماد الآخرين المقدمين مع Azure SDK، يرجى تثبيت الحزمة @azure/identity :

npm install @azure/identity

ستحتاج أيضا إلى تسجيل تطبيق AAD جديد ومنح حق الوصول إلى Language عن طريق تعيين "Cognitive Services User" الدور إلى كيان الخدمة (ملاحظة: لن تمنح أدوار أخرى مثل "Owner" الأذونات الضرورية، بل تكفي فقط "Cognitive Services User" لتشغيل الأمثلة ونموذج التعليمات البرمجية).

قم بتعيين قيم معرف العميل ومعرف المستأجر وسر العميل لتطبيق AAD كمتغيرات بيئة: AZURE_CLIENT_ID، ، AZURE_TENANT_ID. AZURE_CLIENT_SECRET

const { TextAnalysisClient } = require("@azure/ai-language-text");
const { DefaultAzureCredential } = require("@azure/identity");

const client = new TextAnalysisClient("<endpoint>", new DefaultAzureCredential());

المفاهيم الرئيسية

TextAnalysisClient

TextAnalysisClient هي الواجهة الأساسية للمطورين الذين يستخدمون مكتبة عميل تحليل النص. استكشف الأساليب الموجودة على كائن العميل هذا لفهم الميزات المختلفة لخدمة Language التي يمكنك الوصول إليها.

إدخال

يمثل المستند وحدة إدخال واحدة ليتم تحليلها بواسطة النماذج التنبؤية في خدمة Language. تأخذ العمليات على TextAnalysisClient مجموعة من المدخلات ليتم تحليلها كدفعة. تحتوي أساليب العملية على حمولات زائدة تسمح بتمثيل المدخلات كسلاسل، أو كعناصر مع بيانات التعريف المرفقة.

على سبيل المثال، يمكن تمرير كل مستند كسلسلة في صفيف، على سبيل المثال.

const documents = [
  "I hated the movie. It was so slow!",
  "The movie made it into my top ten favorites.",
  "What a great movie!",
];

أو، إذا كنت ترغب في تمرير مستند id لكل عنصر أو languagecountryHint/، فيمكن منحها كقوائم TextDocumentInput بالعملية أو DetectLanguageInput اعتمادا عليها؛

const textDocumentInputs = [
  { id: "1", language: "en", text: "I hated the movie. It was so slow!" },
  { id: "2", language: "en", text: "The movie made it into my top ten favorites." },
  { id: "3", language: "en", text: "What a great movie!" },
];

راجع قيود الخدمة للإدخال، بما في ذلك حدود طول المستند والحد الأقصى لحجم الدفعة وترميزات النص المدعومة.

القيمة المرجعة

القيمة المرجعة المقابلة لمستند واحد هي إما نتيجة ناجحة أو عنصر خطأ. ترجع كل TextAnalysisClient طريقة صفيفا غير متجانس من النتائج والأخطاء التي تتوافق مع المدخلات حسب الفهرس. سيكون لإدخال النص والنتيجة نفس الفهرس في مجموعات الإدخال والنتيجة.

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

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

معالجة أخطاء المستند

في المجموعة التي تم إرجاعها بواسطة عملية، يتم تمييز الأخطاء عن الاستجابات الناجحة من خلال وجود الخاصية error ، التي تحتوي على الكائن الداخلي TextAnalysisError إذا تمت مصادفة خطأ. بالنسبة لكائنات النتائج الناجحة، تكون هذه الخاصية دائماundefined.

على سبيل المثال، لتصفية جميع الأخطاء، يمكنك استخدام ما يلي filter:

const results = await client.analyze("SentimentAnalysis", documents);
const onlySuccessful = results.filter((result) => result.error === undefined);

ملاحظة: يمكن لمستخدمي TypeScript الاستفادة من التحقق بشكل أفضل من نوع عناصر النتائج والخطأ إذا compilerOptions.strictNullChecks تم تعيينها إلى true في tsconfig.json التكوين. على سبيل المثال:

const [result] = await client.analyze("SentimentAnalysis", ["Hello world!"]);

if (result.error !== undefined) {
  // In this if block, TypeScript will be sure that the type of `result` is
  // `TextAnalysisError` if compilerOptions.strictNullChecks is enabled in
  // the tsconfig.json

  console.log(result.error);
}

عينات

استخدام العميل

المهام التي تم إنشاؤها مسبقا

المهام المخصصة

استكشاف الأخطاء وإصلاحها

تسجيل الدخول

قد يساعد تمكين التسجيل في الكشف عن معلومات مفيدة حول حالات الفشل. للاطلاع على سجل لطلبات HTTP واستجاباته، قم بتعيين AZURE_LOG_LEVELمتغير البيئة إلى info. بدلًا من ذلك، يمكن تمكين التسجيل في وقت التشغيل عن طريق الاتصال setLogLevelبـ @azure/logger:

const { setLogLevel } = require("@azure/logger");

setLogLevel("info");

للحصول على إرشادات أكثر تفصيلا حول كيفية تمكين السجلات، يمكنك إلقاء نظرة على مستندات حزمة @azure/المسجل.

الخطوات التالية

يرجى إلقاء نظرة على دليل العينات للحصول على أمثلة مفصلة حول كيفية استخدام هذه المكتبة.

المساهمة

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

مرات الظهور