Rozszerzenie Google Machine Learning Engine

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

Wersja 1.2.1

Wysyłaj prośby o prognozy do Cloud Machine Learning Engine. Za pomocą działania predict możesz wysyłać żądania prognoz z istniejącego wytrenowanego modelu i je obsługiwać.

Po skonfigurowaniu tego rozszerzenia za pomocą identyfikatora projektu Google Cloud i danych logowania możesz wywoływać je z poziomu serwera proxy interfejsu API za pomocą zasady ExtensionCallout. W konfiguracji zasad określasz model i jego wersję, które mają być używane, a także dane instancji, które model ma wykorzystywać do prognozowania.

Aby rozpocząć korzystanie z Cloud ML Engine, zapoznaj się z wprowadzeniem do Cloud ML Engine.

Wymagania wstępne

Te treści zawierają informacje o konfigurowaniu i używaniu tego rozszerzenia. Zanim zaczniesz korzystać z rozszerzenia w ramach serwera proxy interfejsu API za pomocą zasady ExtensionCallout, musisz:

  1. Sprawdź, czy masz model.

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

  2. Wygeneruj klucz konta usługi w konsoli GCP

  3. Podczas dodawania i konfigurowania rozszerzenia za pomocą dokumentacji konfiguracji użyj zawartości utworzonego pliku JSON z kluczem.

Informacje o Cloud Machine Learning Engine

Za pomocą Cloud Machine Learning Engine możesz trenować modele uczenia maszynowego, korzystając z zasobów Google Cloud Platform. Wytrenowane modele możesz hostować w Cloud ML Engine, aby wysyłać do nich żądania prognozowania oraz zarządzać modelami i zadaniami za pomocą usług GCP.

Działania

przewidywać,

Przeprowadź prognozowanie na określonych danych instancji za pomocą 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ślny Wymagane
model model, który ma być używany do prognozowania. Ciąg znaków Brak. Tak.
wersja Wersja rozwiązania ML, która ma być używana do prognozowania. Ciąg znaków Brak. Tak.
instancje Instancje, dla których chcesz uzyskać prognozy. Kształt elementów w tej wartości będzie zależeć od oczekiwań modelu, którego używasz do prognozowania. Więcej informacji znajdziesz w artykule Szczegóły prognozowania żądań. Tablica Brak. Tak.

Odpowiedź

predictions Tablica zawierająca dane prognozy 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
      ]
    }
  ]
}

Odwołanie do konfiguracji

Podczas konfigurowania i wdrażania tego rozszerzenia do użycia w proxy interfejsów API postępuj zgodnie z tymi instrukcjami. Instrukcje konfigurowania rozszerzenia za pomocą konsoli Apigee znajdziesz w artykule Dodawanie i konfigurowanie rozszerzenia.

Wspólne 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ń

Określ wartości tych właściwości konfiguracji, które są specyficzne dla tego rozszerzenia.

Właściwość Opis Domyślny Wymagane
Identyfikator projektu Identyfikator projektu GCP zawierającego wytrenowane modele używane przez to rozszerzenie. Brak. Tak.
dane logowania Po wpisaniu w konsoli Apigee Edge jest to zawartość pliku klucza konta usługi. Gdy jest wysyłany za pomocą interfejsu Management API, jest to wartość zakodowana w formacie base64 wygenerowana z pliku klucza konta usługi. Brak. Tak.