Extensión de Google Machine Learning Engine

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

Versión 1.2.1

Solicita predicciones de Cloud Machine Learning Engine. Mediante la acción predict, puedes solicitar y entregar predicciones a partir de un modelo entrenado existente.

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

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

Requisitos previos

En este contenido, se proporciona referencia para configurar y usar la extensión. Antes de utilizar la extensión desde un proxy de API con la política ExtensionExtension, 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 a fin de generar una clave para la cuenta de servicio.

  3. Usa el contenido del archivo JSON de claves resultante cuando agregues y configures la extensión mediante 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 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 especificados con el modelo indicado.

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 Predeterminada Obligatorias
model El modelo que se usará para las predicciones. Cadena Ningún contenido de este tipo Sí.
version Es la versión de una solución de AA que se usará en las predicciones. Cadena Ningún contenido de este tipo Sí.
instancias Las instancias para las que se obtienen 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 Ningún contenido de este tipo Sí.

Respuesta

Un array predictions que incluye datos de predicción que muestra el modelo especificado en la configuración de la política ExtensionExtension.

{
  "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 la siguiente información cuando configures e implementes esta extensión para usarla en proxies de API. Si quieres conocer los pasos para configurar una extensión con la consola de Apigee, consulta Agrega y configura una extensión.

Propiedades comunes de las extensiones

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 Obligatorias
projectId ID del proyecto de GCP que contiene los modelos entrenados que usa esta extensión. Ningún contenido de este tipo 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 Management, es un valor codificado en base64 que se genera a partir del archivo de claves de la cuenta de servicio. Ningún contenido de este tipo Sí.