Rozszerzenie Google Machine Learning Engine

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X.
informacje.

Wersja 1.0.0

Wysyłanie żądań prognoz do Cloud Machine Learning Engine. Działanie predict umożliwia wysyłanie żądań prognoz do już wytrenowanego modelu i ich udostępnianie.

Po skonfigurowaniu tego rozszerzenia przy użyciu identyfikatora projektu Google Cloud i danych logowania możesz wykonywać wywołania z serwera proxy interfejsu API przy użyciu zasady ExtensionCallout. W konfiguracji zasad określasz model i wersję modelu do użycia, a także dane instancji, których model ma używać do prognozowania.

Aby zacząć korzystać z Cloud ML Engine, zapoznaj się z wprowadzeniem do Cloud ML Engine.

Wymagania wstępne

W tym artykule znajdziesz informacje na temat konfigurowania i używania tego rozszerzenia. Zanim użyjesz rozszerzenia z serwera proxy interfejsu API przy użyciu zasady ExtensionCallout, musisz:

  1. Upewnij się, że masz model.

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

  2. Wygeneruj klucz dla konta usługi za pomocą konsoli GCP.

  3. Użyj zawartości wynikowego pliku JSON klucza podczas dodawania i konfigurowania rozszerzenia w dokumentacji konfiguracji.

Informacje o Google Cloud Machine Learning Engine

Możesz użyć Cloud Machine Learning Engine do trenowania modeli systemów uczących się z wykorzystaniem 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

prognozuj

Wykonuj prognozy na określonych danych 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ślny Wymagane
model Model używany na potrzeby prognoz. Ciąg znaków Brak. Tak.
wersja Wersja rozwiązania ML, która ma być używana 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, którego używasz do prognozowania. Więcej informacji znajdziesz w artykule Prognozowanie szczegółów prośby. Tablica Brak. Tak.

Odpowiedź

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

Odniesienie do konfiguracji

Podczas konfigurowania i wdrażania tego rozszerzenia na potrzeby serwerów proxy interfejsu API użyj poniższych wskazówek. Instrukcje konfigurowania rozszerzenia za pomocą 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ń

Określ wartości następujących właściwości konfiguracji specyficznych 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 Jeśli wpiszesz ją w konsoli Apigee Edge, zobaczysz zawartość pliku klucza konta usługi. W przypadku wysyłania przez interfejs API zarządzania jest to wartość zakodowana w formacie base64 generowana na podstawie pliku klucza konta usługi. Brak. Tak.