التشغيل السريع: إنشاء مورد خدمات معرفية باستخدام Azure CLI

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

استخدم هذه البداية السريعة لبدء استخدام Azure Cognitive Services باستخدام أوامر Azure Command-Line Interface (CLI ).

Azure Cognitive Services هي خدمات مستندة إلى السحابة مع واجهات برمجة تطبيقات REST، وتتوفر مجموعات SDK لمكتبة العميل لمساعدة المطورين على بناء الذكاء المعرفي في التطبيقات دون الحاجة إلى الذكاء الاصطناعي المباشر (الذكاء الاصطناعي) أو مهارات أو معارف علوم البيانات. يمكّن Azure Cognitive Services المطورين من إضافة ميزات معرفية بسهولة إلى تطبيقاتهم من خلال الحلول المعرفية التي يمكنها الرؤية والسماع والتحدث والفهم وحتى البدء في التفكير.

يتم تمثيل Cognitive Services بواسطة موارد Azure التي تقوم بإنشائها في اشتراكك بـ Azure. بعد إنشاء المورد، استخدم المفاتيح ونقطة النهاية التي تم إنشاؤها لك لمصادقة تطبيقاتك.

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

يمكنك الوصول إلى Azure Cognitive Services من خلال موردين مختلفين: مورد متعدد الخدمات، أو مورد خدمة واحدة.

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

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

  • اشتراك Azure صالح - إنشاء اشتراك مجاناً.
  • واجهة Azure CLI
  • يجب أن يكون لحساب Azure دور مساهم في الخدمات المعرفية تم تعيينه لكي توافق على شروط الذكاء الاصطناعي المسؤولة وإنشاء مورد. لتعيين هذا الدور إلى حسابك، اتبع الخطوات الواردة في وثائق تعيين الأدوار ، أو اتصل بالمشرف.
  • يجب عليك إنشاء الوجه الأول، أو التحليلات النصية أو موارد رؤية الكمبيوتر من مدخل Microsoft Azure لمراجعة الشروط والأحكام والموافقة عليها. يمكنك القيام بذلك هنا: Face، وText Analytics، وComputer Vision. بعد ذلك، يمكنك إنشاء موارد لاحقة من خلال استخدام أي أداة نشر (حزمة SDK، أو CLI، أو ARM، إلخ) من خلال نفس الاشتراك على Azure.

قم بتثبيت Azure CLI ثم تسجيل الدخول

قم بتثبيت Azure CLI. لتسجيل الدخول إلى التثبيت المحلي الخاص بك لـ CLI، قم بتشغيل الأمر تسجيل الدخول إلى az:

az login

يمكنك أيضاً استخدام الزر الأخضر Try It لتشغيل هذه الأوامر في المستعرض.

أنشئ مجموعة موارد Azure Cognitive Services جديدة

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

اختيار موقع مجموعة الموارد

لإنشاء مورد، ستحتاج إلى أحد مواقع Azure المتوفرة للاشتراك. يمكنك استرداد قائمة بالمواقع المتوفرة باستخدام الأمر az account list-locations. يمكن الوصول إلى معظم Cognitive Services من عدة مواقع. اختر الأقرب إليك، أو اطلع على المواقع المتاحة للخدمة.

هام

  • تذكر موقع Azure، حيث ستحتاج إليه عند الاتصال بـ Azure Cognitive Services.
  • قد يختلف توفر بعض الخدمات المعرفية حسب المنطقة. للحصول على مزيدٍ من المعلومات، اطلع على منتجات Azure حسب المنطقة.
az account list-locations \
    --query "[].{Region:name}" \
    --out table

بعد أن يكون لديك موقع Azure، قم بإنشاء مجموعة موارد جديدة في CLI Azure باستخدام الأمر az group create.

في المثال أدناه، استبدل موقع Azure westus2 بأحد مواقع Azure المتوفرة للاشتراك.

az group create \
    --name cognitive-services-resource-group \
    --location westus2

إنشاء مورد الخدمات المعرفية

اختيار الخدمة المعرفية ومستوى التسعير

عند إنشاء مورد جديد، ستحتاج إلى معرفة "نوع" الخدمة التي تريد استخدامها، بالإضافة إلى مستوى التسعير (أو SKU) الذي تريده. يمكنك استخدام هذه المعلومات وغيرها كمعلمات عند إنشاء المورد.

يمكنك الوصول إلى Azure Cognitive Services من خلال موردين مختلفين: مورد متعدد الخدمات، أو مورد خدمة واحدة.

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

انظر قائمة وحدات SKU ومعلومات التسعير أدناه.

متعدد الخدمات

الخدمة النوع
خدمات متعددة. لمزيد من المعلومات، يُرجى الرجوع إلى صفحة التسعير. CognitiveServices

البحث الضوئي

الخدمة النوع
رؤية الكمبيوتر ComputerVision
Custom Vision - التنبؤ CustomVision.Prediction
Custom Vision - التدريب CustomVision.Training
وجه Face
Form Recognizer FormRecognizer

الكلام

الخدمة النوع
خدمات الكلام SpeechServices

اللغة

الخدمة النوع
LUIS LUIS
QnA Maker QnAMaker
خدمة اللغة TextAnalytics
مترجم النصوص TextTranslation

القرار

الخدمة النوع
Anomaly Detector AnomalyDetector
مشرف المحتوى ContentModerator
Personalizer Personalizer

مستويات التسعير والفوترة

تستند مستويات التسعير (والمبلغ الذي تتم فوترته لك) إلى عدد المعاملات التي ترسلها باستخدام معلومات المصادقة الخاصة بك. يحدد كل مستوى تسعير ما يلي:

  • الحد الأقصى لعدد المعاملات المسموح بها في الثانية (TPS).
  • ميزات الخدمة الممكنة ضمن مستوى التسعير.
  • تكلفة عدد محدد مسبقاً من المعاملات. سيؤدي تجاوز هذا الرقم إلى فرض رسوم إضافية كما هو محدد في تفاصيل التسعير لخدمتك.

ملاحظة

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

يمكنك العثور على قائمة "أنواع" الخدمة المعرفية المتوفرة مع الأمر az cognitiveservices account list-kinds

az cognitiveservices account list-kinds

إضافة مورد جديد إلى مجموعة الموارد

لإنشاء مورد خدمات معرفية جديد والاشتراك فيه، استخدم الأمر az cognitiveservices account create. يضيف هذا الأمر مورداً جديداً قابلاً للفوترة إلى مجموعة الموارد التي تم إنشاؤها مسبقاً. عند إنشاء مورد جديد، ستحتاج إلى معرفة "نوع" الخدمة التي تريد استخدامها، بالإضافة إلى مستوى التسعير (أو sku) وموقع Azure:

يمكنك إنشاء مورد F0 (مجاناً) للكشف عن الشذوذ، المسمى anomaly-detector-resource باستخدام الأمر أدناه.

az cognitiveservices account create \
    --name anomaly-detector-resource \
    --resource-group cognitive-services-resource-group \
    --kind AnomalyDetector \
    --sku F0 \
    --location westus2 \
    --yes

تلميح

إذا كان اشتراكك لا يسمح لك بإنشاء مورد خدمة معرفية، فقد تحتاج إلى تمكين هذه القدرة من موفر الموارد Azure باستخدام مدخل Azure، أو أمر PowerShell أو أمر Azure CLI. إذا لم تكن مالك الاشتراك، فاطلب من مالك الاشتراك أو أي شخص له دور مسؤول إكمال التسجيل لك أو طلب امتيازات /register/action الممنوحة لحسابك.

الحصول على مفاتيح المورد الخاص بك

لتسجيل الدخول إلى التثبيت المحلي الخاص بك من واجهة سطر الأوامر (CLI)، استخدم الأمر az login.

az login

استخدم الأمر az cognitiveservices account keys list للحصول على مفاتيح مورد "الخدمة المعرفية".

    az cognitiveservices account keys list \
    --name anomaly-detector-resource \
    --resource-group cognitive-services-resource-group

تكوين متغير البيئة للمصادقة

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

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

setx COGNITIVE_SERVICE_KEY "your-key"

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

مستويات التسعير والفوترة

تستند مستويات التسعير (والمبلغ الذي تتم فوترته لك) إلى عدد المعاملات التي ترسلها باستخدام معلومات المصادقة الخاصة بك. يحدد كل مستوى تسعير ما يلي:

  • الحد الأقصى لعدد المعاملات المسموح بها في الثانية (TPS).
  • ميزات الخدمة الممكنة ضمن مستوى التسعير.
  • تكلفة عدد محدد مسبقاً من المعاملات. سيؤدي تجاوز هذا المبلغ إلى فرض رسوم إضافية كما هو محدد في تفاصيل التسعير لخدمتك.

الحصول على استخدام الحصة الحالية لمواردك

استخدم الأمر az cognitiveservices account list-usage للحصول على الاستخدام لمورد الخدمة المعرفية الخاص بك.

az cognitiveservices account list-usage \
    --name anomaly-detector-resource \
    --resource-group cognitive-services-resource-group \
    --subscription subscription-name

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

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

لإزالة مجموعة الموارد والموارد المرتبطة بها، استخدم الأمر az group delete.

az group delete --name cognitive-services-resource-group

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

راجع أيضًا