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

مقالة
04/27/2022
قراءة خلال 8 دقائق

استخدم هذا المقال للشروع في "Language Detection" باستخدام مكتبة العميل وواجهة برمجة تطبيقات REST. اتبع هذه الخطوات لتجربة أمثلة التعليمات البرمجية لاستخراج النص.

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

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

اشتراك Azure - إنشاء اشتراك مجاناً
Visual Studio IDE
بمجرد حصولك على اشتراك Azure، قم بإنشاء مورد لغة في مدخل Azure للحصول على المفتاح ونقطة النهاية. بعد توزيعه، انقر فوق انتقل إلى المورد.
- ستحتاج إلى المفتاح ونقطة النهاية من المورد الذي تنشئه لتوصيل تطبيقك إلى واجهة برمجة التطبيقات. ستلصق المفتاح ونقطة النهاية في التعليمات البرمجية أدناه لاحقًا في التشغيل السريع.
- يمكنك استخدام مستوى التسعير الحر (F0) لتجربة الخدمة، والترقية لاحقًا إلى مستوى مدفوع للإنتاج.
لاستخدام ميزة التحليل، ستحتاج إلى مورد اللغة مع مستوى التسعير القياسي (S).

الإعداد

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

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

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

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

انسخ التعليمات البرمجية التالية إلى ملف program.cs. تذكر استبدال المتغير key بمفتاح موردك، واستبدال المتغير endpoint بنقطة النهاية للمورد.

هام

انتقل إلى مدخل Azure. إذا تم نشر مورد اللغة الذي أنشأته في قسمPrerequisites بنجاح، فانقر فوق الزر Go to Resource ضمن Next Steps. يمكنك العثور على مفاتيح الاشتراك ونقطة النهاية في صفحة مفتاح ونقطة النهاية المورد ضمن إدارة الموارد.

تذكر إزالة المفتاح من التعليمات البرمجية عند الانتهاء، وعدم نشره على الملأ مطلقًا. للإنتاج، فكر في استخدام طريقة آمنة لتخزين بيانات الاعتماد الخاصة بك والوصول إليها. على سبيل المثال، Azure key vault.

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

namespace LanguageDetectionExample
{
    class Program
    {
        private static readonly AzureKeyCredential credentials = new AzureKeyCredential("replace-with-your-key-here");
        private static readonly Uri endpoint = new Uri("replace-with-your-endpoint-here");

        // 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(endpoint, credentials);
            LanguageDetectionExample(client);

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

    }
}

المخرجات

Language:
        French, ISO-6391: fr

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

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

اشتراك Azure - إنشاء اشتراك مجاناً
Java Development Kit (SDK) الإصدار 8 أو أعلى.
بمجرد حصولك على اشتراك Azure، قم بإنشاء مورد لغة في مدخل Azure للحصول على المفتاح ونقطة النهاية. بعد توزيعه، انقر فوق انتقل إلى المورد.
- ستحتاج إلى المفتاح ونقطة النهاية من المورد الذي تنشئه لتوصيل تطبيقك إلى واجهة برمجة التطبيقات. ستلصق المفتاح ونقطة النهاية في التعليمات البرمجية أدناه لاحقًا في التشغيل السريع.
- يمكنك استخدام مستوى التسعير الحر (F0) لتجربة الخدمة، والترقية لاحقًا إلى مستوى مدفوع للإنتاج.
لاستخدام ميزة التحليل، ستحتاج إلى مورد اللغة مع مستوى التسعير القياسي (S).

الإعداد

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

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

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

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

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

هام

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 {

    private static String KEY = "replace-with-your-key-here";
    private static String ENDPOINT = "replace-with-your-endpoint-here";

    public static void main(String[] args) {
        TextAnalyticsClient client = authenticateClient(KEY, ENDPOINT);
        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)⁧⁩⁧ | ⁩⁧⁩النماذج⁧⁩

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

اشتراك Azure - إنشاء اشتراك مجانًا
الإصدار الحالي من Node.js.
بمجرد حصولك على اشتراك Azure، قم بإنشاء مورد لغة في مدخل Azure للحصول على المفتاح ونقطة النهاية. بعد توزيعه، انقر فوق انتقل إلى المورد.
- ستحتاج إلى المفتاح ونقطة النهاية من المورد الذي تنشئه لتوصيل تطبيقك إلى واجهة برمجة التطبيقات. ستلصق المفتاح ونقطة النهاية في التعليمات البرمجية أدناه لاحقًا في التشغيل السريع.
- يمكنك استخدام مستوى التسعير الحر (F0) لتجربة الخدمة، والترقية لاحقًا إلى مستوى مدفوع للإنتاج.
لاستخدام ميزة التحليل، ستحتاج إلى مورد اللغة مع مستوى التسعير القياسي (S).

الإعداد

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

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

mkdir myapp 

cd myapp

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

npm init

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

تثبيت الحزمة NPM:

npm install --save @azure/ai-text-analytics@5.1.0

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

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

هام

"use strict";

const { TextAnalyticsClient, AzureKeyCredential } = require("@azure/ai-text-analytics");
const key = '<paste-your-key-here>';
const endpoint = '<paste-your-endpoint-here>';
// Authenticate the client with your key and endpoint
const textAnalyticsClient = new TextAnalyticsClient(endpoint, new AzureKeyCredential(key));

// Example method for detecting the language of text
async function languageDetection(client) {

    const languageInputArray = [
        "Ce document est rédigé en Français."
    ];
    const languageResult = await client.detectLanguage(languageInputArray);

    languageResult.forEach(document => {
        console.log(`ID: ${document.id}`);
        console.log(`\tPrimary Language ${document.primaryLanguage.name}`)
    });
}
languageDetection(textAnalyticsClient);

المخرجات

ID: 0
    Primary Language French

Reference documentation | Library source code | Package (PiPy) | Samples

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

اشتراك Azure - إنشاء اشتراك مجانًا
⁧⁩Python 3.x⁧⁩
بمجرد حصولك على اشتراك Azure، قم بإنشاء مورد لغة في مدخل Azure للحصول على المفتاح ونقطة النهاية. بعد توزيعه، انقر فوق انتقل إلى المورد.
- ستحتاج إلى المفتاح ونقطة النهاية من المورد الذي تنشئه لتوصيل تطبيقك إلى واجهة برمجة التطبيقات. ستلصق المفتاح ونقطة النهاية في التعليمات البرمجية أدناه لاحقًا في التشغيل السريع.
- يمكنك استخدام مستوى التسعير الحر (F0) لتجربة الخدمة، والترقية لاحقًا إلى مستوى مدفوع للإنتاج.
لاستخدام ميزة التحليل، ستحتاج إلى مورد اللغة مع مستوى التسعير القياسي (S).

الإعداد

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

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

pip install azure-ai-textanalytics==5.1.0

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

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

هام

key = "paste-your-key-here"
endpoint = "paste-your-endpoint-here"

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(key)
    text_analytics_client = TextAnalyticsClient(
            endpoint=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

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

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

اشتراك Azure - إنشاء اشتراك مجانًا
الإصدار الحالي من ⁧⁩cURL⁧⁩.
بمجرد حصولك على اشتراك Azure، قم بإنشاء مورد لغة في مدخل Azure للحصول على المفتاح ونقطة النهاية. بعد توزيعه، انقر فوق انتقل إلى المورد.
- ستحتاج إلى المفتاح ونقطة النهاية من المورد الذي تنشئه لتوصيل تطبيقك إلى واجهة برمجة التطبيقات. ستلصق المفتاح ونقطة النهاية في التعليمات البرمجية أدناه لاحقًا في التشغيل السريع.
- يمكنك استخدام مستوى التسعير الحر (F0) لتجربة الخدمة، والترقية لاحقًا إلى مستوى مدفوع للإنتاج.

ملاحظة

تستخدم أمثلة BASH التالية ⁧\⁩ حرف متابعة السطر. إذا كانت وحدة التحكم أو المحطة الطرفية تستخدم حرف متابعة سطر مختلف، فاستخدم هذا الحرف.
يمكنك العثور على عينات لغة محددة على ⁧⁩GitHub⁧⁩.
انتقل إلى مدخل Azure وابحث عن المفتاح ونقطة النهاية لمورد اللغة الذي أنشأته في المتطلبات الأساسية. سيتم تحديد موقعها في صفحة ⁧⁩مفتاح المورد ونقطة النهاية،⁧⁩ ضمن ⁧⁩إدارة الموارد⁧⁩. ثم استبدل السلاسل في التعليمات البرمجية أدناه بالمفتاح ونقطة النهاية. لاسترجاع واجهة برمجة التطبيقات، تحتاج إلى المعلومات التالية:

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

يتم تنفيذ أوامر cURL التالية من BASH shell. قم بتحرير هذه الأوامر باستخدام اسم المورد الخاص بك ومفتاح المورد وقيم JSON.

تحديد اللغة

نسخ الأمر إلى محرر نص.
قم بإجراء التغييرات التالية في الأمر عند الحاجة:
1. استبدال القيمة <your-text-analytics-key-here> بمفتاحك.
2. استبدل الجزء الأول من عنوان URL للطلب <your-text-analytics-endpoint-here> بعنوان URL لنقطة النهاية الخاص بك.
افتح نافذة موجه الأوامر.
الصق الأمر من محرر النص في إطار موجه الأوامر ثم قم بتشغيل الأمر.

curl -X POST https://<your-text-analytics-endpoint-here>/text/analytics/v3.1/languages/ \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: <your-text-analytics-key-here>" \
-d '{ documents: [{ id: "1", text: "This is a document written in English."}]}'

استجابة JSON

{
   "documents":[
      {
         "id":"1",
         "detectedLanguage":{
            "name":"English",
            "iso6391Name":"en",
            "confidenceScore":1.0
         },
         "warnings":[
            
         ]
      }
   ],
   "errors":[
      
   ],
   "modelVersion":"2021-01-05"
}

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

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

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

نظرة عامة على "Language Detection"

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

هل هذه الصفحة مفيدة؟

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

الإعداد

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

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

المخرجات

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

الإعداد

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

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

المخرجات

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

الإعداد

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

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

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

المخرجات

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

الإعداد

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

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

المخرجات

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

تحديد اللغة

استجابة JSON

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

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