Request Form 工具

表單工具（Request Form）讓 Agent 可以在對話中引導用戶填寫結構化表單，收集特定資訊。

什麼時候使用

需要收集特定格式的資訊
確保用戶提供必要欄位
建立標準化的需求收集流程

使用情境範例

情境	表單內容
Bug 回報	環境資訊、重現步驟、錯誤訊息
需求蒐集	功能描述、優先級、期望時程
客服工單	問題類型、聯絡方式、問題描述
預約申請	日期、時段、人數、特殊需求

設定步驟

步驟 1：新增表單工具

在 Tools 區塊點擊「新增工具」，開啟工具選擇器，在「表單工具」分組中選擇「表單工具」。

步驟 2：設計表單結構

點擊剛剛新增的表單工具，再點擊「表單編輯器」按鈕，設計表單結構。

表單編輯器提供以下功能：

新增/刪除欄位：可以動態添加或移除欄位
調整欄位順序：可以拖曳調整欄位的顯示順序
設定欄位屬性：每個欄位可以設定名稱、問題文字、必填/選填、預設值等
設定資料欄位名稱（選填）：每個欄位可以設定一個選填的英文標籤，用於匯出資料的檔案中，以便後續分析資料（如在「姓名」的問題，設定 name 作為匯出或分析資料的欄位名稱）

可用欄位類型

類型	說明	範例
短文字	單行文字輸入	姓名、Email
長文字	多行文字輸入	問題描述、備註
數字	數值輸入	數量、金額
下拉選單	單選清單	問題類型、優先級
單選	單選按鈕	是/否、同意/不同意
核取方塊（多選）	複選方塊	適用功能、偏好選項
日期	日期選擇	期望日期、生日

步驟 3：設定必填與選填

在表單編輯器中，標記哪些欄位是必填的。

步驟 4：設定「調用指示」（When to Use）

告訴 Agent 何時使用這個表單。

範例：

當用戶想要回報問題或 Bug 時，使用這個表單收集資訊。
在顯示表單前，先簡短說明為什麼需要這些資訊。
表單填寫完成後，確認資訊並告知後續處理流程。

當用戶表達購買意願或想要報價時，使用這個表單收集需求規格。
用友善的語調引導用戶填寫，解釋每個欄位的用途。

步驟 5：確認新增

點擊確認，工具會出現在 Tools 列表中。

表單填寫流程

用戶看到的流程：

Agent 判斷需要收集資訊
Agent 說明原因，顯示表單
用戶填寫表單
Agent 確認收到的資訊
Agent 根據資訊繼續對話

工具列表顯示

已添加的 Request Form 工具會顯示在「工具」區塊的「表單工具」分組中，每個工具顯示：

表單標題（如果未設定則顯示「Untitled Form」）
可展開查看詳細設定（包括「調用指示」（When to Use）和表單編輯器）
可點擊刪除按鈕移除工具

點擊「表單編輯器」可以隨時修改表單結構。

設計表單的技巧

欄位數量適中

太少：資訊不完整
太多：用戶放棄填寫
建議：5-10 個欄位

使用正確的欄位類型

有固定選項 → 下拉選單或單選
自由輸入 → 短/長文字
明確數值 → 數字

欄位順序合理

簡單問題放前面
相關問題放一起
必填項目標示清楚

最佳實務

配合 Agent 的「核心指示」（Core Instruction）使用

在 Agent 的「核心指示」中說明表單用途：

## 資訊收集
當需要收集 Bug 回報資訊時：
1. 先表達感謝用戶回報
2. 說明需要一些資訊來幫助處理
3. 顯示 Bug 回報表單
4. 收到後確認並說明處理時間

表單後的後續動作

在「調用指示」（When to Use）中說明：

表單填寫完成後：
- 整理收到的資訊
- 生成工單編號（如果需要）
- 告知用戶預計處理時間
- 提供追蹤方式

測試表單

新增後，測試流程：

說一個應該觸發表單的話（如「我想回報一個問題」）
確認表單正確顯示
填寫測試資料
確認 Agent 正確接收並回應

常見問題

用戶可以不填表單嗎？

可以。用戶可以忽略表單繼續對話。建議在 Agent 的「核心指示」（Core Instruction）中處理這種情況，例如改用對話方式逐一詢問。

表單資料會儲存在哪裡？

表單資料會成為對話紀錄的一部分，也可以到 Codeer 的 Agent 後台查看表單回覆結果。

可以有多個表單嗎？

可以新增多個 Request Form 工具，每個有不同的表單結構和觸發條件。例如「Bug 回報表單」和「需求提交表單」。

欄位可以有預設值嗎？

目前不支援預設值，但可以在欄位說明中提供範例。

下一步

Knowledge Base - 連接資料來源
Call Agent - 分工處理
回到工具概覽