Расширение "Система машинного обучения Google"

Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X.
Информация

Версия 1.2.1

Запрашивать прогнозы у Cloud Machine Learning Engine. С помощью действия predict можно запрашивать и показывать прогнозы на основе существующей обученной модели.

После того как вы настроите это расширение, указав идентификатор проекта и учетные данные облачного проекта Google Cloud, вы сможете выполнять вызовы из прокси-сервера API с помощью правила ExtensionCallout. В конфигурации правил вы указываете модель и ее версию, а также данные экземпляра, которые модель должна использовать для прогнозирования.

Чтобы начать работу с Cloud ML Engine, ознакомьтесь с обзором Cloud ML Engine.

Требования

В нем приведена информация о том, как настроить и использовать это расширение. Прежде чем использовать расширение из прокси-сервера API с помощью правила ExtensionCallout, необходимо:

  1. Убедитесь, что у вас есть модель.

    Подробнее о моделях Cloud ML Engine и других понятиях рассказывается в статье Проекты, модели, версии и задания.

  2. Как создать ключ для сервисного аккаунта с помощью консоли GCP

  3. Используйте содержимое полученного JSON-файла ключа при добавлении и настройке расширения, следуя инструкциям по настройке.

О Google Cloud Machine Learning Engine

Вы можете использовать Cloud Machine Learning Engine для обучения моделей машинного обучения с помощью ресурсов Google Cloud Platform. Вы можете разместить обученные модели в Cloud ML Engine, чтобы отправлять им запросы на прогнозирование и управлять моделями и заданиями с помощью сервисов GCP.

Действия

прогнозировать;

Выполняет прогнозирование на основе указанных данных экземпляра с помощью указанной модели.

Синтаксис

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

Пример

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

Параметры запроса

Параметр Описание Тип По умолчанию Обязательно
модель Модель, которая будет использоваться для прогнозов. Строка Нет. Да.
version Версия решения на основе машинного обучения, которая будет использоваться для прогнозов. Строка Нет. Да.
экз. Экземпляры, для которых нужно получить прогнозы. Форма объектов в этом значении будет зависеть от ожиданий модели, которую вы используете для прогнозирования. Подробнее о прогнозировании запросов… Массив Нет. Да.

Ответ

Массив predictions, содержащий данные прогноза, возвращенные моделью, указанной в конфигурации правила 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
      ]
    }
  ]
}

Справочник по конфигурации

При настройке и развертывании этого расширения для использования в прокси API следуйте приведенным ниже инструкциям. Инструкции по настройке расширения с помощью консоли Apigee приведены в разделе Добавление и настройка расширения.

Общие свойства расширений

Следующие свойства присутствуют для каждого расширения.

Свойство Описание По умолчанию Необходимый
name Имя, которое вы даете этой конфигурации расширения. Никто Да
packageName Имя пакета расширения, предоставленное Apigee Edge. Никто Да
version Номер версии пакета расширения, из которого вы настраиваете расширение. Никто Да
configuration Значение конфигурации, относящееся к добавляемому расширению. См. Свойства этого пакета расширения. Никто Да

Свойства пакета расширения

Укажите значения для следующих свойств конфигурации, относящихся к этому расширению.

Свойство Описание По умолчанию Обязательно
Идентификатор проекта Идентификатор проекта GCP, содержащего обученные модели, которые используются этим расширением. Нет. Да.
учетные данные При вводе в консоли Apigee Edge это содержимое файла ключа сервисного аккаунта. При отправке через Management API это значение в кодировке base64, сгенерированное на основе файла ключа сервисного аккаунта. Нет. Да.