إضافة Google Machine Learning Engine

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلىمستندات Apigee X.
info

الإصدار 2.0.0

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

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

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

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

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

  1. التأكّد من توفّر نموذج

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

  2. استخدام Google Cloud Console لإنشاء مفتاح لحساب الخدمة.

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

لمحة عن Google Cloud Machine Learning Engine

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

الإجراءات

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>

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

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

الردّ

مصفوفة 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 الذي يحتوي على النماذج التي تم تدريبها والتي تستخدمها هذه الإضافة بلا عُري نعم.
credentials عند إدخالها في وحدة تحكّم Apigee Edge، تكون هذه هي محتويات ملف مفتاح حساب الخدمة . عند إرسالها باستخدام Management API، تكون قيمة بترميز base64 تم إنشاؤها من ملف مفتاح حساب الخدمة. بلا عُري نعم.