サービス学習のリクエスト

印刷する
共有
PDF

記事の要約

この要約は役に立ちましたか?

ご意見ありがとうございます

最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。

サービス学習をリクエストします。

POST https://aitems.apigw.ntruss.com/api/v1/services/{serviceId}

リクエスト

リクエストパラメータ

パラメータ名	要否	タイプ	制約事項	説明
serviceId	Yes	String		作成されたサービス ID

リクエストボディ

パラメータ名	要否	タイプ	制約事項	説明
type	Yes	Array	personalRecommend, relatedItem, 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

例

リクエスト例

POST /api/v1/services/49qkb0fbnar
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}

{
  "types": [
    "personalRecommend"
  ],
  "description": "test",
  "hpConfig": {
    "is_enabled": false
  }
}

レスポンス例

{
  "serviceId": "49qkb0fbnar",
  "name": "movie-service",
  "description": "",
  "status": "learning",
  "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"
}

この記事は役に立ちましたか?

What's Next

サービス周期学習のリクエスト

リクエスト
レスポンス
例

タグ

AiTEMS