建立 Agent¶
Agent 是一個會對話、會自己使用工具的 AI 助理。這頁帶你從零建立第一個 Agent；建立後再到 Agent 設定總覽 補上工具與細部設定。
開始前
若要自己指定模型，你需要一個已設定好的大型語言模型 (LLM) 資源（也就是 Agent 背後的 AI 模型）。若還沒有，請參考 大型語言模型資源指南，或請管理員協助準備。
三種建立方式¶
從左側選單進入「Agents」，按右上角的 +（新增）按鈕，會跳出選單，由上而下提供三個選項：
選單沒跳出來？也可以直接開網址
那顆 + 要點在按鈕上才會展開選單。如果一直開不出來，直接在瀏覽器網址列輸入 /agents/create 也能進到「從空白開始」的建立表單（本頁「方式一」教的就是這張表單）。
| 選項 | 適合誰 | 特色 |
|---|---|---|
| 使用 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 貼的分類小標（例如 客服、財務），之後可在 Agents 清單用標籤篩選。位置在「描述」與「Agent 提示詞」之間，打字後按 Enter 就成為一個 chip；規則與上限見通用介面元件 — 「標籤」欄位。 |
| Agent 提示詞（Agent Prompt） | 否（強烈建議） | 一段文字，告訴 Agent 它是誰、要做什麼、語氣如何。不填也能建立，但回答品質會差很多。你可以自己撰寫，也可以先寫幾句草稿、再用編輯器內建的改寫功能請 AI 幫你優化（見用「改寫」讓 AI 幫你優化提示詞）。 |
Agent 提示詞怎麼寫
把它想成「給新進助理的工作說明」。例如：
你是一位客服助理，負責回答本公司產品的問題。請用親切、簡潔的繁體中文回答；若不確定答案，請誠實告知並建議聯絡真人客服。
其餘欄位（描述、可切換的大型語言模型、最大對話輪數、工具、介面設定等）都有合理預設值，可之後再調整——詳見 Agent 設定總覽。
提示詞編輯器的工具列¶
「Agent 提示詞」編輯器的右上角一直有一排小工具（不必把滑鼠移上去才會出現），由左到右依序是：
| 按鈕 | 作用 |
|---|---|
| 產生／改寫 | 請 AI 幫你寫提示詞，結果直接填回輸入框。輸入框空白時按鈕寫「產生」，會依上方的「名稱」與「描述」生成一版；已有內容時改寫「改寫」，依你的初稿改出更完整的版本。用法見下一節。需先選好大型語言模型才會亮起。 |
| 自動換行、 複製、 下載、 在對話方塊中編輯 | 通用的編輯器工具，每個多行欄位都有，說明見通用介面元件 — 編輯器工具列。 |
用「改寫」讓 AI 幫你優化提示詞¶
不確定提示詞怎麼寫得更完整？可以先寫幾句白話草稿，再請 AI 幫你補齊結構、語氣與細節，省去從零琢磨的工夫；完全空白也能直接請它依「名稱」與「描述」生成一版。
操作步驟：
- 先在上方選好「大型語言模型」（沒選時 按鈕會維持灰色不可點），並在「Agent 提示詞」填入草稿（哪怕只是一兩句）。留空也可以，按鈕會改成「產生」。
-
點輸入框右上角的 「改寫」（或「產生」），開啟視窗。
提示詞留空時，整個視窗會改叫「產生」
兩條路走的是同一個視窗，但用字會跟著按鈕變：提示詞已有草稿時是「改寫提示詞」視窗／「改寫指令」欄位／右上角「改寫」鈕；提示詞空白時整組換成「產生提示詞」視窗／「產生指令」欄位／右上角「產生」鈕。下面的欄位表以「改寫」那一組命名為準，欄位位置與作用兩者相同。
-
視需要填寫下方欄位（全部都可留空，直接改寫也可以）。
- 點視窗右上角的「改寫」（空白時是「產生」）。系統開始處理時按鈕會顯示「改寫中…」，完成後會把新版本直接覆蓋填回提示詞輸入框。
- 對結果不滿意可再改寫一次，或手動微調。
按「放棄」會再次確認
若你在「改寫提示詞」視窗裡改過任何東西（例如展開過進階設定）後按「放棄」，系統會再跳出一個「放棄修改／你所做的修改將不會被保存」的二次確認視窗，上面兩顆鈕是「取消」與「放棄」——再按一次「放棄」才會真的關閉。
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 改寫指令（提示詞空白時叫「產生指令」） | 否 | 空白 | 告訴 AI 你希望怎麼改，例如「更口語」「更正式」「多舉幾個例子」「更精簡」或「改成條列式」。留空則由系統自行判斷如何優化。 |
| 限制條件 | 否 | 空白 | 改寫後的提示詞必須遵守的硬性規則，輸入一條後按 Enter 新增，可加多條。例如「不可承諾具體送達日期」「輸出格式必須為 JSON」「不可提及競爭對手品牌」。 |
| 提示詞語言 | 是 | 同介面語言 | 改寫後提示詞的主要語言，可選英文或正體中文。開啟視窗時會依你目前的介面語言預先帶入（正體中文介面即帶入「正體中文」）。建議與原始草稿語言一致，較能維持風格。 |
進階設定（點「進階設定」展開）：
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 執行大型語言模型 | 是 | 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。 |
點「建立」後，平台會自動幫你建立並串接需要的資源，畫面上會即時顯示五個進度項目，完成的項目前面會打勾：
| 進度項目 | 平台在做什麼 |
|---|---|
| 建立儲存庫 | 建立一個儲存庫（Storage）來存放你上傳的檔案。 |
| 上傳檔案 | 把步驟 2 的檔案上傳到該儲存庫。 |
| 建立知識庫 | 建立知識庫（Knowledge Base），讓文件內容能被語意檢索。 |
| 建立載入器 | 建立載入器（Loader），負責把儲存庫的檔案載入知識庫並建立索引。 |
| 建立 Agent | 建立 Agent 本身，並把查詢知識庫的「檢索」工具接上去。 |
步驟 3：Agent 已就緒¶
五個進度項目都完成後，顯示成功畫面（標題為「更新成功，正在同步資料。」）。點「開始對話」即可直接和 Agent 聊天；也可以點「前往同步任務查看進度」追蹤資料集的同步狀態。
資料集需要時間同步
建立完成後，知識庫的資料集會在背景同步，可能需要幾分鐘才會完整生效。你可以先開始對話，但若 Agent 還答不出文件內容，請稍等幾分鐘後再試。
生成器不含進階設定
生成器為了快速上手，不會在過程中讓你設定模型切換、最大對話輪數、自訂工具等。這些建立後到 Agent 設定總覽 的編輯畫面再調即可。
生成器會一次幫你建立四個東西
按下「建立」之後，平台不只建 Agent，還會連帶建立一個儲存庫、一個知識庫、一個載入器（就是步驟 3 進度清單上那幾項）。它們都會留在你的資源清單裡，之後不需要就得自己去刪。只是想試試看的話，建議先用「方式一：從空白開始」——那個不會產生額外資源。
建立之後¶
- 加上工具：讓 Agent 不只會聊天，還能查知識庫、上網、呼叫外部系統 → 工具總覽
- 掛上 Skill：給 Agent 可重複使用的做事指引 → 技能工具
- 實際對話測試：開啟對話、看它怎麼回應 → 與 Agent 對話