التشغيل السريع: استخدام مكتبة عميل "Language Detection" وواجهة برمجة تطبيقات REST

الوثائق | المرجعية مزيد من نماذج حزمة (NuGet) | التعليمات | البرمجية المصدر للمكتبة

استخدم هذا Quickstart لإنشاء تطبيق الكشف عن اللغة مع مكتبة العميل لـ .NET. في المثال التالي، يمكنك إنشاء تطبيق C# يمكنه تحديد اللغة التي تمت كتابة نموذج نص بها.

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

الإعداد

أنشئ مورد Azure.

لاستخدام نموذج التعليمات البرمجية أدناه، ستحتاج إلى نشر مورد Azure. سيحتوي هذا المورد على مفتاح ونقطة نهاية ستستخدمهما لمصادقة استدعاءات واجهة برمجة التطبيقات التي ترسلها إلى خدمة Language.

  1. استخدم الارتباط التالي لإنشاء مورد لغة باستخدام مدخل Microsoft Azure. ستحتاج إلى تسجيل الدخول باستخدام اشتراك Azure الخاص بك.

  2. في شاشة تحديد ميزات إضافية التي تظهر، حدد متابعة لإنشاء المورد الخاص بك.

    لقطة شاشة تعرض خيارات ميزات إضافية في مدخل Microsoft Azure.

  3. في شاشة إنشاء لغة ، قم بتوفير المعلومات التالية:

    تفاصيل ‏‏الوصف
    الاشتراك حساب الاشتراك الذي سيتم إقران المورد به. حدد اشتراك Azure من القائمة المنسدلة.
    مجموعة الموارد مجموعة الموارد هي حاوية تخزن الموارد التي تقوم بإنشائها. حدد إنشاء جديد لإنشاء مجموعة موارد جديدة.
    المنطقة موقع مورد اللغة الخاص بك. قد تقدم مناطق مختلفة زمن انتقال اعتمادا على موقعك الفعلي، ولكن ليس لها أي تأثير على توفر وقت التشغيل للمورد الخاص بك. لهذا التشغيل السريع، حدد منطقة متوفرة بالقرب منك، أو اختر شرق الولايات المتحدة.
    الاسم اسم مورد اللغة. سيتم استخدام هذا الاسم أيضا لإنشاء عنوان URL لنقطة النهاية التي ستستخدمها تطبيقاتك لإرسال طلبات واجهة برمجة التطبيقات.
    مستوى الأسعار مستوى التسعير لمورد اللغة الخاص بك. يمكنك استخدام طبقة F0 المجانية لتجربة الخدمة والترقية لاحقا إلى مستوى مدفوع للإنتاج.

    لقطة شاشة تعرض تفاصيل إنشاء الموارد في مدخل Microsoft Azure.

  4. تأكد من تحديد خانة الاختيار إشعار الذكاء الاصطناعي المسؤول.

  5. حدد Review + Create في أسفل الصفحة.

  6. في الشاشة التي تظهر، تأكد من اجتياز التحقق من الصحة، ومن إدخال معلوماتك بشكل صحيح. وبعد ذلك، حدد إنشاء.

الحصول على المفتاح ونقطة النهاية

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

  1. بعد نشر مورد Language بنجاح، انقر فوق الزر Go to Resource ضمن Next Steps.

    لقطة شاشة تعرض الخطوات التالية بعد نشر مورد.

  2. على شاشة المورد، حدد Keys and endpoint في قائمة التنقل اليسرى. ستستخدم أحد المفاتيح ونقطة النهاية في الخطوات أدناه.

    لقطة شاشة تعرض قسم المفاتيح ونقطة النهاية لمورد.

إنشاء متغيرات البيئة

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

لتعيين متغير البيئة لمفتاح مورد Language، افتح نافذة وحدة تحكم، واتبع الإرشادات الخاصة بنظام التشغيل وبيئة التطوير.

  • لتعيين LANGUAGE_KEY متغير البيئة، استبدل your-key بأحد مفاتيح المورد الخاص بك.
  • لتعيين LANGUAGE_ENDPOINT متغير البيئة، استبدل your-endpoint بنقطة النهاية للمورد الخاص بك.

هام

إذا كنت تستخدم مفتاح API، فخزنه بأمان في مكان آخر، كما هو الحال في Azure Key Vault. لا تقم بتضمين مفتاح API مباشرة في التعليمات البرمجية الخاصة بك، ولا تنشره بشكل عام.

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

setx LANGUAGE_KEY your-key
setx LANGUAGE_ENDPOINT your-endpoint

إشعار

إذا كنت بحاجة فقط إلى الوصول إلى متغيرات البيئة في وحدة التحكم الحالية قيد التشغيل، يمكنك تعيين متغير البيئة باستخدام set بدلا من setx.

بعد إضافة متغيرات البيئة، قد تحتاج إلى إعادة تشغيل أي برامج قيد التشغيل ستحتاج إلى قراءة متغيرات البيئة، بما في ذلك نافذة وحدة التحكم. على سبيل المثال، إذا كنت تستخدم Visual Studio كمحرر، فأعد تشغيل Visual Studio قبل تشغيل المثال.

إنشاء تطبيق .NET Core جديد

باستخدام Visual Studio IDE، قم بإنشاء تطبيق وحدة تحكم .NET Core جديد. يؤدي هذا إلى إنشاء مشروع "مرحبًا بالعالم" مع ملف مصدر C# واحد: program.cs.

تثبيت مكتبة العميل بالنقر بزر الماوس الأيمن فوق الحل في "Solution Explorer" وتحديد "Manage NuGet Packages". في إدارة الحزمة التي تفتح، حدد "Browse" وابحث عن Azure.AI.TextAnalytics. حدد الإصدار 5.2.0، ثم حدد Install. يمكنك أيضاً استخدام Package Manager Console.

مثال على التعليمات البرمجية

انسخ التعليمة البرمجية التالية إلى ملفprogram.cs. ثم قم بتشغيل التعليمة البرمجية.

using Azure;
using System;
using Azure.AI.TextAnalytics;

namespace LanguageDetectionExample
{
    class Program
    {
        // This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
        static string languageKey = Environment.GetEnvironmentVariable("LANGUAGE_KEY");
        static string languageEndpoint = Environment.GetEnvironmentVariable("LANGUAGE_ENDPOINT");

        private static readonly AzureKeyCredential credentials = new AzureKeyCredential(languageKey);
        private static readonly Uri endpoint = new Uri(languageEndpoint);

        // Example method for detecting the language of text
        static void LanguageDetectionExample(TextAnalyticsClient client)
        {
            DetectedLanguage detectedLanguage = client.DetectLanguage("Ce document est rédigé en Français.");
            Console.WriteLine("Language:");
            Console.WriteLine($"\t{detectedLanguage.Name},\tISO-6391: {detectedLanguage.Iso6391Name}\n");
        }

        static void Main(string[] args)
        {
            var client = new TextAnalyticsClient(languageEndpoint, languageKey);
            LanguageDetectionExample(client);

            Console.Write("Press any key to exit.");
            Console.ReadKey();
        }

    }
}

المخرجات

Language:
    French, ISO-6391: fr

الوثائق | المرجعية مزيد من نماذج حزمة (Maven) | التعليمات | البرمجية المصدر للمكتبة

استخدم هذا التطبيق السريع لإنشاء تطبيق لاكتشاف اللغة باستخدام مكتبة العميل لـ Java. في المثال التالي، يمكنك إنشاء تطبيق Java يمكنه تحديد اللغة التي كتبت بها عينة نصية.

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

الإعداد

أنشئ مورد Azure.

لاستخدام نموذج التعليمات البرمجية أدناه، ستحتاج إلى نشر مورد Azure. سيحتوي هذا المورد على مفتاح ونقطة نهاية ستستخدمهما لمصادقة استدعاءات واجهة برمجة التطبيقات التي ترسلها إلى خدمة Language.

  1. استخدم الارتباط التالي لإنشاء مورد لغة باستخدام مدخل Microsoft Azure. ستحتاج إلى تسجيل الدخول باستخدام اشتراك Azure الخاص بك.

  2. في شاشة تحديد ميزات إضافية التي تظهر، حدد متابعة لإنشاء المورد الخاص بك.

    لقطة شاشة تعرض خيارات ميزات إضافية في مدخل Microsoft Azure.

  3. في شاشة إنشاء لغة ، قم بتوفير المعلومات التالية:

    تفاصيل ‏‏الوصف
    الاشتراك حساب الاشتراك الذي سيتم إقران المورد به. حدد اشتراك Azure من القائمة المنسدلة.
    مجموعة الموارد مجموعة الموارد هي حاوية تخزن الموارد التي تقوم بإنشائها. حدد إنشاء جديد لإنشاء مجموعة موارد جديدة.
    المنطقة موقع مورد اللغة الخاص بك. قد تقدم مناطق مختلفة زمن انتقال اعتمادا على موقعك الفعلي، ولكن ليس لها أي تأثير على توفر وقت التشغيل للمورد الخاص بك. لهذا التشغيل السريع، حدد منطقة متوفرة بالقرب منك، أو اختر شرق الولايات المتحدة.
    الاسم اسم مورد اللغة. سيتم استخدام هذا الاسم أيضا لإنشاء عنوان URL لنقطة النهاية التي ستستخدمها تطبيقاتك لإرسال طلبات واجهة برمجة التطبيقات.
    مستوى الأسعار مستوى التسعير لمورد اللغة الخاص بك. يمكنك استخدام طبقة F0 المجانية لتجربة الخدمة والترقية لاحقا إلى مستوى مدفوع للإنتاج.

    لقطة شاشة تعرض تفاصيل إنشاء الموارد في مدخل Microsoft Azure.

  4. تأكد من تحديد خانة الاختيار إشعار الذكاء الاصطناعي المسؤول.

  5. حدد Review + Create في أسفل الصفحة.

  6. في الشاشة التي تظهر، تأكد من اجتياز التحقق من الصحة، ومن إدخال معلوماتك بشكل صحيح. وبعد ذلك، حدد إنشاء.

الحصول على المفتاح ونقطة النهاية

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

  1. بعد نشر مورد Language بنجاح، انقر فوق الزر Go to Resource ضمن Next Steps.

    لقطة شاشة تعرض الخطوات التالية بعد نشر مورد.

  2. على شاشة المورد، حدد Keys and endpoint في قائمة التنقل اليسرى. ستستخدم أحد المفاتيح ونقطة النهاية في الخطوات أدناه.

    لقطة شاشة تعرض قسم المفاتيح ونقطة النهاية لمورد.

إنشاء متغيرات البيئة

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

لتعيين متغير البيئة لمفتاح مورد Language، افتح نافذة وحدة تحكم، واتبع الإرشادات الخاصة بنظام التشغيل وبيئة التطوير.

  • لتعيين LANGUAGE_KEY متغير البيئة، استبدل your-key بأحد مفاتيح المورد الخاص بك.
  • لتعيين LANGUAGE_ENDPOINT متغير البيئة، استبدل your-endpoint بنقطة النهاية للمورد الخاص بك.

هام

إذا كنت تستخدم مفتاح API، فخزنه بأمان في مكان آخر، كما هو الحال في Azure Key Vault. لا تقم بتضمين مفتاح API مباشرة في التعليمات البرمجية الخاصة بك، ولا تنشره بشكل عام.

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

setx LANGUAGE_KEY your-key
setx LANGUAGE_ENDPOINT your-endpoint

إشعار

إذا كنت بحاجة فقط إلى الوصول إلى متغيرات البيئة في وحدة التحكم الحالية قيد التشغيل، يمكنك تعيين متغير البيئة باستخدام set بدلا من setx.

بعد إضافة متغيرات البيئة، قد تحتاج إلى إعادة تشغيل أي برامج قيد التشغيل ستحتاج إلى قراءة متغيرات البيئة، بما في ذلك نافذة وحدة التحكم. على سبيل المثال، إذا كنت تستخدم Visual Studio كمحرر، فأعد تشغيل Visual Studio قبل تشغيل المثال.

إضافة مكتبة العميل

إنشاء مشروع Maven في IDE أو بيئة التطوير المفضلة لديك. ثم أضف التبعية التالية إلى ملف pom.xml الخاص بمشروعك. يمكنك العثور على بنية التنفيذ لأدوات البناء الأخرى عبر الإنترنت.

<dependencies>
     <dependency>
        <groupId>com.azure</groupId>
        <artifactId>azure-ai-textanalytics</artifactId>
        <version>5.2.0</version>
    </dependency>
</dependencies>

مثال على التعليمات البرمجية

إنشاء ملف Java باسم Example.java. افتح الملف وانسخ التعليمات البرمجية أدناه. ثم قم بتشغيل التعليمة البرمجية.

import com.azure.core.credential.AzureKeyCredential;
import com.azure.ai.textanalytics.models.*;
import com.azure.ai.textanalytics.TextAnalyticsClientBuilder;
import com.azure.ai.textanalytics.TextAnalyticsClient;

public class Example {

    // This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
    private static String languageKey = System.getenv("LANGUAGE_KEY");
    private static String languageEndpoint = System.getenv("LANGUAGE_ENDPOINT");

    public static void main(String[] args) {
        TextAnalyticsClient client = authenticateClient(languageKey, languageEndpoint);
        detectLanguageExample(client);
    }
    // Method to authenticate the client object with your key and endpoint
    static TextAnalyticsClient authenticateClient(String key, String endpoint) {
        return new TextAnalyticsClientBuilder()
                .credential(new AzureKeyCredential(key))
                .endpoint(endpoint)
                .buildClient();
    }
    // Example method for detecting the language of text
    static void detectLanguageExample(TextAnalyticsClient client)
    {
        // The text to be analyzed.
        String text = "Ce document est rédigé en Français.";

        DetectedLanguage detectedLanguage = client.detectLanguage(text);
        System.out.printf("Detected primary language: %s, ISO 6391 name: %s, score: %.2f.%n",
                detectedLanguage.getName(),
                detectedLanguage.getIso6391Name(),
                detectedLanguage.getConfidenceScore());
    }
}

المخرجات

Detected primary language: French, ISO 6391 name: fr, score: 1.00.

الوثائق | المرجعية مزيد من نماذج حزمة (npm) | مكتبة التعليمات | البرمجية المصدر

استخدم هذا البدء السريع لإنشاء تطبيق اكتشاف اللغة باستخدام مكتبة العميل لـ Node.js. في المثال التالي، يمكنك إنشاء تطبيق JavaScript يمكنه تحديد اللغة التي تمت كتابة نموذج نص بها.

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

الإعداد

أنشئ مورد Azure.

لاستخدام نموذج التعليمات البرمجية أدناه، ستحتاج إلى نشر مورد Azure. سيحتوي هذا المورد على مفتاح ونقطة نهاية ستستخدمهما لمصادقة استدعاءات واجهة برمجة التطبيقات التي ترسلها إلى خدمة Language.

  1. استخدم الارتباط التالي لإنشاء مورد لغة باستخدام مدخل Microsoft Azure. ستحتاج إلى تسجيل الدخول باستخدام اشتراك Azure الخاص بك.

  2. في شاشة تحديد ميزات إضافية التي تظهر، حدد متابعة لإنشاء المورد الخاص بك.

    لقطة شاشة تعرض خيارات ميزات إضافية في مدخل Microsoft Azure.

  3. في شاشة إنشاء لغة ، قم بتوفير المعلومات التالية:

    تفاصيل ‏‏الوصف
    الاشتراك حساب الاشتراك الذي سيتم إقران المورد به. حدد اشتراك Azure من القائمة المنسدلة.
    مجموعة الموارد مجموعة الموارد هي حاوية تخزن الموارد التي تقوم بإنشائها. حدد إنشاء جديد لإنشاء مجموعة موارد جديدة.
    المنطقة موقع مورد اللغة الخاص بك. قد تقدم مناطق مختلفة زمن انتقال اعتمادا على موقعك الفعلي، ولكن ليس لها أي تأثير على توفر وقت التشغيل للمورد الخاص بك. لهذا التشغيل السريع، حدد منطقة متوفرة بالقرب منك، أو اختر شرق الولايات المتحدة.
    الاسم اسم مورد اللغة. سيتم استخدام هذا الاسم أيضا لإنشاء عنوان URL لنقطة النهاية التي ستستخدمها تطبيقاتك لإرسال طلبات واجهة برمجة التطبيقات.
    مستوى الأسعار مستوى التسعير لمورد اللغة الخاص بك. يمكنك استخدام طبقة F0 المجانية لتجربة الخدمة والترقية لاحقا إلى مستوى مدفوع للإنتاج.

    لقطة شاشة تعرض تفاصيل إنشاء الموارد في مدخل Microsoft Azure.

  4. تأكد من تحديد خانة الاختيار إشعار الذكاء الاصطناعي المسؤول.

  5. حدد Review + Create في أسفل الصفحة.

  6. في الشاشة التي تظهر، تأكد من اجتياز التحقق من الصحة، ومن إدخال معلوماتك بشكل صحيح. وبعد ذلك، حدد إنشاء.

الحصول على المفتاح ونقطة النهاية

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

  1. بعد نشر مورد Language بنجاح، انقر فوق الزر Go to Resource ضمن Next Steps.

    لقطة شاشة تعرض الخطوات التالية بعد نشر مورد.

  2. على شاشة المورد، حدد Keys and endpoint في قائمة التنقل اليسرى. ستستخدم أحد المفاتيح ونقطة النهاية في الخطوات أدناه.

    لقطة شاشة تعرض قسم المفاتيح ونقطة النهاية لمورد.

إنشاء متغيرات البيئة

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

لتعيين متغير البيئة لمفتاح مورد Language، افتح نافذة وحدة تحكم، واتبع الإرشادات الخاصة بنظام التشغيل وبيئة التطوير.

  • لتعيين LANGUAGE_KEY متغير البيئة، استبدل your-key بأحد مفاتيح المورد الخاص بك.
  • لتعيين LANGUAGE_ENDPOINT متغير البيئة، استبدل your-endpoint بنقطة النهاية للمورد الخاص بك.

هام

إذا كنت تستخدم مفتاح API، فخزنه بأمان في مكان آخر، كما هو الحال في Azure Key Vault. لا تقم بتضمين مفتاح API مباشرة في التعليمات البرمجية الخاصة بك، ولا تنشره بشكل عام.

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

setx LANGUAGE_KEY your-key
setx LANGUAGE_ENDPOINT your-endpoint

إشعار

إذا كنت بحاجة فقط إلى الوصول إلى متغيرات البيئة في وحدة التحكم الحالية قيد التشغيل، يمكنك تعيين متغير البيئة باستخدام set بدلا من setx.

بعد إضافة متغيرات البيئة، قد تحتاج إلى إعادة تشغيل أي برامج قيد التشغيل ستحتاج إلى قراءة متغيرات البيئة، بما في ذلك نافذة وحدة التحكم. على سبيل المثال، إذا كنت تستخدم Visual Studio كمحرر، فأعد تشغيل Visual Studio قبل تشغيل المثال.

إنشاء تطبيق Node.js جديد

في إطار نافذة وحدة التحكم (مثل cmd أو PowerShell أو Bash)، يمكنك إنشاء دليل جديد لتطبيقك وانتقل إليه.

mkdir myapp 

cd myapp

شغّل الأمر npm init لإنشاء تطبيق node باستخدام ملف package.json.

npm init

تثبيت مكتبة العميل

تثبيت حزمة npm :

npm install @azure/ai-language-text

مثال على التعليمات البرمجية

افتح الملف وانسخ التعليمات البرمجية أدناه. ثم قم بتشغيل التعليمة البرمجية.

"use strict";

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

// This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
const key = process.env.LANGUAGE_KEY;
const endpoint = process.env.LANGUAGE_ENDPOINT;

//Example sentences in different languages to be analyzed
const documents = [
    "This document is written in English.",
    "这是一个用中文写的文件",
];

//Example of how to use the client library to detect language
async function main() {
    console.log("== Language detection sample ==");
  
    const client = new TextAnalysisClient(endpoint, new AzureKeyCredential(key));
  
    const result = await client.analyze("LanguageDetection", documents);
  
    for (const doc of result) {
      if (!doc.error) {
        console.log(
          `ID ${doc.id} - Primary language: ${doc.primaryLanguage.name} (iso6391 name: ${doc.primaryLanguage.iso6391Name})`
        );
      }
    }
}

main().catch((err) => {
    console.error("The sample encountered an error:", err);
});

المخرجات

== Language detection sample ==
ID 0 - Primary language: English (iso6391 name: en)
ID 1 - Primary language: Chinese_Simplified (iso6391 name: zh_chs)

الوثائق | المرجعية المزيد من نماذج حزمة (PyPi) | التعليمات | البرمجية المصدر للمكتبة

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

تلميح

يمكنك استخدام Language Studio لتجربة ميزات خدمة Language دون الحاجة إلى كتابة التعليمات البرمجية.

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

الإعداد

أنشئ مورد Azure.

لاستخدام نموذج التعليمات البرمجية أدناه، ستحتاج إلى نشر مورد Azure. سيحتوي هذا المورد على مفتاح ونقطة نهاية ستستخدمهما لمصادقة استدعاءات واجهة برمجة التطبيقات التي ترسلها إلى خدمة Language.

  1. استخدم الارتباط التالي لإنشاء مورد لغة باستخدام مدخل Microsoft Azure. ستحتاج إلى تسجيل الدخول باستخدام اشتراك Azure الخاص بك.

  2. في شاشة تحديد ميزات إضافية التي تظهر، حدد متابعة لإنشاء المورد الخاص بك.

    لقطة شاشة تعرض خيارات ميزات إضافية في مدخل Microsoft Azure.

  3. في شاشة إنشاء لغة ، قم بتوفير المعلومات التالية:

    تفاصيل ‏‏الوصف
    الاشتراك حساب الاشتراك الذي سيتم إقران المورد به. حدد اشتراك Azure من القائمة المنسدلة.
    مجموعة الموارد مجموعة الموارد هي حاوية تخزن الموارد التي تقوم بإنشائها. حدد إنشاء جديد لإنشاء مجموعة موارد جديدة.
    المنطقة موقع مورد اللغة الخاص بك. قد تقدم مناطق مختلفة زمن انتقال اعتمادا على موقعك الفعلي، ولكن ليس لها أي تأثير على توفر وقت التشغيل للمورد الخاص بك. لهذا التشغيل السريع، حدد منطقة متوفرة بالقرب منك، أو اختر شرق الولايات المتحدة.
    الاسم اسم مورد اللغة. سيتم استخدام هذا الاسم أيضا لإنشاء عنوان URL لنقطة النهاية التي ستستخدمها تطبيقاتك لإرسال طلبات واجهة برمجة التطبيقات.
    مستوى الأسعار مستوى التسعير لمورد اللغة الخاص بك. يمكنك استخدام طبقة F0 المجانية لتجربة الخدمة والترقية لاحقا إلى مستوى مدفوع للإنتاج.

    لقطة شاشة تعرض تفاصيل إنشاء الموارد في مدخل Microsoft Azure.

  4. تأكد من تحديد خانة الاختيار إشعار الذكاء الاصطناعي المسؤول.

  5. حدد Review + Create في أسفل الصفحة.

  6. في الشاشة التي تظهر، تأكد من اجتياز التحقق من الصحة، ومن إدخال معلوماتك بشكل صحيح. وبعد ذلك، حدد إنشاء.

الحصول على المفتاح ونقطة النهاية

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

  1. بعد نشر مورد Language بنجاح، انقر فوق الزر Go to Resource ضمن Next Steps.

    لقطة شاشة تعرض الخطوات التالية بعد نشر مورد.

  2. على شاشة المورد، حدد Keys and endpoint في قائمة التنقل اليسرى. ستستخدم أحد المفاتيح ونقطة النهاية في الخطوات أدناه.

    لقطة شاشة تعرض قسم المفاتيح ونقطة النهاية لمورد.

إنشاء متغيرات البيئة

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

لتعيين متغير البيئة لمفتاح مورد Language، افتح نافذة وحدة تحكم، واتبع الإرشادات الخاصة بنظام التشغيل وبيئة التطوير.

  • لتعيين LANGUAGE_KEY متغير البيئة، استبدل your-key بأحد مفاتيح المورد الخاص بك.
  • لتعيين LANGUAGE_ENDPOINT متغير البيئة، استبدل your-endpoint بنقطة النهاية للمورد الخاص بك.

هام

إذا كنت تستخدم مفتاح API، فخزنه بأمان في مكان آخر، كما هو الحال في Azure Key Vault. لا تقم بتضمين مفتاح API مباشرة في التعليمات البرمجية الخاصة بك، ولا تنشره بشكل عام.

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

setx LANGUAGE_KEY your-key
setx LANGUAGE_ENDPOINT your-endpoint

إشعار

إذا كنت بحاجة فقط إلى الوصول إلى متغيرات البيئة في وحدة التحكم الحالية قيد التشغيل، يمكنك تعيين متغير البيئة باستخدام set بدلا من setx.

بعد إضافة متغيرات البيئة، قد تحتاج إلى إعادة تشغيل أي برامج قيد التشغيل ستحتاج إلى قراءة متغيرات البيئة، بما في ذلك نافذة وحدة التحكم. على سبيل المثال، إذا كنت تستخدم Visual Studio كمحرر، فأعد تشغيل Visual Studio قبل تشغيل المثال.

تثبيت مكتبة العميل

بعد تثبيت Python، يمكنك تثبيت مكتبة العميل عن طريق:

pip install azure-ai-textanalytics==5.2.0

مثال على التعليمات البرمجية

إنشاء ملف Python جديد ونسخ التعليمات البرمجية أدناه. ثم قم بتشغيل التعليمة البرمجية.

# This example requires environment variables named "LANGUAGE_KEY" and "LANGUAGE_ENDPOINT"
language_key = os.environ.get('LANGUAGE_KEY')
language_endpoint = os.environ.get('LANGUAGE_ENDPOINT')

from azure.ai.textanalytics import TextAnalyticsClient
from azure.core.credentials import AzureKeyCredential

# Authenticate the client using your key and endpoint 
def authenticate_client():
    ta_credential = AzureKeyCredential(language_key)
    text_analytics_client = TextAnalyticsClient(
            endpoint=language_endpoint, 
            credential=ta_credential)
    return text_analytics_client

client = authenticate_client()

# Example method for detecting the language of text
def language_detection_example(client):
    try:
        documents = ["Ce document est rédigé en Français."]
        response = client.detect_language(documents = documents, country_hint = 'us')[0]
        print("Language: ", response.primary_language.name)

    except Exception as err:
        print("Encountered exception. {}".format(err))
language_detection_example(client)

المخرجات

Language:  French

الوثائق المرجعية

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

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

الإعداد

أنشئ مورد Azure.

لاستخدام نموذج التعليمات البرمجية أدناه، ستحتاج إلى نشر مورد Azure. سيحتوي هذا المورد على مفتاح ونقطة نهاية ستستخدمهما لمصادقة استدعاءات واجهة برمجة التطبيقات التي ترسلها إلى خدمة Language.

  1. استخدم الارتباط التالي لإنشاء مورد لغة باستخدام مدخل Microsoft Azure. ستحتاج إلى تسجيل الدخول باستخدام اشتراك Azure الخاص بك.

  2. في شاشة تحديد ميزات إضافية التي تظهر، حدد متابعة لإنشاء المورد الخاص بك.

    لقطة شاشة تعرض خيارات ميزات إضافية في مدخل Microsoft Azure.

  3. في شاشة إنشاء لغة ، قم بتوفير المعلومات التالية:

    تفاصيل ‏‏الوصف
    الاشتراك حساب الاشتراك الذي سيتم إقران المورد به. حدد اشتراك Azure من القائمة المنسدلة.
    مجموعة الموارد مجموعة الموارد هي حاوية تخزن الموارد التي تقوم بإنشائها. حدد إنشاء جديد لإنشاء مجموعة موارد جديدة.
    المنطقة موقع مورد اللغة الخاص بك. قد تقدم مناطق مختلفة زمن انتقال اعتمادا على موقعك الفعلي، ولكن ليس لها أي تأثير على توفر وقت التشغيل للمورد الخاص بك. لهذا التشغيل السريع، حدد منطقة متوفرة بالقرب منك، أو اختر شرق الولايات المتحدة.
    الاسم اسم مورد اللغة. سيتم استخدام هذا الاسم أيضا لإنشاء عنوان URL لنقطة النهاية التي ستستخدمها تطبيقاتك لإرسال طلبات واجهة برمجة التطبيقات.
    مستوى الأسعار مستوى التسعير لمورد اللغة الخاص بك. يمكنك استخدام طبقة F0 المجانية لتجربة الخدمة والترقية لاحقا إلى مستوى مدفوع للإنتاج.

    لقطة شاشة تعرض تفاصيل إنشاء الموارد في مدخل Microsoft Azure.

  4. تأكد من تحديد خانة الاختيار إشعار الذكاء الاصطناعي المسؤول.

  5. حدد Review + Create في أسفل الصفحة.

  6. في الشاشة التي تظهر، تأكد من اجتياز التحقق من الصحة، ومن إدخال معلوماتك بشكل صحيح. وبعد ذلك، حدد إنشاء.

الحصول على المفتاح ونقطة النهاية

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

  1. بعد نشر مورد Language بنجاح، انقر فوق الزر Go to Resource ضمن Next Steps.

    لقطة شاشة تعرض الخطوات التالية بعد نشر مورد.

  2. على شاشة المورد، حدد Keys and endpoint في قائمة التنقل اليسرى. ستستخدم أحد المفاتيح ونقطة النهاية في الخطوات أدناه.

    لقطة شاشة تعرض قسم المفاتيح ونقطة النهاية لمورد.

إنشاء متغيرات البيئة

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

لتعيين متغير البيئة لمفتاح مورد Language، افتح نافذة وحدة تحكم، واتبع الإرشادات الخاصة بنظام التشغيل وبيئة التطوير.

  • لتعيين LANGUAGE_KEY متغير البيئة، استبدل your-key بأحد مفاتيح المورد الخاص بك.
  • لتعيين LANGUAGE_ENDPOINT متغير البيئة، استبدل your-endpoint بنقطة النهاية للمورد الخاص بك.

هام

إذا كنت تستخدم مفتاح API، فخزنه بأمان في مكان آخر، كما هو الحال في Azure Key Vault. لا تقم بتضمين مفتاح API مباشرة في التعليمات البرمجية الخاصة بك، ولا تنشره بشكل عام.

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

setx LANGUAGE_KEY your-key
setx LANGUAGE_ENDPOINT your-endpoint

إشعار

إذا كنت بحاجة فقط إلى الوصول إلى متغيرات البيئة في وحدة التحكم الحالية قيد التشغيل، يمكنك تعيين متغير البيئة باستخدام set بدلا من setx.

بعد إضافة متغيرات البيئة، قد تحتاج إلى إعادة تشغيل أي برامج قيد التشغيل ستحتاج إلى قراءة متغيرات البيئة، بما في ذلك نافذة وحدة التحكم. على سبيل المثال، إذا كنت تستخدم Visual Studio كمحرر، فأعد تشغيل Visual Studio قبل تشغيل المثال.

إنشاء ملف JSON مع مثال نص الطلب

في محرر التعليمات البرمجية، أنشئ ملفا جديدا باسم test_languagedetection_payload.json وانسخ مثال JSON التالي. سيتم إرسال طلب المثال هذا إلى واجهة برمجة التطبيقات في الخطوة التالية.

{
    "kind": "LanguageDetection",
    "parameters": {
        "modelVersion": "latest"
    },
    "analysisInput":{
        "documents":[
            {
                "id":"1",
                "text": "This is a document written in English."
            }
        ]
    }
}

احفظ test_detection_payload.json في مكان ما على الكمبيوتر. على سبيل المثال، سطح المكتب الخاص بك.

إرسال طلب الكشف عن اللغة

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

المعلمة ‏‏الوصف‬
-X POST <endpoint> تحديد نقطة النهاية للوصول إلى واجهة برمجة التطبيقات.
-H Content-Type: application/json نوع المحتوى لإرسال بيانات JSON.
-H "Ocp-Apim-Subscription-Key:<key> تحديد مفتاح الوصول إلى واجهة برمجة التطبيقات.
-d <documents> يحتوي JSON على المستندات التي تريد إرسالها.

احفظ test_languagedetection_payload.json في مكان ما على الكمبيوتر. على سبيل المثال، سطح المكتب الخاص بك.

إرسال طلب واجهة برمجة تطبيقات الكشف عن اللغة

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

المعلمة ‏‏الوصف‬
-X POST <endpoint> تحديد نقطة النهاية للوصول إلى واجهة برمجة التطبيقات.
-H Content-Type: application/json نوع المحتوى لإرسال بيانات JSON.
-H "Ocp-Apim-Subscription-Key:<key> تحديد مفتاح الوصول إلى واجهة برمجة التطبيقات.
-d <documents> يحتوي JSON على المستندات التي تريد إرسالها.

استبدل C:\Users\<myaccount>\Desktop\test_languagedetection_payload.json بموقع ملف طلب JSON المثال الذي أنشأته في الخطوة السابقة.

موجه الأمر

curl -X POST "%LANGUAGE_ENDPOINT%/language/:analyze-text?api-version=2023-11-15-preview" ^
-H "Content-Type: application/json" ^
-H "Ocp-Apim-Subscription-Key: %LANGUAGE_KEY%" ^
-d "@C:\Users\<myaccount>\Desktop\test_languagedetection_payload.json"

PowerShell

curl.exe -X POST $env:LANGUAGE_ENDPOINT/language/:analyze-text?api-version=2023-11-15-preview `
-H "Content-Type: application/json" `
-H "Ocp-Apim-Subscription-Key: $env:LANGUAGE_KEY" `
-d "@C:\Users\<myaccount>\Desktop\test_languagedetection_payload.json"

استخدم الأوامر التالية لإرسال طلب واجهة برمجة التطبيقات باستخدام البرنامج الذي تستخدمه. استبدل /home/mydir/test_detection_payload.json بموقع ملف طلب JSON المثال الذي أنشأته في الخطوة السابقة.

curl -X POST $LANGUAGE_ENDPOINT/language/:analyze-text?api-version=2023-11-15-preview \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: $LANGUAGE_KEY" \
-d "@/home/mydir/test_detection_payload.json"

استجابة JSON

{
    "kind": "LanguageDetectionResults",
    "results": {
        "documents": [
            {
                "id": "1",
                "detectedLanguage": {
                    "name": "English",
                    "iso6391Name": "en",
                    "confidenceScore": 1.0,
                    "script": "Latin",
                    "scriptCode": "Latn"
                },
                "warnings": []
            }
        ],
        "errors": [],
        "modelVersion": "2023-12-01"
    }
}

استخدم الأوامر التالية لحذف متغيرات البيئة التي قمت بإنشائها لهذا التشغيل السريع.

reg delete "HKCU\Environment" /v LANGUAGE_KEY /f
reg delete "HKCU\Environment" /v LANGUAGE_ENDPOINT /f

تنظيف الموارد

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

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