Request Formツール

Request Formツール（フォームツール）により、Agentは会話中にユーザーに構造化フォームの入力を案内し、特定の情報を収集できます。

使用するタイミング

特定のフォーマットの情報を収集する必要がある場合
ユーザーが必須フィールドを提供することを確保したい場合
標準化された要件収集プロセスを確立したい場合

使用シナリオ例

シナリオ	フォーム内容
バグレポート	環境情報、再現手順、エラーメッセージ
要件収集	機能説明、優先度、期待タイムライン
カスタマーサービスチケット	問題タイプ、連絡先、問題の説明
予約申請	日付、時間帯、人数、特別な要望

設定手順

ステップ1：フォームツールを追加

Toolsセクションで「ツールを追加」をクリックし、ツールセレクターを開き、「フォームツール」グループから「フォームツール」を選択します。

ステップ2：フォーム構造を設計

追加したばかりのフォームツールをクリックし、「フォームエディタ」ボタンをクリックしてフォーム構造を設計します。

フォームエディタは以下の機能を提供します：

フィールドの追加/削除：フィールドを動的に追加または削除可能
フィールド順序の調整：ドラッグしてフィールドの表示順序を調整可能
フィールドプロパティの設定：各フィールドで名前、質問テキスト、必須/任意、デフォルト値などを設定可能
データフィールド名の設定（オプション）：各フィールドでオプションの英語ラベルを設定でき、エクスポートされたデータファイルで使用して後続のデータ分析に役立てることができます（例：「氏名」の質問で、エクスポートまたはデータ分析のフィールド名としてnameを設定）

利用可能なフィールドタイプ

タイプ	説明	例
短いテキスト	1行テキスト入力	氏名、メール
長いテキスト	複数行テキスト入力	問題の説明、備考
数字	数値入力	数量、金額
ドロップダウン	単一選択リスト	問題タイプ、優先度
ラジオボタン	単一選択ボタン	はい/いいえ、同意/不同意
チェックボックス（複数選択）	複数選択チェックボックス	適用機能、好みのオプション
日付	日付選択	期待日、誕生日

ステップ3：必須と任意を設定

フォームエディタで、どのフィールドが必須かをマークします。

ステップ4：「When to Use」の設定

Agentにこのフォームをいつ使用するかを伝えます。

例：

ユーザーが問題やバグを報告したい場合は、このフォームを使用して情報を収集してください。
フォームを表示する前に、なぜこれらの情報が必要かを簡単に説明してください。
フォームの入力完了後、情報を確認して次のステップを通知してください。

ユーザーが購入の意向を示したり見積もりを希望したりする場合は、このフォームを使用して要件仕様を収集してください。
フレンドリーなトーンでユーザーに入力を案内し、各フィールドの目的を説明してください。

ステップ5：追加を確認

確認をクリックすると、ツールがToolsリストに表示されます。

フォーム入力プロセス

ユーザーに表示されるプロセス：

Agentが情報を収集する必要があると判断
Agentが理由を説明し、フォームを表示
ユーザーがフォームに入力
Agentが受け取った情報を確認
Agentが情報に基づいて会話を続ける

ツールリスト表示

追加されたRequest Formツールは「ツール」セクションの「フォームツール」グループに表示され、各ツールには次のものが表示されます：

フォームタイトル（設定されていない場合は「Untitled Form」を表示）
展開して詳細設定を表示可能（「When to Use」とフォームエディタを含む）
削除ボタンをクリックしてツールを削除可能

「フォームエディタ」をクリックすると、いつでもフォーム構造を変更できます。

フォームデザインのコツ

適度なフィールド数

少なすぎる：情報が不完全
多すぎる：ユーザーが入力を放棄
推奨：5〜10フィールド

正しいフィールドタイプを使用

固定オプション → ドロップダウンまたはラジオボタン
自由入力 → 短い/長いテキスト
明確な数値 → 数字

合理的なフィールド順序

簡単な質問を最初に
関連する質問を一緒に
必須項目を明確にマーク

ベストプラクティス

Agentの「Core Instruction」と併用

Agentの「Core Instruction」でフォームの目的を説明します：

## 情報収集
バグレポート情報を収集する必要がある場合：
1. まずユーザーのレポートに感謝を表明
2. 処理を支援するためにいくつかの情報が必要であることを説明
3. バグレポートフォームを表示
4. 受領を確認し、処理時間を説明

フォーム後のフォローアップアクション

「When to Use」で説明します：

フォーム完了後：
- 受け取った情報を整理
- チケット番号を生成（必要に応じて）
- ユーザーに予想処理時間を通知
- 追跡方法を提供

フォームのテスト

追加後、プロセスをテストします：

フォームをトリガーすべき発言をする（例：「問題を報告したい」）
フォームが正しく表示されることを確認
テストデータを入力
Agentが正しく受信して応答することを確認

よくある質問

ユーザーはフォームをスキップできますか？

はい。ユーザーはフォームを無視して会話を続けることができます。Agentの「Core Instruction」でこの状況を処理することをお勧めします。例えば、会話を通じて1つずつ質問する方法に切り替えるなど。

フォームデータはどこに保存されますか？

フォームデータは会話履歴の一部となり、CodeerのAgentバックエンドでフォーム回答結果を表示することもできます。

複数のフォームを持つことはできますか？

はい、複数のRequest Formツールを追加でき、それぞれ異なるフォーム構造とトリガー条件を持つことができます。例：「バグレポートフォーム」と「要件提出フォーム」。

フィールドにデフォルト値を設定できますか？

現在、デフォルト値はサポートされていませんが、フィールドの説明に例を提供できます。

次のステップ

Knowledge Base - データソースを接続
Call Agent - タスクを分担
ツール概要に戻る