---
title: "檔案來源的處理狀態代表什麼？"
description: "檔案來源八種狀態的意義與後續動作、「部分完成」與「失敗」的分別，以及單一檔案在每次同步中的處理結果"
canonical_url: "https://docs.ardge.com/zh-tw/knowledge/argent/source-statuses"
---
# 檔案來源的處理狀態代表什麼？

> 檔案來源八種狀態的意義與後續動作、「部分完成」與「失敗」的分別，以及單一檔案在每次同步中的處理結果

## 快速解答

**檔案來源** 清單的 **上次執行結果** 欄顯示該來源最近一次同步的狀態，共八種。**完成** 與 **部分完成** 表示本輪同步的結果已可供 Agent 使用；**失敗** 與 **已停止** 表示本輪結果不完整。要查看單一檔案的處理結果，請開啟該來源的 **日誌**，再點選任一次同步。

## 詳細說明

### 八種狀態的意義與後續動作

<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>
        進行中
      </strong>
    </td>
    
    <td>
      同步正在執行
    </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>
  
  <tr>
    <td>
      <strong>
        失敗
      </strong>
    </td>
    
    <td>
      同步任務中止，未能完成本輪處理
    </td>
    
    <td>
      確認 NAS 可連線且帳號權限足夠，再重新啟動同步
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        已停止
      </strong>
    </td>
    
    <td>
      同步在執行中被手動停止
    </td>
    
    <td>
      需要時點擊同步圖示重新啟動同步
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        停止中
      </strong>
    </td>
    
    <td>
      已送出停止指令，任務正在收尾
    </td>
    
    <td>
      等待狀態轉為 <strong>
        已停止
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        刪除中
      </strong>
    </td>
    
    <td>
      已送出刪除指令，檔案來源正在移除
    </td>
    
    <td>
      等待處理結束
    </td>
  </tr>
</tbody>
</table>

### 「部分完成」與「失敗」的分別

兩者的差異在於任務本身有沒有跑完：

- **失敗** 指整個同步任務中止。常見情形是無法連線至 NAS，或帳號對共享資料夾沒有足夠權限，使任務無法繼續
- **部分完成** 指任務已完整執行完畢，但其中個別檔案在轉換階段失敗。其餘檔案均已處理成功

### 「部分完成」時 Agent 能不能用？

可以。狀態為 **部分完成** 時，已處理成功的檔案仍可被 Agent 檢索，但失敗的檔案不在其知識範圍內。

此時使用該來源的 Agent 卡片會顯示「**檔案來源 <名稱> 同步失敗**」，提醒你還有檔案需要處理。

### 單一檔案的處理結果

每次同步中，每個檔案都有各自的處理結果：

<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>
      已轉換並加入知識
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        失敗
      </strong>
    </td>
    
    <td>
      轉換失敗，原因見 <strong>
        失敗原因
      </strong>
      
       欄
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        未變更
      </strong>
    </td>
    
    <td>
      自上次同步後內容沒有變動，因此略過
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        不支援
      </strong>
    </td>
    
    <td>
      格式不在支援範圍內，因此略過
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        已移除
      </strong>
    </td>
    
    <td>
      檔案已不在來源中，已從知識中移除
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        移除失敗
      </strong>
    </td>
    
    <td>
      檔案已不在來源中，但從知識中移除時失敗
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        已停止
      </strong>
    </td>
    
    <td>
      同步被停止，此檔案未處理完成
    </td>
  </tr>
</tbody>
</table>

## 如何查看

1. 前往 **檔案來源** 頁面，於 **上次執行結果** 欄查看各來源的狀態
2. 點擊來源名稱進入明細頁，頁面上方的 **狀態** 卡片顯示同一數值
3. 於明細頁的檔案清單中，未能轉換成功的檔案會帶有失敗圖示。將游標停留在圖示上，即顯示該檔案的失敗原因

要查看歷次同步的結果時，請於 **檔案來源** 清單中該列右側的功能選單點擊 **日誌**，每次執行的 **狀態** 皆列於其中。點選任一次執行，會開啟 **檔案處理結果**，列出每個檔案的處理結果與失敗原因。

## 相關文章

- [檔案轉換失敗時該如何處理？](https://docs.ardge.com/zh-tw/knowledge/argent/conversion-failures)
- [連接 NAS 共享資料夾作為檔案來源](https://docs.ardge.com/zh-tw/knowledge/argent/nas-file-source)


## Sitemap

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