Google 機器學習引擎擴充功能

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件
資訊

1.0.0 版本

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

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

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

必要條件

這項內容提供設定與使用這項擴充功能的參考資源。透過 Extension 摘要政策使用 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 陣列,包含 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 您要新增的擴充功能專屬的設定值。請參閱「這個擴充功能套件的屬性」一文 相容

這個擴充功能套件的屬性

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

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