Google Machine Learning Engine Extension

You're viewing Apigee Edge documentation.
Go to the Apigee X documentation. info

Version 1.0.0

Request predictions from Cloud Machine Learning Engine. Through the predict action, you can request and serve predictions from an existing trained model.

After configuring this extension with your Google Cloud project ID and credentials, you make calls from an API proxy using the ExtensionCallout policy. In your policy configuration, you specify the model and model version to use, as well as the instance data you want the model to use for predicting.

To get started with Cloud ML Engine, see Introduction to Cloud ML Engine.

Prerequisites

This content provides reference for configuring and using this extension. Before using the extension from an API proxy using the ExtensionCallout policy, you must:

1. Ensure that you have a model.

   For more about Cloud ML Engine models and other concepts, see Projects, Models, Versions, and Jobs.

2. Use the GCP Console to generate a key for the service account.

3. Use the contents of the resulting key JSON file when adding and configuring the extension using the configuration reference.

About Google Cloud Machine Learning Engine

You can use Cloud Machine Learning Engine to train machine learning models using the resources of Google Cloud Platform. You can host your trained models on Cloud ML Engine so that you can send them prediction requests and manage your models and jobs using the GCP services.

Actions

predict

Perform predictions on the specified instance data using the specified model.

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

Request parameters

Response

A predictions array that includes prediction data returned by model specified in ExtensionCallout policy configuration.

{
  "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
      ]
    }
  ]
}

Configuration Reference

Use the following when you're configuring and deploying this extension for use in API proxies. For steps to configure an extension using the Apigee console, see Adding and configuring an extension.

Common extension properties

The following properties are present for every extension.

Properties for this extension package

Specify values for the following configuration properties specific to this extension.