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:
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.
Usa GCP Console a fin de generar una clave para la cuenta de servicio.
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 | Sí |
packageName |
Nombre del paquete de extensiones proporcionado por Apigee Edge. | Ninguna | Sí |
version |
El número de versión del paquete de extensiones desde el que quieres configurar la extensión. | Ninguna | Sí |
configuration |
Es un valor de configuración específico para la extensión que agregas. Consulta Propiedades para este paquete de extensiones | Ninguna | Sí |
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í. |