---
title: "連接 NAS 共享資料夾作為檔案來源"
description: "在 ARGENT 新增 CIFS/SMB 檔案伺服器、以共享資料夾建立檔案來源並設定同步排程，再管理同步與查閱日誌"
canonical_url: "https://docs.ardge.com/zh-tw/knowledge/argent/nas-file-source"
---
# 連接 NAS 共享資料夾作為檔案來源

> 在 ARGENT 新增 CIFS/SMB 檔案伺服器、以共享資料夾建立檔案來源並設定同步排程，再管理同步與查閱日誌

## 概觀

企業既有文件多集中存放於 NAS 的共享資料夾。ARGENT 可直接連接 CIFS/SMB 共享資料夾作為檔案來源，無須將檔案逐一上傳。

建立完成後，ARGENT 會自共享資料夾取回檔案並處理為向量。之後每次同步時，系統會比對資料夾內容，處理其中新增、刪除與更新的檔案。同步可依排程自動執行，也可手動啟動。

本文說明如何新增 CIFS/SMB 檔案伺服器、以其中一個資料夾建立檔案來源，以及後續的同步管理與日誌查閱。

## 你將學會什麼

- 於 ARGENT 新增 CIFS/SMB 檔案伺服器並載入共享資料夾
- 以共享資料夾中的指定資料夾建立檔案來源，並設定同步排程
- 啟動與停止同步，並自日誌確認每次同步的檔案異動

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

## 適用版本

- ARGENT 1.0.1 及以上版本

## 開始之前

- 已完成 **模型連線** 設定，見[設定 ARGENT 的模型連線](https://docs.ardge.com/zh-tw/knowledge/argent/model-connection)
- ARX 裝置與 NAS 位於可互通的網段
- NAS 上的目標共享資料夾已開放 CIFS/SMB 存取

## 你需要準備的資訊

新增檔案伺服器需使用下列三項資訊，請於開始前取得：

<table>
<thead>
  <tr>
    <th>
      資訊
    </th>
    
    <th>
      用途
    </th>
    
    <th>
      取得位置
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        NAS 的 IP 位址或主機名稱
      </strong>
    </td>
    
    <td>
      指定連線目標
    </td>
    
    <td>
      NAS 的網路設定頁面
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        可存取共享資料夾的帳號
      </strong>
    </td>
    
    <td>
      通過 CIFS/SMB 驗證
    </td>
    
    <td>
      NAS 的使用者管理頁面
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        該帳號的密碼
      </strong>
    </td>
    
    <td>
      通過 CIFS/SMB 驗證
    </td>
    
    <td>
      同上
    </td>
  </tr>
</tbody>
</table>

## 步驟 1：新增 CIFS/SMB 檔案伺服器

檔案伺服器於建立檔案來源的頁面中新增，不需另行前往其他頁面。

1. 前往 **檔案來源** 頁面，點擊 **新增檔案來源**
2. 於 **來源類型** 選擇 **從 NAS 選取**
3. 於 **NAS 來源** 欄位右側點擊 **+**，開啟 **新增檔案伺服器** 對話框
4. 依下表填寫欄位
5. 點擊 **新增伺服器**

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

<tbody>
  <tr>
    <td>
      <strong>
        伺服器名稱
      </strong>
    </td>
    
    <td>
      此伺服器的識別名稱
    </td>
    
    <td>
      必填
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        IP位址/主機名稱
      </strong>
    </td>
    
    <td>
      NAS 的 IP 位址或主機名稱，例如 <code>
        192.168.0.100
      </code>
    </td>
    
    <td>
      必填
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        使用者帳號
      </strong>
    </td>
    
    <td>
      可存取共享資料夾的帳號
    </td>
    
    <td>
      必填
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        密碼
      </strong>
    </td>
    
    <td>
      該帳號的密碼
    </td>
    
    <td>
      必填
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        共享資料夾
      </strong>
    </td>
    
    <td>
      自下拉選單選取
    </td>
    
    <td>
      必填。前三個連線欄位填妥後才會載入清單
    </td>
  </tr>
</tbody>
</table>

新增成功時，畫面顯示「**伺服器已新增／伺服器「<伺服器名稱>」已成功新增。**」，且該伺服器出現在 **NAS 來源** 的下拉選單中。

![新增檔案來源頁面，已選擇從 NAS 選取](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/nas-file-source/step-1-1.webp)

![新增檔案伺服器對話框](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/nas-file-source/step-1-2.webp)

![管理 NAS 來源對話框](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/nas-file-source/step-1-3.webp)

<tip>

**伺服器集中於「管理 NAS 來源」維護：**

點擊 **NAS 來源** 欄位右側的齒輪圖示，開啟 **管理 NAS 來源** 對話框，即可編輯或刪除已新增的伺服器。刪除伺服器前，對話框會列出 **受影響的檔案來源**。

</tip>

## 步驟 2：建立檔案來源並設定同步排程

1. 於 **來源名稱** 欄位填入名稱
2. 於 **NAS 來源** 選取步驟 1 新增的伺服器
3. 於 **選擇資料夾：** 的清單中選取要納入的資料夾
4. 於 **同步排程** 勾選 **啟用**，選擇要同步的 **星期** 與 **時間**。不需要自動同步時，取消勾選 **啟用**
5. 點擊 **建立**

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

<tbody>
  <tr>
    <td>
      <strong>
        來源名稱
      </strong>
    </td>
    
    <td>
      檔案來源的識別名稱
    </td>
    
    <td>
      必填，頭尾不得有空格，且不得與既有的檔案來源同名
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        NAS 來源
      </strong>
    </td>
    
    <td>
      步驟 1 新增的伺服器
    </td>
    
    <td>
      必填。尚未新增時顯示「<strong>
        沒有可用的伺服器。請先新增遠端伺服器。
      </strong>
      
      」
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        選擇資料夾：
      </strong>
    </td>
    
    <td>
      要納入的資料夾
    </td>
    
    <td>
      必填。同一個資料夾只能由一個檔案來源使用
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        同步排程
      </strong>
    </td>
    
    <td>
      自動同步的星期與時間
    </td>
    
    <td>
      啟用時至少須選擇一天
    </td>
  </tr>
</tbody>
</table>

<note>

**支援的檔案格式及大小：**

單一檔案上限 150 MB，支援 TXT、MD、HTML、JSON、PDF、DOCX、PPTX、PNG、JPG、XLSX、CSV 等格式。詳見[ARGENT 支援哪些檔案格式與限制？](https://docs.ardge.com/zh-tw/knowledge/argent/formats-and-limits)。

</note>

建立成功時，畫面顯示「**文件同步任務已建立並啟動**」並返回 **檔案來源** 頁面。清單中該筆的 **來源路徑** 欄顯示伺服器名稱與資料夾路徑，**上次執行結果** 欄顯示同步狀態，**下次排程** 欄顯示下一次自動同步的時間。

![選取 NAS 來源後顯示的資料夾清單](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/nas-file-source/step-2-1.webp)

![已選取資料夾並設定同步排程](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/nas-file-source/step-2-2.webp)

![建立後的檔案來源清單與同步進度](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/nas-file-source/step-2-3.webp)

## 步驟 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>
        刪除
      </strong>
    </td>
    
    <td>
      刪除此檔案來源。仍被 Agent 使用時無法刪除
    </td>
  </tr>
</tbody>
</table>

**日誌** 以每次同步為一列，欄位如下：

<table>
<thead>
  <tr>
    <th>
      欄位
    </th>
    
    <th>
      內容
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        #
      </strong>
    </td>
    
    <td>
      該次同步的序號
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        開始時間
      </strong>
      
      ／<strong>
        結束時間
      </strong>
    </td>
    
    <td>
      該次同步的起訖時間
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        觸發方式
      </strong>
    </td>
    
    <td>
      <strong>
        排程
      </strong>
      
       或 <strong>
        手動
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        狀態
      </strong>
    </td>
    
    <td>
      該次同步的結果
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        總大小
      </strong>
      
      ／<strong>
        總檔案數
      </strong>
    </td>
    
    <td>
      該次同步結束時來源涵蓋的容量與檔案數
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        新增檔案數
      </strong>
      
      ／<strong>
        刪除檔案數
      </strong>
      
      ／<strong>
        更新檔案數
      </strong>
    </td>
    
    <td>
      該次同步新增、移除與重新處理的檔案數
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        不支援檔案數
      </strong>
    </td>
    
    <td>
      因格式不支援而略過的檔案數
    </td>
  </tr>
</tbody>
</table>

點擊日誌中的任一列，會開啟 **檔案處理結果**，逐一列出該次同步處理的 **檔案路徑**、**狀態**、**失敗原因** 與 **處理時間**。各狀態的意義見[檔案來源的處理狀態代表什麼？](https://docs.ardge.com/zh-tw/knowledge/argent/source-statuses)。

![停止同步確認視窗](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/nas-file-source/step-3-1.webp)

![檔案來源列的功能選單](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/nas-file-source/step-3-2.webp)

![日誌對話框](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/nas-file-source/step-3-3.webp)

## 疑難排解

<table>
<thead>
  <tr>
    <th>
      訊息
    </th>
    
    <th>
      可能原因
    </th>
    
    <th>
      處理方式
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        新增伺服器失敗：<錯誤>
      </code>
    </td>
    
    <td>
      帳號密碼有誤，或 NAS 無法連線
    </td>
    
    <td>
      於 NAS 端確認該帳號可存取共享資料夾，並確認網段互通
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        載入共享資料夾失敗：伺服器回傳的資料格式無效。
      </code>
    </td>
    
    <td>
      NAS 回傳的共享資料夾清單無法解析
    </td>
    
    <td>
      確認 NAS 的 CIFS/SMB 服務正常後重試
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        名稱已被其他檔案來源使用
      </code>
    </td>
    
    <td>
      <strong>
        來源名稱
      </strong>
      
       與既有的檔案來源重複
    </td>
    
    <td>
      改用其他名稱
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        頭尾不得輸入空格
      </code>
    </td>
    
    <td>
      <strong>
        來源名稱
      </strong>
      
       前後含空格
    </td>
    
    <td>
      移除空白字元
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        資料夾已被其他檔案來源使用
      </code>
    </td>
    
    <td>
      該資料夾已由另一個檔案來源使用
    </td>
    
    <td>
      改選尚未被使用的資料夾
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        請至少選擇一天。
      </code>
    </td>
    
    <td>
      已啟用 <strong>
        同步排程
      </strong>
      
      ，但未選擇星期
    </td>
    
    <td>
      選擇至少一天，或取消勾選 <strong>
        啟用
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        無法載入資料夾清單。
      </code>
    </td>
    
    <td>
      建立過程中無法讀取伺服器的目錄結構
    </td>
    
    <td>
      確認伺服器仍可連線後重試
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        啟動同步任務失敗，請稍後再試
      </code>
    </td>
    
    <td>
      檔案來源已建立，但同步任務未啟動
    </td>
    
    <td>
      回到 <strong>
        檔案來源
      </strong>
      
       清單，點擊該列的同步圖示手動啟動
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        此檔案來源正被 AI Agent 使用，請先在 Agent 設定中移除後稍候再試。
      </code>
    </td>
    
    <td>
      刪除的檔案來源仍連結在 Agent 上
    </td>
    
    <td>
      先於該 Agent 的 <strong>
        檔案來源
      </strong>
      
       分頁取消連結
    </td>
  </tr>
</tbody>
</table>

![資料夾已被其他檔案來源使用的錯誤訊息](https://docs.ardge.com/screenshots/knowledge/zh-tw/argent/nas-file-source/troubleshooting.webp)

## 後續步驟

檔案來源處理完成後，即可建立使用該來源的 Agent，見[建立你的第一個 AI Agent](https://docs.ardge.com/zh-tw/knowledge/argent/first-ai-agent)。

## 相關文章

- [檔案來源該用「手動上傳」還是「從 NAS 選取」？](https://docs.ardge.com/zh-tw/knowledge/argent/local-or-remote)
- [檔案來源的處理狀態代表什麼？](https://docs.ardge.com/zh-tw/knowledge/argent/source-statuses)
- [ARGENT 支援哪些檔案格式與限制？](https://docs.ardge.com/zh-tw/knowledge/argent/formats-and-limits)


## Sitemap

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