Freigeben über

Service Configuration - Update

  • Referenz
Dienst:
Cognitive Services - Personalizer
API-Version:
v1.1-preview.1

Aktualisieren der Dienstkonfiguration.
Aktualisieren Sie die Konfiguration des Personalisierungsdiensts.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
Endpoint
 path True

string

Unterstützter Cognitive Services-Endpunkt.

Anforderungstext

Name Erforderlich Typ Beschreibung
defaultReward True

number

Die Belohnung, die gewährt wird, wenn eine Belohnung nicht innerhalb der angegebenen Wartezeit erhalten wird.
explorationPercentage True

number

Der Prozentsatz der Rangantworten, die die Exploration verwenden.
logRetentionDays True

integer

Anzahl der Tage, an denen Verlaufsprotokolle verwaltet werden sollen. -1 bedeutet, dass die Protokolle nie gelöscht werden.
modelExportFrequency True

string

Die Personalisierung beginnt automatisch in jedem angegebenen Zeitraum mit der Verwendung des am häufigsten aktualisierten trainierten Modells für Online-Rangfolgen. Beispiel: PT5M (5 Minuten). Informationen zum Zeitformat finden Sie unter http://en.wikipedia.org/wiki/ISO_8601#Durations
rewardAggregation True

string

Die Funktion, die zum Verarbeiten von Belohnungen verwendet wird, wenn mehrere Belohnungsbewertungen empfangen werden, bevor rewardWaitTime abgelaufen ist.
rewardWaitTime True

string

Die Zeitspanne, die gewartet wurde, bis eine Anforderung mit der Standardbelohnung gekennzeichnet ist, sollte zwischen 5 Sekunden und 2 Tagen betragen. Beispiel: PT5M (5 Minuten). Informationen zum Zeitformat finden Sie unter http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationFrequency

string

Häufigkeit der automatischen Optimierung. Nur relevant, wenn IsAutoOptimizationEnabled true ist. Beispiel: PT5M (5 Minuten). Informationen zum Zeitformat \r\nfinden Sie unter http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate

string

Datum, an dem die erste automatische Optimierungsauswertung durchgeführt werden muss. Nur relevant, wenn IsAutoOptimizationEnabled true ist.
isAutoOptimizationEnabled

boolean

Flag, das angibt, ob die Personalisierung die Lerneinstellungen automatisch optimiert, indem Offlineauswertungen regelmäßig ausgeführt werden.
lastConfigurationEditDate

string

Letzte Aktualisierung der Modelltrainingskonfiguration
learningMode

LearningMode

Lernmodi für die Personalisierung
logMirrorEnabled

boolean

Flag gibt an, ob die Protokollspiegelung aktiviert ist.
logMirrorSasUri

string

Sas-URI des Azure-Speicherkontocontainers für die Protokollspiegelung.

Antworten

Name Typ Beschreibung
200 OK

ServiceConfiguration

Erfolg
Other Status Codes

ErrorResponse

Das Aktualisieren von defaultReward, rewardWaitTime und rewardAggregation beim Wechsel des Lernmodus vom Online- in den Lehrlingsmodus und umgekehrt ist nicht zulässig. Ändern Sie den Modus, und ändern Sie dann die zusätzlichen Einstellungen mit einem zusätzlichen API-Aufruf.

Beispiele

Successful ServiceConfiguration_Update request

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
ErrorResponse

Wird verwendet, um einen Fehler an den Client zurückzugeben.
InternalError

Ein Objekt, das spezifischere Informationen als das übergeordnete Objekt zum Fehler enthält.
LearningMode

Lernmodi für die Personalisierung
PersonalizerError

Das Fehlerobjekt.
PersonalizerErrorCode

Von der Personalisierung zurückgegebene Fehlercodes
ServiceConfiguration

Die Konfiguration des Diensts.

ErrorResponse

Wird verwendet, um einen Fehler an den Client zurückzugeben.

Name Typ Beschreibung
error

PersonalizerError

Das Fehlerobjekt.

InternalError

Ein Objekt, das spezifischere Informationen als das übergeordnete Objekt zum Fehler enthält.

Name Typ Beschreibung
code

string

Detaillierter Fehlercode.
innererror

InternalError

Ein Objekt, das spezifischere Informationen als das übergeordnete Objekt zum Fehler enthält.

LearningMode

Lernmodi für die Personalisierung

Name Typ Beschreibung
Apprentice

string

LoggingOnly

string

Online

string

PersonalizerError

Das Fehlerobjekt.

Name Typ Beschreibung
code

PersonalizerErrorCode

Von der Personalisierung zurückgegebene Fehlercodes
details

PersonalizerError[]

Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
innerError

InternalError

Ein Objekt, das spezifischere Informationen als das übergeordnete Objekt zum Fehler enthält.
message

string

Eine Meldung, die den vom Dienst gemeldeten Fehler erklärt.
target

string

Fehlerquellenelement.

PersonalizerErrorCode

Von der Personalisierung zurückgegebene Fehlercodes

Name Typ Beschreibung
ApprenticeModeNeverTurnedOn

string

Der Lehrlingsmodus wurde nie aktiviert.
BadRequest

string

Die Anforderung konnte vom Server nicht verstanden werden.
DuplicateCustomPolicyNames

string

Benutzerdefinierte Richtliniennamen sollten eindeutig sein.
EvaluationModelNotFound

string

Das Modell wurde in der Auswertung nicht gefunden.
EvaluationNotFound

string

Offlineauswertung nicht gefunden.
FrontEndNotFound

string

Front-End nicht gefunden.
InternalServerError

string

Auf dem Server ist ein allgemeiner Fehler aufgetreten.
InvalidContainer

string

SAS-Uri muss der URI für einen Container sein, der über Schreibberechtigungen verfügt.
InvalidEvaluationContract

string

Ungültiger Bewertungsvertrag.
InvalidEventIdToActivate

string

Ungültige Aktivierungsereignisanforderung.
InvalidExportLogsRequest

string

Ungültige Anforderung.
InvalidLearningModeServiceConfiguration

string

Das Aktualisieren von defaultReward, rewardWaitTime und rewardAggregation beim Wechsel des Lernmodus vom Online- in den Lehrlingsmodus und umgekehrt ist nicht zulässig. Ändern Sie den Modus, und ändern Sie dann die zusätzlichen Einstellungen mit einem zusätzlichen API-Aufruf.
InvalidModelMetadata

string

Ungültige Modellmetadaten.
InvalidMultiSlotApiAccess

string

Das Feature mit mehreren Slots ist derzeit deaktiviert. Bitte folgen Sie der Dokumentation zur Personalisierung mit mehreren Slots, um Ihre Schleifeneinstellungen zu aktualisieren, um die Multi-Slot-Funktionalität zu aktivieren.
InvalidPolicyConfiguration

string

Ungültige Richtlinienkonfiguration.
InvalidPolicyContract

string

Ungültiger Richtlinienvertrag.
InvalidRankRequest

string

Ungültige Anforderung.
InvalidRewardRequest

string

Ungültige Belohnungsanforderung.
InvalidRewardWaitTime

string

Die Wartezeit der Belohnung sollte zwischen 5 Sekunden und 2 Tagen betragen.
InvalidServiceConfiguration

string

Ungültige Dienstkonfiguration.
LearningSettingsNotFound

string

Lerneinstellungen wurden in der Auswertung nicht gefunden.
LogsPropertiesNotFound

string

Protokolleigenschaften wurden nicht gefunden.
LogsSizeExceedAllowedLimit

string

Die Gesamtgröße der Protokolle überschreitet den zulässigen Grenzwert.
MissingAppId

string

AppId fehlt im Header.
ModelFileAccessDenied

string

Auf schlüsseltresorschlüssel, der für den kundenseitig verwalteten Schlüssel verwendet wird, kann nicht zugegriffen werden.
ModelMetadataUpdateFailed

string

Fehler beim Aktualisieren von Modellmetadaten.
ModelPublishFailed

string

Fehler bei der Modellveröffentlichung.
ModelRankingError

string

Fehler beim Rangieren von Aktionen mithilfe des Modells. Überprüfen Sie, ob die Lerneinstellungen gültig sind.
ModelResetFailed

string

Fehler beim Zurücksetzen des Modells.
NoLogsExistInDateRange

string

Im Datumsbereich sind keine Protokolle vorhanden.
OperationNotAllowed

string

Dieser Vorgang ist derzeit nicht zulässig.
ProblemTypeIncompatibleWithAutoOptimization

string

Die automatische Optimierung ist nicht mit der Personalisierung mit mehreren Slots kompatibel.
RankNullResponse

string

Rangfolgeaufruf gibt NULL-Antwort zurück.
ResourceNotFound

string

Die angeforderte Ressource ist auf dem Server nicht vorhanden.
UpdateConfigurationFailed

string

Fehler beim Aktualisieren der Konfiguration.

ServiceConfiguration

Die Konfiguration des Diensts.

Name Typ Beschreibung
autoOptimizationFrequency

string

Häufigkeit der automatischen Optimierung. Nur relevant, wenn IsAutoOptimizationEnabled true ist. Beispiel: PT5M (5 Minuten). Informationen zum Zeitformat \r\nfinden Sie unter http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate

string

Datum, an dem die erste automatische Optimierungsauswertung durchgeführt werden muss. Nur relevant, wenn IsAutoOptimizationEnabled true ist.
defaultReward

number

Die Belohnung, die gewährt wird, wenn eine Belohnung nicht innerhalb der angegebenen Wartezeit erhalten wird.
explorationPercentage

number

Der Prozentsatz der Rangantworten, die die Exploration verwenden.
isAutoOptimizationEnabled

boolean

Flag, das angibt, ob die Personalisierung die Lerneinstellungen automatisch optimiert, indem Offlineauswertungen regelmäßig ausgeführt werden.
lastConfigurationEditDate

string

Letzte Aktualisierung der Modelltrainingskonfiguration
learningMode

LearningMode

Lernmodi für die Personalisierung
logMirrorEnabled

boolean

Flag gibt an, ob die Protokollspiegelung aktiviert ist.
logMirrorSasUri

string

Sas-URI des Azure-Speicherkontocontainers für die Protokollspiegelung.
logRetentionDays

integer

Anzahl der Tage, an denen Verlaufsprotokolle verwaltet werden sollen. -1 bedeutet, dass die Protokolle nie gelöscht werden.
modelExportFrequency

string

Die Personalisierung beginnt automatisch in jedem angegebenen Zeitraum mit der Verwendung des am häufigsten aktualisierten trainierten Modells für Online-Rangfolgen. Beispiel: PT5M (5 Minuten). Informationen zum Zeitformat finden Sie unter http://en.wikipedia.org/wiki/ISO_8601#Durations
rewardAggregation

string

Die Funktion, die zum Verarbeiten von Belohnungen verwendet wird, wenn mehrere Belohnungsbewertungen empfangen werden, bevor rewardWaitTime abgelaufen ist.
rewardWaitTime

string

Die Zeitspanne, die gewartet wurde, bis eine Anforderung mit der Standardbelohnung gekennzeichnet ist, sollte zwischen 5 Sekunden und 2 Tagen betragen. Beispiel: PT5M (5 Minuten). Informationen zum Zeitformat finden Sie unter http://en.wikipedia.org/wiki/ISO_8601#Durations