إضافة Google Machine Learning Engine

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
المعلومات

الإصدار 1.2.1

يمكنك طلب التوقعات من Cloud Machine Learning Engine. ومن خلال الإجراء predict، يمكنك طلب وتقديم عبارات البحث المقترحة من نموذج مدرّب حالي.

بعد ضبط هذه الإضافة باستخدام رقم تعريف المشروع على Google Cloud وبيانات الاعتماد، يمكنك إجراء مكالمات من خادم وكيل لواجهة برمجة التطبيقات باستخدام سياسة ExtensionCallout. في ضبط السياسة، عليك تحديد النموذج وإصدار النموذج المراد استخدامهما، بالإضافة إلى بيانات المثيل التي تريد أن يستخدمها النموذج للتوقّع.

لبدء استخدام Cloud ML Engine، يُرجى الاطّلاع على مقدّمة عن Cloud ML Engine.

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

يوفر هذا المحتوى مرجعًا لضبط هذه الإضافة واستخدامها. قبل استخدام الإضافة من خادم وكيل لواجهة برمجة التطبيقات باستخدام سياسة ExtensionCallout، يجب عليك:

  1. تأكد من أن لديك نموذجًا.

    ولمزيد من المعلومات عن نماذج Cloud ML Engine والمفاهيم الأخرى، يُرجى الاطّلاع على المشاريع والنماذج والإصدارات والوظائف.

  2. استخدِم وحدة تحكُّم Google Cloud Platform لإنشاء مفتاح لحساب الخدمة.

  3. استخدِم محتوى ملف JSON للمفتاح الناتج عند تثبيت الإضافة وضبطها باستخدام مرجع الإعدادات.

لمحة عن Google Cloud Machine Learning Engine

يمكنك استخدام Cloud Machine Learning Engine لتدريب نماذج تعلُّم الآلة باستخدام موارد Google Cloud Platform. يمكنك استضافة نماذجك المدربة على Cloud ML Engine لتتمكّن من إرسال طلبات التوقّع إليها وإدارة نماذجك ومهامك باستخدام خدمات GCP.

المهام

predict

يمكن تطبيق تنبؤات على بيانات المثيل المحددة باستخدام النموذج المحدد.

البنية

<Action>predict</Action>
<Input><![CDATA[{
  "model" : model-for-prediction,
  "version" : model-version,
  "instances" : data-to-use-for-making-prediction
}]]></Input>

مثال

<Action>predict</Action>
<Input><![CDATA[{
  "model" : mymodel,
  "version" : version4,
  "instances" : {"instances": ["the quick brown fox", "la bruja le dio"]}
}]]></Input>

مَعلمات الطلب

المَعلمة الوصف Type تلقائي مطلوبة
model النموذج المستخدم للتنبؤات. سلسلة بلا عُري نعم.
إصدار يشير ذلك المصطلح إلى إصدار حل تعلُّم الآلة الذي يتم استخدامه في التوقّعات. سلسلة بلا عُري نعم.
الحالات تمثّل هذه السمة الحالات المطلوب الحصول على توقّعات بشأنها. وسيعتمد شكل العناصر في هذه القيمة على توقعات النموذج الذي تستخدمه للتنبؤ. لمعرفة المزيد من المعلومات، اطّلِع على توقّع تفاصيل الطلب. مصفوفة بلا عُري نعم.

الإجابة

مصفوفة predictions تتضمّن بيانات توقّعات يعرضها النموذج المحدّد في إعدادات سياسة ExtensionCallout.

{
  "predictions": [
    {
      "probabilities": [
        0.9435398578643799,
        0.05646015331149101
      ],
      "logits": [
        -2.816103458404541
      ],
      "classes": [
        "0"
      ],
      "class_ids": [
        0
      ],
      "logistic": [
        0.056460149586200714
      ]
    },
    {
      "probabilities": [
        0.9271764755249023,
        0.07282354682683945
      ],
      "logits": [
        -2.54410457611084
      ],
      "classes": [
        "0"
      ],
      "class_ids": [
        0
      ],
      "logistic": [
        0.07282353937625885
      ]
    }
  ]
}

مرجع التكوين

استخدِم ما يلي عند ضبط هذه الإضافة ونشرها للاستخدام في الخوادم الوكيلة لواجهة برمجة التطبيقات. لمعرفة خطوات إعداد إضافة باستخدام وحدة تحكُّم Apigee، يُرجى الاطّلاع على إضافة إضافة وضبطها.

خصائص الإضافات الشائعة

السمات التالية متاحة لكل إضافة.

الموقع الوصف تلقائي عنصر مطلوب
name الاسم الذي تُعطِه هذه الإضافة من الإضافات. لا ينطبق متوافق
packageName اسم حزمة الإضافة كما هو مُوضَّح من Apigee Edge. لا ينطبق متوافق
version رقم إصدار حزمة الإضافة التي تجري عملية إعداد الإضافة منها. لا ينطبق متوافق
configuration قيمة الإعداد المتعلقة بالإضافة التي تدرجها الاطّلاع على خصائص حزمة الإضافات هذه لا ينطبق متوافق

الخصائص لحزمة الإضافات هذه

يمكنك تحديد قيم لخصائص الإعداد التالية الخاصة بهذه الإضافة.

الموقع الوصف تلقائي مطلوبة
projectId رقم تعريف مشروع Google Cloud Platform الذي يحتوي على نماذج مدرَّبة تستخدمها هذه الإضافة. بلا عُري نعم.
بيانات الاعتماد عند إدخالها في وحدة تحكّم Apigee Edge، تكون هي محتوى ملف مفتاح حساب الخدمة. وعند إرسالها من خلال واجهة برمجة تطبيقات الإدارة، تكون قيمة بترميز base64 يتم إنشاؤها من ملف مفتاح حساب الخدمة. بلا عُري نعم.