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

يصف هذا التشغيل السريع كيفية استخدام قالب "Azure Resource Manager" (قالب ARM) لإنشاء خدمات معرفية.

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

إنشاء موارد باستخدام قالب "Azure Resource Manager" (قالب ARM). يتيح لك هذا المورد متعدد الخدمات ما يلي:

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

نموذج ARM هو ملف JavaScript Object Notation (JSON) الذي يُعرف البنية الأساسية والتكوين للمشروع الخاص بك. يستخدم النموذج عبارات توضيحية. خلال العبارات التوضيحية، تصف عملية الإرسال المقصودة دون تسلسل لأوامر البرمجة لهذا الغرض.

إذا كانت بيئتك تلبي المتطلبات الأساسية وكنت معتاداً على استخدام قوالب إدارة "ARM"، فحدد الزرتوزيع في Azure. سيتم فتح القالب في مدخل "Azure".

Deploy your cognitive service to Azure

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

مراجعة القالب

يُعدّ القالب المستخدم في هذا التشغيل السريع مأخوذ من قوالب التشغيل السريع من "Azure".

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.5.6.12127",
      "templateHash": "15212843909029853621"
    }
  },
  "parameters": {
    "cognitiveServiceName": {
      "type": "string",
      "defaultValue": "[format('CognitiveService-{0}', uniqueString(resourceGroup().id))]",
      "metadata": {
        "description": "That name is the name of our application. It has to be unique.Type a name followed by your resource group name. (<name>-<resourceGroupName>)"
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    },
    "sku": {
      "type": "string",
      "defaultValue": "S0",
      "allowedValues": [
        "S0"
      ]
    }
  },
  "resources": [
    {
      "type": "Microsoft.CognitiveServices/accounts",
      "apiVersion": "2021-10-01",
      "name": "[parameters('cognitiveServiceName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('sku')]"
      },
      "kind": "CognitiveServices",
      "properties": {
        "apiProperties": {
          "statisticsEnabled": false
        }
      }
    }
  ]
}

تم تعريف أحد موارد "Azure" في القالب:

نشر القالب

  1. انقر فوق زر "Deploy to Azure" .

    Deploy to Azure

  2. أدخِل القيم الآتية.

    القيمة الوصف
    الاشتراك حدد اشتراك "Azure".
    مجموعة الموارد حدد "Create new" ، وأدخل اسماً فريداً لمجموعة الموارد، ثم انقر فوق "OK" .
    المنطقة حدد منطقة. على سبيل المثال، شرق الولايات المتحدة
    اسم الخدمة المعرفية استبدال باسم فريد لمجموعة الموارد. ستحتاج إلى الاسم في القسم التالي عند التحقق من صحة النشر.
    ⁩الموقع⁧ استبدال بالمنطقة المستخدمة أعلاه.
    "Sku" مستوى التسعير للمورد الخاص بك.

    Resource creation screen.

  3. حدد "Review + Create" ، ثم "Create" . بعد انتهاء المورد بنجاح من النشر، سيتم تمييز زر "Go to resource" .

تلميح

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

مراجعة الموارد المنشورة

عند انتهاء عملية النشر، ستتمكن من النقر فوق زر "Go to resource" لرؤية المورد الجديد. يمكنك أيضاً إيجاد مجموعة الموارد من خلال:

  1. تحديد "Resource groups" من قائمة التنقل اليسرى.
  2. حدد اسم مجموعة الموارد.

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

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

  1. في "Azure portal"، توسيع القائمة على الجانب الأيمن لفتح قائمة الخدمات، واختيار "Resource Groups" لعرض قائمة مجموعات الموارد.
  2. تحديد موقع مجموعة الموارد التي تحتوي على المورد المراد حذفه
  3. انقر بزر الماوس الأيمن على قائمة مجموعة الموارد. حدد "Delete resource group" ، ثم قم بالتأكيد.

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

راجع أيضًا