Service Configuration - Update

  • リファレンス
サービス:
Cognitive Services - Personalizer
API バージョン:
v1.1-preview.1

サービス構成を更新します。
Personalizer サービスの構成を更新します。

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

URI パラメーター

名前 / 必須 型 説明
Endpoint
 path True

string

サポートされている Cognitive Services エンドポイント。

要求本文

名前 必須 型 説明
defaultReward True

number

指定された待機時間内に報酬を受け取らない場合に与えられる報酬。
explorationPercentage True

number

探索を使用するランク応答の割合。
logRetentionDays True

integer

履歴ログを保持する日数。 -1 は、ログが削除されないようにすることを意味します。
modelExportFrequency True

string

Personalizer は、指定された期間ごとに自動的にオンライン ランクに対して最新のトレーニング済みモデルの使用を開始します。 たとえば、PT5M (5 分)。 時刻形式の詳細については、次を参照してください。 http://en.wikipedia.org/wiki/ISO_8601#Durations
rewardAggregation True

string

rewardWaitTime が終了する前に複数の報酬スコアを受け取った場合に、報酬の処理に使用される関数。
rewardWaitTime True

string

期間は、要求が既定の報酬でマークされるまで待機し、5 秒から 2 日の間にする必要があります。 たとえば、PT5M (5 分)。 時刻形式の詳細については、次を参照してください。 http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationFrequency

string

自動最適化の頻度。 IsAutoOptimizationEnabled が true の場合にのみ関連します。 たとえば、PT5M (5 分)。 時刻形式の詳細については、「\r\n」を参照してください。 http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate

string

最初の自動最適化評価を実行する必要がある日付。 IsAutoOptimizationEnabled が true の場合にのみ関連します。
isAutoOptimizationEnabled

boolean

Personalizer がオフライン評価を定期的に実行して学習設定を自動的に最適化するかどうかを示すフラグ。
lastConfigurationEditDate

string

前回モデルトレーニングの構成が更新されました
learningMode

LearningMode

Personalizer の学習モード
logMirrorEnabled

boolean

フラグは、ログ ミラーリングが有効かどうかを示します。
logMirrorSasUri

string

ログ ミラーリング用の Azure ストレージ アカウント コンテナー SAS URI。

応答

名前 型 説明
200 OK

ServiceConfiguration

Success
Other Status Codes

ErrorResponse

学習モードをオンラインから見習いモードに変更する場合、defaultReward、rewardWaitTime、rewardAggregation を更新することはできません。 モードを変更してから、追加の API 呼び出しを使用して追加の設定を変更します。

例

Successful ServiceConfiguration_Update request

要求のサンプル

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

応答のサンプル

状態コード:
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"
}

定義

名前 説明
ErrorResponse

クライアントにエラーを返すために使用されます
InternalError

エラーに関する親オブジェクトよりも具体的な情報を含む オブジェクト。
LearningMode

Personalizer の学習モード
PersonalizerError

error オブジェクト。
PersonalizerErrorCode

Personalizer によって返されるエラー コード
ServiceConfiguration

サービスの構成。

ErrorResponse

クライアントにエラーを返すために使用されます

名前 型 説明
error

PersonalizerError

error オブジェクト。

InternalError

エラーに関する親オブジェクトよりも具体的な情報を含む オブジェクト。

名前 型 説明
code

string

詳細なエラー コード。
innererror

InternalError

エラーに関する親オブジェクトよりも具体的な情報を含む オブジェクト。

LearningMode

Personalizer の学習モード

名前 型 説明
Apprentice

string

LoggingOnly

string

Online

string

PersonalizerError

error オブジェクト。

名前 型 説明
code

PersonalizerErrorCode

Personalizer によって返されるエラー コード
details

PersonalizerError[]

この報告されたエラーの原因となった特定のエラーに関する詳細の配列。
innerError

InternalError

エラーに関する親オブジェクトよりも具体的な情報を含む オブジェクト。
message

string

サービスによって報告されたエラーを説明するメッセージ。
target

string

エラー ソース要素。

PersonalizerErrorCode

Personalizer によって返されるエラー コード

名前 型 説明
ApprenticeModeNeverTurnedOn

string

見習いモードがオンになることはありません。
BadRequest

string

サーバーが要求を認識できませんでした。
DuplicateCustomPolicyNames

string

カスタム ポリシー名は一意である必要があります。
EvaluationModelNotFound

string

モデルが評価で見つかりません。
EvaluationNotFound

string

オフライン評価が見つかりません。
FrontEndNotFound

string

フロントエンドが見つかりません。
InternalServerError

string

サーバーで汎用エラーが発生しました。
InvalidContainer

string

SAS Uri は、書き込みアクセス許可を持つコンテナーの URI である必要があります。
InvalidEvaluationContract

string

評価コントラクトが無効です。
InvalidEventIdToActivate

string

アクティブ化イベント要求が無効です。
InvalidExportLogsRequest

string

無効な要求です。
InvalidLearningModeServiceConfiguration

string

学習モードをオンラインから見習いモードに変更する場合、defaultReward、rewardWaitTime、rewardAggregation を更新することはできません。 モードを変更してから、追加の API 呼び出しを使用して追加の設定を変更します。
InvalidModelMetadata

string

モデル メタデータが無効です。
InvalidMultiSlotApiAccess

string

マルチスロット機能は現在無効になっています。 マルチスロット Personalizer のドキュメントに従って、ループ設定を更新してマルチスロット機能を有効にしてください。
InvalidPolicyConfiguration

string

ポリシー構成が無効です。
InvalidPolicyContract

string

ポリシー コントラクトが無効です。
InvalidRankRequest

string

無効な要求です。
InvalidRewardRequest

string

報酬要求が無効です。
InvalidRewardWaitTime

string

報酬の待機時間は 5 秒から 2 日の間にする必要があります
InvalidServiceConfiguration

string

無効なサービス構成。
LearningSettingsNotFound

string

評価で学習設定が見つかりません。
LogsPropertiesNotFound

string

ログのプロパティが見つかりません。
LogsSizeExceedAllowedLimit

string

ログの合計サイズが許可された制限を超えています。
MissingAppId

string

ヘッダーに AppId がありません。
ModelFileAccessDenied

string

カスタマー マネージド キーに使用されるキー コンテナー キーにアクセスできません。
ModelMetadataUpdateFailed

string

モデル メタデータの更新に失敗しました。
ModelPublishFailed

string

モデルの発行に失敗しました。
ModelRankingError

string

モデルを使用したアクションのランク付け中にエラーが発生しました。 学習設定が有効であることを確認してください。
ModelResetFailed

string

モデルのリセットに失敗しました。
NoLogsExistInDateRange

string

日付範囲にログが存在しません。
OperationNotAllowed

string

現時点では、この操作は許可されていません。
ProblemTypeIncompatibleWithAutoOptimization

string

自動最適化は、マルチスロットパーソナル化と互換性がありません。
RankNullResponse

string

ランク呼び出しで null 応答が返されました。
ResourceNotFound

string

要求されたリソースがサーバーに存在しません。
UpdateConfigurationFailed

string

構成を更新できませんでした。

ServiceConfiguration

サービスの構成。

名前 型 説明
autoOptimizationFrequency

string

自動最適化の頻度。 IsAutoOptimizationEnabled が true の場合にのみ関連します。 たとえば、PT5M (5 分)。 時刻形式の詳細については、「\r\n」を参照してください。 http://en.wikipedia.org/wiki/ISO_8601#Durations
autoOptimizationStartDate

string

最初の自動最適化評価を実行する必要がある日付。 IsAutoOptimizationEnabled が true の場合にのみ関連します。
defaultReward

number

指定された待機時間内に報酬を受け取らない場合に与えられる報酬。
explorationPercentage

number

探索を使用するランク応答の割合。
isAutoOptimizationEnabled

boolean

Personalizer がオフライン評価を定期的に実行して学習設定を自動的に最適化するかどうかを示すフラグ。
lastConfigurationEditDate

string

前回モデルトレーニングの構成が更新されました
learningMode

LearningMode

Personalizer の学習モード
logMirrorEnabled

boolean

フラグは、ログ ミラーリングが有効かどうかを示します。
logMirrorSasUri

string

ログ ミラーリング用の Azure ストレージ アカウント コンテナー SAS URI。
logRetentionDays

integer

履歴ログを保持する日数。 -1 は、ログが削除されないようにすることを意味します。
modelExportFrequency

string

Personalizer は、指定された期間ごとに自動的にオンライン ランクに対して最新のトレーニング済みモデルの使用を開始します。 たとえば、PT5M (5 分)。 時刻形式の詳細については、次を参照してください。 http://en.wikipedia.org/wiki/ISO_8601#Durations
rewardAggregation

string

rewardWaitTime が終了する前に複数の報酬スコアを受け取った場合に、報酬の処理に使用される関数。
rewardWaitTime

string

期間は、要求が既定の報酬でマークされるまで待機し、5 秒から 2 日の間にする必要があります。 たとえば、PT5M (5 分)。 時刻形式の詳細については、次を参照してください。 http://en.wikipedia.org/wiki/ISO_8601#Durations