Partager via

Service Configuration - Update

  • Référence
Service:
Cognitive Services - Personalizer
Version d'API:
v1.1-preview.1

Mettre à jour la configuration du service.
Met à jour la configuration du service Personalizer.

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

Paramètres URI

Nom Dans Obligatoire Type Description
Endpoint
 path True

string

Point de terminaison Cognitive Services pris en charge.

Corps de la demande

Nom Obligatoire Type Description
defaultReward True

number

Récompense donnée si aucune récompense n’est reçue dans le délai d’attente spécifié.
explorationPercentage True

number

Pourcentage de réponses de classement qui utiliseront l’exploration.
logRetentionDays True

integer

Nombre de jours pendant lesquels les journaux d’activité historiques doivent être conservés. -1 implique que les journaux ne seront jamais supprimés.
modelExportFrequency True

string

Personalizer commence automatiquement à utiliser le modèle entraîné le plus mis à jour pour les classements en ligne à chaque période spécifiée. Par exemple, PT5M (5 minutes). Pour plus d’informations sur le format de l’heure, consultez http://en.wikipedia.org/wiki/ISO_8601#Durations
rewardAggregation True

string

Fonction utilisée pour traiter les récompenses, si plusieurs scores de récompense sont reçus avant la fin de rewardWaitTime.
rewardWaitTime True

string

L’intervalle de temps attendu jusqu’à ce qu’une demande soit marquée avec la récompense par défaut et doit être compris entre 5 secondes et 2 jours. Par exemple, PT5M (5 minutes). Pour plus d’informations sur le format de l’heure, consultez http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationFrequency

string

Fréquence de l’optimisation automatique. Pertinent uniquement si IsAutoOptimizationEnabled a la valeur true. Par exemple, PT5M (5 minutes). Pour plus d’informations sur le format d’heure, \r\nconsultez http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate

string

Date à laquelle la première évaluation d’optimisation automatique doit être effectuée. Pertinent uniquement si IsAutoOptimizationEnabled a la valeur true.
isAutoOptimizationEnabled

boolean

Indicateur indiquant si Personalizer optimisera automatiquement les paramètres d’apprentissage en exécutant régulièrement des évaluations hors connexion.
lastConfigurationEditDate

string

Dernière mise à jour de la configuration de l’entraînement du modèle
learningMode

LearningMode

Modes d’apprentissage pour Personalizer
logMirrorEnabled

boolean

Indicateur indique si la mise en miroir des journaux est activée.
logMirrorSasUri

string

URI SAP du conteneur de compte de stockage Azure pour la mise en miroir des journaux.

Réponses

Nom Type Description
200 OK

ServiceConfiguration

Succès
Other Status Codes

ErrorResponse

La mise à jour de defaultReward, rewardWaitTime et rewardAggregation lors du passage du mode d’apprentissage En ligne au mode Apprenti et vice versa n’est pas autorisée. Modifiez le mode, puis modifiez les paramètres supplémentaires avec un appel d’API supplémentaire.

Exemples

Successful ServiceConfiguration_Update request

Exemple de requête

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

Exemple de réponse

Code d’état:
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"
}

Définitions

Nom Description
ErrorResponse

Utilisé pour retourner une erreur au client
InternalError

Objet contenant des informations plus spécifiques que l’objet parent sur l’erreur.
LearningMode

Modes d’apprentissage pour Personalizer
PersonalizerError

Objet error.
PersonalizerErrorCode

Codes d’erreur retournés par Personalizer
ServiceConfiguration

Configuration du service.

ErrorResponse

Utilisé pour retourner une erreur au client

Nom Type Description
error

PersonalizerError

Objet error.

InternalError

Objet contenant des informations plus spécifiques que l’objet parent sur l’erreur.

Nom Type Description
code

string

Code d’erreur détaillé.
innererror

InternalError

Objet contenant des informations plus spécifiques que l’objet parent sur l’erreur.

LearningMode

Modes d’apprentissage pour Personalizer

Nom Type Description
Apprentice

string

LoggingOnly

string

Online

string

PersonalizerError

Objet error.

Nom Type Description
code

PersonalizerErrorCode

Codes d’erreur retournés par Personalizer
details

PersonalizerError[]

Tableau de détails sur les erreurs spécifiques qui ont conduit à cette erreur signalée.
innerError

InternalError

Objet contenant des informations plus spécifiques que l’objet parent sur l’erreur.
message

string

Message expliquant l’erreur signalée par le service.
target

string

Élément source d’erreur.

PersonalizerErrorCode

Codes d’erreur retournés par Personalizer

Nom Type Description
ApprenticeModeNeverTurnedOn

string

Le mode Apprenti n’a jamais été activé.
BadRequest

string

La demande n’a pas pu être comprise par le serveur.
DuplicateCustomPolicyNames

string

Les noms de stratégie personnalisée doivent être uniques.
EvaluationModelNotFound

string

Modèle introuvable dans l’évaluation.
EvaluationNotFound

string

Évaluation hors connexion introuvable.
FrontEndNotFound

string

Serveur frontal introuvable.
InternalServerError

string

Une erreur générique s’est produite sur le serveur.
InvalidContainer

string

L’URI SAS doit être l’URI d’un conteneur disposant d’autorisations d’écriture.
InvalidEvaluationContract

string

Contrat d’évaluation non valide.
InvalidEventIdToActivate

string

Demande d’événement d’activation non valide.
InvalidExportLogsRequest

string

Demande non valide.
InvalidLearningModeServiceConfiguration

string

La mise à jour de defaultReward, rewardWaitTime et rewardAggregation lors du passage du mode d’apprentissage En ligne au mode Apprenti et vice versa n’est pas autorisée. Modifiez le mode, puis modifiez les paramètres supplémentaires avec un appel d’API supplémentaire.
InvalidModelMetadata

string

Métadonnées de modèle non valides.
InvalidMultiSlotApiAccess

string

La fonctionnalité multi-emplacements est actuellement désactivée. Suivez la documentation Personalizer multi-emplacements pour mettre à jour vos paramètres de boucle afin d’activer les fonctionnalités multi-emplacements.
InvalidPolicyConfiguration

string

Configuration de stratégie non valide.
InvalidPolicyContract

string

Contrat de stratégie non valide.
InvalidRankRequest

string

Demande non valide.
InvalidRewardRequest

string

Demande de récompense non valide.
InvalidRewardWaitTime

string

Le temps d’attente de la récompense doit être compris entre 5 secondes et 2 jours
InvalidServiceConfiguration

string

Configuration de service non valide.
LearningSettingsNotFound

string

Paramètres d’apprentissage introuvables dans l’évaluation.
LogsPropertiesNotFound

string

Propriétés de journal introuvables.
LogsSizeExceedAllowedLimit

string

La taille totale des journaux dépasse la limite autorisée.
MissingAppId

string

AppId est manquant dans l’en-tête.
ModelFileAccessDenied

string

La clé de coffre de clés utilisée pour la clé gérée par le client n’est pas accessible.
ModelMetadataUpdateFailed

string

Échec de la mise à jour des métadonnées du modèle.
ModelPublishFailed

string

Échec de la publication du modèle.
ModelRankingError

string

Erreur lors du classement des actions à l’aide du modèle. Vérifiez que les paramètres d’apprentissage sont valides.
ModelResetFailed

string

Échec de la réinitialisation du modèle.
NoLogsExistInDateRange

string

Aucun journal n’existe dans la plage de dates.
OperationNotAllowed

string

Cette opération n’est pas autorisée pour l’instant.
ProblemTypeIncompatibleWithAutoOptimization

string

L’optimisation automatique n’est pas compatible avec la personnalisation à plusieurs emplacements.
RankNullResponse

string

L’appel de classement a retourné une réponse null.
ResourceNotFound

string

La ressource demandée n’existe pas sur le serveur.
UpdateConfigurationFailed

string

Échec de la mise à jour de la configuration.

ServiceConfiguration

Configuration du service.

Nom Type Description
autoOptimizationFrequency

string

Fréquence de l’optimisation automatique. Pertinent uniquement si IsAutoOptimizationEnabled a la valeur true. Par exemple, PT5M (5 minutes). Pour plus d’informations sur le format d’heure, \r\nconsultez http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate

string

Date à laquelle la première évaluation d’optimisation automatique doit être effectuée. Pertinent uniquement si IsAutoOptimizationEnabled a la valeur true.
defaultReward

number

Récompense donnée si aucune récompense n’est reçue dans le délai d’attente spécifié.
explorationPercentage

number

Pourcentage de réponses de classement qui utiliseront l’exploration.
isAutoOptimizationEnabled

boolean

Indicateur indiquant si Personalizer optimisera automatiquement les paramètres d’apprentissage en exécutant régulièrement des évaluations hors connexion.
lastConfigurationEditDate

string

Dernière mise à jour de la configuration de l’entraînement du modèle
learningMode

LearningMode

Modes d’apprentissage pour Personalizer
logMirrorEnabled

boolean

Indicateur indique si la mise en miroir des journaux est activée.
logMirrorSasUri

string

URI SAP du conteneur de compte de stockage Azure pour la mise en miroir des journaux.
logRetentionDays

integer

Nombre de jours pendant lesquels les journaux d’activité historiques doivent être conservés. -1 implique que les journaux ne seront jamais supprimés.
modelExportFrequency

string

Personalizer commence automatiquement à utiliser le modèle entraîné le plus mis à jour pour les classements en ligne à chaque période spécifiée. Par exemple, PT5M (5 minutes). Pour plus d’informations sur le format de l’heure, consultez http://en.wikipedia.org/wiki/ISO_8601#Durations
rewardAggregation

string

Fonction utilisée pour traiter les récompenses, si plusieurs scores de récompense sont reçus avant la fin de rewardWaitTime.
rewardWaitTime

string

L’intervalle de temps attendu jusqu’à ce qu’une demande soit marquée avec la récompense par défaut et doit être compris entre 5 secondes et 2 jours. Par exemple, PT5M (5 minutes). Pour plus d’informations sur le format de l’heure, consultez http://en.wikipedia.org/wiki/ISO_8601#Durations