跳轉到

Agent 設定總覽

用「從空白開始」建立、或日後編輯 Agent 時，會看到一張完整的設定表單。這頁依畫面由上而下的順序逐一說明每個設定，幫你知道「哪裡可以調什麼」。多數設定都有合理預設值，初期照預設用即可。

畫面結構大致是：上方一組「基本欄位」（一直顯示），下方數個可展開的區塊——「內建工具」、「自訂工具」、「進階設定」、「介面設定」、「點數設定」。

建立 Agent 的設定表單，上方為名稱、大型語言模型、描述、Agent 提示詞，下方為內建工具、自訂工具、進階設定、介面設定四個摺疊區塊

基本欄位（一直顯示）

欄位 必填 預設 說明
名稱（Name） 是 （無） 好辨識的名稱。最長 64 字，不可空白，且不能以 default 開頭。
大型語言模型（LLM） 是 （無） Agent 主要使用的 AI 模型。點這個欄位會開啟一個資源選擇對話框（可搜尋的清單，每列前面有圓形選鈕），選好你要的 LLM 資源那一列後，按對話框右上角的「儲存」確認。
描述（Description） 否 （無） 簡述這個 Agent 的用途，最長 4096 字。屬於內部說明；當這個 Agent 被別的 Agent 當成工具呼叫時，也可作為辨識參考。
Agent 提示詞（Agent Prompt） 否 （無） 定義 Agent 的角色、任務、語氣與規則，最長 4096 字。這是影響回答品質最關鍵的設定，支援 Jinja 樣板語法。

Agent 提示詞撰寫建議

  • 講清楚身分與任務：「你是…，負責…」
  • 訂出語氣與語言：例如「用親切、簡潔的繁體中文」
  • 寫下界線：不確定時該怎麼辦、哪些事不要做

內建工具

平台內建、開關即可使用的能力（讀網頁、執行程式碼、操作檔案等），預設全部關閉，需要哪個就勾哪個。

內建工具區塊，逐列列出瀏覽器、程式碼、向使用者提問、任務、技能、讀取網址、讀取檔案、Glob、Grep、寫入檔案等工具的勾選框與說明

逐列勾選要啟用的工具；最上方標題列的勾選框可一次全選／全部取消所有內建工具。各工具用途與可調選項詳見 內建工具。

自訂工具

連到特定資源或系統的工具，例如某個知識庫、MCP 伺服器、Lambda 函式。展開後點「新增」會跳出工具清單，選一種再填它的設定。

新增工具的選擇清單，列出檢索、搜尋引擎、工作流程、MCP 伺服器、技能、Lambda、API、HTTP、Agent、Athena、OpenSearch、MySQL 等工具類型

各工具的設定欄位詳見 工具總覽。

進階設定

這個展開區塊用來控制模型切換與 Agent 的行為上限，不確定就先用預設值。

進階設定區塊，顯示「啟用大型語言模型切換」開關、「最大對話輪數」（10）與「最大工具使用次數」（30）

設定 必填 預設 範圍 說明
啟用大型語言模型切換（Enable Switchable LLMs） — 關閉 開／關 開啟後才會出現可切換的大型語言模型欄位，讓使用者在對話時切換模型。
可切換的大型語言模型（Switchable LLMs） 開啟切換時必填 （無） 至少 1 個 允許在對話中切換的模型清單；預設的大型語言模型必須包含在內。
最大對話輪數（Max Turns） 是 10 1–100 一段對話最多能來回幾組訊息，超過就不再接受新訊息。
最大工具使用次數（Max Tool Uses） 是 30 1–200 Agent 回答「一則」訊息時，最多能連續動作幾步（例如查資料、再查、再整理）。設太低可能還沒查完就停下。

提示快取與中間步驟由系統決定

Agent 內部還有「提示快取」與「是否保存工具使用的中間步驟」等設定，但目前不在設定畫面開放調整，由平台預設處理，這裡不需操作。

介面設定

調整使用者在對話畫面看到的樣子。全部選填。

介面設定區塊，標題填入「客服小幫手」、描述（Markdown 編輯器）填入一段開場白、輸入框提示文字填入「有任何產品問題都可以問我…」，下方為頭像上傳

欄位 必填 預設 說明
頭像（Avatar） 否 預設機器人圖示 對話畫面顯示的 Agent 頭像圖片，可點上傳更換。
標題（Title） 否 （無） 對話畫面顯示的 Agent 標題，最長 64 字。未填時顯示系統預設問候語。
描述（Description） 否 （無） 進入對話時顯示給使用者看的開場白，支援 Markdown。（這是給使用者看的開場白，與上方「基本欄位」的內部描述不同。）旁邊有「改寫」按鈕，可依 Agent 名稱與描述自動潤飾這段開場白。
輸入框提示文字（Input Placeholder） 否 （無） 輸入框尚未輸入時顯示的灰字提示，最長 32 字，例如「有任何產品問題都可以問我…」。
建議提示（Starter Prompts） 否 （無） 每行輸入一則建議提示，會在新對話的起始畫面以可點擊按鈕呈現，使用者點一下即直接送出。旁邊有「產生」按鈕可依 Agent 自動產生建議提示。
顯示儲存庫按鈕（Show Storage Button） 否 關閉 開啟後，對話輸入區才會顯示「選擇儲存庫」按鈕，讓使用者在對話時挑選要存取的儲存庫 (Storage)；關閉時對話畫面不會出現該按鈕。

用「標題 + 描述」組成開場白

對話畫面最上方會顯示「標題」當作大標、再把「描述」的 Markdown 內容顯示在下方，組成使用者一進場就看到的開場白；若填了「建議提示」，會在開場白下方以可點擊按鈕呈現。實際呈現效果見與 Agent 對話。

建議提示超過五則會隨機顯示

「建議提示」最多會在起始畫面顯示五則；若你填超過五則，每次開啟新對話會從中隨機挑選五則顯示。

「描述」的 Markdown 編輯器工具列

「描述」是多行 Markdown 編輯器，右上角有複製（）、下載（）、自動換行（）、放大編輯（）等工具，說明見通用介面元件 — 編輯器工具列。

點數設定

控制這個 Agent 的點數（用量計費）相關設定。這個區塊有兩個各自獨立的開關，其中「設定點數額度」僅管理員可見。

點數設定區塊（管理員視角），顯示「顯示點數使用狀態」與「設定點數額度」開關，以及基本額度與點數上限欄位

欄位 必填 預設 可見對象 說明
顯示點數使用狀態（Enable Credit） — 關閉 所有人 開啟後，一般使用者可在 Agent 詳細頁查看此 Agent 當月的點數使用狀態；停用時一般使用者看不到，但管理員仍可檢視。
設定點數額度（Credit Config Enabled） — 關閉 僅管理員 開啟後才會出現下方「基本額度」與「點數上限」欄位，用來設定此 Agent 的計費額度；停用會移除已設定的額度。
基本額度（Tier Threshold） 開啟「設定點數額度」時必填 （無） 僅管理員 每月的基本額度（方案預付）。用量可超過此值，超出部分以加價計費。最小為 1，且必須小於或等於「點數上限」。
點數上限（Quota） 否 無上限 僅管理員 此 Agent 每月可使用的點數上限。最小為 1；留空表示無上限。達到上限後會停止用量，無法再產生新的使用。

基本額度與點數上限的關係

「基本額度」是方案已預付的額度；用量在此額度內不額外收費，超過後到「點數上限」之間以加價計費；達到「點數上限」則停止用量。因此「基本額度」必須設得比「點數上限」小或相等。

點數使用狀態

當「顯示點數使用狀態」開啟時，使用者可在 Agent 詳細頁的「點數使用狀態」分頁看到目前用量；管理員一律看得到（若未對使用者開啟，會標示「未對一般使用者顯示。」）。卡片會顯示「統計區間」、「已使用點數」、「剩餘點數」、「距離基本額度」、「距離點數上限」等資訊（單位為「點」），並依目前狀態提示：

  • 尚在基本額度內（已預付，無額外費用）。
  • 已超出基本額度，超出部分加價計費中。
  • 已達點數上限，已停止用量。

若尚未設定額度，會顯示「尚未設定點數額度。」；管理員可由此進入編輯，點「設定點數額度」按鈕回到 Agent 設定填寫額度。

下一步