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

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

גרסה 2.0.0

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

אחרי שמגדירים את התוסף הזה עם מזהה הפרויקט ופרטי הכניסה ב-Google Cloud, מבצעים קריאות משרתי proxy של API באמצעות מדיניות 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. אתם יכולים לארח את המודלים המאומנים ב-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>

פרמטרים של בקשות

פרמטר תיאור סוג ברירת מחדל חובה
מודל המודל שמשמש לביצוע תחזיות. מחרוזת ללא. כן.
גרסה הגרסה של פתרון ה-ML לשימוש בחיזויים. מחרוזת ללא. כן.
מכונות המכונות שעבורן רוצים לקבל חיזויים. הצורה של הפריטים בערך הזה תלויה בציפיות של המודל שבו אתם משתמשים כדי לבצע את החיזוי. מידע נוסף זמין במאמר חיזוי פרטי הבקשה. מערך ללא. כן.

תשובה

מערך 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, זהו התוכן של קובץ המפתח של חשבון השירות. כששולחים אותו דרך ממשק ה-API לניהול, הוא ערך בקידוד base64 שנוצר מקובץ המפתח של חשבון השירות. ללא. כן.