建立 Agent¶

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

開始前

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

三種建立方式¶

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

選單沒跳出來？也可以直接開網址

那顆 + 要點在按鈕上才會展開選單。如果一直開不出來，直接在瀏覽器網址列輸入 /agents/create 也能進到「從空白開始」的建立表單（本頁「方式一」教的就是這張表單）。

選項	適合誰	特色
使用 Copilot 建立	不知道要填什麼、想先用白話講清楚需求的人	打開 Copilot 對話面板，用中文描述要的功能，由 Copilot 把設定填好。做法見 Copilot。
從空白開始（Create from scratch）	想完整掌控每個設定的人	單一表單，一次顯示所有欄位（模型、提示詞、工具、進階設定）。
從生成器建立（Create from builder）	想快速做出「會讀自家文件」的問答助理	三步驟精靈，上傳文件後平台自動接好知識庫。

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

方式一：從空白開始¶

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

從左側選單進入「Agents」。
點右上角「+」，選「從空白開始」。
填寫下方最少需要的欄位。
（選用）展開「內建工具」、「自訂工具」、「介面設定」、「進階設定」等區塊調整。這五個區塊在新建畫面預設全部收合，而且新 Agent 的標題旁不會有「已變更」標籤（那個標籤只在某一項被改成非預設值時才出現，見 Agent 設定總覽）。
點右上角「儲存」。

最少需要填什麼¶

真正必填的只有前兩項（名稱、大型語言模型）；下表把「標籤」與「Agent 提示詞」一起列出來，是因為它們就排在表單的同一段裡，看「必填」那一欄就知道哪些可以先跳過。

欄位	必填	說明
名稱（Name）	是	好辨識的名稱，例如 `customer-support-agent`。最長 64 字，不可空白，且不能以 `default` 開頭。
大型語言模型（LLM）	是	Agent 預設使用的 AI 模型。點這個欄位的任何位置（或欄位右端的鈕，兩者效果相同）會開啟一個資源選擇對話框（可搜尋的清單，每列前面有圓形選鈕），點該列前面的圓形選鈕、或名稱以外的任一格選好需要的 LLM 資源，再按對話框右上角的「儲存」確認——點「名稱」會在新分頁開啟那個資源的詳細頁，不會選取它（見資源挑選欄位）。
防護機制	否	掛一道內容檢查關卡，使用者輸入、模型輸出，以及工具的輸入與輸出都會先過它，違規內容會被擋下。位置在「大型語言模型」與「描述」之間，同樣是資源挑選欄位，欄位右側的可清空。第一次建立 Agent 可以留空，日後再補；設定方式與地區限制見防護機制、防護機制與模型地區。
標籤	否	給這個 Agent 貼的分類小標（例如 `客服`、`財務`），之後可在 Agents 清單用標籤篩選。位置在「描述」與「Agent 提示詞」之間，打字後按 Enter 就成為一個 chip；規則與上限見通用介面元件 — 「標籤」欄位。
Agent 提示詞（Agent Prompt）	否（強烈建議）	一段文字，告訴 Agent 它是誰、要做什麼、語氣如何。不填也能建立，但回答品質會差很多。可自己撰寫，也可以先寫幾句草稿、再用編輯器內建的改寫功能請 AI 優化（見用「改寫」讓 AI 優化提示詞）。

Agent 提示詞怎麼寫

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

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

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

「Agent 提示詞」編輯器的右上角一直有一排小工具（不必把滑鼠移上去才會出現），由左到右依序是：

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

按鈕	作用
產生／改寫	請 AI 寫提示詞，結果直接填回輸入框。輸入框空白時按鈕寫「產生」，會依上方的「名稱」與「描述」生成一版；已有內容時改寫「改寫」，依現有初稿改出更完整的版本。用法見下一節。需先選好大型語言模型才會亮起。
自動換行、複製、下載、在對話方塊中編輯	通用的編輯器工具，每個多行欄位都有，說明見通用介面元件 — 編輯器工具列。

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

不確定提示詞怎麼寫得更完整？可以先寫幾句白話草稿，再請 AI 補齊結構、語氣與細節，省去從零琢磨的工夫；完全空白也能直接請它依「名稱」與「描述」生成一版。

操作步驟：

先在上方選好「大型語言模型」（沒選時按鈕是灰的、點不動；把滑鼠移上去會顯示提示「需要先選擇模型。」），並在「Agent 提示詞」填入草稿（哪怕只是一兩句）。留空也可以，按鈕會改成「產生」。
點輸入框右上角的「改寫」（或「產生」），開啟視窗。

提示詞留空時，整個視窗會改叫「產生」

兩條路走的是同一個視窗，但用字會跟著按鈕變：提示詞已有草稿時是「改寫提示詞」視窗／「改寫指令」欄位／右上角「改寫」鈕；提示詞空白時整組換成「產生提示詞」視窗／「產生指令」欄位／右上角「產生」鈕。下面的欄位表以「改寫」那一組命名為準，欄位位置與作用兩者相同。
視需要填寫下方欄位（全部都可留空，直接改寫也可以）。
點視窗右上角的「改寫」（空白時是「產生」）。系統開始處理時按鈕會顯示「改寫中…」，完成後會把新版本直接覆蓋填回提示詞輸入框。
對結果不滿意可再改寫一次，或手動微調。

按「放棄」會再次確認

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

欄位	必填	預設	說明
改寫指令（提示詞空白時叫「產生指令」）	否	空白	告訴 AI 要怎麼改，例如「更口語」「更正式」「多舉幾個例子」「更精簡」或「改成條列式」。留空則由系統自行判斷如何優化。
限制條件	否	空白	改寫後的提示詞必須遵守的硬性規則，輸入一條後按 Enter 新增，可加多條。例如「不可承諾具體送達日期」「輸出格式必須為 JSON」「不可提及競爭對手品牌」。
提示詞語言	是	同介面語言	改寫後提示詞本身要用哪種語言寫——不是 Agent 回話的語言（Agent 用什麼語言回答，取決於提示詞內容與使用者怎麼問）。選項就是這套環境可切換的介面語言：「英文」與「正體中文」一定有，有開啟額外語系的環境還會多一個「日文」；想確認自己這台有幾個，對照右上角頭像選單的「語言」即可，兩邊清單相同。開啟視窗時會依目前的介面語言預先帶入（正體中文介面即帶入「正體中文」）。建議與原始草稿語言一致，較能維持風格。這是不可清空的下拉、永遠帶著一個值，所以畫面上不加必填星號。

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

欄位	必填	預設	說明
執行大型語言模型	是	`default-llm`	這次執行改寫這個動作要用的模型（不是 Agent 平常回話用的模型）。預設帶入平台內建的 `default-llm`，照用即可；也可改選其他 LLM 資源，或點旁邊的微調該模型參數。
附件	否	無	提供給模型參考的檔案，讓它產生更貼近需求的提示詞。這不是從本機上傳檔案，而是一張「名稱」「儲存庫」兩欄的表格：按 + 新增一列，從已建立的儲存庫 (Storage) 裡挑一個檔案。所以要先有儲存庫、且檔案已放進去，否則挑不到東西；沒有儲存庫時留空即可，不影響改寫。
啟用內容安全	是	開啟	加入內容安全的改寫規範，降低產生不當或敏感內容的風險。適合面向一般使用者、教育或公共場景的 Agent。
啟用隱私保護	是	開啟	加入隱私保護的改寫規範，移除或遮蔽敏感資訊。當提示詞可能含個資、客戶資料或內部機密時建議保持開啟。

改寫會套用 Agent 選定的模型

從這裡開啟改寫時，系統會自動以 Agent 上方選定的「大型語言模型」作為改寫的目標模型（也就是「這段提示詞是要寫給哪個模型看」），因此視窗中不會再出現「目標大型語言模型」相關欄位。這與進階設定裡的「執行大型語言模型」是兩件事——後者是「由誰來動筆改寫」。

default-llm 是平台內建的預設模型

default-llm 不是某個環境才有的資源名稱，而是平台內建、每個環境都有的預設模型，所以在任何環境都會看到同一個名字，可以直接照用。它的內部代號是 llm-default，所以某些唯讀畫面（例如版本的版本詳細頁）會顯示 llm-default——那是同一個模型的代號，不是另一個模型。

方式二：從生成器建立¶

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

步驟 1：Agent 角色¶

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

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

欄位	必填	說明
名稱（Name）	是	Agent 的名稱，建議取一看就懂用途的名字，例如 `示範文件問答助理`。
提示詞（Prompt）	是	定義 Agent 的身分、任務與語氣，等同從空白開始的 Agent 提示詞。和「從空白開始」一樣，這裡也有 AI 工具可請它優化初稿——生成器裡這顆鈕不論欄位空不空都寫「改寫」（不像從空白開始會在空白時變成「產生」），而且欄位空著時它是停用的，要先自己打幾句才按得下去（用法見用「改寫」讓 AI 優化提示詞）。

提示詞可以怎麼寫

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

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

步驟 2：知識整合¶

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

上傳檔案，有兩種方式：
- 點「上傳檔案」選單一或多個檔案，或點「上傳資料夾」整批上傳。
- 直接把檔案或資料夾拖曳到「將檔案和資料夾拖曳至此處」區塊內。
上傳後，檔案會列在下方表格，顯示「名稱」、「資料夾」、「大小」、「類型」。每一列右側有編輯（）與刪除（）圖示，可調整或移除；最左側的可按住上下拖曳調整列的順序（順序不影響知識庫內容，純粹是這張表看起來順不順）。
確認檔案無誤後，點右下角的「建立」；要回頭改第一步的名稱或提示詞，點左下角的「上一步」。

欄位	必填	說明
上傳資料集（Upload Dataset）	是	要讓 Agent 參考的文件。可上傳一個或多個檔案／資料夾。沒上傳任何檔案就按「建立」不會前進：上方步驟列的「知識整合」會變成紅色並顯示「上傳資料集以繼續」，補上檔案就能繼續。可接受的檔案類型（畫面上沒有列出來，這裡補齊）：`.csv`、`.docx`、`.json`、`.jsonl`、`.md`、`.pdf`、`.pptx`、`.tsv`、`.ppt`、`.txt`、`.xls`、`.xlsx`，以及 `.jpg`、`.jpeg`、`.png`、`.gif`、`.webp`。

點「建立」後，平台會自動建立並串接需要的資源，畫面上會即時顯示五個進度項目，完成的項目前面會打勾：

生成器建立進度清單，五項依序為建立儲存庫、上傳檔案、建立知識庫、建立載入器、建立 Agent，前四項已完成打勾

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

步驟 3：Agent 已就緒¶

五個進度項目都完成後，顯示成功畫面（標題為「更新成功，正在同步資料。」）。點「開始對話」即可直接和 Agent 聊天；也可以點「前往同步任務查看進度」追蹤資料集的同步狀態。

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

資料集需要時間同步

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

生成器不含進階設定

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

生成器會一次建立四個東西

按下「建立」之後，平台不只建 Agent，還會連帶建立一個儲存庫、一個知識庫、一個載入器（就是步驟 3 進度清單上那幾項）。它們都會留在資源清單裡，之後不需要就得自己去刪。只是想試試看的話，建議先用「方式一：從空白開始」——那個不會產生額外資源。

建立之後¶

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