Расширение механизма машинного обучения Google

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

Версия 1.2.1

Запросите прогнозы у облачного механизма машинного обучения . С помощью действия 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>

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

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

Ответ

Массив 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 Значение конфигурации, относящееся к добавляемому расширению. См. Свойства этого пакета расширения. Никто Да

Свойства для этого пакета расширений

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

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