> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/build/system-prompt.md). # ロール指示の設計ガイド {% hint style="info" %} MaiAgent が提供する [ロール指示を生成する AI ツール](https://chat.maiagent.ai/web-chats/4b67b140-db5f-40dc-bce3-f2217e9574bd) を使って、ロール指示をより洗練させることができます。 {% endhint %} ## 🎭 「ロール指示」とは？映画を監督していると想像してみてください。俳優にどんな役を演じるのか、どんな性格なのか、どのように話すべきかを伝える必要があります。**ロール指示**とは、いわば AI に渡す「台本」であり、どのようなカスタマーサポート担当者を演じるべきかを伝えるものです。

### 📚 技術用語ミニ辞典始める前に、いくつかの重要な概念を確認しておきましょう。 **🤖 AI Agent（AI エージェント）** * **たとえ**：あなたが雇用するバーチャル従業員のようなものです * **説明**：自律的にタスクを実行できる AI システムで、カスタマーサポートの場面ではあなたのデジタルサポート担当者にあたります **💬 Prompt（プロンプト）** * **たとえ**：AI に渡す「業務マニュアル」です * **説明**：AI が何をすべきか、どのように行うべきかを伝える指示テキストです **🎯 Context（コンテキスト）** * **たとえ**：会話の「記憶」と「背景情報」です * **説明**：AI が現在の会話状況を理解するために必要な関連情報です **🔄 Token（トークン）** * **たとえ**：AI が文字を理解する「単位」で、文章を小さな塊に切り分けるようなものです * **説明**：AI がテキストを処理する際の基本単位で、処理効率とコストに影響します *** ## 🌟 なぜロール指示はこれほど重要なのか？ #### ロール指示がない AI サポート 😵 ``` ユーザー：「注文した商品がまだ届かないのですが？」 AI：「システムのデータによりますと、ご注文のステータスは処理中です。」 ``` *まるでロボットと話しているような、冷たい印象です* #### 優れたロール指示がある AI サポート 😊 ``` ユーザー：「注文した商品がまだ届かないのですが？」 AI：「ご心配な気持ち、よくわかります！すぐにご注文のステータスをお調べいたします。追跡情報によりますと、お荷物は現在配送センターにあり、明日の午後にはお届けできる見込みです。追跡番号をお伝えいたしましょうか？」 ``` *まるで本物のサポート担当者と話しているような、温かく専門的な印象です* *** ## 🏗️ ロール指示の四つの柱

#### 1. 🎭 アイデンティティの設定（Who） AI に「あなたは誰か」を伝えます。 **❌ あいまいなアイデンティティ** ``` あなたはカスタマーサポートです ``` **✅ 明確なアイデンティティ** ``` あなたは「ミミ」、MaiAgent 社のシニアカスタマーサポート担当者です。 5 年のサポート経験を持ち、製品相談と問題解決を得意としています。 ``` #### 2. 🗣️ 口調とスタイル（How） AI に「どのように話すか」を伝えます。 **口調の選び方ガイド：** * **専門的でフォーマル**：金融、法律、医療業界に適しています * **親しみやすくフレンドリー**：小売、飲食、生活サービスに適しています * **明るく若々しい**：ゲーム、エンターテインメント、ファッション業界に適しています * **温かく思いやりがある**：教育、健康、社会福祉サービスに適しています **例：親しみやすくフレンドリーなスタイル** ``` 返信の際は温かくフレンドリーな口調を使い、敬意を示すために適度に「お客様」という表現を用いてください。「ご利用いただきありがとうございます」などの親しみやすい言葉を加えてもかまいませんが、過度に熱心になりすぎたり、感嘆符を多用したりすることは避けてください。 ``` #### 3. 🎯 専門能力（What） AI に「何ができるか」を伝えます。 ``` あなたの専門能力には以下が含まれます： - 製品機能の紹介と使用ガイド - 注文照会と配送追跡 - 返品・交換ポリシーの説明 - 技術的な問題の初期診断 - アカウントと支払いに関する問題への対応対応能力を超える問題に遭遇した場合は、積極的に有人サポートへ引き継いでください。 ``` #### 4. 📋 行動規範（Rules） AI に「何をしてよいか、何をしてはいけないか」を伝えます。 ``` 必ず守るべき原則： ✅ ユーザーのプライバシーを保護し、個人情報を漏らさない ✅ 知らないことは知らないと認め、答えをでっち上げない ✅ クレームを受けた際は冷静さを保ち、まず謝罪してから解決する ✅ 返信の長さは 100 文字以内に抑え、簡潔さを保つ絶対に禁止： ❌ 実現できないことを約束する ❌ ユーザーと言い争ったり反論したりする ❌ 社内情報を漏らす ❌ 権限を超える返金申請に対応する ``` *** ## 🛠️ 実践：最初のロール指示を設計する #### ステップ 1：業務ニーズを分析する **次の問いを考えてみましょう：** * あなたの顧客は誰ですか？（年齢、職業、利用習慣） * あなたの製品・サービスの特徴は何ですか？ * 顧客が最もよく尋ねる質問は何ですか？ * 顧客にどのようなサービス体験を提供したいですか？ #### ステップ 2：適切なロール設定を選ぶ **🏪 EC サポートの例** ``` あなたは「アシスタント」、プロのオンラインショッピングアドバイザーです。すべての商品情報に精通しており、最適な製品を推薦するのが得意で、注文に関する問題を素早く処理できます。話し方は親しみやすく自然で、友人のように顧客のニーズを気にかけます。 ``` **🏥 医療サポートの例** ``` あなたは「ヘルスアシスタント」、プロの医療サービス相談員です。基礎的な医療知識を備え、受付や検査の流れなどの情報を提供できますが、医療診断のアドバイスは決して行いません。話し方は専門的で温かく、患者に安心感を与えます。 ``` #### ステップ 3：完全なロール指示を作成する **📝 ロール指示テンプレート** ``` # ロールのアイデンティティあなたは [ロール名]、[会社名] の [役職] です。 [ロールの背景と専門経験] # サービス目標あなたの主なタスクは [中核タスク] であり、 [サービス方法] を通じて顧客が [目標を達成する] のを支援します。 # 言語スタイル - 口調：[適切な口調を選ぶ] - 用語：[具体的な用語の要件] - 長さ：[返信の長さ制限] # 専門能力あなたは以下の問題に対応できます： - [能力リスト 1] - [能力リスト 2] - [能力リスト 3] # 行動規範必ず守ること： ✅ [規範 1] ✅ [規範 2] 絶対に禁止： ❌ [禁止事項 1] ❌ [禁止事項 2] # 特殊な状況への対応 [特殊な状況] に遭遇した場合は、[対応方法] してください。 ``` *** ## 🎨 応用テクニック：ロール指示をより生き生きとさせる #### 1. 🎪 個性を加える **通常版：** ``` あなたはカスタマーサポート担当者で、質問に答える役割です。 ``` **生き生きとした版：** ``` あなたは「サトシ」、好奇心にあふれたテクノロジー好きです。いつも新機能にワクワクし、わかりやすいたとえを使って複雑な技術概念を説明するのが好きで、誰もが気軽に理解できるようにします。 ``` #### 2. 🎯 状況に応じた指示状況に応じて応答の仕方を調整します。 ``` # 状況認識の指示 - 顧客が不満を表したとき：まず共感を示してから解決策を提供する - 顧客が技術的な質問をしたとき：身近なたとえを使って説明する - 顧客が購入をためらっているとき：客観的なアドバイスを提供し、無理に売り込まない - 顧客が製品を褒めたとき：感謝を伝え、他に必要なサポートがないか尋ねる ``` #### 3. 🔄 動的な調整の仕組み ``` # 会話への適応性顧客の応答に合わせてスタイルを調整してください： - 顧客がフォーマルな言葉を使う場合は、あなたもそれに合わせてフォーマルにする - 顧客が急いでいる場合は、より簡潔で効率的にする - 顧客が話好きな場合は、少し話題を広げてもよい ``` #### **4. バージョン管理に適した設計** * バージョン番号と更新履歴を加える * 後方互換性を保ち、ロール指示を更新した後も既存のフローが正しく動作することを確保する例： ``` バージョン：v1.0 # 更新日：2024年10月26日 # 更新履歴： # - 初期バージョン。基本的な製品推薦機能を提供。 # - ユーザーの好みに応じて製品を推薦。 # - 返信の口調を親しみやすく専門的に設定。 ``` *** ## 🚀 ロール指示のテストと最適化 #### フェーズ 1：基本テストよくある質問を使って、AI の応答が期待どおりかどうかをテストします。 **テスト質問の例：** * 「返品ポリシーはどうなっていますか？」 * 「注文した商品はいつ届きますか？」 * 「この製品は私に合っていますか？」 #### フェーズ 2：境界テスト極端な状況での AI のふるまいをテストします。 **境界ケースの例：** * 顧客の感情が高ぶっているとき * 答えがわからない質問に遭遇したとき * 権限を超えることを求められたとき #### フェーズ 3：継続的な最適化 **📊 データを収集する** * 顧客満足度スコア * 問題解決率 * 有人サポートへの引き継ぎ率 **🔧 調整戦略** * よくある質問に応じてナレッジベースを補強する * 顧客のフィードバックに応じて言語スタイルを調整する * 失敗事例に応じて行動規範を改善する *** ## **📝 System Prompt の長さをコントロールするテクニック** **ベストプラクティスの指針** System Prompt の理想的な長さは 500〜2000 文字（約 200〜800 tokens）の範囲に抑えるのが望ましく、一般的な最適値は 800〜1500 文字です。「簡潔さは冗長さに勝る」という核心的な原則を覚えておきましょう。指示が長すぎるとモデルに無視されやすく、短すぎると動作が不安定になる可能性があります。 **なぜ長さが重要なのか？** 第一にモデルの性能の観点です。プロンプトが長すぎるとモデルの注意が分散し、重要な指示の実行効果に影響します。第二に Context の容量の制約です。System prompt は会話の context window を占有し、ユーザーの会話スペースを圧迫します。最後にメンテナンスコストです。簡潔で構造化されたプロンプトのほうが、継続的に最適化・調整しやすくなります。 **作成の三大テクニック** 構造化された設計：明確に段落を分け、中核となる指示を最前面に配置します。簡素化の原則：重複した記述や冗長な背景を取り除き、必要なルールだけを残します。継続的な検証：異なるモデル（GPT、Claude、Gemini）に対して A/B テストを行い、最適な長さの設定を見つけます。 **実用上の注意点** AI モデルによって長いプロンプトへの耐性はそれぞれ異なるため、個別にテストして検証する必要があります。token の計算では、日本語は概ね 1 文字が 1 token に相当し、英語は 1 token が約 0.75 単語に相当します。System prompt は指示としての重みが高いため、内容を集中させ、不必要に冗長な記述を避けることをおすすめします。 *** ## 💡 よくある質問と解決策 #### Q1: AI の返信をより自然にするには？ **A:** ロール指示に具体的な会話例を加え、明確な言語スタイルのガイドを設定してください。 #### Q2: AI がいつも無関係な質問に答えてしまう場合は？ **A:** ロール指示の中でサービス範囲を明確に定義し、範囲外の質問をどのように識別して対応するかを AI に教えてください。 #### Q3: 専門性と親しみやすさをどうバランスさせるか？ **A:** 対象とする顧客層に応じて調整してください。B2B の顧客は専門性を好み、B2C の顧客は親しみやすさを好みます。A/B テストを設計して最適なバランスを見つけることができます。 *** ## 🎉 おわりに：あなた専用の AI サポートを作り上げるロール指示を設計することは、新しい従業員を育てるようなもので、忍耐と継続的な調整が必要です。次の重要な原則を覚えておいてください。 1. **🎯 明確な設定**：AI に自分が誰なのかを明確に伝える 2. **🗣️ 一貫したスタイル**：言語スタイルの統一性を保つ 3. **📋 明確な境界**：何ができて、何ができないかを明確にする 4. **🔄 継続的な最適化**：実際の利用状況に応じて絶えず改善するさあ、今すぐ最初のロール指示を設計してみましょう！最良のロール指示は、実際の利用を通じて絶えず磨き上げられていくものだということを忘れないでください。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/build/system-prompt.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.