Vous consultez la documentation Apigee Edge.
Accédez à la
documentation**Apigee X**. info
Version 1.0.0
Demandez des prédictions à Cloud Machine Learning Engine. Grâce à 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 l'ID du projet et les identifiants de votre projet Google Cloud, vous effectuez des appels à partir d'un proxy d'API à l'aide de la règle ExtensionCallout. Dans la configuration de votre règle, vous spécifiez le modèle et la version du modèle à utiliser, ainsi que les données d'instance que vous souhaitez que le modèle utilise pour la prédiction.
Pour commencer à utiliser Cloud ML Engine, consultez 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 ExtensionCallout, vous devez effectuer les opérations suivantes :
Assurez-vous d'avoir un modèle.
Pour en savoir plus sur les modèles Cloud ML Engine et d'autres concepts, consultez Projets, modèles, versions et tâches.
Utilisez la console GCP pour générer une clé pour le compte de service.
Utilisez le contenu du fichier JSON de clé obtenu lorsque vous ajoutez et configurez l'extension à l'aide de la documentation de référence sur la 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 de gérer vos modèles et vos tâches à l'aide des services GCP.
Actions
predict
Effectuez 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 | Valeur par défaut | Obligatoire |
|---|---|---|---|---|
| modèle | Modèle à utiliser pour les prédictions. | Chaîne | Aucune. | Oui. |
| version | Version d'une solution de ML à utiliser pour les prédictions. | Chaîne | Aucune. | Oui. |
| instances | Instances pour lesquelles obtenir des prédictions. La forme des éléments de cette valeur dépendra des attentes du modèle que vous utilisez pour la prédiction. Pour en savoir plus, consultez Détails de la requête de prédiction. | Tableau | Aucune. | Oui. |
Réponse
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 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
]
}
]
}
Documentation de référence sur la configuration
Utilisez les informations suivantes lorsque vous configurez et déployez cette extension pour 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 d'extension courantes
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 propres à cette extension.
| Propriété | Description | Valeur par défaut | Obligatoire |
|---|---|---|---|
| projectId | ID du projet GCP contenant les modèles entraînés utilisés par cette extension. | Aucune. | Oui. |
| identifiants | Lorsqu'ils sont saisis dans la console Apigee Edge, il s'agit du contenu de votre fichier de clé de compte de service. Lorsqu'ils sont envoyés via l'API de gestion, il s'agit d'une valeur encodée en base64 générée à partir du fichier de clé de compte de service. | Aucune. | Oui. |