チャットのウィジェットコードと非公開の指示: 効果的なシステムプロンプトの書き方

2つのチャットウィジェットが同じ1行の埋め込みコードを使いながら、まったく違う振る舞いをすることがあります。違いを生むのは、システムプロンプトとも呼ばれる非公開の指示です。指示はウィジェットと一緒にサーバーに保存され、会話のたびに送られ、訪問者に表示されることはありません。

指示の置き場所

ウィジェット でチャットウィジェットを開き、動作 までスクロールします。指示欄には最大4,000文字まで入力できます。指示はサーバーに残るため、ページを調べる訪問者に見えるのはscriptタグ内のウィジェットIDだけです。

<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>

指示の変更は次のメッセージから反映されます。サイトのコードを更新する必要はありません。

うまく機能する構成

良い指示は、モデルに対して4つの問いに答えます。

1. あなたは誰か？ 「あなたはアウトドア用品のオンラインストア、Northwindのアシスタントです。」
2. 何を知っているか？ 配送日数、返品ルール、営業時間、製品ラインなど、大事な事実を貼り付けます。モデルの正確さは、与えた事実の正確さを超えません。
3. 何を避けるべきか？ 「割引を約束しないでください。医療や法律に関する助言はしないでください。確信がなければそう伝え、お問い合わせページを案内してください。」
4. どんな話し方をするか？ 「2〜3文の短い文で答えてください。訪問者の言語を使ってください。」

ルールは1つずつ短く具体的に書きましょう。長くあいまいな段落は、短いリストよりもモデルが従いにくくなります。

訪問者になったつもりでテストする

エディターのプレビューは未保存の指示で実際にリクエストを送るので、素早く改善を重ねられます。

• サポート窓口に最もよく届く質問を5つ聞いてみましょう。
• 指示に書いていないことを聞き、ウィジェットが「わからない」と認めるか確認しましょう。
• 割引コードを求めるなど、ルールを破らせようとしてみましょう。

各ラウンドのあとに指示を調整します。ちょっとした言い回しの変更で、たいていの問題は解決します。

ブランドの一貫性を保つ

チャットウィジェットはホワイトラベルです。ロゴも「powered by」の表記もありません。タイトル、あいさつメッセージ、プレースホルダー、ボタンの文言、エラーメッセージを自社の言葉で設定し、アクセントカラー、角の丸み、テーマをサイトに合わせましょう。空欄のテキストには、アカウントの言語の既定値が使われます。

指示と上限を組み合わせる

指示は回答を形づくりますが、予算の代わりにはなりません。最大応答長 (トークン) で上限を設定して回答を短く保ち、ウィジェットを動かすAPIキーを選びましょう。そのキーの1日の利用上限と許可するモデルが訪問者のすべてのリクエストに適用され、独立した2つ目の安全網になります。

まずは ウィジェットページ で下書きを作り、ダッシュボード で仕上げましょう。