--- url: https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/gdrive-kb-sync.md description: >- Google Drive 連線除了讓 AI 在對話時即時讀檔，也可以定期把資料夾裡的檔案匯入知識庫：來源新增、修改、刪除都會跟著同步，AI 用語意檢索找答案並附上出處。這篇說明怎麼設定、多久同步一次、哪些檔案會匯入，以及在知識庫裡改了同步檔案會怎樣。 --- 看完這篇，你可以把一條 Google Drive 連線同步到知識庫資料夾，並看懂同步狀態與知識庫裡的「同步」標記。 ## 開始前 * 先建好 Google Drive 連線並儲存，見[把 Google Drive 資料夾分享給服務帳號](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/gdrive-share-folder.md)。目前只有 **Google Drive** 連線有這個功能；HTTP API、資料庫、MCP、網站連線沒有。 * 先在知識庫建一個資料夾，用來放同步進來的檔案，見[資料夾](https://docs.oakxgen.ai/zh-Hant-TW/guide/knowledge/folders.md)。 * 新增同步、立即同步需要**編輯工具**＋**上傳檔案**能力；只看同步設定需要**檢視工具**。 ## 同步和「動作」差在哪 | | Drive 連線的動作（搜尋、讀取） | 同步到知識庫 | |---|---|---| | 什麼時候讀 Drive | 客人問到時才即時去讀 | 每天（或你按立即同步時）匯入一次 | | AI 怎麼找答案 | 先搜尋檔名，再讀整份檔案 | 跟其他知識庫文件一樣，用語意檢索找段落並附出處 | | 適合 | 一定要讀到最新一秒的檔案，例如即時價目表 | 文件多、內容不常變，想讓 AI 像查知識庫一樣精準引用 | 兩種可以同時用。同步範圍就是連線**資料夾範圍**裡勾選的資料夾（含子資料夾），同步分頁裡不能另外挑。 ## 設定同步 1. 到**工具庫**打開已儲存的 Google Drive 連線，切到左側的**同步到知識庫**。 2. 在**同步到資料夾**選要放檔案的知識庫資料夾（已經在同步的資料夾不能再選）。 3. **頻率**選**每天**或**手動**。 4. 按**新增同步**，右上角出現「已新增，按「立即同步」或等排程開始匯入」。 5. 要馬上匯入就按那一列的**立即同步**；完成後出現「同步完成」，列下方顯示上次同步時間與「新增 N」這類統計。 下面的動畫示範在「示範：門市價目表 Drive」按**立即同步**：幾秒後右上角出現「同步完成」，列下方顯示新增 1 個檔案。 [動畫（MP4）](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/images/gdrive-kb-sync-02-sync-now.mp4) 下圖是設定好之後的分頁：上面一列是同步到「示範：Drive 價目表同步」，狀態**正常**，右邊依序是頻率、暫停開關、**立即同步**與刪除；下面是新增另一筆同步的欄位。 ![同步到知識庫分頁，一筆同步到示範：Drive 價目表同步、狀態正常、新增 1，下方是新增同步的欄位](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/images/gdrive-kb-sync-03-status.png) 同一條連線可以同步到多個資料夾，但同一個資料夾只能設一次（重複會出現「這條連線已經同步到這個資料夾了」）。 ## 多久同步一次、同步什麼 | 項目 | 規則 | |---|---| | **每天** | 沒有固定時刻；距離上次同步約 23 小時後的下一輪排程自動執行 | | **手動** | 只在按**立即同步**時執行 | | 暫停 | 關掉那一列的開關（「暫停同步」），排程與立即同步都不跑；打開「恢復同步」 | | 新增、修改 | 來源有新檔或內容改了就匯入；沒變的檔案不重新下載 | | 改名、搬移 | 只更新檔名，不重新處理內容 | | 刪除 | 來源刪掉的檔案，知識庫裡也會刪除 | | Google 文件／試算表／簡報 | 分別轉成 Markdown、Excel（每個工作表都會匯入）、純文字；表單、繪圖這類無法匯出的會略過 | | 其他檔案 | 支援 PDF、Word、Excel、CSV、Markdown、純文字、HTML、圖片；單檔超過 20 MB 會略過 | 檔案多的時候一次可能跑不完，狀態會是**未跑完**，提示「檔案比較多，這次沒跑完，排程會自動接著同步」。圖片與需要視覺辨識的 PDF 會用到 AI，用量記在 [AI 用量](https://docs.oakxgen.ai/zh-Hant-TW/guide/settings/usage.md)頁。 ## 狀態與提示 | 狀態 | 意思 | 怎麼辦 | |---|---|---| | **正常** | 上次同步完成 | — | | **部分失敗** | 有些檔案沒匯入成功 | 看列下方的失敗數，檢查那些檔案的格式或大小 | | **失敗** | 整次同步失敗，提示「同步失敗，請檢查連線設定後再試一次」或後端原文 | 先按連線的**測試連線**，確認資料夾還分享給服務帳號 | | **未跑完** | 檔案太多，這次沒跑完 | 等下一輪排程，或再按一次立即同步 | | **點數不足** | 點數用完，後面的檔案沒匯入 | 加值後下一次同步會補上 | | **刪除暫停** | 這次掃到的檔案不到上次的一半，為了安全先不刪除 | 確認來源資料夾沒有被搬走或權限沒被改掉；確定要刪就等下一次同步 | ## 知識庫裡的同步標記 同步進來的資料夾，在知識庫左側名稱旁有一個同步圖示（暫停時是灰色、上次有問題時是紅色）；點進資料夾，上方有一條提示「由「連線名稱」同步」，每個檔案旁標著**同步**。 ![知識庫裡的同步資料夾，上方提示由示範：門市價目表 Drive 同步，檔案旁標著同步](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/images/gdrive-kb-sync-04-kb-folder.png) 同步進來的檔案在知識庫裡改或刪，下次同步會被來源的版本蓋回來；要改內容請改 Google Drive 上的檔案。按提示右邊的**查看同步設定**可以回到連線的同步分頁。 ## 常見問題 ### 刪掉同步設定後，已經匯入的檔案會怎樣 會留在知識庫裡。刪除時的確認視窗寫著「之後不會再同步到「資料夾名稱」。已經匯入的檔案會留在知識庫裡，要刪請到資料夾裡刪。」 ### 這個同步已經暫停，先恢復再同步 按**立即同步**時那一列是暫停的。先打開開關（恢復同步）再按。 ### 這個同步正在進行中，請稍後再看結果 上一次同步還沒跑完，等一下重新整理頁面看狀態。 ### 同步分頁沒出現 連線還沒儲存，或不是 Google Drive 連線。先按**儲存**，再重新打開這條連線。 ## 延伸閱讀 * [把 Google Drive 資料夾分享給服務帳號](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/gdrive-share-folder.md) * [價目表放在 Google Drive，改了檔案，AI 馬上照新的講](https://docs.oakxgen.ai/zh-Hant-TW/guide/scenarios-tutorials/gdrive-price-list-live-update.md) * [資料來源怎麼設](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/data-sources.md)