إنشاء مورد المترجم

للبدء، تحتاج إلى حساب Azure نشط. إذا لم يكن لديك اشتراك، يمكنك إنشاء اشتراك مجاني لمدة 12 شهراً.

باستخدام حساب Azure الخاص بك، يمكنك الوصول إلى خدمة المترجم من خلال نوعين مختلفين من الموارد:

1. تتيح أنواع موارد الخدمة الواحدة الوصول إلى مفتاح API ونقطة نهاية واحدة لخدمة واحدة.

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

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

1. «Subscription» (الاشتراك) حدد أحد اشتراكات Azure المتوفرة.

2. مجموعة الموارد يمكنك إنشاء مجموعة موارد جديدة أو إضافة المورد الخاص بك إلى مجموعة موارد موجودة مسبقًا تشترك في نفس دورة الحياة والأذونات والنُهج.

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

4. الاسم. أدخل اسمًا لموردك. يجب أن يكون الاسم الذي تختاره فريدًا في Azure.

   إشعار

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

5. مستوى الأسعار. حدد مستوى تسعير يلبي احتياجاتك:

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

6. إذا قمت بإنشاء مورد متعدد الخدمات، فإن الارتباطات الموجودة أسفل علامة التبويب Basics توفر وثائق تقنية تتعلق بالعملية المناسبة للخدمة.

7. حدد "استعراض + إنشاء".

8. راجع شروط الخدمة، وحدد Create لنشر المورد الخاص بك.

9. بعد نشر موردك بنجاح، حدد Go to resource.

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

   تتطلب جميع طلبات واجهة برمجة تطبيقات خدمات Azure الذكاء الاصطناعي عنوان URL لنقطة النهاية ومفتاح للقراءة فقط للمصادقة.

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

   • عنوان URL نقطة النهاية. استخدم نقطة النهاية العمومية في طلب واجهة برمجة التطبيقات ما لم تكن بحاجة إلى منطقة Azure معينة أو نقطة نهاية مخصصة. لمزيد من المعلومات، راجع عناوين URL الأساسية. عنوان URL لنقطة النهاية العمومية هو api.cognitive.microsofttranslator.com.

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

1. بعد نشر المورد الجديد، حدد Go to resource أو انتقل إلى صفحة المورد.

2. في جزء التنقل الأيمن، ضمن Resource Management، حدد Keys and Endpoint.

3. انسخ المفاتيح وعنوان URL لنقطة النهاية والصقها في موقع مناسب، مثل المفكرة.

   

تدعم ترجمة النص نقاط النهاية العالمية والإقليمية على حد سواء. بمجرد أن يكون لديك مفاتيح المصادقة الخاصة بك، تحتاج إلى إنشاء مثيل TextTranslationClientل ، باستخدام AzureKeyCredential للمصادقة، للتفاعل مع خدمة Text Translation:

1. لإنشاء TextTranslationClient باستخدام نقطة نهاية مورد عمومي، تحتاج إلى مفتاح API للمورد:

     AzureKeyCredential credential = new('<apiKey>');
     TextTranslationClient client = new(credential);
   

2. لإنشاء TextTranslationClient باستخدام نقطة نهاية مورد إقليمي، تحتاج إلى مفتاح API للمورد واسم المنطقة التي يوجد فيها المورد الخاص بك:

   AzureKeyCredential credential = new('<apiKey>');
   TextTranslationClient client = new(credential, '<region>');
   

لإزالة المورد:

1. ابحث عن Resource groups وحددها في مدخل Microsoft Azure، وحدد مجموعة الموارد الخاصة بك.

2. حدد الموارد المراد حذفها عن طريق تحديد خانة الاختيار المجاورة.

3. حدد Delete من القائمة العلوية بالقرب من الحافة اليمنى.

4. أدخل حذف في مربع الحوار حذف الموارد .

5. حدد حذف.

لحذف مجموعة الموارد:

1. انتقل إلى مجموعة الموارد الخاصة بك في مدخل Microsoft Azure.

2. حدد حذف مجموعة الموارد من شريط القوائم العلوي.

3. أكد طلب الحذف بإدخال اسم مجموعة الموارد وتحديد Delete.