Extensión de Google Machine Learning Engine

Estás viendo la documentación de Apigee Edge.
Ve 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 publicar predicciones de un modelo entrenado existente.

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

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

Requisitos previos

En este contenido, se 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. Asegúrate 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. Usa GCP Console para generar una clave para la cuenta de servicio.

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

Informació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 Platform. Puedes alojar tus modelos entrenados en Cloud ML Engine para enviarles solicitudes de predicción y administrar tus modelos y trabajos con los servicios de GCP.

Acciones

predict

Realiza predicciones en los datos de la instancia especificada 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 Sí.
versión Es la versión de una solución de AA que se usará para las predicciones. String Ninguno Sí.
instancias Las instancias para las que se deben obtener predicciones. La forma de los elementos en este valor dependerá de las expectativas del modelo que uses para realizar la predicción. Para obtener más información, consulta Detalles de la solicitud de predicción. Array Ninguno Sí.

Respuesta

Un array predictions que incluye los datos de predicción que devuelve 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, luego, 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 Predeterminada Obligatorio
ID de proyecto Es el ID del proyecto de GCP que contiene los modelos entrenados que usa esta extensión. Ninguno Sí.
credenciales Cuando se ingresa en la consola de Apigee Edge, este es el contenido de tu archivo de claves de la cuenta de servicio. Cuando se envía a través de 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 Sí.