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

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

Версия 1.0.0

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

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

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

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