أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
الإصدار 1.2.1
طلب توقّعات من Cloud Machine Learning Engine من خلال الإجراء predict، يمكنك طلب التوقّعات وعرضها من نموذج مدرَّب حالي.
بعد ضبط هذه الإضافة باستخدام رقم تعريف مشروعك على Google Cloud وبيانات الاعتماد، يمكنك إجراء طلبات من خادم وكيل لواجهة برمجة التطبيقات باستخدام سياسة ExtensionCallout. في إعدادات السياسة، يمكنك تحديد النموذج وإصداره المطلوب استخدامهما، بالإضافة إلى بيانات المثيل التي تريد أن يستخدمها النموذج لإجراء التوقعات.
لبدء استخدام Cloud ML Engine، راجِع مقدمة عن Cloud ML Engine.
المتطلبات الأساسية
يوفّر هذا المحتوى مرجعًا لإعداد هذه الإضافة واستخدامها. قبل استخدام الإضافة من خادم وكيل لواجهة برمجة التطبيقات باستخدام سياسة ExtensionCallout، يجب اتّباع ما يلي:
تأكَّد من توفّر نموذج.
لمزيد من المعلومات حول نماذج Cloud ML Engine والمفاهيم الأخرى، يمكنك الاطّلاع على المشاريع والنماذج والإصدارات والمهام.
استخدام "وحدة تحكّم Google Cloud Platform" لإنشاء مفتاح لحساب الخدمة
استخدِم محتوى ملف مفتاح JSON الناتج عند إضافة الإضافة وإعدادها باستخدام مرجع الإعداد.
لمحة عن Google Cloud Machine Learning Engine
يمكنك استخدام Cloud Machine Learning Engine لتدريب نماذج تعلُّم الآلة باستخدام موارد Google Cloud Platform. يمكنك استضافة نماذجك المدرَّبة على Cloud ML Engine حتى تتمكّن من إرسال طلبات توقّع إليها وإدارة نماذجك ومهامك باستخدام خدمات Google Cloud Platform.
الإجراءات
توقّع
إجراء توقّعات بشأن بيانات المثيل المحدّدة باستخدام النموذج المحدّد
البنية
<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 Platform الذي يحتوي على النماذج المدرَّبة التي تستخدمها هذه الإضافة | بلا عُري | نعم. |
| بيانات الاعتماد | عند إدخالها في وحدة تحكّم Apigee Edge، يكون هذا هو محتوى ملف مفتاح حساب الخدمة. عند إرسالها من خلال واجهة برمجة التطبيقات الإدارية، تكون قيمة بترميز base64 تم إنشاؤها من ملف مفتاح حساب الخدمة. | بلا عُري | نعم. |