Estensione di Google Machine Learning Engine

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X.
Informazioni

Versione 1.2.1

Richiedi previsioni a 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 di Google Cloud, potrai effettuare chiamate da un proxy API utilizzando il criterio ExtensionCallout. Nella configurazione dei criteri, specifichi 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 un riferimento per la configurazione e l'utilizzo di questa estensione. Prima di utilizzare l'estensione da un proxy API utilizzando le norme ExtensionCallout, devi:

  1. Assicurati di avere un modello.

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

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

  3. Utilizza i contenuti del file JSON chiave risultante quando aggiungi e configuri l'estensione mediante 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 tuoi modelli e 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 ML da utilizzare per le previsioni. Stringa Nessuno. Sì.
istanze Le istanze per le quali ottenere previsioni. La forma degli elementi in questo valore dipenderà dalle aspettative del modello che stai utilizzando per la previsione. Per ulteriori informazioni, consulta la sezione Prevedere i dettagli delle richieste. 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 alla configurazione

Quando configuri questa estensione e ne esegui il deployment da usare nei proxy API, usa quanto segue. Per la procedura di configurazione di un'estensione utilizzando la console Apigee, vedi Aggiungere e configurare 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
packageName Nome del pacchetto dell'estensione fornito da Apigee Edge. Nessuno
version Numero di versione del pacchetto dell'estensione da cui stai configurando un'estensione. Nessuno
configuration Valore di configurazione specifico per l'estensione che stai aggiungendo. Vedi Proprietà per questo pacchetto di estensioni Nessuno

Proprietà per questo pacchetto di estensioni

Specifica i valori per le seguenti proprietà di configurazione specifiche per 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, questi sono i contenuti del file delle chiavi dell'account di servizio. Se inviato tramite l'API di gestione, si tratta di un valore codificato in base64 generato dal file delle chiavi dell'account di servizio. Nessuno. Sì.