---
title: "建立你的第一個 AI Agent"
description: "以手動上傳建立檔案來源，接著設定 Agent 的基本資訊、連結檔案來源與提示詞，最後以搜尋檔案內容與測試對話驗證回答品質"
canonical_url: "https://docs.ardge.com/zh-tw/knowledge/argent/first-ai-agent"
---
# 建立你的第一個 AI Agent

> 以手動上傳建立檔案來源，接著設定 Agent 的基本資訊、連結檔案來源與提示詞，最後以搜尋檔案內容與測試對話驗證回答品質

## 概觀

AI Agent 是 ARGENT 對外提供智慧問答的單位。每個 Agent 連結一個或多個檔案來源，並依提示詞設定決定回答的角色與語氣。

建立 Agent 的順序固定為兩段：先建立檔案來源，讓檔案完成向量處理；再建立 Agent 並連結該檔案來源。本文以手動上傳檔案的方式走完這段流程，並在最後驗證 Agent 的回答。

## 你將學會什麼

- 以手動上傳建立檔案來源，並確認處理狀態
- 建立 AI Agent，設定頭像、名稱、歡迎訊息、風險聲明與預設問題
- 以提示詞模板快速定義 Agent 的角色
- 以搜尋檔案內容與測試對話，確認 Agent 能從檔案中找到正確內容

**預計時間：約 20 分鐘**（不含檔案處理為向量所需時間）

## 適用版本

- ARGENT 1.0.1 及以上版本

## 開始之前

- 已完成 **模型連線** 設定，且大語言模型與向量化模型於 AI Model Center 的狀態皆為 **Running**。設定方式見[設定 ARGENT 的模型連線](https://docs.ardge.com/zh-tw/knowledge/argent/model-connection)
- 已備妥要交給 Agent 的檔案，且格式在支援範圍內

## 步驟 1：上傳檔案建立檔案來源

1. 前往 **檔案來源** 頁面，點擊 **新增檔案來源**
2. 於 **來源名稱** 填入名稱，例如「產品型錄」
3. 於 **來源類型** 選擇 **手動上傳**
4. 於 **上傳檔案** 區塊點擊 **選擇檔案**，或將檔案拖放至區塊中
5. 確認區塊上方的 **檔案數量：** 與 **總檔案大小：** 未超出上限
6. 點擊 **建立**

<note>

**上傳的格式與數量限制：**

單一檔案上限 150 MB，支援 TXT、MD、HTML、JSON、PDF、DOCX、PPTX、PNG、JPG、XLSX、CSV 等格式。點擊說明旁的資訊圖示，可查看各類別支援的完整格式。

單次最多上傳 50 個檔案，總計 50 GB。

</note>

超出限制的檔案不會加入上傳佇列，畫面會列出這些檔名並顯示「**因上傳限制，以下檔案無法加入上傳佇列中：**」。

建立成功時，畫面顯示「**文件同步任務已建立並啟動**」並返回 **檔案來源** 頁面。清單中該檔案來源的 **上次執行結果** 欄，處理期間顯示進度百分比，處理完成後顯示 **完成**。

<tip>

**之後可再追加檔案：**

點擊清單中的來源名稱進入明細頁，點擊 **上傳檔案** 即可將更多檔案加入同一個檔案來源。

</tip>

![檔案來源頁面與新增檔案來源按鈕](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-1-1.webp)

![新增檔案來源頁面，已選擇手動上傳](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-1-2.webp)

![已加入檔案的上傳檔案區塊，顯示檔案數量與總檔案大小](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-1-3.webp)

## 步驟 2：填寫 Agent 的基本資訊

1. 前往 **AI Agent** 頁面
2. 點擊 **建立 Agent**，開啟 **建立新的 Agent** 頁面
3. 依下表填寫欄位

<table>
<thead>
  <tr>
    <th>
      欄位
    </th>
    
    <th>
      設定值
    </th>
    
    <th>
      規則與注意事項
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        頭像
      </strong>
    </td>
    
    <td>
      Agent 的圖示
    </td>
    
    <td>
      從 10 個圖示中點選一個
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Agent 名稱
      </strong>
    </td>
    
    <td>
      Agent 的識別名稱，例如「客戶服務」
    </td>
    
    <td>
      必填
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        描述
      </strong>
    </td>
    
    <td>
      此 Agent 的用途
    </td>
    
    <td>
      選填。顯示於 Agent 卡片
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        歡迎訊息
      </strong>
    </td>
    
    <td>
      使用者開啟對話時看到的第一句話
    </td>
    
    <td>
      選填。已預先帶入預設文字
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        風險聲明
      </strong>
    </td>
    
    <td>
      顯示於 AI 聊天室底部的免責聲明
    </td>
    
    <td>
      選填。已預先帶入預設文字
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        預設問題
      </strong>
    </td>
    
    <td>
      供使用者直接點選的問題
    </td>
    
    <td>
      選填。點擊 <strong>
        新增預設問題
      </strong>
      
       逐則加入，最多 5 則
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        存取權限
      </strong>
    </td>
    
    <td>
      可使用此 Agent 的帳號
    </td>
    
    <td>
      選填。建立者預設在清單中。點擊 <strong>
        修改
      </strong>
      
       調整
    </td>
  </tr>
</tbody>
</table>

![AI Agent 頁面與建立 Agent 按鈕](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-2-1.webp)

![建立新的 Agent 頁面的空白表單](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-2-2.webp)

![已填寫 Agent 名稱、描述、歡迎訊息與風險聲明的表單](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-2-3.webp)

![表單下半部的預設問題、檔案來源、存取權限與提示詞設定](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-2-4.webp)

## 步驟 3：連結檔案來源

1. 於 **檔案來源** 欄位點擊 **連結檔案來源**
2. 於 **連結檔案來源** 對話框中，依 **名稱**、**檔案數量** 與 **狀態** 勾選步驟 1 建立的檔案來源
3. 點擊 **確認**

選取的檔案來源會顯示在 **連結檔案來源** 按鈕上方。

![連結檔案來源對話框](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-3-1.webp)

![已勾選檔案來源的連結檔案來源對話框](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-3-2.webp)

![檔案來源欄位上方列出已連結的檔案來源](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-3-3.webp)

<warning>

**檔案來源為必填：**

未選取任何檔案來源時，送出表單會在該欄位顯示「**此欄位為必填**」，且無法建立 Agent。

</warning>

## 步驟 4：設定提示詞

提示詞決定 Agent 的角色定義、語氣與限制。

1. 於 **提示詞設定** 欄位點擊 **提示詞模板**
2. 於 **提示詞模板** 對話框點選一項模板，再點擊 **確認**。模板內容會填入 **提示詞設定** 欄位
3. 依實際需求修改該內容

可選的模板如下：

<table>
<thead>
  <tr>
    <th>
      模板
    </th>
    
    <th>
      適用情境
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        一般問答助理
      </strong>
    </td>
    
    <td>
      依文件內容回答問題，並提供相關背景資訊
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        人資助理
      </strong>
    </td>
    
    <td>
      回答公司政策、福利、薪資與培訓相關問題
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        IT 支援機器人
      </strong>
    </td>
    
    <td>
      回答技術問題，提供明確的操作步驟
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        客服助理
      </strong>
    </td>
    
    <td>
      回答產品、服務、訂單狀態與退換貨政策
    </td>
  </tr>
</tbody>
</table>

![提示詞模板對話框](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-4-1.webp)

![套用模板後的提示詞設定欄位](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-4-2.webp)

<tip>

**提示詞內容較長時可放大編輯：**

點擊 **提示詞設定** 欄位右下角的展開圖示，即可於 **進階提示設定** 對話框中編輯，完成後點擊 **套用**。

</tip>

## 步驟 5：建立 Agent

點擊頁面右下角的 **建立**。

建立成功時畫面顯示「**建立成功／AI Agent 已成功建立**」，並返回 **AI Agent** 頁面，清單中出現該 Agent 的卡片。卡片右上角的切換開關控制 Agent 的啟用狀態。

![表單底部的建立按鈕](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-5-1.webp)

![建立成功提示與新的 Agent 卡片](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-5-2.webp)

## 步驟 6：驗證回答品質

建立完成後，請先確認 Agent 能從檔案中找到正確內容，再對外開放。

**確認檔案已處理並可被搜尋：**

1. 於 **AI Agent** 頁面點擊該 Agent 的卡片，進入 **檔案來源** 分頁
2. 確認清單中已列出步驟 1 上傳的檔案
3. 於 **搜尋檔案內容...** 欄位輸入關鍵字，確認結果列出相關的內容片段。查無結果時顯示「**沒有符合的檔案內容**」
4. 要確認某個檔案的辨識結果時，點擊該列的 **查看解析結果**，對話框會並列 **原始頁面** 與 **解析結果**

**以測試對話確認回答：**

1. 切換至 **設定** 分頁
2. 於右側 **測試對話** 面板點選預設問題，問題會帶入 **輸入問題測試此 Agent** 欄位；也可以直接於該欄位輸入問題
3. 點擊送出圖示
4. 確認回答內容與檔案相符。點開回答上方的 **參考文件**，可查看回答引用的檔案與頁碼

**測試對話** 會套用左側目前的設定，包含尚未儲存的變更。按下 **儲存** 後，變更才會對其他使用者生效。

![Agent 的檔案來源分頁](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-6-1.webp)

![搜尋檔案內容後列出相符的內容片段](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-6-2.webp)

![查看解析結果對話框，並列原始頁面與解析結果](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-6-3.webp)

![設定分頁右側的測試對話面板與回答](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/first-ai-agent/step-6-4.webp)

## 疑難排解

<table>
<thead>
  <tr>
    <th>
      症狀
    </th>
    
    <th>
      可能原因
    </th>
    
    <th>
      處理方式
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Agent 卡片顯示 <code>
        檔案來源 <名稱> 已斷線
      </code>
    </td>
    
    <td>
      該檔案來源所屬的 NAS 無法連線
    </td>
    
    <td>
      檢查 NAS 的網路狀態與憑證，見<a href="https://docs.ardge.com/zh-tw/knowledge/argent/nas-file-source">
        連接 NAS 共享資料夾作為檔案來源
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      Agent 卡片顯示 <code>
        檔案來源 <名稱> 同步失敗
      </code>
    </td>
    
    <td>
      該檔案來源的同步未成功完成，或其中有檔案轉換失敗（狀態為 <strong>
        部分完成
      </strong>
      
      ）
    </td>
    
    <td>
      進入該來源的明細頁處理失敗的檔案。狀態為 <strong>
        部分完成
      </strong>
      
       時，已處理成功的檔案仍可被搜尋。見<a href="https://docs.ardge.com/zh-tw/knowledge/argent/source-statuses">
        檔案來源的處理狀態代表什麼？
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      Agent 卡片顯示 <code>
        同步中
      </code>
    </td>
    
    <td>
      檔案來源正在同步
    </td>
    
    <td>
      待同步結束後再開啟
    </td>
  </tr>
  
  <tr>
    <td>
      檔案清單中某個檔案帶有失敗圖示
    </td>
    
    <td>
      該檔案未能轉換成功
    </td>
    
    <td>
      將游標停留在圖示上查看原因，見<a href="https://docs.ardge.com/zh-tw/knowledge/argent/conversion-failures">
        檔案轉換失敗時該如何處理？
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        搜尋失敗，請再試一次
      </code>
    </td>
    
    <td>
      搜尋請求未成功完成
    </td>
    
    <td>
      確認向量化模型正在執行後重試
    </td>
  </tr>
  
  <tr>
    <td>
      測試對話顯示 <code>
        尚未設定可用的語言模型，請聯絡系統管理員。
      </code>
    </td>
    
    <td>
      模型設定未選擇大語言模型
    </td>
    
    <td>
      見<a href="https://docs.ardge.com/zh-tw/knowledge/argent/model-connection">
        設定 ARGENT 的模型連線
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        無法建立 AI Agent，請稍後再試
      </code>
    </td>
    
    <td>
      建立請求未成功送達
    </td>
    
    <td>
      稍後重新點擊 <strong>
        建立
      </strong>
    </td>
  </tr>
</tbody>
</table>

## 後續步驟

要讓外部訪客不必登入即可使用此 Agent，請見[將 AI Agent 嵌入你的網站](https://docs.ardge.com/zh-tw/knowledge/argent/embed-on-website)。

## 相關文章

- [設定 ARGENT 的模型連線](https://docs.ardge.com/zh-tw/knowledge/argent/model-connection)
- [檔案來源該用「手動上傳」還是「從 NAS 選取」？](https://docs.ardge.com/zh-tw/knowledge/argent/local-or-remote)
- [ARGENT 支援哪些檔案格式與限制？](https://docs.ardge.com/zh-tw/knowledge/argent/formats-and-limits)
- [查看 ARGENT 的使用狀況與對話紀錄](https://docs.ardge.com/zh-tw/knowledge/argent/usage-analytics)


## Sitemap

See the full [sitemap](https://docs.ardge.com/sitemap.md) for all pages.