logo
Development
検索
ユーザーフォーム収集

ユーザーフォーム収集

複数の構造化情報(氏名+連絡先+注文番号……)を収集する必要があるとき、モデルは現在のチャネルでネイティブにフォームを1枚レンダリングしてユーザーに送信できます。ユーザーがチャットで自由に入力する(曖昧になりやすく、複数項目が1文に詰め込まれがち)必要はありません。

中核となる挙動:フォームは送信した時点で完了し、回答を待たない

モデルはフォームを送信した後すぐに本ターンを終了し、ユーザーの入力を待って中断状態になることはありません。通常はその直後に「上のフォームにご記入ください」と一言添えます。ユーザーが送信した内容は、次の新しいメッセージとして改めて対話に入ってきます。

つまり、フォームを送信した時点で本ターンは終了しており、ユーザーが記入して送信して初めて新しいターンがトリガーされます——これは設計であり、無反応ではありません。

表示の前提とフィールドの機能

  • フォーム収集は、現在のチャネルがネイティブフォームに対応している場合にのみモデルに表示されます。対応していないチャネルでは、モデルはプレーンテキストで1項目ずつ収集する方式に切り替えます。
  • 1枚のフォームは最大 10 フィールド、各選択フィールドは最大 10 個の選択肢で、超過分は切り捨てられます。
  • 添付ファイルフィールド:ユーザーに画像、請求書、証明書などをアップロードさせられます(許可するファイルタイプと、数量 1〜9 個を設定可能)。
  • フォームのタイトルと説明は、モデルが対話言語に合わせてその場で生成します。バックエンドでの事前設定ではないため、言語によって文言が異なり、バックエンドで「フォームの文言を変更する」こともできません
  • フォームのトリガータイミングを制御したい場合は、ペルソナで @ 指令によってフォーム収集ツールを呼び出し、いつフォームを送信するか、どのフォームフィールドを送信するかを制御するプロンプトを追加できます。

チャネルによる違い

チャネル フォーム体験
Web ファミリー(Web サイト/共有ページ/埋め込み/Widget/デバッグ) チャット内に複数フィールドのフォームカードを直接表示
LiveDesk ネイティブフォームを送信
Telegram、LiveChat ボタンを押してホスト型フォームページを開いて記入
WhatsApp およびその他の未対応チャネル テキストへのフォールバック:モデルがプレーンテキストで1項目ずつ収集する方式に切り替え
  • 現在すべてのチャネルでフォーム全体を一度に記入する方式で、「フィールドごと」の体験はありません。
  • チャネルがフォームに対応していない場合、モデルは自動的にテキストへフォールバックし、開けないデッドリンクを送ることは決してありません。

添付ファイルの切り分け

  • 顧客が画像/ファイルをアップロードしたのに、エージェントが内容を読めない:まずエージェントのマルチモーダル入力設定で該当カテゴリ(画像/ドキュメントなど)が有効になっているか、また添付ファイルフィールドで許可されているタイプがそれをカバーしているかを確認してください。そうでないと、添付ファイルはリンクの形でしか入らず、モデルは実際に画像認識やファイル読み取りを行いません。
  • Telegram/LiveChat のホスト型ページ:ポップアップしたフォームページでできるだけ早く送信してください(通常は数秒で完了します)。間隔が空きすぎてから送信すると、添付ファイルがプレーンテキストとして処理される可能性があります。