Google 機器學習引擎擴充功能

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

1.2.1 版本

向 Cloud Machine Learning Engine 要求預測。透過 predict 動作，您可以從現有訓練模型要求及提供預測結果。

使用 Google Cloud 專案 ID 和憑證設定這個擴充功能後，您可以使用 ExtensionCallout 政策，從 API 代理程式發出呼叫。在政策設定中，您可以指定要使用的模型和模型版本，以及模型用於預測的例項資料。

如要開始使用 Cloud ML Engine，請參閱「Cloud ML Engine 簡介」。

必要條件

這項內容提供設定及使用這項擴充功能的參考資料。使用 ExtensionCallout 政策從 API Proxy 使用擴充功能之前，請務必完成下列步驟：

確認您有模型。

如要進一步瞭解 Cloud ML Engine 模型和其他概念，請參閱「專案、模型、版本與工作」。
使用 GCP 主控台為服務帳戶產生金鑰。
使用產生的金鑰 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>

要求參數

參數	說明	類型	預設	必填
模型	用於預測的模型。	字串	無。	是。
版本	用於預測的機器學習解決方案版本。	字串	無。	是。
執行個體	要取得預測結果的執行個體。這個值中項目的形狀取決於您用於預測的模型期望。詳情請參閱「預測要求詳細資料」。	陣列	無。	是。

回應

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 Proxy 中使用時，請參考下列資訊。如要瞭解如何使用 Apigee 控制台設定擴充功能，請參閱「新增及設定擴充功能」。

常見的擴充功能屬性

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

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

這個擴充套件的屬性

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

屬性	說明	預設	必填
projectId	包含這項擴充功能所用已訓練模型的 GCP 專案 ID。	無。	是。
憑證	在 Apigee Edge 控制台中輸入時，這是服務帳戶金鑰檔案的內容。透過 Management API 傳送時，這是從服務帳戶金鑰檔案產生的 Base64 編碼值。	無。	是。