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

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

גרסה 1.0.0

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

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

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

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

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

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

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

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

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

מידע על מנוע למידת המכונה של Google Cloud

אפשר להשתמש ב-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>

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

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

תשובה

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

{
  "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 שנוצר מקובץ המפתח של חשבון השירות. ללא. כן.