サービス周期学習のリクエスト
- 印刷する
- PDF
サービス周期学習のリクエスト
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。
サービス学習をリクエストします。
PUT https://aitems.apigw.ntruss.com/api/v1/services/{serviceId}/schedule?action=start
リクエスト
リクエストパラメータ
パラメータ名 | 要否 | タイプ | 制約事項 | 説明 |
---|---|---|---|---|
serviceId | Yes | String | 作成されたサービス ID | |
action | Yes | String | start, stop | 周期学習の実行および停止有無 |
リクエストボディ
パラメータ名 | 要否 | タイプ | 制約事項 | 説明 |
---|---|---|---|---|
trainTypes | Yes | Array | personalRecommend, pop | 学習リクエストタイプ |
description | No | String | 0~100文字で入力 | 学習の説明 |
hpConfig.is_enabled | Yes | Boolean | HPO設定の有無 | |
hpConfig.{option} | No | String, Int | 設定された HPO値 |
HPO(Hyper parameter option)
オプション名 | 要否 | タイプ | 学習タイプ | 制約事項 | 説明 |
---|---|---|---|---|---|
session_max_timestamp | No | Long | 個別化推薦、関連推薦 | - デフォルト値: 1800 - 最小値: 5 - 最大値: なし | - 同じセッションとみなすアクション間の最大アイドルタイム(秒) - 1800(30分)以上推奨 |
item_top_n | No | Long | 個別化推薦、関連推薦 | - デフォルト値: 20000 - 最小値: 1000 - 最大値: 500000 | - 推薦に活用する最大商品数 - 人気順に活用 |
min_item_cut | No | Long | 個別化推薦、関連推薦 | - デフォルト値: 5 - 最小値: 1 - 最大値: なし | 商品の最小登場条件回数 |
min_session_length | No | Long | 個別化推薦、関連推薦 | - デフォルト値: 2 - 最小値: 2 - 最大値: なし | セッション内の最小アクション数 |
max_user_recommend_top | No | Long | 個別化推薦 | - デフォルト値: 100 - 最小値: 1 - 最大値: 1000 | ユーザー1人当たりの最大おすすめ商品数 |
max_relate_recommend_top | No | Long | 関連推薦 | - デフォルト値: 100 - 最小値: 1 - 最大値: 1000 | 商品当たりの最大関連おすすめ商品数 |
remove_history_item | No | Boolean | 個別化推薦、関連推薦 | - デフォルト値: false | 個別化商品推薦に既に履歴がある商品の削除有無 |
group_column | Yes | Array | 人気商品 | USER_ID、ITEM_ID、TIMESTAMP選択不可 | 人気抽出グループのカラムリスト |
target_column | No | String | 人気商品 | USER_ID、ITEM_ID、TIMESTAMP選択不可 | 人気抽出対象のカラム |
max_group_recommend_top | No | Long | 人気商品 | - デフォルト値 - 100 - 最小値: 1 - 最大値: 1000 | グループ当たりの最大人気商品数 |
レスポンス
フィールド名 | タイプ | 説明 | 備考 |
---|---|---|---|
serviceId | String | サービス ID | |
name | String | サービス名 | |
description | String | サービスの説明 | |
status | String | サービスの状態 | |
datasets[].datasetId | String | サービスに設定されたデータセット ID | |
datasets[].type | String | サービスに設定されたデータセットタイプ | |
datasets[].name | String | サービスに設定されたデータセット名 | |
datasets[].schemaName | String | サービスに設定されたデータセットスキーマ名 | |
datasets[].status | String | サービスに設定されたデータセット状態 | |
datasets[].createdDate | String | サービスに設定されたデータセット作成日 | |
datasets[].updatedDate | String | サービスに設定されたデータセットの最終アップデート | |
hpConfig.is_enabled | Boolean | HPO設定の有無 | |
hpConfig.{option} | String | 設定された HPO値 | |
infers[].dataType | String | 学習結果のデータセットタイプ | |
infers[].trainVersion | String | 学習結果バージョン | |
infers[].status | String | 学習結果の状態 | |
infers[].rowCount | String | 学習結果件数 | |
createdDate | String | サービス作成日 | |
updatedDate | String | 最終アップデート | |
type | String | サービスタイプ | |
learningInterval | String | アップデート周期 | |
scheduledDate | String | アップデート基準時間 |
レスポンス Status
HTTP Status | Desc |
---|---|
200 | OK(リクエスト完了) |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
500 | Internal Server Error |
例
リクエスト例
PUT /api/v1/services/49qkb0fbnar/schedule?action=start
Host: aitems.apigw.ntruss.com
accept: application/json
x-ncp-iam-access-key: {Access key}
x-ncp-apigw-signature-v2: {API GW signature}
x-ncp-apigw-timestamp: {timestamp}
{
"trainTypes": [
"personalRecommend"
],
"description": "test",
"hpConfig": {
"is_enabled": false
}
}
レスポンス例
{
"serviceId": "49qkb0fbnar",
"name": "movie-service",
"description": "",
"status": "scheduled",
"datasets": [
{
"datasetId": "7qkv2ox8211",
"type": "interaction",
"name": "m-interaction",
"schemaName": "movie_interaction",
"status": "learnable",
"createdDate": "2021-09-15T18:19:22.709",
"updatedDate": "2021-11-22T17:03:35.844"
},
{
"datasetId": "qc80eu7udo9",
"type": "user",
"name": "m-user",
"schemaName": "movie_user",
"status": "learnable",
"createdDate": "2021-09-15T18:18:58.123",
"updatedDate": "2021-11-22T16:01:38.486"
},
{
"datasetId": "ap0l4f72e9f",
"type": "item",
"name": "m-item",
"schemaName": "movie_item",
"status": "learnable",
"createdDate": "2021-09-15T18:19:10.454",
"updatedDate": "2021-11-22T17:04:35.977"
}
],
"hpConfig": {
"is_enabled": false,
"group_column": [
"AGE"
]
},
"infers": [
{
"dataType": "personalRecommend",
"trainVersion": "owpayt7nw1n",
"status": "enable",
"rowCount": 1113,
"createdDate": "2021-11-24T15:24:06.62",
"updatedDate": "2021-11-24T15:24:18.162"
},
{
"dataType": "relatedItem",
"trainVersion": "owpayt7nw1n",
"status": "enable",
"rowCount": 2641,
"createdDate": "2021-11-24T15:24:06.686",
"updatedDate": "2021-11-24T15:24:20.902"
},
{
"dataType": "pop",
"trainVersion": "owpayt7nw1n",
"status": "enable",
"rowCount": 92,
"createdDate": "2021-11-24T15:17:29.353",
"updatedDate": "2021-11-24T15:17:39.565"
}
],
"createdDate": "2021-09-29T11:36:50.217",
"updatedDate": "2021-11-24T15:24:20.985"
"type": "interval",
"learningInterval": "hour6",
"scheduledDate": "2021-11-18T15:17:12.968"
}
この記事は役に立ちましたか?