ترجمة النصوص مهارة معرفية

  • مقالة
  • قراءة خلال 2 دقائق

تقوم مهارة ترجمة النص بتقييم النص، ولكل سجل، تقوم بإرجاع النص المترجم إلى اللغة الهدف المحددة. تستخدم هذه المهارة المترجم Text API v3.0 المتوفرة في الخدمات المعرفية.

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

تعد واجهة برمجة تطبيقات نص المترجم الإصدار 3.0 خدمة معرفية غير إقليمية، مما يعني أنه ليس من المضمون بقاء بياناتك في نفس المنطقة التي يوجد بها مورد Azure Cognitive Search أو مورد الخدمات المعرفية المرفق.

ملاحظة

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

@odata.type

Microsoft.Skills.Text.TranslationSkill

حدود البيانات

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

معلمات المهارة

المعلمات حساسة لحالة الأحرف.

الإدخالات الوصف
defaultToLanguageCode (مطلوب) رمز اللغة لترجمة المستندات إلى المستندات التي لا تحدد اللغة إلى بشكل صريح.
راجع القائمة الكاملة للغات المدعومة.
defaultFromLanguageCode (اختياري) رمز اللغة لترجمة المستندات منه للمستندات التي لا تحدد اللغة من اللغة صراحة. إذا لم يتم تحديد defaultFromLanguageCode، استخدام الكشف التلقائي عن اللغة الذي توفره واجهة برمجة تطبيقات النص المترجم لتحديد اللغة من.
راجع القائمة الكاملة للغات المدعومة.
مقترحمن (اختياري) رمز اللغة لترجمة المستندات من عند عدم توفير إدخال fromLanguageCode أو المعلمة defaultFromLanguageCode، والكشف التلقائي عن اللغة غير ناجحة. إذا لم يتم تحديد اللغة المقترحةمن اللغة ، استخدام اللغة الإنجليزية (en) كلغة مقترحة.
راجع القائمة الكاملة للغات المدعومة.

مدخلات المهارات

اسم الإدخال الوصف
نص النص المراد ترجمته.
toLanguageCode سلسلة تشير إلى اللغة التي يجب ترجمة النص إليها. إذا لم يتم تحديد هذا الإدخال، استخدام defaultToLanguageCode لترجمة النص.
راجع القائمة الكاملة للغات المدعومة.
منرمز اللغة سلسلة تشير إلى اللغة الحالية للنص. إذا لم يتم تحديد هذه المعلمة، استخدام defaultFromLanguageCode (أو الكشف التلقائي عن اللغة إذا لم يتم توفير defaultFromLanguageCode) لترجمة النص.
راجع القائمة الكاملة للغات المدعومة.

مخرجات المهارات

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

نموذج تعريف

 {
    "@odata.type": "#Microsoft.Skills.Text.TranslationSkill",
    "defaultToLanguageCode": "fr",
    "suggestedFrom": "en",
    "context": "/document",
    "inputs": [
      {
        "name": "text",
        "source": "/document/text"
      }
    ],
    "outputs": [
      {
        "name": "translatedText",
        "targetName": "translatedText"
      },
      {
        "name": "translatedFromLanguageCode",
        "targetName": "translatedFromLanguageCode"
      },
      {
        "name": "translatedToLanguageCode",
        "targetName": "translatedToLanguageCode"
      }
    ]
  }

عينة الإدخال

{
  "values": [
    {
      "recordId": "1",
      "data":
        {
          "text": "We hold these truths to be self-evident, that all men are created equal."
        }
    },
    {
      "recordId": "2",
      "data":
        {
          "text": "Estamos muy felices de estar con ustedes."
        }
    }
  ]
}

عينة الإخراج

{
  "values": [
    {
      "recordId": "1",
      "data":
        {
          "translatedText": "Nous tenons ces vérités pour évidentes, que tous les hommes sont créés égaux.",
          "translatedFromLanguageCode": "en",
          "translatedToLanguageCode": "fr"
        }
    },
    {
      "recordId": "2",
      "data":
        {
          "translatedText": "Nous sommes très heureux d'être avec vous.",
          "translatedFromLanguageCode": "es",
          "translatedToLanguageCode": "fr"
        }
    }
  ]
}

الأخطاء والتحذيرات

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

راجع أيضًا