Service Configuration - Update

Servizio:: Azure AI Services

Versione API:: v1.1-preview.1

Aggiornare la configurazione del servizio.
Aggiornare la configurazione del servizio Personalizza esperienze.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
Endpoint	path	True	string	Endpoint di Servizi cognitivi supportato.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
defaultReward	True	number (float) minimum: -1 maximum: 1	Ricompensa specificata se una ricompensa non viene ricevuta entro il tempo di attesa specificato.
explorationPercentage	True	number (float) minimum: 0 maximum: 1	Percentuale di risposte di classificazione che useranno l'esplorazione.
logRetentionDays	True	integer (int32) minimum: -1 maximum: 2147483647	Numero di giorni per cui devono essere mantenuti i log cronologici. -1 implica che i log non verranno mai eliminati.
modelExportFrequency	True	string (duration)	Personalizza esperienze inizierà a usare automaticamente il modello con training più aggiornato per i ranghi online ogni periodo di tempo specificato. Ad esempio, PT5M (5 minuti). Per informazioni sul formato ora, vedere http://en.wikipedia.org/wiki/ISO_8601#Durations
rewardAggregation	True	string maxLength: 256	Funzione usata per elaborare i premi, se vengono ricevuti più punteggi di ricompensa prima che rewardWaitTime sia finito.
rewardWaitTime	True	string (duration)	Intervallo di tempo di attesa fino a quando una richiesta viene contrassegnata con la ricompensa predefinita e deve essere compresa tra 5 secondi e 2 giorni. Ad esempio, PT5M (5 minuti). Per informazioni sul formato ora, vedere http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationFrequency		string (duration)	Frequenza di ottimizzazione automatica. Rilevante solo se IsAutoOptimizationEnabled è true. Ad esempio, PT5M (5 minuti). Per informazioni sul formato ora, \r\nvedere http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate		string (date-time)	Data di esecuzione della prima valutazione dell'ottimizzazione automatica. Rilevante solo se IsAutoOptimizationEnabled è true.
isAutoOptimizationEnabled		boolean	Flag che indica se Personalizza esperienze ottimizza automaticamente le impostazioni di apprendimento eseguendo periodicamente valutazioni offline.
lastConfigurationEditDate		string (date-time)	Ultima volta che è stata aggiornata la configurazione del training del modello
learningMode		LearningMode	Modalità di apprendimento per Personalizza esperienze
logMirrorEnabled		boolean	Flag indica se il mirroring del log è abilitato.
logMirrorSasUri		string	URI di firma di accesso condiviso del contenitore dell'account di archiviazione di Azure per il mirroring del log.

Risposte

Nome	Tipo	Descrizione
200 OK	ServiceConfiguration	Successo
Other Status Codes	ErrorResponse	L'aggiornamento di defaultReward, rewardWaitTime e rewardAggregation quando si cambia la modalità di apprendimento da Online a Apprendista e viceversa non è consentito. Modificare la modalità e quindi modificare le impostazioni aggiuntive con una chiamata API aggiuntiva.

Esempio

Successful ServiceConfiguration_Update request

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
}

Definizioni

Nome	Descrizione
ErrorResponse	Usato per restituire un errore al client
InternalError	Oggetto contenente informazioni più specifiche dell'oggetto padre sull'errore.
LearningMode	Modalità di apprendimento per Personalizza esperienze
PersonalizerError	Oggetto error.
PersonalizerErrorCode	Codici di errore restituiti da Personalizza esperienze
ServiceConfiguration	Configurazione del servizio.

ErrorResponse

Object

Usato per restituire un errore al client

Nome	Tipo	Descrizione
error	PersonalizerError	Oggetto error.

InternalError

Object

Oggetto contenente informazioni più specifiche dell'oggetto padre sull'errore.

Nome	Tipo	Descrizione
code	string	Codice di errore dettagliato.
innererror	InternalError	Oggetto contenente informazioni più specifiche dell'oggetto padre sull'errore.

LearningMode

Enumerazione

Modalità di apprendimento per Personalizza esperienze

Valore	Descrizione
Online
Apprentice
LoggingOnly

PersonalizerError

Object

Oggetto error.

Nome	Tipo	Descrizione
code	PersonalizerErrorCode	Codici di errore restituiti da Personalizza esperienze
details	PersonalizerError[]	Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato.
innerError	InternalError	Oggetto contenente informazioni più specifiche dell'oggetto padre sull'errore.
message	string	Messaggio che spiega l'errore segnalato dal servizio.
target	string	Elemento di origine dell'errore.

PersonalizerErrorCode

Enumerazione

Codici di errore restituiti da Personalizza esperienze

Valore	Descrizione
BadRequest	Impossibile comprendere la richiesta dal server.
InvalidServiceConfiguration	Configurazione del servizio non valida.
InvalidLearningModeServiceConfiguration	L'aggiornamento di defaultReward, rewardWaitTime e rewardAggregation quando si cambia la modalità di apprendimento da Online a Apprendista e viceversa non è consentito. Modificare la modalità e quindi modificare le impostazioni aggiuntive con una chiamata API aggiuntiva.
InvalidPolicyConfiguration	Configurazione dei criteri non valida.
InvalidPolicyContract	Contratto di criteri non valido.
InvalidEvaluationContract	Contratto di valutazione non valido.
DuplicateCustomPolicyNames	I nomi dei criteri personalizzati devono essere univoci.
NoLogsExistInDateRange	Nessun log esistente nell'intervallo di date.
LogsSizeExceedAllowedLimit	Le dimensioni totali dei log superano il limite consentito.
InvalidRewardRequest	Richiesta di ricompensa non valida.
InvalidEventIdToActivate	Richiesta evento di attivazione non valida.
InvalidRankRequest	Richiesta non valida.
InvalidExportLogsRequest	Richiesta non valida.
InvalidContainer	L'URI di firma di accesso condiviso deve essere l'URI di un contenitore con autorizzazioni di scrittura.
InvalidModelMetadata	Metadati del modello non validi.
ApprenticeModeNeverTurnedOn	La modalità apprendista non è mai stata attivata.
MissingAppId	AppId manca nell'intestazione.
InvalidRewardWaitTime	Il tempo di attesa della ricompensa deve essere compreso tra 5 secondi e 2 giorni
InvalidMultiSlotApiAccess	La funzionalità multi-slot è attualmente disabilitata. Seguire la documentazione di Personalizza esperienze multi-slot per aggiornare le impostazioni del ciclo per abilitare la funzionalità multi-slot.
ModelFileAccessDenied	Non è possibile accedere alla chiave dell'insieme di credenziali delle chiavi usata per la chiave gestita dal cliente.
ProblemTypeIncompatibleWithAutoOptimization	L'ottimizzazione automatica non è compatibile con la personalizzazione con più slot.
ResourceNotFound	La risorsa richiesta non esiste nel server.
FrontEndNotFound	Front-end non trovato.
EvaluationNotFound	Valutazione offline non trovata.
LearningSettingsNotFound	Impostazioni di apprendimento non trovate nella valutazione.
EvaluationModelNotFound	Modello non trovato nella valutazione.
LogsPropertiesNotFound	Impossibile trovare le proprietà del log.
ModelRankingError	Errore durante la classificazione delle azioni usando il modello. Verificare che le impostazioni di apprendimento siano valide.
InternalServerError	Si è verificato un errore generico nel server.
RankNullResponse	La chiamata rank ha restituito una risposta Null.
UpdateConfigurationFailed	Impossibile aggiornare la configurazione.
ModelResetFailed	La reimpostazione del modello non è riuscita.
ModelPublishFailed	Pubblicazione del modello non riuscita.
ModelMetadataUpdateFailed	Aggiornamento dei metadati del modello non riuscito.
OperationNotAllowed	Questa operazione non è consentita al momento.

ServiceConfiguration

Object

Configurazione del servizio.

Nome	Tipo	Descrizione
autoOptimizationFrequency	string (duration)	Frequenza di ottimizzazione automatica. Rilevante solo se IsAutoOptimizationEnabled è true. Ad esempio, PT5M (5 minuti). Per informazioni sul formato ora, \r\nvedere http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate	string (date-time)	Data di esecuzione della prima valutazione dell'ottimizzazione automatica. Rilevante solo se IsAutoOptimizationEnabled è true.
defaultReward	number (float) minimum: -1 maximum: 1	Ricompensa specificata se una ricompensa non viene ricevuta entro il tempo di attesa specificato.
explorationPercentage	number (float) minimum: 0 maximum: 1	Percentuale di risposte di classificazione che useranno l'esplorazione.
isAutoOptimizationEnabled	boolean	Flag che indica se Personalizza esperienze ottimizza automaticamente le impostazioni di apprendimento eseguendo periodicamente valutazioni offline.
lastConfigurationEditDate	string (date-time)	Ultima volta che è stata aggiornata la configurazione del training del modello
learningMode	LearningMode	Modalità di apprendimento per Personalizza esperienze
logMirrorEnabled	boolean	Flag indica se il mirroring del log è abilitato.
logMirrorSasUri	string	URI di firma di accesso condiviso del contenitore dell'account di archiviazione di Azure per il mirroring del log.
logRetentionDays	integer (int32) minimum: -1 maximum: 2147483647	Numero di giorni per cui devono essere mantenuti i log cronologici. -1 implica che i log non verranno mai eliminati.
modelExportFrequency	string (duration)	Personalizza esperienze inizierà a usare automaticamente il modello con training più aggiornato per i ranghi online ogni periodo di tempo specificato. Ad esempio, PT5M (5 minuti). Per informazioni sul formato ora, vedere http://en.wikipedia.org/wiki/ISO_8601#Durations
rewardAggregation	string maxLength: 256	Funzione usata per elaborare i premi, se vengono ricevuti più punteggi di ricompensa prima che rewardWaitTime sia finito.
rewardWaitTime	string (duration)	Intervallo di tempo di attesa fino a quando una richiesta viene contrassegnata con la ricompensa predefinita e deve essere compresa tra 5 secondi e 2 giorni. Ad esempio, PT5M (5 minuti). Per informazioni sul formato ora, vedere http://en.wikipedia.org/wiki/ISO_8601#Durations