Google Machine Learning Engine 拡張機能

Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメントに移動します。 情報

バージョン 2.0.0

Cloud Machine Learning Engine から予測をリクエストします。predict アクションを使用すると、既存のトレーニング済みモデルから予測をリクエストして提供できます。

Google Cloud プロジェクト ID と認証情報を使用してこの拡張機能を構成したら、ExtensionCallout ポリシーを使用して API プロキシから呼び出しを行います。ポリシー構成では、使用するモデルとモデルのバージョン、モデルが予測に使用するインスタンス データを指定します。

Cloud ML Engine の使用を開始するには、Cloud ML Engine の概要をご覧ください。

前提条件

このコンテンツでは、この拡張機能を構成して使用するためのリファレンスを提供します。ExtensionCallout ポリシーを使用して API プロキシから拡張機能を使用する前に、次の操作を行う必要があります。

  1. モデルがあることを確認します。

    Cloud ML Engine モデルとその他のコンセプトの詳細については、プロジェクト、モデル、バージョン、ジョブをご覧ください。

  2. Google Cloud コンソールを使用して、サービス アカウントのキーを生成します。

  3. 構成リファレンスを使用して拡張機能を追加して構成するときは、生成された鍵 JSON ファイルの内容を使用します。

Google Cloud Machine Learning Engine について

Cloud Machine Learning Engine を使用すると、Google Cloud のリソースを使用して ML モデルをトレーニングできます。トレーニング済みモデルを Cloud ML Engine でホストして、予測リクエストを送信し、Google Cloud サービスを使用してモデルとジョブを管理できます。

操作

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>

リクエスト パラメータ

パラメータ 説明 型 デフォルト 必須
モデル 予測に使用するモデル。 文字列 なし。 はい。
version 予測に使用する ML ソリューションのバージョン。 文字列 なし。 はい。
インスタンス 予測を取得するインスタンス。この値のアイテムの形状は、予測に使用するモデルの期待値によって異なります。詳細については、予測リクエストの詳細をご覧ください。 配列 なし。 はい。

レスポンス

ExtensionCallout ポリシー構成で指定されたモデルから返された予測データを含む 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
      ]
    }
  ]
}

構成リファレンス

API プロキシで使用するためにこの拡張機能を構成してデプロイする場合は、次の点に注意してください。Apigee コンソールを使用して拡張機能を構成する手順については、拡張機能を追加して構成するをご覧ください。

共通の拡張プロパティ

すべての拡張機能には次のプロパティがあります。

プロパティ 説明 デフォルト 必須
name この拡張機能に付ける名前。 なし ○
packageName Apigee Edge から提供された拡張機能パッケージの名前。 なし ○
version 拡張機能を構成する拡張機能パッケージのバージョン番号。 なし ○
configuration 追加する拡張機能に固有の構成値。この拡張機能パッケージのプロパティをご覧ください。 なし ○

この拡張パッケージのプロパティ

この拡張機能に固有の次の構成プロパティの値を指定します。

プロパティ 説明 デフォルト 必須
projectId この拡張機能で使用されるトレーニング済みモデルを含む Google Cloud プロジェクトの ID。 なし。 はい。
credentials Apigee Edge コンソールに入力すると、これはサービス アカウント キーファイルの内容になります。管理 API を使用して送信される場合、サービス アカウント キーファイルから生成された base64 エンコード値になります。 なし。 はい。