建立 Agent¶

Agent 是一個會對話、會自己使用工具的 AI 助理。這頁帶你從零建立第一個 Agent；建立後再到 Agent 設定總覽補上工具與細部設定。

開始前

若要自己指定模型，你需要一個已設定好的大型語言模型 (LLM) 資源（也就是 Agent 背後的 AI 模型）。若還沒有，請參考 LLM Resource 指南，或請管理員協助準備。

兩種建立方式¶

從左側選單進入「Agents」，按右上角的 +（新增）按鈕，會跳出選單，提供兩個選項：

選項	適合誰	特色
從空白開始（Create from scratch）	想完整掌控每個設定的人	單一表單，一次顯示所有欄位（模型、提示詞、工具、進階設定）。
從生成器建立（Create from builder）	想快速做出「會讀自家文件」的問答助理	三步驟精靈，上傳文件後平台自動幫你接好知識庫。

不確定就先用「從空白開始」；本頁與 Agent 設定總覽主要以它為準。

方式一：從空白開始¶

這是一張完整的設定表單。最少只要填必填欄位就能建立並開始對話，其餘可日後再調。

從左側選單進入「Agents」。
點右上角「+」，選「從空白開始」。
填寫下方最少需要的欄位。
（選用）展開「內建工具」、「自訂工具」、「進階設定」、「介面設定」等區塊調整。
點右上角「儲存」。

最少需要填什麼¶

欄位	必填	說明
名稱（Name）	是	好辨識的名稱，例如 `customer-support-agent`。最長 64 字，不可空白，且不能以 `default` 開頭。
大型語言模型（LLM）	是	Agent 預設使用的 AI 模型。點這個欄位會開啟一個資源選擇對話框（可搜尋的清單，每列前面有圓形選鈕），選好你要的 LLM 資源那一列後，按對話框右上角的「儲存」確認。
Agent 提示詞（Agent Prompt）	否（強烈建議）	一段文字，告訴 Agent 它是誰、要做什麼、語氣如何。不填也能建立，但回答品質會差很多。你可以自己撰寫，也可以先寫幾句草稿、再用編輯器內建的改寫功能請 AI 幫你優化（見用「改寫」讓 AI 幫你優化提示詞）。

Agent 提示詞怎麼寫

把它想成「給新進助理的工作說明」。例如：

你是一位客服助理，負責回答本公司產品的問題。請用親切、簡潔的繁體中文回答；若不確定答案，請誠實告知並建議聯絡真人客服。

其餘欄位（描述、可切換的大型語言模型、最大對話輪數、工具、介面設定等）都有合理預設值，可之後再調整——詳見 Agent 設定總覽。

把滑鼠移到「Agent 提示詞」輸入框，右上角會出現一排小工具，由左到右依序是：

Agent 提示詞輸入框，右上角顯示改寫、自動換行、複製、下載、在對話方塊中編輯五個工具按鈕

按鈕	作用
改寫	請 AI 依你的初稿產生一版更完整的提示詞，並直接填回輸入框。用法見下一節。需先選好大型語言模型並輸入內容才會亮起。
自動換行、複製、下載、在對話方塊中編輯	通用的編輯器工具，每個多行欄位都有，說明見通用介面元件 — 編輯器工具列。

用「改寫」讓 AI 幫你優化提示詞¶

不確定提示詞怎麼寫得更完整？可以先寫幾句白話草稿，再用「改寫」功能請 AI 幫你補齊結構、語氣與細節，省去從零琢磨的工夫。

操作步驟：

先在上方選好「大型語言模型」，並在「Agent 提示詞」填入草稿（哪怕只是一兩句）。兩者缺一時「改寫」按鈕會維持灰色不可點。
點輸入框右上角的「改寫」，開啟「改寫提示詞」視窗。
視需要填寫下方欄位（全部都可留空，直接改寫也可以）。
點視窗右上角的「改寫」。系統開始處理時按鈕會顯示「改寫中…」，完成後會把新版本直接覆蓋填回提示詞輸入框。
對結果不滿意可再改寫一次，或手動微調。

按「放棄」會再次確認

若你在「改寫提示詞」視窗裡改過任何東西（例如展開過進階設定）後按「放棄」，系統會再跳出一個「放棄修改／你所做的修改將不會被保存」的二次確認視窗，再按一次確認才會真的關閉。

欄位	必填	預設	說明
改寫指令	否	空白	告訴 AI 你希望怎麼改，例如「更口語」「更正式」「多舉幾個例子」「更精簡」或「改成條列式」。留空則由系統自行判斷如何優化。
限制條件	否	空白	改寫後的提示詞必須遵守的硬性規則，輸入一條後按 Enter 新增，可加多條。例如「不可承諾具體送達日期」「輸出格式必須為 JSON」「不可提及競爭對手品牌」。
提示詞語言	是	英文	改寫後提示詞的主要語言，可選英文或正體中文。建議與原始草稿語言一致，較能維持風格。

進階設定（點「進階設定」展開）：

欄位	必填	預設	說明
執行大型語言模型	是	`default-llm`	這次「執行改寫」要用的模型。可改選其他 LLM 資源，或點旁邊的微調該模型參數。
附件	否	無	提供給模型參考的檔案。選擇後，模型會參考附件內容，產生更貼近你需求的提示詞。
啟用內容安全	是	開啟	加入內容安全的改寫規範，降低產生不當或敏感內容的風險。適合面向一般使用者、教育或公共場景的 Agent。
啟用隱私保護	是	開啟	加入隱私保護的改寫規範，移除或遮蔽敏感資訊。當提示詞可能含個資、客戶資料或內部機密時建議保持開啟。

改寫會套用 Agent 選定的模型

從這裡開啟改寫時，系統會自動以 Agent 上方選定的「大型語言模型」作為改寫的目標模型，因此視窗中不會再出現「目標大型語言模型」相關欄位。

方式二：從生成器建立¶

生成器把「建立一個會引用自家文件的 Agent」拆成三步，過程中平台會自動幫你建立並串接需要的資源——存放檔案的儲存庫（Storage）、把文件變成可查詢知識的知識庫（Knowledge Base），以及負責把檔案載入知識庫的載入器（Loader）——你不必逐一手動設定。畫面上方會顯示「Agent 角色」、「知識整合」、「Agent 已就緒」三步進度。

步驟 1：Agent 角色¶

第一步定義 Agent 的身分與任務。填好下表兩個欄位後，點右下角的「下一步」。

在「名稱」欄位填一個好辨識的名稱（例如 產品文件問答助理）。
在「提示詞」欄位描述這個 Agent 是誰、要做什麼、語氣如何。
點右下角的「下一步」進入第二步。

欄位	必填	說明
名稱（Name）	是	Agent 的名稱，建議取一看就懂用途的名字，例如 `產品文件問答助理`。
提示詞（Prompt）	是	定義 Agent 的身分、任務與語氣，等同從空白開始的 Agent 提示詞。和「從空白開始」一樣，這裡也有「改寫」工具可請 AI 幫你優化初稿（用法見用「改寫」讓 AI 幫你優化提示詞）。

提示詞可以怎麼寫

把它想成「給新進助理的工作說明」，講清楚身分、任務、語氣與遇到答不出來時該怎麼辦。以一個會讀公司產品文件的問答助理為例：

你是本公司的產品文件小幫手，負責根據公司上傳的產品手冊與說明文件，用簡潔、親切的繁體中文回答同仁與客戶的問題。回答時請盡量引用文件內容；若文件中找不到答案，請誠實告知並建議聯絡負責窗口，不要自行編造。

步驟 2：知識整合¶

第二步上傳要讓 Agent 參考的文件，平台之後會把它們變成 Agent 可查詢的知識庫。

上傳檔案，有兩種方式：
- 點「上傳檔案」選單一或多個檔案，或點「上傳資料夾」整批上傳。
- 直接把檔案或資料夾拖曳到「將檔案和資料夾拖曳至此處」區塊內。
上傳後，檔案會列在下方表格，顯示「名稱」、「資料夾」、「大小」、「類型」。每一列右側有編輯（）與刪除（）圖示，可調整或移除。
確認檔案無誤後，點右下角的「建立」。

欄位	必填	說明
上傳資料集（Upload Dataset）	是	要讓 Agent 參考的文件。可上傳一個或多個檔案／資料夾；至少要有一個檔案才能按「建立」。

點「建立」後，平台會自動依序建立並串接四項資源，畫面會即時顯示進度：

生成器建立進度：依序建立儲存庫、上傳檔案、建立知識庫、建立載入器、建立 Agent

進度項目	平台在做什麼
建立儲存庫	建立一個儲存庫（Storage）來存放你上傳的檔案。
上傳檔案	把步驟 2 的檔案上傳到該儲存庫。
建立知識庫	建立知識庫（Knowledge Base），讓文件內容能被語意檢索。
建立載入器	建立載入器（Loader），負責把儲存庫的檔案載入知識庫並建立索引。
建立 Agent	建立 Agent 本身，並把查詢知識庫的「檢索」工具接上去。

步驟 3：Agent 已就緒¶

四項資源都建立完成後，顯示成功畫面。點「開始對話」即可直接和 Agent 聊天；也可以點「前往同步任務查看進度」追蹤資料集的同步狀態。

生成器步驟 3「Agent 已就緒」，顯示更新成功與「開始對話」按鈕

資料集需要時間同步

建立完成後，知識庫的資料集會在背景同步，可能需要幾分鐘才會完整生效。你可以先開始對話，但若 Agent 還答不出文件內容，請稍等幾分鐘後再試。

生成器不含進階設定

生成器為了快速上手，不會在過程中讓你設定模型切換、最大對話輪數、自訂工具等。這些建立後到 Agent 設定總覽的編輯畫面再調即可。

建立之後¶

加上工具：讓 Agent 不只會聊天，還能查知識庫、上網、呼叫外部系統 → 工具總覽
掛上 Skill：給 Agent 可重複使用的做事指引 → 技能工具
實際對話測試：開啟對話、看它怎麼回應 → 與 Agent 對話