Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Versione 1.2.1
Richiedi previsioni a Cloud Machine Learning Engine. Con l'azione predict
puoi richiedere e pubblicare previsioni da un modello addestrato esistente.
Dopo aver configurato questa estensione con le credenziali e l'ID del progetto Google Cloud, puoi effettuare chiamate da un proxy API utilizzando le norme di ExtensionsCallout. Nella configurazione dei criteri, devi specificare il modello e la versione da utilizzare, nonché i dati dell'istanza che il modello deve utilizzare per la previsione.
Per iniziare a utilizzare Cloud ML Engine, consulta Introduzione a Cloud ML Engine.
Prerequisiti
Questi contenuti forniscono riferimento per la configurazione e l'utilizzo di questa estensione. Prima di utilizzare l'estensione da un proxy API con le norme relative ai callout estensione, devi:
Assicurati di avere un modello.
Per ulteriori informazioni sui modelli di Cloud ML Engine e altri concetti, consulta Progetti, modelli, versioni e job.
Utilizza la console di Google Cloud per generare una chiave per l'account di servizio.
Utilizza i contenuti del file JSON della chiave risultante durante l'aggiunta e la configurazione dell'estensione utilizzando il riferimento di configurazione.
Informazioni su Google Cloud Machine Learning Engine
Puoi utilizzare Cloud Machine Learning Engine per addestrare 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 loro richieste di previsione e gestire i modelli e i job utilizzando i servizi Google Cloud.
Azioni
predict
Esegui previsioni sui dati dell'istanza specificata 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 richiesta
Parametro | Descrizione | Tipo | Predefinito | Obbligatorie |
---|---|---|---|---|
model | Il modello da utilizzare per le previsioni. | Stringa | Nessuna. | Sì. |
versione | La versione di una soluzione ML da utilizzare per le previsioni. | Stringa | Nessuna. | Sì. |
istanze | Le istanze per cui ottenere previsioni. La forma degli elementi in questo valore dipenderà dalle aspettative del modello che utilizzi per la previsione. Per ulteriori informazioni, consulta Prevedere i dettagli delle richieste. | Array | Nessuna. | Sì. |
Risposta
Un array predictions
che include i dati di previsione restituiti dal modello specificato nella configurazione dei criteri 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 per la configurazione
Utilizza quanto segue durante la configurazione e il deployment di questa estensione per l'utilizzo nei proxy API. Per i passaggi per configurare un'estensione utilizzando la console Apigee, consulta Aggiungere e configurare un'estensione.
Proprietà delle estensioni comuni
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 | Obbligatorie |
---|---|---|---|
projectId | ID del progetto Google Cloud contenente i modelli addestrati utilizzati da questa estensione. | Nessuna. | Sì. |
credenziali | Una volta inseriti nella console Apigee Edge, questi saranno i contenuti del file della chiave dell'account di servizio. Quando viene inviato tramite l'API di gestione, si tratta di un valore con codifica Base64 generato dal file della chiave dell'account di servizio. | Nessuna. | Sì. |