Partilhar via


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

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

ServiceConfiguration

Com êxito

Other Status Codes

ErrorResponse

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
ErrorResponse

Utilizado para devolver um erro ao cliente

InternalError

Um objeto que contém informações mais específicas do que o objeto principal sobre o erro.

LearningMode

Modos de Aprendizagem para Personalizador

PersonalizerError

O objeto de erro.

PersonalizerErrorCode

Códigos de Erro devolvidos pelo Personalizador

ServiceConfiguration

A configuração do serviço.

ErrorResponse

Utilizado para devolver um erro ao cliente

Name Tipo Description
error

PersonalizerError

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

InternalError

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

PersonalizerErrorCode

Códigos de Erro devolvidos pelo Personalizador

details

PersonalizerError[]

Uma série de detalhes sobre erros específicos que levaram a este erro comunicado.

innerError

InternalError

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

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