Form Submissions
Agent が Request Form を使って structured information を集める時、Form Submissions が重要になります。
まだ form を使っていないなら、この page が空でも正常です。
このページの役割
自由な chat から structured intake に切り替わる時、このページが operational surface になります。
Consultation Desk では、たとえば:
- callback 用の連絡先
- 希望する follow-up 時間帯
- chat から手作業で拾い直したくない intake 情報
Operator の使い方
submission が届き始めたら、この page は運用キューになります。
- user が何を送ったか確認する
- 情報が足りているかを見る
- 正しい human workflow に渡す
通知動作を確認する
読み取り専用の通知概要は、現在のフィルターに応じて変わります。すべてのフォーム を選ぶと、ワークスペースルールの状態と通知先、および個別設定があるフォーム数が表示されます。特定のフォームを選ぶと、そのフォームがワークスペースのデフォルト、カスタム通知先、通知なしのどれを使用しているかと、実際に通知を受け取る通知先が表示されます。ワークスペース通知を管理 を選ぶと、ワークスペース通知の フォーム送信 イベントが開きます。
そこで使うルール編集画面では、ワークスペースカタログにある既存かつ互換性のある通知先だけを選択できます。フォーム回答ページには通知先の管理機能はありません。
通知先を追加、編集、テスト、確認、有効化、無効化、削除する場合は、ワークスペース通知の 通知先 タブを使います。
フォーム送信ルールでは、次の通知先を利用できます。
Slack Incoming Webhook: format された submission message を Slack channel に送ります。Slack Workflow Webhook: field を key-value payload として Slack Workflow に送ります。メール: verified email address に submission notification を送ります。
メール通知先では、運用を始める前に 通知先 から確認メールを送り、確認リンクを開いてください。メールアドレスを変更した場合は再確認が必要です。設定後はテスト通知で、通知先が動作することを確認します。
フォーム通知ルールで通知先のチェックを外して保存すると、そのルールからのルーティングは停止します。他のルールでも使われる共有通知先自体は削除されません。
Slack Workflow payload keys
各 form field は top-level payload key になります。
- field label が key になります。label が空の場合は field name を使います。
- 複数の field が同じ key になる場合、後の値が前の値を上書きします。
- Codeer は
event_type、form_name、form_request_id、submitted_at、submitted_by_external_user_id、workspace_name、workspace_id、agent_name、agent_idも追加します。
Workflow を接続する前に、Agent settings → Tools → Request Form → Open Form Builder で field に安定した一意の label を設定してください。
Identity masking は notification payload を書き換えません
Form Submission notification は、user が送信した form field を外部 destination に送り、生の submitted_by_external_user_id を含む場合があります。Mask end-user identity が保護するのは workspace UI response であり、notification payload 内の identity value は置き換えません。この end-user data の受信を許可された destination だけを使用してください。
Webhook URL は秘密として扱う
Slack webhook URL は secret です。public document、issue comment、screenshot、source code に貼らないでください。
page が空の時
空である理由は多くの場合次のどれかです。
- Agent がまだ
Request Formを使っていない - form はあるがまだ誰も起動していない
- rollout が早期段階で submission が発生していない