Estensione di Google Machine Learning Engine

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X.
info

Versione 1.2.1

Richiedi previsioni da Cloud Machine Learning Engine. Tramite l'azione predict, puoi richiedere e pubblicare previsioni da un modello addestrato esistente.

Dopo aver configurato questa estensione con l'ID progetto e le credenziali del tuo progetto Google Cloud, puoi effettuare chiamate da un proxy API utilizzando il criterio ExtensionCallout. Nella configurazione dei criteri, devi specificare il modello e la versione del modello da utilizzare, nonché i dati dell'istanza che vuoi che il modello utilizzi per la previsione.

Per iniziare a utilizzare Cloud ML Engine, consulta la pagina Introduzione a Cloud ML Engine.

Prerequisiti

Questo contenuto fornisce 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:

  1. Assicurarti di avere un modello.

    Per ulteriori informazioni sui modelli di Cloud ML Engine e su altri concetti, consulta la pagina Progetti, modelli, versioni e job.

  2. Utilizzare la console Google Cloud per generare una chiave per l'account di servizio.

  3. Utilizzare i contenuti del file JSON della chiave risultante quando aggiungi e configuri l'estensione utilizzando il riferimento di configurazione.

Informazioni su Google Cloud Machine Learning Engine

Puoi utilizzare Cloud Machine Learning Engine per addestrare i modelli di machine learning utilizzando le risorse di Google Cloud Platform. 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 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 cui ottenere le previsioni. La forma degli elementi in questo valore dipende dalle aspettative del modello che stai utilizzando per la previsione. Per ulteriori informazioni, consulta la sezione Dettagli della richiesta di previsione. Array Nessuno. 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 quando configuri ed esegui il deployment di questa estensione per l'utilizzo nei proxy API. Per la procedura di configurazione di un'estensione utilizzando la console Apigee, consulta la pagina Aggiungere e configurare un'estensione.

Proprietà comuni delle estensioni

The following properties are present for every extension.

Property Description Default Required
name Name you're giving this configuration of the extension. None Yes
packageName Name of the extension package as given by Apigee Edge. None Yes
version Version number for the extension package from which you're configuring an extension. None Yes
configuration Configuration value specific to the extension you're adding. See Properties for this extension package None Yes

Proprietà per questo pacchetto di estensioni

Specifica i valori per le seguenti proprietà di configurazione specifiche per questa estensione.

Proprietà Descrizione Predefinito Obbligatorio
projectId L'ID del progetto Google Cloud contenente i modelli addestrati utilizzati da questa estensione. Nessuno. Sì.
credenziali Se inserito nella console Apigee Edge, questo è il contenuto del file della chiave del service account . Se inviato tramite l'API di gestione, è un valore con codifica Base64 generato dal file della chiave del service account. Nessuno. Sì.