إضافة Google Machine Learning Engine

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

الإصدار 2.0.0

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

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

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

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

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

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

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

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

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

لمحة عن خدمة "تعلُّم الآلة" من Google Cloud

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

الإجراءات

توقّع

إجراء توقّعات بشأن بيانات المثيل المحدّدة باستخدام النموذج المحدّد

البنية

<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>

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

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

الردّ

مصفوفة 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
      ]
    }
  ]
}

مرجع الإعدادات

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

سمات الإضافات الشائعة

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

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

سمات حزمة هذه الإضافة

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

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