機能設定

対話プラットフォームの機能設定について説明します。基本機能、AI インタラクション機能、Hook 処理マーカー、ツール表示モード、質問オプション表示モード、AI の認識設定（システム時刻、送信者名、位置情報を回答に利用）、タイムゾーンの規則を扱います。

機能設定は、対話プラットフォームの設定ページで最も多くのスイッチがある項目です。ユーザーが対話中に「何をできるか、何を見られるか」、AI が回答時に「何を把握しているか」を決めます。Web と API プラットフォームには 6 つのセクションがすべてあります。内部プラットフォームには「質問オプション表示モード」がありません。LINE や Microsoft Teams などのメッセージングプラットフォームには、OCR を有効化と「AI の認識設定」だけがあります。

これらの設定はAI エージェントではなく、各対話プラットフォームに紐づきます。同じエージェントを Web と LINE の両方に接続する場合は、それぞれのプラットフォームで設定してください。設定ページの全体構成と開き方については、対話プラットフォーム設定の概要を参照してください。

1. 利用する場面

あるクリニックでは、LINE 上の AI エージェントで予約に関する質問に答えています。患者が「今日の午後はまだ予約できますか」と尋ねると、エージェントは「今日は何月何日ですか」と聞き返しました。担当者は LINE プラットフォームの機能設定を開き、システム時刻を回答に利用をオンにして、タイムゾーンを Asia/Taipei のままにし、保存をクリックします。もう一度尋ねると、エージェントは「今日は金曜日です。午後の診療は 14:00 に始まり、まだ予約できます」と直接答えます。エージェントのロール指示は一文字も変更していません。

2. 基本機能

Web プラットフォームの機能設定：「基本機能」の最終行には「対話の引き継ぎを有効化」と「コンテキスト使用量を表示」があります

スイッチ	説明
有効化	オフにすると、このプラットフォームは外部向けのサービスを停止し、ユーザーは対話ページからメッセージを送れなくなります
ファイルのアップロードを許可	ユーザーは対話中に画像やファイルをアップロードして、AI に分析させることができます
対話の共有を許可	ユーザーは対話の共有リンクを生成できます
文字サイズの変更を許可	対話ウィンドウに文字サイズの切り替え機能を表示します
対話の引き継ぎを有効化	MaiAgent で対話の引き継ぎが全体で有効になっている場合、このプラットフォームの Web Chat では、コンテキスト使用量が 80% に達すると引き継ぎの案内バーが表示され、引き継ぎ用の要約カードを生成できます。全体のスイッチは管理画面にはないため、MaiAgent にお問い合わせください。全体で有効になっていなければ、このスイッチをオンにしても画面上の変化はありません。初期設定はオフです
コンテキスト使用量を表示	このプラットフォームの Web Chat で、入力欄の下にコンテキスト使用量の割合を表示します。対話の引き継ぎとは独立しており、どちらか一方だけを有効にできます。初期設定はオフです

対話の引き継ぎを有効化とコンテキスト使用量を表示は、Web と API プラットフォームにのみ表示されます。内部プラットフォームの設定ページには、この 2 つのスイッチはありません。MaiGPT では設定は不要です。コンテキスト使用量は常に表示され、対話の引き継ぎは全体のスイッチだけに従います。対話中の実際の動作については、対話の引き継ぎを参照してください。

3. AI インタラクション機能

スイッチ	説明
引用文書を表示	AI の回答で参照したナレッジベースの情報源を列挙します。ユーザーは引用をクリックして文書の抜粋を確認できます
引用文書のダウンロードを許可	ユーザーは引用されたファイルをダウンロードできます
OCR を有効化	アップロードされた画像の文字を認識し、AI がスクリーンショットやスキャン文書の内容を読めるようにします
思考過程を表示	対話中に AI の推論過程を表示します
ユーザーによる推論の深さの調整を許可	ユーザーが対話ウィンドウで AI の推論の深さを調整できます

「引用文書を表示」と「引用文書のダウンロードを許可」をオンにした対話画面

引用情報を公開するかどうかは、用途に応じて決めてください。一般向けのカスタマーサポートでは、すべての引用を表示して信頼性を高められます。社内サポートでは、機密文書を守るためにダウンロードを無効にできます。教育機関では、学生が参照できる学習資料を表示できます。

4. Hook 処理マーカー

Hook 処理マーカーを表示をオンにすると、メッセージが Hook で処理されたとき（機密情報のマスキングなど）、対話中にマーカーが表示されます。マーカーの文言はカスタマイズできます。Hook 自体の設定については、Hook によるメッセージのインターセプトを参照してください。

5. ツール表示モード

AI がツール（MCP、API）を呼び出したとき、対話ウィンドウにどの程度の情報を表示するかを、3 枚のカードから選びます。

モード	対話中の表示
詳細	ツール名を表示し、展開すると入力パラメータと応答結果を確認できます
簡易	ツール名と実行状態だけを表示します
非表示	ツールの実行情報を表示しません

ツール表示モードは 3 つから 1 つを選びます

個別のツールの「表示文言」タブにも表示モードがあります。対話プラットフォームの設定に従うか、そのツールに詳細、簡易、非表示のいずれかを指定できます。ツールメッセージ表示のカスタマイズを参照してください。ツールの実行中に表示される文言と待機アニメーションは、応答待機スタイルで設定します。

6. 質問オプション表示モード

AI エージェントに組み込みのAgent UI 質問ツールを設定すると、対話中にユーザーへ質問を提示できます。たとえば「どのトピックについて知りたいですか」と尋ねて複数の選択肢を示し、選ばれた回答に沿って対話を進めます。このセクションでは、Web Chat に選択肢をどう表示するかを決めます。2 枚のカードから 1 つを選び、ページ全体の保存をクリックします。

モード	対話ウィンドウでの表示
フローティングボタン	選択肢が入力欄の上にボタンの列として表示され、入力欄はそのまま使えます。ユーザーが直接入力して送信すると、選択肢は無視されます
選択肢パネル	選択肢のパネルが入力エリアを覆います。ユーザーが回答するかパネルを閉じると、入力欄に戻ります

質問オプション表示モード：2 枚のカードにサムネイルが表示され、選択内容はページ全体と一緒に保存されます

カスタマーサポートの責任者が設定したエージェントは、対話の冒頭で訪問者に「製品機能」「料金プラン」「技術サポート」からトピックを選ぶよう求めます。公開後、ある訪問者から「質問を直接入力したいのに、選択肢パネルが入力欄を隠している」との声がありました。責任者はその Web プラットフォームの機能設定を開き、「質問オプション表示モード」でフローティングボタンを選んで保存をクリックします。訪問者が対話ウィンドウを開き直すと、選択肢は入力欄の上のボタン列になります。パネルを閉じることなく、選択肢をクリックするか自由に入力できます。

初期設定は「選択肢パネル」で、新規と既存のプラットフォームのどちらも同じです。フローティングボタンを使う場合は、手動で切り替えてください。この設定は Web と API プラットフォームの Web Chat 表示だけに影響します。内部プラットフォームのテスト対話では常に選択肢パネルを使用するため、設定ページにこのセクションは表示されません。

エージェントに質問させる：ロール指示の例

エージェントに対話中に質問させるには、AI 機能 → AI エージェントのツールタブで、組み込みのAgent UI 質問ツールを設定します。各質問で使えるフィールドはツールから AI に伝えられます。ロール指示には、いつ質問するか、何を質問するか、自由入力を許可するかの 3 点を書くだけです。管理画面に「その他を許可」のスイッチはありません。これらはロール指示で決まり、AI が質問するたびに設定を含めます。

各質問で使えるフィールド：

フィールド	用途	省略した場合
label	質問文	必須
options	選択肢の一覧。2～5 個を推奨します	必須
multi_select	複数選択を許可します	単一選択になります
allow_other	「その他」の自由入力を許可します。選択肢パネルには「その他」の入力欄が追加され、フローティングボタンでは入力欄のプレースホルダーが「その他の回答を入力」に変わります	選択肢からのみ回答できます
skippable	false にすると回答必須になります。選択肢パネルには「スキップ」ボタンが表示されず、Esc キーも無効になります	スキップできます

例 1：要望が曖昧なときに確認する（単一選択）

ロール指示の抜粋

ユーザーの質問が複数のプランに当てはまり、どのプランについて答えるべきか判断できない場合は、推測せずに Agent UI 質問ツールで確認してください。
たとえば、ユーザーが「プランについて知りたい」と言ったら、「どのプランについて知りたいですか」と質問し、「スターター」「プロフェッショナル」「エンタープライズ」を選択肢にしてください。
一度に出す質問は最大 2 問、各質問の選択肢は 2～5 個にしてください。回答を受け取ったら直接答え、同じ質問を繰り返さないでください。

例 2：「その他」と複数選択を許可する

ロール指示の抜粋

ユーザーの業種を尋ねるときは「金融」「小売」「製造」を選択肢にし、「その他」の自由入力を許可してください（allow_other を true に設定）。
関心のある機能を尋ねるときは複数選択を許可し（multi_select を true に設定）、選択肢を「ナレッジベース」「ワークフロー」「多言語対応」「API 連携」にしてください。

例 3：対話の冒頭で一度だけ質問する

ロール指示の抜粋

対話の最初の応答で Agent UI 質問ツールを使い、「どのトピックについて知りたいですか」と質問してください。選択肢は「製品機能」「料金プラン」「技術サポート」にしてください。
ユーザーが「もう一度選ぶ」と言わない限り、その後は自発的に質問しないでください。

例 4：回答必須の質問（スキップ不可）

ロール指示の抜粋

クイズの各問題には必ず回答してもらってください（skippable を false に設定）。
ユーザーが選択肢を選ばずに直接入力したり、質問を閉じたりした場合は、回答が必要であることを一文で伝え、同じ質問を再度提示してください。

skippable: false が影響するのは、選択肢パネルの「スキップ」ボタンと Esc キーだけです。ユーザーは ✕ を押してパネルを閉じることができます。フローティングボタンにはスキップボタンがなく、直接入力すると選択肢を無視したことになります。そのため、回答を必須にするには、例 4 のように「回答しなければ同じ質問を出し直す」とロール指示に明記し、エージェントに確認させてください。

上記の指示に従って AI が生成する質問は次のようになります（AI が自動的に組み立てるもので、確認用です。ロール指示には記載しません）。

例 2 の最初の質問

{ "id": "industry", "label": "あなたの業種は？", "options": ["金融", "小売", "製造"], "allow_other": true }

ユーザーが回答すると、Web Chat は「Q: 質問」「A: 回答」の形式で送信します。複数選択は「、」でつながれ、自由入力した「その他」の回答も同じ形式になります。回答に応じて処理を分ける場合は、ロール指示でこの形式を使って判断してください。

ロール指示や質問文に「スキップを押す」「パネルを閉じる」と書かないでください。フローティングボタンモードには、その 2 つのボタンがありません。ユーザーが直接入力して送信すると選択肢を無視したことになります。質問で allow_other が有効な場合、入力した内容は「その他」の回答として扱われます。

7. AI の認識設定

AI の認識設定を使うと、AI エージェントは回答時に「現在の時刻」「対話相手」「相手の場所」を把握できます。有効にすると、システムが各応答の前に対応する情報を AI のコンテキストへ自動的に追加します。ロール指示を変更したり、別のツールを連携したりする必要はありません。3 つのスイッチはプラットフォームごとに設定します。エージェントの作成時に自動生成される Web、内部、API の 3 つのプラットフォームでは、いずれも初期設定はオフです。

スイッチ	AI が把握する情報	適した場面	対応プラットフォーム
システム時刻を回答に利用	現在の日付、時刻、曜日、タイムゾーン	「今日は何日？」「今何時？」「まだ営業していますか？」「3 日後は何曜日？」	すべてのプラットフォーム
送信者名を回答に利用	対話相手の名前	顧客を名前で呼ぶ、挨拶を個別化する	すべてのプラットフォーム
位置情報を回答に利用	ユーザーが共有した座標	「一番近い店舗は？」「近くにサービス拠点はありますか？」	Web、内部、API、LINE

システム時刻を回答に利用

AI の認識設定セクションまでスクロールし、システム時刻を回答に利用をオンにします。Web と内部プラットフォームでは、オンにすると「タイムゾーンの自動検出」が表示されます。タイムゾーンはユーザーのブラウザーから取得されるため、手動設定は不要です。

Web プラットフォーム：オンにすると「タイムゾーンの自動検出」が表示され、ユーザーのブラウザーのタイムゾーンを使用します

API や LINE などのメッセージングプラットフォームでは、オンにするとタイムゾーンのドロップダウンが追加されます。その下に、そのタイムゾーンの現在時刻が即時表示され、確認できます。初期設定は Asia/Taipei（台北時間、UTC+8）で、検索して別のタイムゾーンに切り替えられます。

API プラットフォーム：タイムゾーンを手動で選び、そのタイムゾーンの現在時刻を下で確認します

タイムゾーンの決まり方

追加される時刻はユーザーのタイムゾーンに換算されます。タイムゾーンの取得元はプラットフォームによって異なります。

プラットフォーム	タイムゾーンの取得元	手動設定は必要？
Web、内部	ユーザーのブラウザーから自動取得し、各メッセージに付けます	不要です。画面に「タイムゾーンの自動検出」が表示されます
API	呼び出し元がメッセージの metadata に timezone を指定します（IANA 形式、例：America/New_York）。指定がなければ、プラットフォームのタイムゾーン設定を使います	タイムゾーンが指定されない場合の初期値として設定することを推奨します
LINE、Microsoft Teams、Slack、Email などのメッセージングプラットフォーム	常にプラットフォームのタイムゾーン設定を使います	必要です。海外ユーザーが中心の場合は、対象地域のタイムゾーンに変更してください

メッセージングプラットフォームでは各ユーザーのタイムゾーンを取得できません。そのため、1 つの LINE プラットフォームで複数の国のユーザーに対応する場合、AI は固定された 1 つのタイムゾーンでしか回答できません。複数地域のユーザーがいる場合は、地域ごとにプラットフォームを作成することを推奨します。

API 連携でメッセージにタイムゾーンを含める例：

{
  "message": {
    "content": "今何時ですか？",
    "metadata": { "timezone": "America/New_York" }
  }
}

タイムゾーンの文字列が無効な場合、API はリクエストを拒否し、検証エラーを返します。

送信者名を回答に利用

オンにすると、AI は相手の名前を把握し、適切なときに名前で呼びかけます。名前はその対話の連絡先から取得されます。これはカスタマーサポート対話 → 連絡先に表示される名前です。メッセージングプラットフォームではユーザーの表示名から自動的に作成され、Web プラットフォームではログインユーザーまたは対話前フォームの入力情報から取得されます。連絡先に名前がない場合、AI は通常どおり回答します。

位置情報を回答に利用

オンにすると、AI はユーザーの座標を使って、最寄りの店舗を勧めるなど、位置に合わせた回答を提供します。Web 対話ウィンドウではブラウザーに位置情報の使用許可を求め、座標をメッセージに含めます。API プラットフォームでは、呼び出し元がメッセージの metadata に latitude と longitude を含めます。このスイッチは現在、Web、内部、API、LINE プラットフォームで利用できます。

8. よくある質問

Q：「システム時刻を回答に利用」をオンにしても、AI が日付を間違えます。

まず、ユーザーが実際に使用しているプラットフォームでスイッチをオンにしたか確認してください。たとえば LINE で問題が起きる場合、Web ではなく LINE のスイッチをオンにします。次に、メッセージングプラットフォームのタイムゾーン設定が正しいか確認してください。

Q：ロール指示に「今日は○月○日」と書く必要がありますか？

必要ありませんし、推奨もしません。時刻はシステムが応答ごとに自動的に追加します。ロール指示に日付を固定して書くと、AI に矛盾する 2 つの日付が渡されるおそれがあります。

Q：AI は外部サービスを呼び出して時刻を調べますか？

呼び出しません。時刻はプラットフォームのサーバー時計から取得し、対応するタイムゾーンに換算して AI に直接提供します。外部 API は呼び出しません。

Q：サマータイムは自動的に処理されますか？

はい。タイムゾーンは IANA 名（例：America/New_York）で設定され、サマータイムの切り替えはシステムが自動的に換算します。

Q：このタイムゾーンは「有人対応への切り替え設定」の営業時間のタイムゾーンと同じですか？

別々の設定です。ここでのタイムゾーンは AI の回答に使います。有人対応への切り替え設定の営業時間には独自のタイムゾーンがあり、担当者の勤務時間の判定に使われます。

Q：「ツール表示モード」でツールカードを非表示にしても、AI はツールを使いますか？

はい。「非表示」は対話中のツール実行エリアを隠すだけで、ツールを無効にはしません。AI に特定のツールを呼び出させたくない場合は、AI エージェントの「ツール」設定からそのツールを外してください。