Condividi tramite

Service Configuration - Update

  • Riferimento
Servizio:
Cognitive Services - Personalizer
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 supportati.

Corpo della richiesta

Nome Necessario Tipo Descrizione
defaultReward True

number

Ricompensa data se una ricompensa non viene ricevuta entro il tempo di attesa specificato.
explorationPercentage True

number

Percentuale di risposte di classificazione che useranno l'esplorazione.
logRetentionDays True

integer

I log cronologici dei giorni devono essere mantenuti. -1 implica che i log non verranno mai eliminati.
modelExportFrequency True

string

Personalizza esperienze inizierà a usare il modello con training più aggiornato per i ranghi online automaticamente 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

La funzione usata per elaborare i premi, se vengono ricevuti più punteggi di ricompensa prima che il premioWaitTime venga superato.
rewardWaitTime True

string

Intervallo di tempo di attesa fino a quando una richiesta è 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

Frequenza di ottimizzazione automatica. Solo pertinente 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

Data di esecuzione della prima valutazione automatica dell'ottimizzazione. Solo pertinente se IsAutoOptimizationEnabled è true.
isAutoOptimizationEnabled

boolean

Flag che indica se Personalizza esperienze ottimizza automaticamente le impostazioni di apprendimento eseguendo periodicamente valutazioni offline.
lastConfigurationEditDate

string

Ultima configurazione del training del modello
learningMode

LearningMode

Modalità di apprendimento per Personalizza esperienze
logMirrorEnabled

boolean

Flag indica se il mirroring dei log è abilitato.
logMirrorSasUri

string

URI sas del contenitore dell'account di archiviazione di Azure per il mirroring dei log.

Risposte

Nome Tipo Descrizione
200 OK

ServiceConfiguration

Operazione riuscita
Other Status Codes

ErrorResponse

Aggiornamento di defaultReward, ricompensaWaitTime e ricompensaAggregazione quando si modifica la modalità di apprendimento da Online a Apprendista e viceversa non è consentito. Apportare la modifica della modalità e quindi modificare le impostazioni aggiuntive con una chiamata API aggiuntiva.

Esempio

Successful ServiceConfiguration_Update request

Esempio di richiesta

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

Usato per restituire un errore al client

Nome Tipo Descrizione
error

PersonalizerError

Oggetto error.

InternalError

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

Modalità di apprendimento per Personalizza esperienze

Nome Tipo Descrizione
Apprentice

string

LoggingOnly

string

Online

string

PersonalizerError

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 degli errori.

PersonalizerErrorCode

Codici di errore restituiti da Personalizza esperienze

Nome Tipo Descrizione
ApprenticeModeNeverTurnedOn

string

La modalità apprendista non è mai attivata.
BadRequest

string

Impossibile comprendere la richiesta dal server.
DuplicateCustomPolicyNames

string

I nomi dei criteri personalizzati devono essere univoci.
EvaluationModelNotFound

string

Modello non trovato nella valutazione.
EvaluationNotFound

string

Valutazione offline non trovata.
FrontEndNotFound

string

Front-end non trovato.
InternalServerError

string

Si è verificato un errore generico nel server.
InvalidContainer

string

L'URI di firma di accesso condiviso deve essere l'URI a un contenitore con autorizzazioni di scrittura.
InvalidEvaluationContract

string

Contratto di valutazione non valido.
InvalidEventIdToActivate

string

Richiesta di evento attiva non valida.
InvalidExportLogsRequest

string

Richiesta non valida.
InvalidLearningModeServiceConfiguration

string

Aggiornamento di defaultReward, ricompensaWaitTime e ricompensaAggregazione quando si modifica la modalità di apprendimento da Online a Apprendista e viceversa non è consentito. Apportare la modifica della modalità e quindi modificare le impostazioni aggiuntive con una chiamata API aggiuntiva.
InvalidModelMetadata

string

Metadati del modello non validi.
InvalidMultiSlotApiAccess

string

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.
InvalidPolicyConfiguration

string

Configurazione dei criteri non valida.
InvalidPolicyContract

string

Contratto di criteri non valido.
InvalidRankRequest

string

Richiesta non valida.
InvalidRewardRequest

string

Richiesta di ricompensa non valida.
InvalidRewardWaitTime

string

Il tempo di attesa ricompensa deve essere compreso tra 5 secondi e 2 giorni
InvalidServiceConfiguration

string

Configurazione del servizio non valida.
LearningSettingsNotFound

string

Impostazioni di apprendimento non trovate nella valutazione.
LogsPropertiesNotFound

string

Proprietà del log non trovate.
LogsSizeExceedAllowedLimit

string

Le dimensioni totali dei log superano il limite consentito.
MissingAppId

string

AppId manca nell'intestazione.
ModelFileAccessDenied

string

La chiave dell'insieme di credenziali delle chiavi utilizzata per la chiave gestita dal cliente non può essere accessibile.
ModelMetadataUpdateFailed

string

Aggiornamento dei metadati del modello non riuscito.
ModelPublishFailed

string

Pubblicazione modello non riuscita.
ModelRankingError

string

Errore durante la classificazione delle azioni usando il modello. Verificare che le impostazioni di apprendimento siano valide.
ModelResetFailed

string

Reimpostazione del modello non riuscita.
NoLogsExistInDateRange

string

Nessun log presente nell'intervallo di date.
OperationNotAllowed

string

Questa operazione non è consentita in questo momento.
ProblemTypeIncompatibleWithAutoOptimization

string

L'ottimizzazione automatica non è compatibile con la personalizzazione multi-slot.
RankNullResponse

string

Chiamata di classificazione restituita risposta Null.
ResourceNotFound

string

La risorsa richiesta non esiste nel server.
UpdateConfigurationFailed

string

Impossibile aggiornare la configurazione.

ServiceConfiguration

Configurazione del servizio.

Nome Tipo Descrizione
autoOptimizationFrequency

string

Frequenza di ottimizzazione automatica. Solo pertinente 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

Data di esecuzione della prima valutazione automatica dell'ottimizzazione. Solo pertinente se IsAutoOptimizationEnabled è true.
defaultReward

number

Ricompensa data se una ricompensa non viene ricevuta entro il tempo di attesa specificato.
explorationPercentage

number

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

Ultima configurazione del training del modello
learningMode

LearningMode

Modalità di apprendimento per Personalizza esperienze
logMirrorEnabled

boolean

Flag indica se il mirroring dei log è abilitato.
logMirrorSasUri

string

URI sas del contenitore dell'account di archiviazione di Azure per il mirroring dei log.
logRetentionDays

integer

I log cronologici dei giorni devono essere mantenuti. -1 implica che i log non verranno mai eliminati.
modelExportFrequency

string

Personalizza esperienze inizierà a usare il modello con training più aggiornato per i ranghi online automaticamente 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

La funzione usata per elaborare i premi, se vengono ricevuti più punteggi di ricompensa prima che il premioWaitTime venga superato.
rewardWaitTime

string

Intervallo di tempo di attesa fino a quando una richiesta è 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