Service Configuration - Update
Atualizar Configuração do Serviço.
Atualize a configuração do serviço Personalizador.
PUT {Endpoint}/personalizer/v1.1-preview.1/configurations/service
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
Endpoint
|
path | True |
string |
Ponto final dos Serviços Cognitivos suportado. |
Corpo do Pedido
Name | Necessário | Tipo | Description |
---|---|---|---|
defaultReward | True |
number |
A recompensa dada se não for recebida uma recompensa dentro do tempo de espera especificado. |
explorationPercentage | True |
number |
A percentagem de respostas de classificação que utilizarão a exploração. |
logRetentionDays | True |
integer |
Número de dias em que os registos históricos devem ser mantidos. -1 implica que os registos nunca serão eliminados. |
modelExportFrequency | True |
string |
O personalizador começará a utilizar o modelo preparado mais atualizado para classificações online automaticamente a cada período de tempo especificado. Por exemplo, PT5M (5 minutos). Para obter informações sobre o formato de hora, consulte http://en.wikipedia.org/wiki/ISO_8601#Durations |
rewardAggregation | True |
string |
A função utilizada para processar recompensas, se forem recebidas várias pontuações de recompensa antes de rewardWaitTime terminar. |
rewardWaitTime | True |
string |
O intervalo de tempo aguardou até que um pedido seja marcado com a recompensa predefinida e deve estar entre 5 segundos e 2 dias. Por exemplo, PT5M (5 minutos). Para obter informações sobre o formato de hora, consulte http://en.wikipedia.org/wiki/ISO_8601#Durations |
autoOptimizationFrequency |
string |
Frequência da otimização automática. Só é relevante se IsAutoOptimizationEnabled for verdadeiro. Por exemplo, PT5M (5 minutos). Para obter informações sobre o formato de hora, \r\nver http://en.wikipedia.org/wiki/ISO_8601#Durations |
|
autoOptimizationStartDate |
string |
Data em que a primeira avaliação de otimização automática tem de ser efetuada. Só é relevante se IsAutoOptimizationEnabled for verdadeiro. |
|
isAutoOptimizationEnabled |
boolean |
Sinalizador que indica se o Personalizador otimiza automaticamente as Definições de Aprendizagem ao executar Avaliações Offline periodicamente. |
|
lastConfigurationEditDate |
string |
Última vez que a configuração de preparação de modelos foi atualizada |
|
learningMode |
Modos de Aprendizagem para Personalizador |
||
logMirrorEnabled |
boolean |
O sinalizador indica se o espelhamento de registo está ativado. |
|
logMirrorSasUri |
string |
URI de SAS do contentor da conta de armazenamento do Azure para espelhamento de registos. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
Com êxito |
|
Other Status Codes |
Não é permitido atualizar defaultReward, rewardWaitTime e rewardAggregation ao alterar o modo de aprendizagem do modo Online para o modo de Aprendiz e vice-versa. Altere o modo e, em seguida, altere as definições adicionais com uma chamada à API adicional. |
Exemplos
Successful ServiceConfiguration_Update request
Pedido de amostra
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"
}
Resposta da amostra
{
"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"
}
Definições
Name | Description |
---|---|
Error |
Utilizado para devolver um erro ao cliente |
Internal |
Um objeto que contém informações mais específicas do que o objeto principal sobre o erro. |
Learning |
Modos de Aprendizagem para Personalizador |
Personalizer |
O objeto de erro. |
Personalizer |
Códigos de Erro devolvidos pelo Personalizador |
Service |
A configuração do serviço. |
ErrorResponse
Utilizado para devolver um erro ao cliente
Name | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
InternalError
Um objeto que contém informações mais específicas do que o objeto principal sobre o erro.
Name | Tipo | Description |
---|---|---|
code |
string |
Código de erro detalhado. |
innererror |
Um objeto que contém informações mais específicas do que o objeto principal sobre o erro. |
LearningMode
Modos de Aprendizagem para Personalizador
Name | Tipo | Description |
---|---|---|
Apprentice |
string |
|
LoggingOnly |
string |
|
Online |
string |
PersonalizerError
O objeto de erro.
Name | Tipo | Description |
---|---|---|
code |
Códigos de Erro devolvidos pelo Personalizador |
|
details |
Uma série de detalhes sobre erros específicos que levaram a este erro comunicado. |
|
innerError |
Um objeto que contém informações mais específicas do que o objeto principal sobre o erro. |
|
message |
string |
Uma mensagem a explicar o erro comunicado pelo serviço. |
target |
string |
Elemento de origem do erro. |
PersonalizerErrorCode
Códigos de Erro devolvidos pelo Personalizador
Name | Tipo | Description |
---|---|---|
ApprenticeModeNeverTurnedOn |
string |
O modo de aprendiz nunca se acendeu. |
BadRequest |
string |
Não foi possível compreender o pedido pelo servidor. |
DuplicateCustomPolicyNames |
string |
Os nomes de políticas personalizadas devem ser exclusivos. |
EvaluationModelNotFound |
string |
Modelo não encontrado na avaliação. |
EvaluationNotFound |
string |
Avaliação Offline não encontrada. |
FrontEndNotFound |
string |
Front-end não encontrado. |
InternalServerError |
string |
Ocorreu um erro genérico no servidor. |
InvalidContainer |
string |
O Uri de SAS tem de ser o Uri para um contentor que tenha permissões de escrita. |
InvalidEvaluationContract |
string |
Contrato de avaliação inválido. |
InvalidEventIdToActivate |
string |
Pedido de evento de ativação inválido. |
InvalidExportLogsRequest |
string |
Pedido inválido. |
InvalidLearningModeServiceConfiguration |
string |
Não é permitido atualizar defaultReward, rewardWaitTime e rewardAggregation ao alterar o modo de aprendizagem do modo Online para o modo de Aprendiz e vice-versa. Altere o modo e, em seguida, altere as definições adicionais com uma chamada à API adicional. |
InvalidModelMetadata |
string |
Metadados de modelo inválidos. |
InvalidMultiSlotApiAccess |
string |
A funcionalidade de vários blocos está atualmente desativada. Siga a documentação do Personalizador de vários blocos para atualizar as definições do ciclo para ativar a funcionalidade de vários blocos. |
InvalidPolicyConfiguration |
string |
Configuração de política inválida. |
InvalidPolicyContract |
string |
Contrato de política inválido. |
InvalidRankRequest |
string |
Pedido inválido. |
InvalidRewardRequest |
string |
Pedido de recompensa inválido. |
InvalidRewardWaitTime |
string |
O tempo de espera da recompensa deve ser entre 5 segundos e 2 dias |
InvalidServiceConfiguration |
string |
Configuração de serviço inválida. |
LearningSettingsNotFound |
string |
Definições de Aprendizagem não encontradas na avaliação. |
LogsPropertiesNotFound |
string |
Propriedades de registo não encontradas. |
LogsSizeExceedAllowedLimit |
string |
O tamanho total dos registos excede o limite permitido. |
MissingAppId |
string |
O AppId está em falta no cabeçalho. |
ModelFileAccessDenied |
string |
Não é possível aceder à Chave do cofre de chaves utilizada para a chave gerida pelo cliente. |
ModelMetadataUpdateFailed |
string |
Falha na atualização de metadados do modelo. |
ModelPublishFailed |
string |
Falha na publicação do modelo. |
ModelRankingError |
string |
Erro ao classificar ações com o modelo. Verifique se as definições de aprendizagem são válidas. |
ModelResetFailed |
string |
Falha na reposição do modelo. |
NoLogsExistInDateRange |
string |
Não existem registos no intervalo de datas. |
OperationNotAllowed |
string |
Esta operação não é permitida neste momento. |
ProblemTypeIncompatibleWithAutoOptimization |
string |
A otimização automática não é compatível com a personalização de vários blocos. |
RankNullResponse |
string |
A chamada de classificação devolveu uma resposta nula. |
ResourceNotFound |
string |
O recurso pedido não existe no servidor. |
UpdateConfigurationFailed |
string |
Falha ao atualizar a configuração. |
ServiceConfiguration
A configuração do serviço.
Name | Tipo | Description |
---|---|---|
autoOptimizationFrequency |
string |
Frequência da otimização automática. Só é relevante se IsAutoOptimizationEnabled for verdadeiro. Por exemplo, PT5M (5 minutos). Para obter informações sobre o formato de hora, \r\nver http://en.wikipedia.org/wiki/ISO_8601#Durations |
autoOptimizationStartDate |
string |
Data em que a primeira avaliação de otimização automática tem de ser efetuada. Só é relevante se IsAutoOptimizationEnabled for verdadeiro. |
defaultReward |
number |
A recompensa dada se não for recebida uma recompensa dentro do tempo de espera especificado. |
explorationPercentage |
number |
A percentagem de respostas de classificação que utilizarão a exploração. |
isAutoOptimizationEnabled |
boolean |
Sinalizador que indica se o Personalizador otimiza automaticamente as Definições de Aprendizagem ao executar Avaliações Offline periodicamente. |
lastConfigurationEditDate |
string |
Última vez que a configuração de preparação de modelos foi atualizada |
learningMode |
Modos de Aprendizagem para Personalizador |
|
logMirrorEnabled |
boolean |
O sinalizador indica se o espelhamento de registo está ativado. |
logMirrorSasUri |
string |
URI de SAS do contentor da conta de armazenamento do Azure para espelhamento de registos. |
logRetentionDays |
integer |
Número de dias em que os registos históricos devem ser mantidos. -1 implica que os registos nunca serão eliminados. |
modelExportFrequency |
string |
O personalizador começará a utilizar o modelo preparado mais atualizado para classificações online automaticamente a cada período de tempo especificado. Por exemplo, PT5M (5 minutos). Para obter informações sobre o formato de hora, consulte http://en.wikipedia.org/wiki/ISO_8601#Durations |
rewardAggregation |
string |
A função utilizada para processar recompensas, se forem recebidas várias pontuações de recompensa antes de rewardWaitTime terminar. |
rewardWaitTime |
string |
O intervalo de tempo aguardou até que um pedido seja marcado com a recompensa predefinida e deve estar entre 5 segundos e 2 dias. Por exemplo, PT5M (5 minutos). Para obter informações sobre o formato de hora, consulte http://en.wikipedia.org/wiki/ISO_8601#Durations |