Service Configuration - Update

Referência

Serviço:: Cognitive Services - Personalizer

Versão da API:: v1.1-preview.1

Atualizar Configuração do Serviço.
Atualizar a configuração do serviço Personalizador.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
Endpoint	path	True	string	Ponto de extremidade dos Serviços Cognitivos com suporte.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
defaultReward	True	number	A recompensa fornecida se uma recompensa não for recebida dentro do tempo de espera especificado.
explorationPercentage	True	number	O percentual de respostas de classificação que usarão a exploração.
logRetentionDays	True	integer	O número de dias em que os logs históricos devem ser mantidos. -1 implica que os logs nunca serão excluídos.
modelExportFrequency	True	string	O Personalizador começará a usar o modelo treinado 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 usada para processar recompensas, se várias pontuações de recompensa forem recebidas antes do rewardWaitTime terminar.
rewardWaitTime	True	string	O período de tempo esperou até que uma solicitação seja marcada com a recompensa padrão e deve ficar 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. Relevante somente se IsAutoOptimizationEnabled for true. Por exemplo, PT5M (5 minutos). Para obter informações sobre o formato de hora, consulte \r\nhttp://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate		string	Data em que a primeira avaliação automática de otimização deve ser executada. Relevante somente se IsAutoOptimizationEnabled for true.
isAutoOptimizationEnabled		boolean	Sinalizador que indica se o Personalizador otimizará automaticamente as Configurações de Aprendizagem executando avaliações offline periodicamente.
lastConfigurationEditDate		string	Última vez que a configuração de treinamento do modelo foi atualizada
learningMode		LearningMode	Modos de aprendizagem para Personalizador
logMirrorEnabled		boolean	O sinalizador indica se o espelhamento de log está habilitado.
logMirrorSasUri		string	URI SAS do contêiner da conta de armazenamento do Azure para espelhamento de log.

Respostas

Nome	Tipo	Description
200 OK	ServiceConfiguration	Êxito
Other Status Codes	ErrorResponse	A atualização de defaultReward, rewardWaitTime e rewardAggregation ao alterar o modo de aprendizagem do modo Online para o Aprendiz e vice-versa não é permitida. Faça o modo mudar e, em seguida, altere as configurações adicionais com uma chamada à API adicional.

Exemplos

Successful ServiceConfiguration_Update request

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 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"
}

Definições

Nome	Description
ErrorResponse	Usado para retornar um erro ao cliente
InternalError	Um objeto que contém informações mais específicas do que o objeto pai sobre o erro.
LearningMode	Modos de aprendizagem para Personalizador
PersonalizerError	O objeto de erro.
PersonalizerErrorCode	Códigos de erro retornados pelo Personalizador
ServiceConfiguration	A configuração do serviço.

ErrorResponse

Usado para retornar um erro ao cliente

Nome	Tipo	Description
error	PersonalizerError	O objeto de erro.

InternalError

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

Nome	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 pai sobre o erro.

LearningMode

Modos de aprendizagem para Personalizador

Nome	Tipo	Description
Apprentice	string
LoggingOnly	string
Online	string

PersonalizerError

O objeto de erro.

Nome	Tipo	Description
code	PersonalizerErrorCode	Códigos de erro retornados pelo Personalizador
details	PersonalizerError[]	Uma matriz de detalhes sobre erros específicos que levaram a esse erro relatado.
innerError	InternalError	Um objeto que contém informações mais específicas do que o objeto pai sobre o erro.
message	string	Uma mensagem explicando o erro relatado pelo serviço.
target	string	Elemento de origem do erro.

PersonalizerErrorCode

Códigos de erro retornados pelo Personalizador

Nome	Tipo	Description
ApprenticeModeNeverTurnedOn	string	O modo aprendiz nunca está ativado.
BadRequest	string	Não foi possível entender a solicitação pelo servidor.
DuplicateCustomPolicyNames	string	Os nomes de política personalizados 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	Erro genérico no servidor.
InvalidContainer	string	O Uri de SAS deve ser o Uri para um contêiner que tenha permissões de gravação.
InvalidEvaluationContract	string	Contrato de avaliação inválido.
InvalidEventIdToActivate	string	Solicitação de evento de ativação inválida.
InvalidExportLogsRequest	string	Solicitação inválida.
InvalidLearningModeServiceConfiguration	string	A atualização de defaultReward, rewardWaitTime e rewardAggregation ao alterar o modo de aprendizagem do modo Online para o Aprendiz e vice-versa não é permitida. Faça o modo mudar e, em seguida, altere as configurações adicionais com uma chamada à API adicional.
InvalidModelMetadata	string	Metadados de modelo inválidos.
InvalidMultiSlotApiAccess	string	No momento, o recurso de vários slots está desabilitado. Siga a documentação do Personalizador de vários slots para atualizar as configurações de loop para habilitar a funcionalidade de vários slots.
InvalidPolicyConfiguration	string	Configuração de política inválida.
InvalidPolicyContract	string	Contrato de política inválido.
InvalidRankRequest	string	Solicitação inválida.
InvalidRewardRequest	string	Solicitação de recompensa inválida.
InvalidRewardWaitTime	string	O tempo de espera de recompensa deve ser entre 5 segundos e 2 dias
InvalidServiceConfiguration	string	Configuração de serviço inválida.
LearningSettingsNotFound	string	Configurações de aprendizagem não encontradas na avaliação.
LogsPropertiesNotFound	string	Propriedades de log não encontradas.
LogsSizeExceedAllowedLimit	string	O tamanho total dos logs excede o limite permitido.
MissingAppId	string	AppId está ausente no cabeçalho.
ModelFileAccessDenied	string	A chave do cofre de chaves usada para a chave gerenciada pelo cliente não pode ser acessada.
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 usando o modelo. Verifique se as configurações de aprendizado são válidas.
ModelResetFailed	string	Falha na redefinição do modelo.
NoLogsExistInDateRange	string	Não existem logs no intervalo de datas.
OperationNotAllowed	string	Essa operação não é permitida no momento.
ProblemTypeIncompatibleWithAutoOptimization	string	A otimização automática não é compatível com a personalização de vários slots.
RankNullResponse	string	A chamada de classificação retornou resposta nula.
ResourceNotFound	string	O recurso solicitado não existe no servidor.
UpdateConfigurationFailed	string	Falha ao atualizar a configuração.

ServiceConfiguration

A configuração do serviço.

Nome	Tipo	Description
autoOptimizationFrequency	string	Frequência da otimização automática. Relevante somente se IsAutoOptimizationEnabled for true. Por exemplo, PT5M (5 minutos). Para obter informações sobre o formato de hora, consulte \r\nhttp://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate	string	Data em que a primeira avaliação automática de otimização deve ser executada. Relevante somente se IsAutoOptimizationEnabled for true.
defaultReward	number	A recompensa fornecida se uma recompensa não for recebida dentro do tempo de espera especificado.
explorationPercentage	number	O percentual de respostas de classificação que usarão a exploração.
isAutoOptimizationEnabled	boolean	Sinalizador que indica se o Personalizador otimizará automaticamente as Configurações de Aprendizagem executando avaliações offline periodicamente.
lastConfigurationEditDate	string	Última vez que a configuração de treinamento do modelo foi atualizada
learningMode	LearningMode	Modos de aprendizagem para Personalizador
logMirrorEnabled	boolean	O sinalizador indica se o espelhamento de log está habilitado.
logMirrorSasUri	string	URI SAS do contêiner da conta de armazenamento do Azure para espelhamento de log.
logRetentionDays	integer	O número de dias em que os logs históricos devem ser mantidos. -1 implica que os logs nunca serão excluídos.
modelExportFrequency	string	O Personalizador começará a usar o modelo treinado 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 usada para processar recompensas, se várias pontuações de recompensa forem recebidas antes do rewardWaitTime terminar.
rewardWaitTime	string	O período de tempo esperou até que uma solicitação seja marcada com a recompensa padrão e deve ficar 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

Compartilhar via