For the complete documentation index, see llms.txt. This page is also available as Markdown.

ロール指示

最終更新:2025-11-14

概要

ロール指示(System Prompt)は、AI アシスタントの動作や回答スタイルを定義する中核的な設定です。綿密に設計されたロール指示により、AI アシスタントに特定の役割を演じさせたり、特定のルールに従わせたり、業務ニーズに合った形で質問に回答させたりすることができます。

ここには AI アシスタントのロール説明や指示を記載し、回答時に守るべきルールや SOP などを含めます。回答のたびに必ず守るべきルールとイメージしてください。要点となる部分だけを記載するようにしてください。あまりに大量のロール指示は、AI が多すぎるルールを吸収しきれず、ルールに従わない原因となる場合があります。大量の情報や、関連する質問があったときにのみ参照すればよいデータは、ナレッジベースに配置してください。

Metadata 処理の仕組み

Metadata とは

Metadata(メタデータ)は、ナレッジベースの文書を説明する付加情報です。例えば次のようなものがあります。

  • 文書の分類

  • 作成日

  • 作成者情報

  • 権限タグ

  • その他のカスタム属性

RAG(検索拡張生成)システムにおいて、Metadata は重要な役割を担い、AI アシスタントがより正確にナレッジベースの内容を絞り込み、活用するのを助けます。

Metadata 除外ロジックの最適化

MaiAgent プラットフォームは Metadata の処理ロジックを最適化し、システムがより正確にメタデータを処理できるようにしました。

最適化の内容

重複した除外ロジックの削除

以前のバージョンでは、システムが特定の Metadata key を重複してチェック・除外し、不要なパフォーマンスのオーバーヘッドが発生する場合がありました。新バージョンではこれらの重複ロジックを削除し、次のことを実現しています。

  • 処理効率の向上:重複するチェック手順を削減

  • ロジックの明確化:同一の除外ルールが繰り返し実行されるのを回避

  • 保守性の向上:コード構造がよりシンプルに

影響範囲

この最適化は主にシステム内部の Metadata 処理フローに影響します。ユーザーにとっては次のとおりです。

  • ✅ Metadata の絞り込み機能は正常に動作します

  • ✅ 検索パフォーマンスが改善されます

  • ✅ 回答の正確性は一貫して維持されます

  • ✅ 既存の設定を調整する必要はありません

ロール指示における Metadata の活用

基本的な使い方

ロール指示の中で、AI アシスタントに Metadata の使い方を指示できます。

Metadata の応用的な活用

権限管理

鮮度の管理

多言語対応

Metadata のベストプラクティス

1. 明確な Metadata 構造を定義する

標準化された Metadata 構造を構築します。

2. ロール指示で Metadata の使用ルールを明確に記載する

3. Metadata 設定を定期的に見直す

  • Metadata の分類が実際の利用ニーズに合致しているか確認する

  • 使用されていない Metadata key がないかチェックする

  • Metadata が検索パフォーマンスに与える影響を評価する

技術的な詳細

Metadata 処理フロー

パフォーマンスに関する考慮事項

  • インデックスの作成:Metadata はファイルのアップロード時にインデックスが作成されます

  • クエリ効率:単純な Metadata の絞り込みは通常ミリ秒単位で完了します

  • 複雑なクエリ:複数条件の Metadata 絞り込みには、より長い時間がかかる場合があります

システムの制限

  • 各文書につき Metadata key は 20 個以下を推奨します

  • Metadata value は短い文字列または数値の使用を推奨します

  • Metadata に大量のテキスト内容を保存することは避けてください

ロール指示の例

あなたはプロフェッショナルな XXX AI アシスタントです。

\ あなたがすべきこと(回答の強化):

  1. 明確で正確、かつ役に立つ回答を提供する

  2. フレンドリーかつプロフェッショナルな対話姿勢を保つ

  3. ユーザーの言語に合わせて回答し、日本語の場合は日本語で回答する

  4. 有害または不適切なアドバイスを提供しない

  5. ユーザーのプライバシーを尊重し、機微な情報を漏らさない

  6. 正しい日本語で回答する

  7. 文脈に応じて回答の詳細度を調整する

  8. 適切なタイミングで発展的な提案や関連情報を提供する

  9. 回答する際は、まずユーザー情報が明確に提供されているか確認し、明確であってから回答する

  10. 複雑な概念を説明する際は、適宜具体例を用いる

あなたがすべきでないこと(回答の制限):

  1. 誤った情報や未確認の主張を拡散する

  2. 偏見や差別的な発言をする

  3. 違法または不適切な内容を議論する

  4. 自分が本物の人間であるかのように振る舞う

  5. AI アシスタントの能力範囲を超える

  6. ナレッジベースの範囲外の質問には、「申し訳ございませんが、現在この質問にはお答えできません」と回答する

ロール指示テンプレート

関連リソース

Last updated

Was this helpful?