Classic/VPC環境で利用できます。
データ収集は、ユーザーの質問に適切な答えを与えるためにモデルが考えて判断するプロセスです。データ収集とデータレビューにより、モデルの思考プロセスを変更できます。
データ収集画面
データ収集画面は以下のように構成されています。
.png?sv=2022-11-02&spr=https&st=2026-02-27T04%3A17%3A27Z&se=2026-02-27T04%3A28%3A27Z&sr=c&sp=r&sig=RdcAiLXhqpf8sfiYDMRlf8p%2BErBZUBudaMhtsK4%2BZLw%3D)
| 項目 | 説明 |
|---|---|
| ① データ収集実行領域 | データを収集するために値を設定して実行する領域
|
| ② データ収集領域 | 作成されたデータを確認して収集する領域
|
| ③ 機能ボタン |
|
データ収集実行
データ収集によってユーザークエリを処理するために、モデルが思考して判断するプロセスをステップ別に確認できます。
データ収集を実行する方法は、次の通りです。
- NAVERクラウドプラットフォームコンソールで、
> Services > AI Services > CLOVA Studio メニューを順にクリックします。 - My Product メニューで [CLOVA Studioに移動する] ボタンをクリックします。
- CLOVA Studioで スキルトレーナー メニューをクリックします。
- データを収集するスキルセットをクリックします。
- [データ収集] タブをクリックします。
- データ収集に必要な情報を設定します。
- Model / Version : 使用する言語モデルまたはバージョンを選択
- Skill : スキルセットに含まれたスキルのリスト。タスクステータスが「タスク完了」のスキルのみ活用可能
- Setting > 呼び出しオプション : ユーザークエリで APIを呼び出す場合の固定値を入力。呼び出しオプションを作成する方法は、呼び出しオプションを作成を参照
- User Query 領域に収集するクエリを入力します。
- [→] ボタンをクリックします。
- 画面左側にデータ収集ステップが順次表示されます。
- [中止する] ボタンをクリックすると、そのステップが中止になります。 [再実行する] ボタンを再びクリックすると、中止になったタスクが再実行されます。
データ収集を実行した後は、 Model / Version 、 User Query を変更できません。変更が必要な場合は、 [初期化] ボタンをクリックして新たにタスクを実行してください。 [初期化] ボタンはデータ収集が完了した後に有効になります。
データのレビューと変更
データ収集を実行した後、各ステップでモデルが明確に判断できていない部分がある場合は、直接パラメータを変更してより正確な回答を作成するように改善できます。
収集したデータをレビューして変更する方法は、次の通りです。
- データ収集実行を実行します。
- クエリ分析結果スキルの呼び出し結果を確認します。
- 各ステップについての詳細は、データ収集ステップをご参照ください。
- 各ステップの [次へ] ボタンをクリックして次のステップを実行します。
- 新しいデータを収集する場合は、最終回答ステップまで [次へ] ボタンなしで一気に作成します。
- データを変更するには各フィールドを変更した後、 [適用] ボタンをクリックします
- その後のステップのデータ作成が再実行されます。
- 最終回答を確認した後、 [タスク完了] ボタンをクリックします。
- 当該タスクを保存して後で再利用したい場合は、 [一時保存] ボタンをクリックします。
- 最終回答が作成されたことで [タスク完了] ボタンが有効になります。
データインポート
以前のタスクデータをインポートし、レビューして変更できます。
データをインポートする方法は、次の通りです。
- NAVERクラウドプラットフォームコンソールで、
> Services > AI Services > CLOVA Studio メニューを順にクリックします。 - My Product メニューで [CLOVA Studioに移動する] ボタンをクリックします。
- CLOVA Studioで スキルトレーナー メニューをクリックします。
- スキルセットをクリックします。
- [データ収集] タブをクリックします。
- データ収集実行領域の [インポート] ボタンをクリックします。
- 一時保存したタスクリストを確認します。
- インポート画面の右上からユーザークエリを基準に検索できます。
- データ結果を確認するには、リストから [⋮] > [データを見る] ボタンをクリックします。
- タスクを削除するには、リストから [⋮] > [削除] ボタンをクリックします。
- データタスク画面で [タスク完了] ボタンをクリックした場合のみ、タスクステータスが「タスク完了」と表示されます。
- データ収集画面で既存のクエリに対するタスクを変更するには、 [開く] ボタンをクリックします。
- データ収集画面が表示され、既存のクエリに対するタスクを継続することができます。
- 当該タスクに適用された呼び出しオプションも一緒にインポートします。
データ収集ステップ
データ収集はクエリ分析、スキル呼び出し、最終回答の順で行われます。各データ収集ステップで実行するタスクについて説明します。
クエリ分析
ユーザークエリを分析し、どのスキルを使うかを決めるステップです。リクエスト単位でクエリを分離し、適切なスキルをマッピングします。2つ以上のクエリが分析される場合、スキル呼び出しも2回行われます。
スキル呼び出し
スキルを呼び出してモデルの思考をレビューするステップです。クエリ分析ステップで分離されたクエリ数に合わせてスキル呼び出しが行われます。
スキル呼び出しは3ステップで構成されます。
- Step 1: 呼び出すスキルに該当する APIを照会するステップ
- 呼び出し方法 : APIを見つけるためのモデルの思考プロセス
- 呼び出しスキル : スキルのモデル名
- API照会内容 : スキルの API Specと Description for modelの情報
- Step 2: API照会結果を確認するステップ
- API照会結果 : APIを呼び出すためのモデルの思考プロセス。API呼び出しに必要なリクエスト変数(パラメータ)を推論
- アクション : APIメソッド。requests getと requests postのみ対応
- アクション入力 : モデルが推論した URLとパラメータ。アクションによって入力フィールドが変わる
- requests_getの時にアクション入力フィールド: API URL/パラメータ
- requests_postの時のアクション入力フィールド: API URL/パラメータ(Key、Value)
- [フィールド追加] ボタンをクリックすると空きフィールドを追加で作成
アイコンをクリックするとフィールドを削除
- 呼び出し結果 : API呼び出し結果
- Step 3: 呼び出し結果を基に内容をまとめるステップ
- 思考 : 呼び出し内容をまとめるためのモデルの思考プロセス
- 結果まとめ : モデルの作成結果
requests_postの時にアクション入力フィールドに新しいパラメータを作成する場合、既存のパラメータの Keyと重複しないように設定してください。重複した Keyがある場合、APIが呼び出されないことがあります。
最終回答
最終回答を作成してレビューするステップです。最終回答が作成された後、 [タスク完了] ボタンをクリックすることでデータ収集が完了します。
呼び出しオプション作成
呼び出しオプションを作成するには、API specの operation IDに対応してヘッダと本文パラメータの特定値を固定できます。
呼び出しオプションを作成する方法は、次の通りです。
- データ収集実行プロセス中に画面右側の Setting 項目の [呼び出しオプション] ボタンをクリックします。
- 呼び出しオプション の画面が表示されます。
- 呼び出し値の入力領域に、呼び出しオプションを JSONタイプで入力します。
- 画面上部のフォーマット例を参照して作成します。
- 呼び出し値の入力に関する詳細は、詳細呼び出しオプションをご参照ください。
- 呼び出し値の入力が完了したら、 [適用] ボタンをクリックします。
- 適用に失敗すると、エラーメッセージが表示されます。呼び出し値を再度変更します。
- データ収集画面を閉じた後、 データ収集 メニューに再びアクセスした場合、呼び出しオプションが初期化されます。
- 呼び出しオプションを適用してデータを収集した後、 [初期化] ボタンをクリックしても呼び出しオプションは維持されます。
- [インポート] ボタンをクリックしてタスク履歴をインポートする場合、当該タスクに適用された呼び出しオプションもインポートします。
詳細呼び出しオプション
呼び出しオプションに作成可能なフィールドに関する情報です。
呼び出しオプションは operationsフィールド、baseOperationフィールド、ユーザークエリの順に適用されます。
| フィールド | データタイプ | 説明 |
|---|---|---|
| baseOperation | object | 当該スキルセット内に登録されたすべての APIに対して呼び出しオプションを適用 |
| baseOperation.header | map<string, string> | すべての APIの HTTP Headerに固定で追加する値 |
| baseOperation.query | map<string, string> | すべての APIの HTTP Query Parameterに固定で追加する値 |
| baseOperation.requestBody | map<string, object> | すべての APIの HTTP Request Bodyに固定で追加する値 |
| operations | list | 当該スキルセット内に登録されている APIの中から、指定された Operation IDに限って呼び出しオプションを適用 |
| operations[].operationId | string | 呼び出しオプションを適用する Operation IDを指定 |
| operations[].header | map<string, string> | 指定された Operation IDにマッピングされる APIの HTTP Headerに固定で追加する値 |
| operations[].query | map<string, string> | 指定された Operation IDにマッピングされる APIの HTTP Query Parameterに固定で追加する値 |
| operations[].requestBody | map<string, object> | 指定された Operation IDにマッピングされる APIの HTTP Request Bodyに固定で追加する値 |