Google 機器學習引擎擴充功能

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件
資訊

1.2.1 版

透過 Cloud Machine Learning Engine 要求預測作業。透過 predict 動作,您可以從已訓練的現有模型要求及提供預測。

使用 Google Cloud 專案 ID 和憑證設定這項擴充功能後,請使用 Extension callout 政策透過 API Proxy 進行呼叫。在政策設定中,您會指定要使用的模型和模型版本,以及要讓模型用於預測的執行個體資料。

如要開始使用 Cloud ML Engine,請參閱 Cloud ML Engine 簡介

必要條件

本文提供設定和使用這個擴充功能的參考資料。透過 Extension callout 政策透過 API Proxy 使用擴充功能前,您必須:

  1. 確認您已擁有模型。

    如要進一步瞭解 Cloud ML Engine 模型和其他概念,請參閱專案、模型、版本和工作

  2. 使用 GCP 控制台產生服務帳戶的金鑰

  3. 透過設定參考資料新增及設定擴充功能時,使用產生的金鑰 JSON 檔案內容。

關於 Google Cloud Machine Learning Engine

您可以透過 Cloud Machine Learning Engine,運用 Google Cloud Platform 的資源訓練機器學習模型。您可以在 Cloud ML Engine 上託管訓練過的模型,以便傳送預測要求,並使用 GCP 服務管理模型和工作。

動作

predict

使用指定模型對指定的樣本資料執行預測。

語法

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

要求參數

參數 說明 類型 預設 需要
model 用於預測的模型。 字串 無。 可以。
version 用於預測的機器學習解決方案版本。 字串 無。 可以。
執行個體 要取得預測結果的例項。這個值中的項目的形狀取決於你用來預測的模型的期望。詳情請參閱預測要求詳細資料 陣列 無。 可以。

回應

predictions 陣列,包含 Extension callout 政策設定中指定的模型傳回的預測資料。

{
  "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 Proxy,請按照下列指示操作。如需使用 Apigee 控制台設定擴充功能的相關步驟,請參閱「新增及設定擴充功能」。

常見擴充功能屬性

每個擴充功能都有下列屬性。

屬性 說明 預設 必要
name 您要為這項擴充功能設定的名稱。 相容
packageName Apigee Edge 指定的擴充功能套件名稱。 相容
version 擴充功能的擴充功能套件版本號碼。 相容
configuration 您要新增的擴充功能專屬的設定值。請參閱「這個擴充功能套件的屬性」一文 相容

這個擴充功能套件的屬性

指定這個擴充功能的下列設定屬性值。

屬性 說明 預設 需要
projectId 這是 GCP 專案的 ID,專案含有這項擴充功能使用的已訓練模型。 無。 可以。
憑證 在 Apigee Edge 控制台中輸入時,服務帳戶金鑰檔案的內容即為。透過 Management API 傳送時,是由服務帳戶金鑰檔案產生的 Base64 編碼值。 無。 可以。