Rozszerzenie Google Machine Learning Engine

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X.
Informacje

Wersja 1.2.1

Wysyłaj żądania prognoz z Cloud Machine Learning Engine. Za pomocą działania predict możesz wysyłać żądania i wyświetlać prognozy generowane na podstawie już wytrenowanego modelu.

Po skonfigurowaniu tego rozszerzenia za pomocą identyfikatora projektu Google Cloud i danych logowania możesz wywoływać serwer proxy interfejsu API, korzystając z zasady ExtensionCallout. W konfiguracji zasad określasz model i wersję modelu, których chcesz używać, a także dane instancji, które model ma używać do prognozowania.

Aby rozpocząć korzystanie z Cloud ML Engine, zobacz Wprowadzenie do Cloud ML Engine.

Wymagania wstępne

Ta treść zawiera informacje na temat konfigurowania tego rozszerzenia i korzystania z niego. Zanim użyjesz zasady ExtensionCallout, musisz użyć rozszerzenia z serwera proxy interfejsu API:

  1. Sprawdź, czy masz model.

    Więcej informacji o modelach Cloud ML Engine i innych koncepcjach znajdziesz w artykule Projekty, modele, wersje i zadania.

  2. Wygeneruj klucz konta usługi w konsoli GCP.

  3. Podczas dodawania i konfigurowania rozszerzenia przy użyciu dokumentu dotyczącego konfiguracji użyj zawartości powstałego klucza pliku JSON.

Informacje o Google Cloud Machine Learning Engine

Za pomocą Cloud Machine Learning Engine możesz trenować modele systemów uczących się przy użyciu zasobów Google Cloud Platform. Możesz hostować wytrenowane modele w Cloud ML Engine, aby wysyłać do nich żądania prognoz oraz zarządzać modelami i zadaniami przy użyciu usług GCP.

Działania

predict

Prognozowanie danych określonej instancji przy użyciu określonego modelu.

Składnia

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

Przykład

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

Parametry żądania

Parametr Opis Typ Domyślne Wymagane
model Model używany do prognozowania. Ciąg znaków Brak. Tak.
Wersja Wersja rozwiązania ML używanego na potrzeby prognoz. Ciąg znaków Brak. Tak.
instancje Instancje, dla których mają być pobierane prognozy. Kształt elementów w tej wartości zależy od oczekiwań modelu używanego do prognozowania. Więcej informacji znajdziesz w sekcji Szczegóły żądania prognozy. Tablica Brak. Tak.

Odpowiedź

Tablica predictions zawierająca dane prognostyczne zwrócone przez model określony w konfiguracji zasady 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
      ]
    }
  ]
}

Dokumentacja konfiguracji

Skorzystaj z podanych niżej instrukcji podczas konfigurowania i wdrażania tego rozszerzenia na potrzeby serwerów proxy interfejsów API. Instrukcje konfigurowania rozszerzenia w konsoli Apigee znajdziesz w artykule Dodawanie i konfigurowanie rozszerzenia.

Typowe właściwości rozszerzeń

Dla każdego rozszerzenia dostępne są poniższe właściwości.

Usługa Opis Domyślnie Wymagany
name Nazwa nadana konfiguracji rozszerzenia. Brak Tak
packageName Nazwa pakietu rozszerzeń podana przez Apigee Edge. Brak Tak
version Numer wersji pakietu rozszerzenia, z którego konfigurujesz rozszerzenie. Brak Tak
configuration Wartość konfiguracji specyficzna dla dodawanego rozszerzenia. Zobacz Właściwości tego pakietu rozszerzeń Brak Tak

Właściwości tego pakietu rozszerzeń

Podaj wartości następujących właściwości konfiguracji specyficznych dla tego rozszerzenia.

Właściwość Opis Domyślne Wymagane
projectId Identyfikator projektu GCP zawierającego wytrenowane modele używane przez to rozszerzenie. Brak. Tak.
dane logowania Wpisana w konsoli Apigee Edge jest to zawartość pliku klucza konta usługi. Gdy jest wysyłana przez interfejs API zarządzania, jest to wartość zakodowana w formacie base64 wygenerowana z pliku klucza konta usługi. Brak. Tak.