Google Machine Learning Engine-Erweiterung

Sie lesen gerade die Dokumentation zu Apigee Edge.
Apigee X-Dokumentation aufrufen.
info

Version 1.2.1

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, können Sie mit der ExtensionCallout-Richtlinie Aufrufe von einem API-Proxy aus starten. 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.

Weitere Informationen zu Cloud ML Engine

Vorbereitung

Dieser Inhalt 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. Schlüssel für das Dienstkonto mit der GCP Console generieren

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

Google Cloud Machine Learning Engine

Mit Cloud Machine Learning Engine können Sie Machine-Learning-Modelle mit den Ressourcen von Google Cloud Platform trainieren. Sie können Ihre trainierten Modelle in Cloud ML Engine hosten, um Vorhersageanfragen zu senden und Ihre Modelle und Jobs mit den GCP-Diensten zu verwalten.

Aktionen

predict

Vorhersagen für die angegebenen Instanzdaten mit dem angegebenen Modell treffen.

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 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.
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 zur Vorhersageanfrage. Array Keine. Ja.

Antwort

Ein predictions-Array mit Vorhersagedaten, die vom Modell zurückgegeben werden, das in der ExtensionCallout-Richtlinienkonfiguration 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

Verwenden Sie die folgenden Informationen, wenn Sie diese Erweiterung für die Verwendung in API-Proxys konfigurieren und bereitstellen. Eine Anleitung zum Konfigurieren einer Erweiterung über die Apigee-Konsole finden Sie unter Erweiterung hinzufügen und konfigurieren.

Allgemeine 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 diese in der Apigee Edge-Konsole eingeben, ist dies der Inhalt Ihrer Dienstkontoschlüsseldatei. Wenn er über die Management API gesendet wird, ist er ein base64-codierter Wert, der aus der Dienstkonto-Schlüsseldatei generiert wird. Keine. Ja.