תוסף למידת מכונה של Google

אתם צופים במסמכי התיעוד של Apigee Edge.
אפשר לעבור אל מסמכי התיעוד של Apigee X.
מידע

גרסה 1.2.1

שליחת בקשות לתחזיות מ-Cloud Machine Learning Engine. באמצעות הפעולה predict, אפשר לבקש תחזיות ממודל מאומן קיים ולהציג אותן.

אחרי שמגדירים את התוסף הזה עם מזהה הפרויקט ופרטי הכניסה שלכם ב-Google Cloud, אפשר להפעיל קריאות מ-API proxy באמצעות מדיניות ExtensionCallout. בהגדרת המדיניות, מציינים את המודל ואת גרסת המודל שבהם רוצים להשתמש, וגם את נתוני המופע שבהם רוצים שהמודל ישתמש לצורך חיזוי.

כדי להתחיל להשתמש ב-Cloud ML Engine, אפשר לקרוא את המאמר מבוא ל-Cloud ML Engine.

דרישות מוקדמות

התוכן הזה מספק הפניה להגדרת התוסף הזה ולשימוש בו. לפני שמשתמשים בתוסף משרת proxy של API באמצעות מדיניות ExtensionCallout, צריך:

  1. מוודאים שיש לכם מודל.

    מידע נוסף על מודלים של Cloud ML Engine ומושגים אחרים זמין במאמר פרויקטים, מודלים, גרסאות ועבודות.

  2. שימוש במסוף GCP כדי ליצור מפתח לחשבון השירות.

  3. משתמשים בתוכן של קובץ ה-JSON של המפתח שנוצר כשמוסיפים ומגדירים את התוסף באמצעות הפניה להגדרות.

מידע על Google Cloud Machine Learning Engine

אפשר להשתמש ב-Cloud Machine Learning Engine כדי לאמן מודלים של למידת מכונה באמצעות המשאבים של Google Cloud Platform. אתם יכולים לארח את המודלים המאומנים ב-Cloud ML Engine כדי לשלוח להם בקשות לחיזוי ולנהל את המודלים והמשימות באמצעות שירותי GCP.

פעולות

לנבא

ביצוע חיזויים על נתוני המופע שצוינו באמצעות המודל שצוין.

תחביר

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

פרמטרים של בקשה

פרמטר תיאור סוג ברירת מחדל חובה
מודל המודל שבו צריך להשתמש בשביל התחזיות. מחרוזת ללא. כן.
גרסה הגרסה של פתרון למידת מכונה שבה רוצים להשתמש לחיזויים. מחרוזת ללא. כן.
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
      ]
    }
  ]
}

הסבר על ההגדרות

כשמגדירים ופורסים את התוסף הזה לשימוש בשרתי proxy ל-API, צריך להשתמש בפרטים הבאים. הוראות להגדרת תוסף באמצעות מסוף Apigee מופיעות במאמר הוספה והגדרה של תוסף.

מאפיינים נפוצים של תוספים

המאפיינים הבאים קיימים בכל תוסף.

נכס תיאור ברירת המחדל נדרש
name השם שבחרת לתצורה הזו של התוסף. ללא כן
packageName השם של חבילת התוסף כפי שהוא סופק על ידי Apigee Edge. ללא כן
version מספר הגרסה של חבילת התוסף שממנה מגדירים את התוסף. ללא כן
configuration ערך הגדרה ספציפי לתוסף שרוצים להוסיף. מאפיינים לחבילת תוספים זו ללא כן

מאפיינים של חבילת התוספים הזו

מזינים ערכים למאפייני ההגדרה הבאים שספציפיים לתוסף הזה.

נכס תיאור ברירת מחדל חובה
projectId מזהה הפרויקט ב-GCP שמכיל מודלים מאומנים שמשמשים את התוסף הזה. ללא. כן.
פרטי כניסה כשמזינים את התוכן הזה במסוף Apigee Edge, הוא מופיע בקובץ המפתח של חשבון השירות. כששולחים את הערך הזה דרך Management API, הוא מגיע בקידוד Base64 שנוצר מקובץ המפתח של חשבון השירות. ללא. כן.