Agent 設定總覽¶
用「從空白開始」建立、或日後編輯 Agent 時，會看到一張完整的設定表單。這頁依畫面由上而下的順序逐一說明每個設定，幫你知道「哪裡可以調什麼」。多數設定都有合理預設值，初期照預設用即可。
畫面結構大致是：上方一組「基本欄位」（一直顯示），下方數個可展開的區塊——「內建工具」、「自訂工具」、「介面設定」、「進階設定」、「點數設定」。
從區塊標題就能看出裡面有沒有東西
每個摺疊區塊的標題下方有一行副標說明用途，標題本身還會帶一個提示，不必逐個展開就知道哪裡有設定：
- 「內建工具」「自訂工具」標題後面接一個括號數字，代表目前已啟用／已新增幾項（例如「自訂工具 (2)」）。
- 「介面設定」「進階設定」只要有任一項不是預設值，標題旁就會出現一個「已變更」標籤。
- 「點數設定」開了「啟用點數額度」時，標題旁會出現「啟用中」標籤（這個開關僅管理員可見）。
編輯畫面可以左右拖寬
在既有 Agent 的編輯畫面，左邊是設定表單、右邊是即時對話預覽，可以邊改邊試（右上角有「新的對話」與 另開分頁）。把滑鼠移到中間的分隔線上可左右拖曳調整兩邊寬度（左側介於整體寬度的 20%–80%，預設 67%），調完的比例會被記住，下次開編輯畫面沿用。視窗較窄時會自動改成上下堆疊。
基本欄位（一直顯示）¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 名稱（Name） | 是 | （無） | 好辨識的名稱。最長 64 字，不可空白，且不能以 default 開頭。 |
| 大型語言模型（LLM） | 是 | （無） | Agent 主要使用的 AI 模型。點這個欄位的任何位置（或欄位右端的 鈕，兩者效果相同）會開啟一個資源選擇對話框（可搜尋的清單，每列前面有圓形選鈕），點該列前面的圓形選鈕、或名稱以外的任一格選好你要的 LLM 資源，再按對話框右上角的「儲存」確認——點「名稱」會在新分頁開啟那個資源的詳細頁，不會選取它（見資源挑選欄位）。 |
| 描述（Description） | 否 | （無） | 簡述這個 Agent 的用途，最長 4096 字。屬於內部說明；當這個 Agent 被別的 Agent 當成工具呼叫時，也可作為辨識參考。 |
| 標籤 | 否 | （無） | 分類用的小標，貼上後可在 Agents 清單頁用「標籤」把同一群 Agent 一次篩出來。填法與數量／長度限制見「標籤」欄位。 |
| Agent 提示詞（Agent Prompt） | 否 | （無） | 定義 Agent 的角色、任務、語氣與規則，最長 4096 字。這是影響回答品質最關鍵的設定，支援 Jinja 樣板語法。 |
Agent 提示詞撰寫建議
- 講清楚身分與任務：「你是…，負責…」
- 訂出語氣與語言：例如「用親切、簡潔的繁體中文」
- 寫下界線：不確定時該怎麼辦、哪些事不要做
內建工具¶
平台內建、開關即可使用的能力（讀網頁、執行程式碼、操作檔案等），預設全部關閉，需要哪個就勾哪個。
逐列勾選要啟用的工具；最上方標題列的勾選框可一次全選／全部取消所有內建工具（按下去會把全部工具一次打開，通常不是你要的）。表格恰好十列：瀏覽器、程式碼、向使用者提問、任務、技能、讀取網址、讀取檔案、Glob、Grep、寫入檔案。其中只有「瀏覽器」與「程式碼」勾起後會多出 選單與展開箭頭，可再調該工具的細項；其餘八項勾起後就只是打開，沒有可調的細項。各工具用途與可調選項詳見 內建工具。
自訂工具¶
連到特定資源或系統的工具，例如某個知識庫、MCP 伺服器、Lambda 函式。展開後點表格中央的「+」圖示鈕會跳出工具清單，選一種再填它的設定。
各工具的設定欄位詳見 工具總覽。
介面設定¶
調整使用者在對話畫面看到的樣子——頭像，以及對話畫面上的各種文字。全部選填。區塊副標寫的是「自訂聊天介面的外觀，例如頭像、標題、起始提示與輸入框。」
上圖是「填好之後」的樣子
這張圖取自建立 Agent 的表單、由本手冊當場填入示範文案（所以「顯示名稱」有值、標題旁也出現了「已變更」標籤）。與 Agent 對話那邊的示範 Agent 則是只有「顯示名稱」留空、其他文案欄位有填，所以對話畫面最上方顯示的是 Agent 名稱、中央仍有標題與開場白——兩者不衝突，是不同時點、不同填法的狀態。
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 頭像（Avatar） | 否 | 預設機器人圖示 | 對話畫面顯示的 Agent 頭像圖片。點圓框即可換圖，見換頭像。 |
| 聊天文案（Chat Content） | 否 | （無） | 使用者在對話畫面看到的文字（顯示名稱、標題、開場白、輸入框提示、建議提示）。依語言分列填寫，見聊天文案：分語言填寫。 |
| 顯示儲存庫按鈕（Show Storage Button） | 否 | 關閉 | 開啟後，對話輸入框的「+」選單才會出現「儲存庫」項目，讓使用者在開始新對話時挑選要存取的儲存庫 (Storage)（見與 Agent 對話）；關閉時該項目不會出現。 |
聊天文案：分語言填寫¶
「聊天文案」是一張表格，一列一個平台支援的介面語言，目前固定三列：English、正體中文、日本語（語言名稱一律顯示該語言自己的寫法，不隨你目前的介面語言改變）。欄位依序為「語言」、「顯示名稱」、「標題」、「描述」、「輸入框提示文字」、「建議提示」、「主要語言」；表格裡只顯示各欄前 40 字，過長會截斷。沒填過的語言，每一欄都顯示 -。
要填內容，點那一列最右端的 （上圖每一列最右邊那顆鉛筆鈕），開啟「編輯<語言>」對話框（例如「編輯正體中文」），填完按右上角「儲存」回到表格。對話框右上角是「放棄」與「儲存」兩顆；即使你什麼都沒改，按「放棄」也會先跳出「放棄修改／你所做的修改將不會被保存。」的確認框，再按一次「放棄」才會關閉。
視窗窄的時候，鉛筆鈕會被捲到畫面外
這張表有七個欄位，視窗較窄時表格會自己左右捲動，鉛筆鈕就被推到畫面外，只在表格右緣看到一個 捲動箭頭。這時把表格往右捲（或把瀏覽器視窗拉寬）就會看到它。文案不是唯讀的，只是入口被捲出去了。
上圖是「還沒填過」的樣子
這張圖取自一個全新的 Agent，所以五個欄位都是空的、AI 按鈕都寫「產生」。已經填過內容的 Agent（例如前一張表格截圖裡的「正體中文」那一列）點進來時，欄位裡會是你原本填好的文字、AI 按鈕也會變成「改寫」——點開不會清空你的內容。
| 欄位 | 必填 | 上限 | 說明 |
|---|---|---|---|
| 顯示名稱（Display Name） | 否 | 64 字 | 對話畫面最上方顯示的 Agent 名稱（也就是名稱選單那一行）。未填時顯示 Agent 的「名稱」。 |
| 標題（Title） | 否 | 64 字 | 對話起始畫面的大標。 |
| 描述（Description） | 否 | — | 進入對話時顯示給使用者看的開場白，支援 Markdown。（這是給使用者看的開場白，與上方「基本欄位」的內部描述不同。） |
| 輸入框提示文字（Input Placeholder） | 否 | 64 字 | 輸入框尚未輸入時顯示的灰字提示，例如「有任何產品問題都可以問我…」。 |
| 建議提示（Starter Prompts） | 否 | — | 每行輸入一則建議提示，會在新對話的起始畫面以可點擊按鈕呈現，使用者點一下即直接送出。 |
| 設為主要語言（Set as Primary Language） | — | 關閉 | 把這一列設為主要語言，見下方說明。 |
沒填的語言會顯示「主要語言」的內容
使用者看到的是符合他介面語言的那一列；該語言留空時，改顯示主要語言那一列的內容（只會退回主要語言，不會再退到另一種語言）。所以至少要把主要語言那一列填完整。
主要語言預設是 English。要換成正體中文，就到「正體中文」那一列打開「設為主要語言」（日本語那一列同樣可以設）；目前是主要語言的那一列，開關是停用的——主要語言只能改指到另一個語言，不能取消。
三種語言只填「正體中文」並把它設為主要語言時，實際結果是這樣：
| 使用者的介面語言 | 他會看到哪一列 |
|---|---|
| 正體中文 | 正體中文（他自己那一列） |
| English | 正體中文（英文那列空的，退回主要語言） |
| 日本語 | 正體中文（日語那列空的，退回主要語言） |
也就是說，只要主要語言填好，另外兩種語言留白不會讓畫面變成空的；但英日語使用者看到的是中文文案，在意的話就把那兩列也填上。
用 AI 產生或改寫文案
對話框裡每個欄位的右上角都有一顆 AI 按鈕，會依 Agent 的名稱、描述與提示詞產生文案，用 Agent 選定的大型語言模型執行，並以該列的語言輸出：
- 欄位空白時按鈕寫「產生」，點下去直接產生一版。
- 欄位已有內容時按鈕變成「改寫」，會先開「改寫內容」對話框讓你填一句「改寫指令」（例如「更口語」「更精簡」「多舉幾個例子」），再依指令改寫。
產生中按鈕會顯示「產生中…」或「改寫中…」，完成後直接覆蓋該欄位的內容。
這五個欄位分別會變成畫面上的哪一塊
對照 與 Agent 對話 的對話起始畫面（由上而下）：
| 你在這裡填的欄位 | 會出現在對話畫面的 |
|---|---|
| 顯示名稱 | 最上方那一行 Agent 名稱（也就是名稱選單）。留空時這一行會改顯示 Agent 的「名稱」——chat.md 那張 chat-overview.png 就是這種情況：最上方是 Agent 名稱「客服助理」，因為那個 Agent 沒填顯示名稱。 |
| 標題 | 畫面中央的大標（chat-overview.png 的「客服小幫手」）。 |
| 描述 | 大標下方的開場白，Markdown 會被排版出來（清單、粗體都有效）。 |
| 建議提示 | 開場白下方那幾顆可點擊的按鈕，點一下即直接送出。 |
| 輸入框提示文字 | 最下方輸入框裡的灰字。 |
所以「標題 + 描述」合起來就是使用者一進場看到的開場白。
建議提示超過五則會隨機顯示
「建議提示」最多會在起始畫面顯示五則；若你填超過五則，每次開啟新對話會從中隨機挑選五則顯示。
每個欄位都有編輯器工具列
對話框裡五個欄位都是編輯器（「描述」支援 Markdown），右上角除了 AI 按鈕，還有自動換行（）、複製（）、下載（）、在對話方塊中編輯（）等工具，說明見通用介面元件 — 編輯器工具列。
換頭像¶
- 點「頭像」的圓框（也可用鍵盤 Tab 移到它再按 Enter 或空白鍵），選一張圖檔。
- 跳出「裁切頭像」對話框：在圖上拖曳調整要保留的位置，用下方的「縮放」滑桿放大縮小。
- 按「儲存」套用。系統會裁成正方形並自動壓縮後存下。
已經有頭像時，圓框右下角會多一顆 按鈕，點它可移除頭像、改回預設的機器人圖示。
進階設定¶
這個展開區塊用來調整模型切換、輪數與工具次數上限、以及輸出格式，不確定就先用預設值。區塊副標寫的是「調整大型語言模型切換、輪數與迭代上限、輸出格式。」
| 設定 | 必填 | 預設 | 範圍 | 說明 |
|---|---|---|---|---|
| 啟用大型語言模型切換（Enable Switchable LLMs） | — | 關閉 | 開／關 | 開啟後才會出現可切換的大型語言模型欄位，讓使用者在對話時切換模型。 |
| 可切換的大型語言模型（Switchable LLMs） | 開啟切換時必填 | （無） | 至少 1 個 | 允許在對話中切換的模型清單；預設的大型語言模型必須包含在內。 |
| 輸出格式（Output Format） | 否 | 不指定 | 五選一 | Agent 回覆時偏好的輸出格式（見下方對照表）。 |
| 強制繁體中文輸出（Force Traditional Chinese Output） | 否 | 關閉 | 三選一 | 是否要求 Agent 一定用繁體中文回覆（見下方對照表）。 |
| 最大對話輪數（Max Turns） | 是 | 10 | 1–100 | 一段對話最多能來回幾組訊息，超過就不再接受新訊息。 |
| 最大工具使用次數（Max Tool Uses） | 是 | 30 | 1–200 | Agent 回答「一則」訊息時，最多能連續動作幾步（例如查資料、再查、再整理）。設太低可能還沒查完就停下。 |
| 儲存中間步驟（Save Intermediate Steps） | 否 | 關閉 | 開／關 | 開啟後，系統會把工具使用與工具結果等中間步驟一併存下來，日後查看歷史對話時也看得到。 |
輸出格式怎麼選¶
| 選項 | 適合 | 說明 |
|---|---|---|
| 不指定 | 多數情況 | 不特別要求格式，由模型自行決定。 |
| Markdown | 需要標題、清單、表格的回答 | 要求模型以 Markdown 撰寫回覆。 |
| HTML | 回答要嵌進網頁 | 要求模型以 HTML 撰寫回覆。 |
| 純文字 | 要把回覆直接接到其他系統 | 要求模型只回純文字，不帶格式標記。 |
| Markdown 與 HTML | 內容以 Markdown 為主，但需要混用 HTML 標籤 | 允許 Markdown 與 HTML 並用。 |
強制繁體中文輸出怎麼選¶
| 選項 | 適合 | 說明 |
|---|---|---|
| 關閉 | 多數情況、或本來就以英文服務 | 不強制繁體中文，Agent 依模型輸出回覆。 |
| 提示模型 | 偶爾冒出簡體字，想先用最省成本的方式改善 | 要求模型以繁體中文回覆，並把中文字後的標點正規化為全形。不保證 100% 轉換，取決於模型能力。 |
| 強制轉換 | 對外文件、公文等絕對不能出現簡體字的情境 | 包含「提示模型」的所有處理，並額外把結果中殘留的簡體字強制轉為繁體。可能造成部分選字錯誤，且會消耗較多 Token。 |
「強制繁體中文輸出」與 LLM 資源的設定是兩層
大型語言模型 (LLM) 資源本身也有一個「將輸出轉換為繁體中文」開關。Agent 的這個設定是在執行時覆寫該行為，因此同一個 LLM 資源可以被不同 Agent 用在不同要求的情境。
提示快取由系統決定
Agent 內部還有「提示快取」等設定，目前不在設定畫面開放調整，由平台預設處理，這裡不需操作。
點數設定¶
控制這個 Agent 的點數（用量計費）相關設定。區塊副標寫的是「設定此 Agent 的點數額度與計費。」。
你展開後只看到一個開關，是正常的
這個區塊的內容依你的權限而不同：
- 一般使用者：展開後永遠只有「顯示點數使用狀態」一個開關，沒有其他欄位、也沒有任何可以再展開的東西。下面那張截圖裡的「啟用點數額度」「基本額度」「點數上限」你看不到，這不是折疊起來、也不是壞掉——那三項是管理員限定，額度由管理員統一設定。
- 管理員：一展開時同樣只看到兩項（「啟用點數額度」與「顯示點數使用狀態」），要先把「啟用點數額度」打開，才會在它下方多出「基本額度」與「點數上限」，變成下圖的四項。
下面這張截圖是管理員、而且已經打開「啟用點數額度」之後的樣子（所以標題旁有「啟用中」標籤）。一般使用者看到的畫面與它不同，兩張圖都附在下面。
一般使用者展開同一個區塊，看到的是這樣——只有一個「顯示點數使用狀態」開關，沒有額度相關欄位，也沒有「啟用中」標籤：
| 欄位 | 必填 | 預設 | 可見對象 | 說明 |
|---|---|---|---|---|
| 啟用點數額度（Credit Config Enabled） | — | 關閉 | 僅管理員 | 開啟後才會在它下方出現「基本額度」與「點數上限」欄位，用來設定此 Agent 的計費額度；停用會移除已設定的額度。 |
| 基本額度（Tier Threshold） | 開啟「啟用點數額度」時必填 | （無） | 僅管理員 | 每月的基本額度（方案預付）。用量可超過此值，超出部分以加價計費。最小為 1，且必須小於或等於「點數上限」。 |
| 點數上限（Quota） | 否 | 無上限 | 僅管理員 | 此 Agent 每月可使用的點數上限。最小為 1；留空表示無上限。達到上限後會停止用量，無法再產生新的使用。 |
| 顯示點數使用狀態（Enable Credit） | — | 關閉 | 所有人 | 開啟後，一般使用者可在 Agent 詳細頁查看此 Agent 當月的點數使用狀態；停用時一般使用者看不到，但管理員仍可檢視。 |
基本額度與點數上限的關係
「基本額度」是方案已預付的額度；用量在此額度內不額外收費，超過後到「點數上限」之間以加價計費；達到「點數上限」則停止用量。因此「基本額度」必須設得比「點數上限」小或相等。
點數使用狀態¶
當「顯示點數使用狀態」開啟時，使用者可在 Agent 詳細頁的「點數使用狀態」分頁看到目前用量；管理員一律看得到（若未對使用者開啟，會標示「未對一般使用者顯示。」）。卡片會顯示「統計區間」、「已使用點數」、「剩餘點數」、「距離基本額度」、「距離點數上限」等資訊（單位為「點」），並依目前狀態提示：
- 尚在基本額度內（已預付，無額外費用）。
- 已超出基本額度，超出部分加價計費中。
- 已達點數上限，已停止用量。
若尚未設定額度，會顯示「尚未設定點數額度。」；管理員可由此進入編輯，點「設定點數額度」按鈕回到 Agent 設定開啟「啟用點數額度」並填寫額度。
下一步¶
- 工具總覽：讓 Agent 真正能做事
- 與 Agent 對話：調整完就實際測試看看
- 版本紀錄：每次儲存都會留下一個版本，改壞了可以把舊版設定拉回來