Google 機器學習引擎擴充功能

您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

2.0.0 版

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

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

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

必要條件

本內容提供設定和使用此擴充功能的參考資訊。使用 ExtensionCallout 政策從 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>

要求參數

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

回應

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 代理程式中使用，請使用下列說明。如要瞭解如何使用 Apigee 控制台設定擴充功能，請參閱「新增及設定擴充功能」。

常見的擴充功能屬性

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

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

這個擴充功能套件的屬性

請為下列專屬於此擴充功能的設定屬性指定值。

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