スキルトレーナー FAQ

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

Classic/VPC環境で利用できます。

スキルトレーナーを使用する際に発生し得る問題と解決方法について説明します。

シナリオ

Q. スキルデータ領域で値を変更すると、次の Stepが消えます。どうすれば呼び出せますか?
A. スキルデータ領域の値を変更した後、 [適用] ボタンをクリックしてください。スキルデータの値(思考、アクション、アクション入力)変更時、スキルデータ領域の監視値とプランニングデータ領域の値が初期化されるのは正常であり、 [適用] ボタンをクリックすると変更された値に基づいて作成結果を再度取得し、次の Stepが再作成されます。

Q. ユーザークエリをアクション入力値(URL)に変換する過程で、言語モデルがパラメータをうまく作成できません。意図した通りにアクション入力値を作成するには、どのように設定すればよいですか?
A. API Specでパラメータの"description"に例を追加してください。例があれば、言語モデルが API Specに基づいてユーザークエリを理解し、正しいパラメータを備えた URLを作成できます。
作成例)

{
    "keyword": {
        "type": "string",
        "description": "修飾語を意味し、連体修飾語と連用修飾語の形です。例) 親切な、満足な、良い",
    },
    "review": {
        "type": "string",
        "description": "肯定否定の選考度。例) pos、negいずれかの値"
    }
}

Q. スキル作成後にシナリオを収集しようとすると、不可との通知が表示されます。どうすれば解決できますか?
A. スキルが「タスク完了」状態であるかご確認ください。
スキルが「タスク完了」状態になるためには、以下の条件を満たす必要があります。

• 必須情報をすべて入力
• API Spec検証完了
• スキル名の重複確認完了

Q. シナリオタスク中にエラーが発生しました。ログはどのように確認できますか?
A. タスク中にエラーが発生した場合は、以下の情報を添えてお問い合わせください。解決方法をご案内いたします。

• エラー画面(スクリーンショット)
• スキルセット
• スキル情報

Q. ユーザークエリを入力して ** [実行] ボタンをクリックしましたが、プランニングデータが作成されません。どうすれば解決できますか?**
A. モデルがスキルの API Specまたは Manifestを正しく理解していない場合、プランニングデータが作成されないことがあります。もし API Specと Manifestの情報を英語で作成した場合は、韓国語で再作成し、スキル情報を変更してください。

スキルチューニング

Q. チューニングしたスキルセットを再チューニングすると、既存のチューニングモデルは削除されますか?
A. 既存のチューニングモデルは削除されず、チューニングしたモデルが追加で作成されます。

Q. スキルセットをチューニングする場合、何個のシナリオを作成するのが良いですか? 性能を保証する最小シナリオと最大シナリオ数が知りたいです。
A. スキルセット1つにつき50個から100個程度のシナリオを作成することをお勧めします。チューニング項目ごとの最小シナリオ数は、次の通りです。APIの複雑度によって必要なシナリオの数は異なる場合があります。

Q. スキルデータ領域を変更してチューニングしましたが、チューニング結果がうまく適用されません。
A. モデルの理解度を高めるために API Specでチューニングの対象となるオブジェクトの descriptionを具体的に作成することをお勧めします。スキル管理で作成例をご参照ください。ご参考までに、変更した API Specを適用するには、シナリオ収集を再実行する必要があります。

Q. スキルセットをチューニングするために ** [タスク作成] ボタンをクリックしましたが、作成したスキルセットがリストにありません。**
A. スキルが「タスク完了」状態であるかご確認ください。タスク完了状態のスキルのみをチューニングできます。

Q. スキルセットをチューニングするには、何個のシナリオが必要ですか?
A. スキルセットをチューニングするには、「タスク完了」状態のシナリオが1つ以上必要です。ただし、スキルセットの性能を上げるために、より多くのシナリオを収集することをお勧めします。

Q. 9個のシナリオでチューニングされたモデルを選択し、1個のシナリオを再チューニングすると、10個のシナリオが反映されたチューニングモデルが作成されるのですか?
A. その通りです。チューニングをリクエストした時点で「タスク完了」状態のシナリオがすべてチューニング対象になるので、10個のシナリオがすべて反映されたチューニングモデルが作成されます。

スキルセット

Q. マルチスキルシナリオでは、最大何個のスキルを使用できますか?
A. マルチスキルシナリオで使用できるスキルは、最大2つまでです。3つ以上のスキルを使用する場合には、言語モデルの性能を保証することはできません。

Q. 1つのスキルセットに何個のスキルを作成できますか?
A.数に制限はありませんが、円滑な利用のために最大4つまで作成することをお勧めします。

スキル

Q. スキル Endpoint URLに入力するポートは決まっていますか?
A. ポートの制限はありません。Endpointに関する通信不具合やモデルの性能不具合でエラーが発生することがあります。引き続き問題が発生する場合は、画面をキャプチャしてお問い合わせください。

API Spec

Q. API Specで descriptionを英語で書いてもいいですか?
A. 英語で作成することも可能です。しかし、モデルの性能を最大限に活用するために、韓国語で作成することをお勧めします。

Q. スキルの Endpoint URLは httpsのみサポートしますか?
A. Endpoint URLは httpと httpsのいずれもサポートします。

Q. API呼び出し時に URLを path方式で構成してもいいですか?
A. API URLは argument方式で構成することをお勧めします。スキルモデルに使用される学習データはすべて argument方式なので、path方式で構成するとモデルの性能を保証することはできません。

Q. パラメータの descriptionにはどのような内容を書けばよいですか?
A.パラメータの descriptionには例を書いてください。例があれば、モデルが descriptionに作成された例に基づいて、より正確なアクション入力値を作成できます。

{
    "date": {
        "type": "string",
        "description": "基準日を意味します。形式は yyyymmddを使用します。例) 20230101、20231121、20210403"
    }
}

Manifest

Q. Multi-path APIがうまく動作するためには、Description for modelをどのように作成すればよいですか?
A. Description for modelは、1つのスキル内に複数の pathがある場合、ユーザークエリに適切な pathを選択するための情報として使用されます。そのため、pathごとのロールについて詳しく作成する必要があり、pathごとに検索されるキーワードを作成する必要があります。
次のように path情報と parameter情報を分離して明示すると、言語モデルの性能を向上させることができます

• ドリンク照会スキル: ドリンクを照会するときは、/sample_api/beverageを使用してください。この APIはドリンク名を検索キーワードとして入力するとうまく動作します。
• 酒類照会スキル: 酒類を照会するときは、/sample_api/liquorを使用してください。この APIは酒類名を検索キーワードとして入力するとうまく動作します。
• 割引アイテム照会スキル: 日別割引アイテムを照会するときは、/sample/eventを使用してください。この APIは日付を検索キーワードとして入力すると動作し、検索日は必ず yyyymmdd形式で入力してください。