Service Configuration - Update

Ссылка

Служба:: Cognitive Services - Personalizer

Версия API:: v1.1-preview.1

Обновление конфигурации службы.
Обновите конфигурацию службы Персонализатора.

PUT {Endpoint}/personalizer/v1.1-preview.1/configurations/service

Параметры URI

Имя	В	Обязательно	Тип	Описание
Endpoint	path	True	string	Поддерживаемая конечная точка Cognitive Services.

Текст запроса

Имя	Обязательно	Тип	Описание
defaultReward	True	number	Вознаграждение, полученное, если вознаграждение не получено в течение указанного времени ожидания.
explorationPercentage	True	number	Процент ответов ранга, которые будут использовать исследование.
logRetentionDays	True	integer	Количество дней, в течение которых должны храниться журналы. -1 означает, что журналы никогда не будут удалены.
modelExportFrequency	True	string	Персонализатор будет автоматически использовать самую обновленную обученную модель для онлайн-ранжирований каждый указанный период времени. Например, PT5M (5 мин). Сведения о формате времени см. в разделе http://en.wikipedia.org/wiki/ISO_8601#Durations
rewardAggregation	True	string	Функция, используемая для обработки вознаграждений, если до окончания rewardWaitTime получено несколько оценок вознаграждения.
rewardWaitTime	True	string	Период ожидания запроса будет отмечен наградой по умолчанию и должен составлять от 5 секунд до 2 дней. Например, PT5M (5 мин). Сведения о формате времени см. в разделе http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationFrequency		string	Частота автоматической оптимизации. Применимо только в том случае, если isAutoOptimizationEnabled имеет значение true. Например, PT5M (5 мин). Сведения о формате времени \r\nсм. в разделе http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate		string	Дата выполнения первой автоматической оценки оптимизации. Применимо только в том случае, если isAutoOptimizationEnabled имеет значение true.
isAutoOptimizationEnabled		boolean	Флаг, указывающий, будет ли Персонализатор автоматически оптимизировать параметры обучения, периодически запуская автономные оценки.
lastConfigurationEditDate		string	Время последнего обновления конфигурации обучения модели
learningMode		LearningMode	Режимы обучения для Персонализатора
logMirrorEnabled		boolean	Флаг указывает, включено ли зеркальное отображение журналов.
logMirrorSasUri		string	URI SAS контейнера учетной записи хранения Azure для зеркального отображения журналов.

Ответы

Имя	Тип	Описание
200 OK	ServiceConfiguration	Успешное завершение
Other Status Codes	ErrorResponse	Обновление defaultReward, rewardWaitTime и rewardAggregation при изменении режима обучения с "в сети" на режим ученика и наоборот не допускается. Измените режим, а затем измените дополнительные параметры с помощью дополнительного вызова API.

Примеры

Successful ServiceConfiguration_Update request

Образец запроса

HTTP

PUT {Endpoint}/personalizer/v1.1-preview.1/configurations/service

{
  "rewardWaitTime": "PT10M",
  "defaultReward": 0,
  "rewardAggregation": "earliest",
  "explorationPercentage": 0.2,
  "modelExportFrequency": "PT5M",
  "logMirrorEnabled": true,
  "logMirrorSasUri": "https://testblob.blob.core.windows.net/container?se=2020-08-13T00%3A00Z&sp=rwl&spr=https&sv=2018-11-09&sr=c&sig=signature",
  "logRetentionDays": 7,
  "lastConfigurationEditDate": "0001-01-01T00:00:00Z",
  "learningMode": "Online",
  "isAutoOptimizationEnabled": true,
  "autoOptimizationFrequency": "P7D",
  "autoOptimizationStartDate": "2019-01-19T00:00:00Z"
}

Пример ответа

Код состояния:: 200

{
  "rewardWaitTime": "PT10M",
  "defaultReward": 0,
  "rewardAggregation": "earliest",
  "explorationPercentage": 0.2,
  "modelExportFrequency": "PT5M",
  "logMirrorEnabled": true,
  "logMirrorSasUri": "https://testblob.blob.core.windows.net/container?se=2020-08-13T00%3A00Z&sp=rwl&spr=https&sv=2018-11-09&sr=c&sig=signature",
  "logRetentionDays": 7,
  "lastConfigurationEditDate": "0001-01-01T00:00:00Z",
  "learningMode": "Online",
  "isAutoOptimizationEnabled": true,
  "autoOptimizationFrequency": "P7D",
  "autoOptimizationStartDate": "2019-01-19T00:00:00Z"
}

Определения

Имя	Описание
ErrorResponse	Используется для возврата ошибки клиенту
InternalError	Объект , содержащий более конкретные сведения об ошибке, чем родительский объект.
LearningMode	Режимы обучения для Персонализатора
PersonalizerError	Объект ошибки.
PersonalizerErrorCode	Коды ошибок, возвращаемые Персонализатором
ServiceConfiguration	Конфигурация службы.

ErrorResponse

Используется для возврата ошибки клиенту

Имя	Тип	Описание
error	PersonalizerError	Объект ошибки.

InternalError

Объект , содержащий более конкретные сведения об ошибке, чем родительский объект.

Имя	Тип	Описание
code	string	Подробный код ошибки.
innererror	InternalError	Объект , содержащий более конкретные сведения об ошибке, чем родительский объект.

LearningMode

Режимы обучения для Персонализатора

Имя	Тип	Описание
Apprentice	string
LoggingOnly	string
Online	string

PersonalizerError

Объект ошибки.

Имя	Тип	Описание
code	PersonalizerErrorCode	Коды ошибок, возвращаемые Персонализатором
details	PersonalizerError[]	Массив сведений о конкретных ошибках, которые привели к этой сообщаемой ошибке.
innerError	InternalError	Объект , содержащий более конкретные сведения об ошибке, чем родительский объект.
message	string	Сообщение, объясняющее ошибку, о которую сообщила служба.
target	string	Элемент источника ошибки.

PersonalizerErrorCode

Коды ошибок, возвращаемые Персонализатором

Имя	Тип	Описание
ApprenticeModeNeverTurnedOn	string	Режим ученика никогда не включен.
BadRequest	string	Запрос не может быть понят сервером.
DuplicateCustomPolicyNames	string	Пользовательские имена политик должны быть уникальными.
EvaluationModelNotFound	string	Модель не найдена в оценке.
EvaluationNotFound	string	Автономная оценка не найдена.
FrontEndNotFound	string	Внешний интерфейс не найден.
InternalServerError	string	На сервере произошла ошибка, не связанная с этим запросом.
InvalidContainer	string	URI SAS должен быть универсальным кодом ресурса (URI) для контейнера с разрешениями на запись.
InvalidEvaluationContract	string	Недопустимый контракт оценки.
InvalidEventIdToActivate	string	Недопустимый запрос на событие активации.
InvalidExportLogsRequest	string	Недопустимый запрос.
InvalidLearningModeServiceConfiguration	string	Обновление defaultReward, rewardWaitTime и rewardAggregation при изменении режима обучения с "в сети" на режим ученика и наоборот не допускается. Измените режим, а затем измените дополнительные параметры с помощью дополнительного вызова API.
InvalidModelMetadata	string	Недопустимые метаданные модели.
InvalidMultiSlotApiAccess	string	Функция с несколькими слотами в настоящее время отключена. Следуйте документации по многослотовой персонализатору, чтобы обновить параметры цикла, чтобы включить функции нескольких слотов.
InvalidPolicyConfiguration	string	Недопустимая конфигурация политики.
InvalidPolicyContract	string	Недопустимый контракт политики.
InvalidRankRequest	string	Недопустимый запрос.
InvalidRewardRequest	string	Недопустимый запрос на вознаграждение.
InvalidRewardWaitTime	string	Время ожидания вознаграждения должно быть от 5 секунд до 2 дней
InvalidServiceConfiguration	string	Недопустимая конфигурация службы.
LearningSettingsNotFound	string	Параметры обучения не найдены в оценке.
LogsPropertiesNotFound	string	Свойства журнала не найдены.
LogsSizeExceedAllowedLimit	string	Общий размер журналов превышает допустимый предел.
MissingAppId	string	AppId отсутствует в заголовке .
ModelFileAccessDenied	string	Доступ к ключу хранилища ключей, используемому для ключа, управляемого клиентом, невозможен.
ModelMetadataUpdateFailed	string	Не удалось обновить метаданные модели.
ModelPublishFailed	string	Сбой публикации модели.
ModelRankingError	string	Ошибка при ранжировании действий с использованием модели. Убедитесь, что параметры обучения являются допустимыми.
ModelResetFailed	string	Сбой сброса модели.
NoLogsExistInDateRange	string	В диапазоне дат не существует журналов.
OperationNotAllowed	string	В настоящее время эта операция не разрешена.
ProblemTypeIncompatibleWithAutoOptimization	string	Автоматическая оптимизация несовместима с персонализацией с несколькими слотами.
RankNullResponse	string	Вызов ранжирования вернул пустой ответ.
ResourceNotFound	string	Запрошенный ресурс не существует на сервере.
UpdateConfigurationFailed	string	Не удалось обновить конфигурацию.

ServiceConfiguration

Конфигурация службы.

Имя	Тип	Описание
autoOptimizationFrequency	string	Частота автоматической оптимизации. Применимо только в том случае, если isAutoOptimizationEnabled имеет значение true. Например, PT5M (5 мин). Сведения о формате времени \r\nсм. в разделе http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate	string	Дата выполнения первой автоматической оценки оптимизации. Применимо только в том случае, если isAutoOptimizationEnabled имеет значение true.
defaultReward	number	Вознаграждение, полученное, если вознаграждение не получено в течение указанного времени ожидания.
explorationPercentage	number	Процент ответов ранга, которые будут использовать исследование.
isAutoOptimizationEnabled	boolean	Флаг, указывающий, будет ли Персонализатор автоматически оптимизировать параметры обучения, периодически запуская автономные оценки.
lastConfigurationEditDate	string	Время последнего обновления конфигурации обучения модели
learningMode	LearningMode	Режимы обучения для Персонализатора
logMirrorEnabled	boolean	Флаг указывает, включено ли зеркальное отображение журналов.
logMirrorSasUri	string	URI SAS контейнера учетной записи хранения Azure для зеркального отображения журналов.
logRetentionDays	integer	Количество дней, в течение которых должны храниться журналы. -1 означает, что журналы никогда не будут удалены.
modelExportFrequency	string	Персонализатор будет автоматически использовать самую обновленную обученную модель для онлайн-ранжирований каждый указанный период времени. Например, PT5M (5 мин). Сведения о формате времени см. в разделе http://en.wikipedia.org/wiki/ISO_8601#Durations
rewardAggregation	string	Функция, используемая для обработки вознаграждений, если до окончания rewardWaitTime получено несколько оценок вознаграждения.
rewardWaitTime	string	Период ожидания запроса будет отмечен наградой по умолчанию и должен составлять от 5 секунд до 2 дней. Например, PT5M (5 мин). Сведения о формате времени см. в разделе http://en.wikipedia.org/wiki/ISO_8601#Durations

Поделиться через