Google Machine Learning Engine-Erweiterung

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation
weitere Informationen

Version 1.2.1

Fordern Sie Vorhersagen von Cloud Machine Learning Engine an. Mit der Aktion predict können Sie Vorhersagen von einem vorhandenen trainierten Modell anfordern und bereitstellen.

Nachdem Sie diese Erweiterung mit Ihrer Google Cloud-Projekt-ID und Ihren Anmeldedaten konfiguriert haben, tätigen Sie mithilfe der ExtensionCallout-Richtlinie Aufrufe von einem API-Proxy. In der Richtlinienkonfiguration geben Sie das zu verwendende Modell und die Modellversion sowie die Instanzdaten an, die das Modell für die Vorhersage verwenden soll.

Informationen zum Einstieg in Cloud ML Engine finden Sie unter Einführung in Cloud ML Engine.

Voraussetzungen

In diesem Artikel erfahren Sie, wie Sie diese Erweiterung konfigurieren und verwenden. Bevor Sie die Erweiterung mithilfe der ExtensionCallout-Richtlinie von einem API-Proxy verwenden, müssen Sie Folgendes tun:

  1. Sie benötigen ein Modell.

    Weitere Informationen zu Cloud ML Engine-Modellen und anderen Konzepten finden Sie unter Projekte, Modelle, Versionen und Jobs.

  2. Verwenden Sie die GCP Console, um einen Schlüssel für das Dienstkonto zu generieren.

  3. Verwenden Sie den Inhalt der resultierenden JSON-Schlüssel-JSON-Datei beim Hinzufügen und Konfigurieren der Erweiterung mithilfe der Konfigurationsreferenz.

Google Cloud Machine Learning Engine

Sie können Cloud Machine Learning Engine verwenden, um Modelle für maschinelles Lernen mit den Ressourcen der Google Cloud Platform zu trainieren. Sie können Ihre trainierten Modelle in Cloud ML Engine hosten, um ihnen Vorhersageanfragen zu senden und Ihre Modelle und Jobs mithilfe der GCP-Dienste zu verwalten.

Aktionen

predict

Sie können mithilfe des angegebenen Modells Vorhersagen für die angegebenen Instanzdaten erstellen.

Syntax

<Action>predict</Action>
<Input><![CDATA[{
  "model" : model-for-prediction,
  "version" : model-version,
  "instances" : data-to-use-for-making-prediction
}]]></Input>

Beispiel

<Action>predict</Action>
<Input><![CDATA[{
  "model" : mymodel,
  "version" : version4,
  "instances" : {"instances": ["the quick brown fox", "la bruja le dio"]}
}]]></Input>

Anfrageparameter

Parameter Beschreibung Typ Standard Erforderlich
model Das für Vorhersagen zu verwendende Modell. String Keine. Ja.
Version Die Version einer ML-Lösung, die für Vorhersagen verwendet werden soll. String Keine. Ja.
instances Die Instanzen, für die Vorhersagen abgerufen werden sollen. Die Form der Elemente in diesem Wert hängt von den Erwartungen an das Modell ab, das Sie für die Vorhersage verwenden. Weitere Informationen finden Sie unter Details zu Vorhersageanfragen. Array Keine. Ja.

Antwort

Ein predictions-Array, das Vorhersagedaten enthält, die von dem in der ExtensionCallout-Richtlinienkonfiguration angegebenen Modell zurückgegeben werden.

{
  "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
      ]
    }
  ]
}

Konfigurationsreferenz

Verwenden Sie Folgendes, wenn Sie diese Erweiterung zur Verwendung in API-Proxys konfigurieren und bereitstellen. Eine Anleitung zum Konfigurieren einer Erweiterung mit der Apigee-Konsole finden Sie unter Erweiterung hinzufügen und konfigurieren.

Häufige Erweiterungseigenschaften

Für jede Erweiterung sind die folgenden Eigenschaften vorhanden.

Attribut Beschreibung Standard Erforderlich
name Der Name, den Sie dieser Konfiguration der Erweiterung zuweisen. Ja
packageName Name des Erweiterungspakets, wie von Apigee Edge angegeben. Ja
version Versionsnummer für das Erweiterungspaket, von dem Sie eine Erweiterung konfigurieren. Ja
configuration Konfigurationswert speziell für die Erweiterung, die Sie hinzufügen. Weitere Informationen finden Sie unter Eigenschaften für dieses Erweiterungspaket. Ja

Eigenschaften dieses Erweiterungspakets

Geben Sie Werte für die folgenden Konfigurationseigenschaften an, die spezifisch für diese Erweiterung sind.

Property Beschreibung Standard Erforderlich
projectId ID des GCP-Projekts, das die von dieser Erweiterung verwendeten trainierten Modelle enthält. Keine. Ja.
Anmeldedaten Bei Eingabe in die Apigee Edge-Konsole ist dies der Inhalt Ihrer Dienstkonto-Schlüsseldatei. Wenn er über die Verwaltungs-API gesendet wird, ist er ein base64-codierter Wert, der aus der Schlüsseldatei des Dienstkontos generiert wird. Keine. Ja.