Extension Google Machine Learning Engine

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X.
En savoir plus

<ph type="x-smartling-placeholder">

Version 1.2.1

Demandez des prédictions à Cloud Machine Learning Engine. Via l'action predict, vous pouvez demander et diffuser des prédictions à partir d'un modèle entraîné existant.

Après avoir configuré cette extension avec votre ID de projet Google Cloud et vos identifiants, vous allez passer des appels à partir d'un proxy d'API à l'aide de la règle ExtensionCall. Dans la configuration des stratégies, vous spécifiez le modèle et la version de modèle à utiliser, ainsi que les données d'instance que le modèle doit utiliser pour la prédiction.

Pour commencer à utiliser Cloud ML Engine, consultez la page Présentation de Cloud ML Engine.

Prérequis

Ce contenu fournit des informations de référence pour configurer et utiliser cette extension. Avant d'utiliser l'extension à partir d'un proxy d'API à l'aide de la règle ExtensionCall, vous devez:

  1. Assurez-vous de disposer d'un modèle.

    Pour en savoir plus sur les modèles Cloud ML Engine et sur les autres concepts, consultez la page Projets, modèles, versions et tâches.

  2. Générez une clé pour le compte de service à l'aide de la console GCP.

  3. Utilisez le contenu du fichier JSON de clé obtenu lors de l'ajout et de la configuration de l'extension à l'aide de la documentation de référence de configuration.

À propos de Google Cloud Machine Learning Engine

Vous pouvez utiliser Cloud Machine Learning Engine pour entraîner des modèles de machine learning à l'aide des ressources de Google Cloud Platform. Vous pouvez héberger vos modèles entraînés sur Cloud ML Engine afin de leur envoyer des requêtes de prédiction, et gérer vos modèles et vos jobs à l'aide des services GCP.

Actions

<ph type="x-smartling-placeholder">

predict

Effectuer des prédictions sur les données d'instance spécifiées à l'aide du modèle spécifié.

Syntaxe

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

Exemple

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

Paramètres de requête

Paramètre Description Type Par défaut Obligatoire
modèle Modèle à utiliser pour les prédictions. Chaîne Aucun Oui.
version Version d'une solution de ML à utiliser pour les prédictions. Chaîne Aucun Oui.
instances Instances pour lesquelles obtenir des prédictions. La forme des éléments dans cette valeur dépendra des attentes du modèle que vous utilisez pour effectuer la prédiction. Pour en savoir plus, consultez la page Détails de la requête de prédiction. Tableau Aucun Oui.

Réponse

Un tableau predictions qui inclut les données de prédiction renvoyées par le modèle spécifié dans la configuration de la règle ExtensionAccroche.

{
  "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
      ]
    }
  ]
}

Documentation de référence sur la configuration

Procédez comme suit lorsque vous configurez et déployez cette extension afin de l'utiliser dans des proxys d'API. Pour savoir comment configurer une extension à l'aide de la console Apigee, consultez Ajouter et configurer une extension.

Propriétés courantes des extensions

Les propriétés suivantes sont présentes pour chaque extension.

Propriété Description Par défaut Obligatoire
name Nom que vous attribuez à cette configuration de l'extension. Aucune Oui
packageName Nom du package d'extension tel qu'indiqué par Apigee Edge. Aucune Oui
version Numéro de version du package d'extension à partir duquel vous configurez une extension. Aucune Oui
configuration Valeur de configuration spécifique à l'extension que vous ajoutez. Consultez Propriétés de ce package d'extension. Aucune Oui

Propriétés de ce package d'extension

Spécifiez des valeurs pour les propriétés de configuration suivantes, spécifiques à cette extension.

Propriété Description Par défaut Obligatoire
projectId ID du projet GCP contenant les modèles entraînés utilisés par cette extension. Aucun Oui.
credentials Lorsque vous le saisissez dans la console Apigee Edge, il s'agit du contenu de votre fichier de clé de compte de service. Lorsqu'elle est envoyée via l'API de gestion, il s'agit d'une valeur encodée en base64 générée à partir du fichier de clé du compte de service. Aucun Oui.