Google Machine Learning Engine-Erweiterung

Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an.
info

Version 2.0.0

Vorhersagen von der Cloud Machine Learning Engine anfordern 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, führen Sie Aufrufe über einen API-Proxy mit der Richtlinie für Zusatzinformationen aus. In der Richtlinienkonfiguration geben Sie das zu verwendende Modell und die zu verwendende Modellversion sowie die Instanzdaten an, die das Modell für die Vorhersage verwenden soll.

Eine Einführung in Cloud ML Engine finden Sie unter Einführung in Cloud ML Engine.

Vorbereitung

Dieser Artikel enthält eine Referenz zum Konfigurieren und Verwenden dieser Erweiterung. Bevor Sie die Erweiterung über einen API-Proxy mit der ExtensionCallout-Richtlinie verwenden können, 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. Erstellen Sie mit der GCP Console einen Schlüssel für das Dienstkonto.

  3. Verwenden Sie den Inhalt der resultierenden JSON-Schlüsseldatei, wenn Sie die Erweiterung mithilfe der Konfigurationsreferenz hinzufügen und konfigurieren.

Google Cloud Machine Learning Engine

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

Aktionen

predict

Mit dem angegebenen Modell 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
Modell Das Modell, das für Vorhersagen verwendet werden soll. String Keine. Ja.
Version Die Version einer ML-Lösung, die für Vorhersagen verwendet werden soll. String Keine. Ja.
Instanzen Die Instanzen, für die Vorhersagen abgerufen werden sollen. Die Form der Elemente in diesem Wert hängt von den Erwartungen des Modells ab, das Sie für die Vorhersage verwenden. Weitere Informationen finden Sie unter Details der Anfrage vorhersagen. Array Keine. Ja.

Antwort

Ein predictions-Array mit Vorhersagedaten, die vom Modell zurückgegeben werden, das in der Richtlinienkonfiguration für „ExtensionCallout“ angegeben ist.

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

Beachten Sie Folgendes, wenn Sie diese Erweiterung für die Verwendung in API-Proxys konfigurieren und bereitstellen. Eine Anleitung zum Konfigurieren einer Erweiterung mit der Apigee Console finden Sie unter Erweiterung hinzufügen und konfigurieren.

Gängige 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

Properties für dieses Erweiterungspaket

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

Attribut Beschreibung Standard Erforderlich
projectId ID des GCP-Projekts, das die von dieser Erweiterung verwendeten trainierten Modelle enthält. Keine. Ja.
Anmeldedaten Wenn Sie diesen Wert in die Apigee Edge-Konsole eingeben, entspricht er dem Inhalt Ihrer Dienstkonto-Schlüsseldatei. Wenn er über die Verwaltungs-API gesendet wird, ist er ein Base64-codierter Wert, der aus der Dienstkonto-Schlüsseldatei generiert wird. Keine. Ja.