Extensión de Google Machine Learning Engine

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X.
info

Versión 2.0.0

Solicita predicciones de Cloud Machine Learning Engine. A través de la acción predict, puedes solicitar y entregar predicciones de un modelo entrenado existente.

Después de configurar esta extensión con tu ID del proyecto y credenciales de Google Cloud, puedes realizar llamadas desde un proxy de API con la política ExtensionCallout. En la configuración de la política, debes especificar el modelo y la versión del modelo que se usarán, así como los datos de la instancia que deseas que el modelo use para la predicción.

Para comenzar a usar Cloud ML Engine, consulta Introducción a Cloud ML Engine.

Requisitos previos

Este contenido proporciona una referencia para configurar y usar esta extensión. Antes de usar la extensión desde un proxy de API con la política ExtensionCallout, debes hacer lo siguiente:

  1. Asegurarte de tener un modelo

    Para obtener más información sobre los modelos de Cloud ML Engine y otros conceptos, consulta Proyectos, modelos, versiones y trabajos.

  2. Usar la consola de Google Cloud para generar una clave para la cuenta de servicio.

  3. Usar el contenido del archivo JSON de claves resultante cuando agregues y configures la extensión con la referencia de configuración.

Acerca de Google Cloud Machine Learning Engine

Puedes usar Cloud Machine Learning Engine para entrenar modelos de aprendizaje automático con los recursos de Google Cloud. Puedes alojar tus modelos entrenados en Cloud ML Engine para que puedas enviarles solicitudes de predicción y administrar tus modelos y trabajos con los servicios de Google Cloud.

Acciones

predict

Realiza predicciones sobre los datos de instancia especificados con el modelo especificado.

Sintaxis

<Action>predict</Action>
<Input><![CDATA[{
  "model" : model-for-prediction,
  "version" : model-version,
  "instances" : data-to-use-for-making-prediction
}]]></Input>

Ejemplo

<Action>predict</Action>
<Input><![CDATA[{
  "model" : mymodel,
  "version" : version4,
  "instances" : {"instances": ["the quick brown fox", "la bruja le dio"]}
}]]></Input>

Parámetros de solicitud

Parámetro Descripción Tipo Predeterminado Obligatorio
modelo El modelo que se usará para las predicciones String Ninguno
versión La versión de una solución de AA que se usará para las predicciones String Ninguno
instancias Las instancias para las que se obtendrán predicciones La forma de los elementos en este valor dependerá de las expectativas del modelo que uses para predecir. Para obtener más información, consulta Detalles de la solicitud de predicción. Array Ninguno

Respuesta

Un array predictions que incluye los datos de predicción que muestra el modelo especificado en la configuración de la política 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
      ]
    }
  ]
}

Referencia de configuración

Usa lo siguiente cuando configures y, también, implementes esta extensión para usarla en proxies de API. Si deseas conocer los pasos para configurar una extensión con la consola de Apigee, consulta Cómo agregar y configurar una extensión.

Propiedades comunes de la extensión

Las siguientes propiedades están presentes para cada extensión.

Propiedad Descripción Predeterminado Obligatorio
name Nombre que asignas a esta configuración de la extensión. Ninguna
packageName Nombre del paquete de extensiones proporcionado por Apigee Edge. Ninguna
version El número de versión del paquete de extensiones desde el que quieres configurar la extensión. Ninguna
configuration Es un valor de configuración específico para la extensión que agregas. Consulta Propiedades para este paquete de extensiones Ninguna

Propiedades de este paquete de extensión

Especifica valores para las siguientes propiedades de configuración específicas de esta extensión.

Propiedad Descripción Predeterminado Obligatorio
projectId Es el ID del proyecto de Google Cloud que contiene los modelos entrenados que usa esta extensión. Ninguno
credenciales Cuando se ingresa en la consola de Apigee Edge, este es el contenido del archivo de claves de tu cuenta de servicio . Cuando se envía con la API de administración, es un valor codificado en Base64 que se genera a partir del archivo de claves de la cuenta de servicio. Ninguno