Extensión de Google Machine Learning Engine

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

Después de configurar esta extensión con el ID y las credenciales de tu proyecto de Google Cloud, realiza llamadas desde un proxy de API con la política ExtensionExtension. 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

En este contenido, se proporciona referencia para configurar y usar esta extensión. Antes de utilizar la extensión desde un proxy de API con la política ExtensionReference, 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. Usar 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 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 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

Realizar 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 Predeterminada 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 predecir. Para obtener más información, consulta Detalles de solicitudes de predicción. Arreglo Ninguno Sí.

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 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 de extensión comunes

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
ID de proyecto 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 su archivo de claves de 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. Ninguno Sí.