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 ed erogare previsioni da un modello addestrato esistente.

Dopo aver configurato questa estensione con l'ID e le credenziali del tuo progetto Google Cloud, effettui chiamate da un proxy API utilizzando il ExtensionCallout policy. Nella configurazione delle norme, specifica 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 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:

  1. Assicurati di avere un modello.

    Per saperne di più sui modelli Cloud ML Engine e su altri concetti, consulta Progetti, modelli, versioni e job.

  2. Utilizza la console Google Cloud per generare una chiave per il service account.

  3. 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 modelli di machine learning utilizzando le risorse di 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 GCP.

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 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 utilizzi per la previsione. Per saperne di più, vedi 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 di callout di estensione.

{
  "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 l'utilizzo nei proxy API. Per i passaggi per configurare un'estensione utilizzando la console Apigee, vedi 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 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, questo è il contenuto del file della chiave dell'account di servizio. Se inviato tramite l'API Management, è un valore con codifica Base64 generato dal file della chiave del service account. Nessuno. Sì.