Service Configuration - Update

Referencia

Servicio:: Cognitive Services - Personalizer

Versión de la API:: v1.1-preview.1

Actualizar la configuración del servicio.
Actualiza la configuración del servicio Personalizer.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
Endpoint	path	True	string	Punto de conexión de Cognitive Services compatible.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
defaultReward	True	number	Recompensa dada si no se recibe una recompensa dentro del tiempo de espera especificado.
explorationPercentage	True	number	Porcentaje de respuestas de clasificación que usarán la exploración.
logRetentionDays	True	integer	Número de días que se van a mantener los registros históricos. -1 implica que los registros nunca se eliminarán.
modelExportFrequency	True	string	Personalizer comenzará a usar el modelo entrenado más actualizado para las clasificaciones en línea automáticamente cada período de tiempo especificado. Por ejemplo, PT5M (5 minutos). Para obtener información sobre el formato de hora, consulte http://en.wikipedia.org/wiki/ISO_8601#Durations
rewardAggregation	True	string	La función que se usa para procesar recompensas, si se reciben varias puntuaciones de recompensa antes de que se supere rewardWaitTime.
rewardWaitTime	True	string	El intervalo de tiempo se espera hasta que una solicitud se marca con la recompensa predeterminada y debe estar entre 5 segundos y 2 días. Por ejemplo, PT5M (5 minutos). Para obtener información sobre el formato de hora, consulte http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationFrequency		string	Frecuencia de optimización automática. Solo es relevante si IsAutoOptimizationEnabled es true. Por ejemplo, PT5M (5 minutos). Para obtener información sobre el formato de hora, \r\nconsulte http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate		string	Fecha en que se debe realizar la primera evaluación de optimización automática. Solo es relevante si IsAutoOptimizationEnabled es true.
isAutoOptimizationEnabled		boolean	Marca que indica si Personalizer optimizará automáticamente la configuración de aprendizaje mediante la ejecución periódica de evaluaciones sin conexión.
lastConfigurationEditDate		string	Última vez que se actualizó la configuración de entrenamiento del modelo
learningMode		LearningMode	Modos de aprendizaje para Personalizer
logMirrorEnabled		boolean	La marca indica si la creación de reflejo del registro está habilitada.
logMirrorSasUri		string	URI de SAS del contenedor de la cuenta de almacenamiento de Azure para la creación de reflejo del registro.

Respuestas

Nombre	Tipo	Description
200 OK	ServiceConfiguration	Correcto
Other Status Codes	ErrorResponse	No se permite actualizar defaultReward, rewardWaitTime y rewardAggregation al cambiar el modo de aprendizaje del modo en línea al de aprendiz y viceversa. Realice el cambio en el modo y, a continuación, cambie la configuración adicional con una llamada API adicional.

Ejemplos

Successful ServiceConfiguration_Update request

Solicitud de ejemplo

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"
}

Respuesta de muestra

status code:: 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"
}

Definiciones

Nombre	Description
ErrorResponse	Se usa para devolver un error al cliente.
InternalError	Objeto que contiene información más específica que el objeto primario sobre el error.
LearningMode	Modos de aprendizaje para Personalizer
PersonalizerError	Objeto de error.
PersonalizerErrorCode	Códigos de error devueltos por Personalizer
ServiceConfiguration	Configuración del servicio.

ErrorResponse

Se usa para devolver un error al cliente.

Nombre	Tipo	Description
error	PersonalizerError	Objeto de error.

InternalError

Objeto que contiene información más específica que el objeto primario sobre el error.

Nombre	Tipo	Description
code	string	Código de error detallado.
innererror	InternalError	Objeto que contiene información más específica que el objeto primario sobre el error.

LearningMode

Modos de aprendizaje para Personalizer

Nombre	Tipo	Description
Apprentice	string
LoggingOnly	string
Online	string

PersonalizerError

Objeto de error.

Nombre	Tipo	Description
code	PersonalizerErrorCode	Códigos de error devueltos por Personalizer
details	PersonalizerError[]	Matriz de detalles sobre errores específicos que llevaron a este error notificado.
innerError	InternalError	Objeto que contiene información más específica que el objeto primario sobre el error.
message	string	Mensaje que explica el error notificado por el servicio.
target	string	Elemento de origen de error.

PersonalizerErrorCode

Códigos de error devueltos por Personalizer

Nombre	Tipo	Description
ApprenticeModeNeverTurnedOn	string	El modo de aprendiz nunca está activado.
BadRequest	string	El servidor no pudo entender la solicitud.
DuplicateCustomPolicyNames	string	Los nombres de directiva personalizados deben ser únicos.
EvaluationModelNotFound	string	No se encontró el modelo en la evaluación.
EvaluationNotFound	string	No se encontró la evaluación sin conexión.
FrontEndNotFound	string	No se encontró el front-end.
InternalServerError	string	Se ha producido un error genérico en el servidor.
InvalidContainer	string	El URI de SAS debe ser el URI de un contenedor que tenga permisos de escritura.
InvalidEvaluationContract	string	Contrato de evaluación no válido.
InvalidEventIdToActivate	string	Solicitud de evento de activación no válida.
InvalidExportLogsRequest	string	Solicitud no válida.
InvalidLearningModeServiceConfiguration	string	No se permite actualizar defaultReward, rewardWaitTime y rewardAggregation al cambiar el modo de aprendizaje del modo en línea al de aprendiz y viceversa. Realice el cambio de modo y, a continuación, cambie la configuración adicional con una llamada API adicional.
InvalidModelMetadata	string	Metadatos de modelo no válidos.
InvalidMultiSlotApiAccess	string	La característica de varias ranuras está deshabilitada actualmente. Siga la documentación de Personalizer de varias ranuras para actualizar la configuración del bucle para habilitar la funcionalidad de varias ranuras.
InvalidPolicyConfiguration	string	Configuración de directiva no válida.
InvalidPolicyContract	string	Contrato de directiva no válido.
InvalidRankRequest	string	Solicitud no válida.
InvalidRewardRequest	string	Solicitud de recompensa no válida.
InvalidRewardWaitTime	string	El tiempo de espera de recompensa debe estar entre 5 segundos y 2 días
InvalidServiceConfiguration	string	Configuración de servicio no válida.
LearningSettingsNotFound	string	No se encontró la configuración de aprendizaje en la evaluación.
LogsPropertiesNotFound	string	No se encontraron las propiedades del registro.
LogsSizeExceedAllowedLimit	string	El tamaño total de los registros supera el límite permitido.
MissingAppId	string	Falta AppId en el encabezado.
ModelFileAccessDenied	string	No se puede acceder a la clave de key vault usada para la clave administrada por el cliente.
ModelMetadataUpdateFailed	string	Error en la actualización de metadatos del modelo.
ModelPublishFailed	string	Error en la publicación del modelo.
ModelRankingError	string	Error al clasificar acciones mediante el modelo. Compruebe que la configuración de aprendizaje es válida.
ModelResetFailed	string	Error de restablecimiento del modelo.
NoLogsExistInDateRange	string	No existen registros en el intervalo de fechas.
OperationNotAllowed	string	Esta operación no se permite en este momento.
ProblemTypeIncompatibleWithAutoOptimization	string	La optimización automática no es compatible con la personalización de varias ranuras.
RankNullResponse	string	La llamada rank devolvió una respuesta nula.
ResourceNotFound	string	El recurso solicitado no existe en el servidor.
UpdateConfigurationFailed	string	No se pudo actualizar la configuración.

ServiceConfiguration

Configuración del servicio.

Nombre	Tipo	Description
autoOptimizationFrequency	string	Frecuencia de optimización automática. Solo es relevante si IsAutoOptimizationEnabled es true. Por ejemplo, PT5M (5 minutos). Para obtener información sobre el formato de hora, \r\nconsulte http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate	string	Fecha en que se debe realizar la primera evaluación de optimización automática. Solo es relevante si IsAutoOptimizationEnabled es true.
defaultReward	number	Recompensa dada si no se recibe una recompensa dentro del tiempo de espera especificado.
explorationPercentage	number	Porcentaje de respuestas de clasificación que usarán la exploración.
isAutoOptimizationEnabled	boolean	Marca que indica si Personalizer optimizará automáticamente la configuración de aprendizaje mediante la ejecución periódica de evaluaciones sin conexión.
lastConfigurationEditDate	string	Última vez que se actualizó la configuración de entrenamiento del modelo
learningMode	LearningMode	Modos de aprendizaje para Personalizer
logMirrorEnabled	boolean	La marca indica si la creación de reflejo del registro está habilitada.
logMirrorSasUri	string	URI de SAS del contenedor de la cuenta de almacenamiento de Azure para la creación de reflejo del registro.
logRetentionDays	integer	Número de días que se van a mantener los registros históricos. -1 implica que los registros nunca se eliminarán.
modelExportFrequency	string	Personalizer comenzará a usar el modelo entrenado más actualizado para las clasificaciones en línea automáticamente cada período de tiempo especificado. Por ejemplo, PT5M (5 minutos). Para obtener información sobre el formato de hora, consulte http://en.wikipedia.org/wiki/ISO_8601#Durations
rewardAggregation	string	La función que se usa para procesar recompensas, si se reciben varias puntuaciones de recompensa antes de que se supere rewardWaitTime.
rewardWaitTime	string	El intervalo de tiempo se espera hasta que una solicitud se marca con la recompensa predeterminada y debe estar entre 5 segundos y 2 días. Por ejemplo, PT5M (5 minutos). Para obtener información sobre el formato de hora, consulte http://en.wikipedia.org/wiki/ISO_8601#Durations

Compartir a través de