Multi Slot Events - Reward

Servicio:

Azure AI Services

Versión de la API:

v1.1-preview.1

Post multi-slot Rewards.
Informe de la recompensa resultante del uso de la acción especificada en rewardActionId para la ranura.

POST {Endpoint}/personalizer/v1.1-preview.1/multislot/events/{eventId}/reward

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
Endpoint	path	True	string	Punto de conexión de Cognitive Services compatible.
eventId	path	True	string maxLength: 256	El identificador de evento al que se aplica esta recompensa.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
reward	True	SlotReward[]	Lista de SlotRewards

Respuestas

Nombre	Tipo	Description
204 No Content		Éxito
Other Status Codes	ErrorResponse	Solicitud de recompensa no válida.

Ejemplos

Successful MultiSlotEvents_Reward request

Solicitud de ejemplo

HTTP

POST {Endpoint}/personalizer/v1.1-preview.1/multislot/events/id/reward

{
  "reward": [
    {
      "slotId": "Heroposition",
      "value": 0.5
    },
    {
      "slotId": "SideBar",
      "value": 0.6
    }
  ]
}

Respuesta de muestra

status code:

204

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.
MultiSlotRewardRequest	Recompensa dada a una lista de ranuras.
PersonalizerError	Objeto de error.
PersonalizerErrorCode	Códigos de error devueltos por Personalizer
SlotReward

ErrorResponse

Object

Se usa para devolver un error al cliente

Nombre	Tipo	Description
error	PersonalizerError	Objeto de error.

InternalError

Object

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.

MultiSlotRewardRequest

Object

Recompensa dada a una lista de ranuras.

Nombre	Tipo	Description
reward	SlotReward[]	Lista de SlotRewards

PersonalizerError

Object

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

Enumeración

Códigos de error devueltos por Personalizer

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

SlotReward

Object

Nombre	Tipo	Description
slotId	string minLength: 1 maxLength: 256	Id. de ranura para el que estamos enviando la recompensa.
value	number (float)	Recompensa que se va a asignar a slotId. El valor debe estar entre -1 y 1 inclusive.