Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. info
Versione 2.0.0
Richiedi le previsioni da Cloud Machine Learning Engine. Tramite l'azione predict
, puoi richiedere e pubblicare le previsioni di un modello addestrato esistente.
Dopo aver configurato questa estensione con le credenziali e l'ID progetto Google Cloud, puoi effettuare chiamate da un proxy API utilizzando il criterio ExtensionCallout. Nella configurazione delle norme, specifichi il modello e la versione del modello da utilizzare, nonché i dati delle istanze che vuoi che il modello utilizzi per la previsione.
Per iniziare a utilizzare Cloud ML Engine, consulta Introduzione a Cloud ML Engine.
Prerequisiti
Questi contenuti forniscono un riferimento per la configurazione e l'utilizzo di questa estensione. Prima di utilizzare l'estensione da un proxy API utilizzando il criterio ExtensionCallout, devi:
Assicurati di avere un modello.
Per saperne di più sui modelli di Cloud ML Engine e su altri concetti, consulta Progetti, modelli, versioni e job.
Utilizza la console Google Cloud per generare una chiave per l'account di servizio.
Utilizza i contenuti del file JSON della chiave risultante quando aggiungi e configuri l'estensione utilizzando il riferimento alla configurazione.
Informazioni su Google Cloud Machine Learning Engine
Puoi utilizzare Cloud Machine Learning Engine per addestrare i modelli di machine learning utilizzando le risorse della piattaforma Google Cloud. Puoi ospitare i modelli addestrati su Cloud ML Engine in modo da poter inviare richieste di previsione e gestire i modelli e i job utilizzando i servizi Google Cloud.
Azioni
predict
Esegui le previsioni sui dati dell'istanza specificati utilizzando il modello specificato.
Sintassi
<Action>predict</Action>
<Input><![CDATA[{
"model" : model-for-prediction,
"version" : model-version,
"instances" : data-to-use-for-making-prediction
}]]></Input>
Esempio
<Action>predict</Action>
<Input><![CDATA[{
"model" : mymodel,
"version" : version4,
"instances" : {"instances": ["the quick brown fox", "la bruja le dio"]}
}]]></Input>
Parametri di richiesta
Parametro | Descrizione | Tipo | Predefinito | Obbligatorio |
---|---|---|---|---|
modello | Il modello da utilizzare per le previsioni. | Stringa | Nessuno. | Sì. |
versione | La versione di una soluzione di ML da utilizzare per le previsioni. | Stringa | Nessuno. | Sì. |
istanze | Le istanze per le quali ottenere le previsioni. La forma degli elementi in questo valore dipende dalle aspettative del modello utilizzato per la previsione. Per saperne di più, consulta Prevedere i dettagli della richiesta. | Array | Nessuno. | Sì. |
Risposta
Un array predictions
che include i dati di previsione restituiti dal modello specificato nella configurazione del criterio 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
]
}
]
}
Riferimento alla configurazione
Utilizza quanto segue quando configuri ed esegui il deployment di questa estensione per utilizzarla nei proxy API. Per la procedura di configurazione di un'estensione utilizzando la console Apigee, vedi Aggiunta e configurazione di un'estensione.
Proprietà comuni delle estensioni
Per ogni estensione sono presenti le seguenti proprietà.
Proprietà | Descrizione | Predefinito | Obbligatorio |
---|---|---|---|
name |
Il nome che assegni a questa configurazione dell'estensione. | Nessuno | Sì |
packageName |
Nome del pacchetto dell'estensione fornito da Apigee Edge. | Nessuno | Sì |
version |
Numero di versione del pacchetto dell'estensione da cui stai configurando un'estensione. | Nessuno | Sì |
configuration |
Valore di configurazione specifico per l'estensione che stai aggiungendo. Vedi Proprietà per questo pacchetto di estensioni | Nessuno | Sì |
Proprietà per questo pacchetto di estensioni
Specifica i valori per le seguenti proprietà di configurazione specifiche di questa estensione.
Proprietà | Descrizione | Predefinito | Obbligatorio |
---|---|---|---|
ID progetto | ID del progetto Google Cloud contenente i modelli addestrati utilizzati da questa estensione. | Nessuno. | Sì. |
credenziali | Se inserito nella console Apigee Edge, si tratta dei contenuti del file della chiave dell'account di servizio. Se inviato tramite l'API di gestione, è un valore codificato in base64 generato dal file della chiave dell'account di servizio. | Nessuno. | Sì. |