文檔讀取節點

定義

文件讀取節點可以讀取已上傳至「文件」中的內容，並將其儲存為變數，供工作流程中的後續節點使用。例如，讀取的內容可以作為變數傳遞給大模型節點，讓大模型理解內容並進行問答互動。

如何配置

文件

添加「文件讀取節點」至畫布後，點擊節點可在右側配置欄進行配置。點擊「+」選擇需要讀取的檔案，最多可選擇10個檔案。需配置所選每個檔案的「目標變數名稱」（必填），輸出變數的格式為「字串」。

• 一個文件讀取節點可讀取一個或多個檔案，透過點擊「+」新增檔案；
• 變數/表達式：在此輸入完整的檔案名稱與路徑，例如分類1/分類2/檔案名稱，即可讀取對應路徑下的檔案。此對話框支援插入變數。一個變數/表達式輸入框僅支援輸入一個檔案的路徑。

小技巧：透過在「變數/表達式」插入變數的方式，可以靈活讀取檔案內容。例如：在對話式工作流程中，透過自然語義變數擷取器擷取到檔案路徑/名稱，插入文件讀取節點的「變數/表達式」輸入框中，即可在工作流程中輕鬆調用指定檔案。

常見使用場景

• 檢查檔案內容
  使用文件讀取節點讀取檔案後，可以添加審查節點（例如使用大模型節點），並配置審查規則以檢查檔案內容是否符合要求（例如格式是否正確、是否有敏感資訊等）。如果發現不符合規則的內容，可透過後續節點發出警示或修改建議，以確保檔案始終符合標準與規範。
• 內容比較
  使用文件讀取節點讀取檔案後，可以配置後續節點進行檔案內容比較。例如，若檔案內容為採購客戶名單，後續節點可以引用此變數來判斷特定客戶是否為採購客戶（例如使用大模型節點或程式碼執行節點）。如果匹配成功，可以觸發相應的處理流程，以實現精確的客戶關係管理。
• 檔案內容快速查詢
  使用文件讀取節點讀取檔案後，可以配置後續節點進行快速查詢。例如，如果檔案內容是售後政策，後續節點可以引用此變數，加入查詢節點（例如使用大模型節點），並依據客戶回饋快速輸出相應的售後政策，從而提高服務效率和客戶滿意度。

「文件讀取節點」和「知識檢索節點」的區別

文件讀取節點錯誤處理分支說明

「文件讀取節點」支援在同一個節點中讀取多個檔案，並分別輸出為不同變數。

在實際使用中，可能會出現部分檔案讀取成功、部分檔案讀取失敗的情況。例如：某個檔案路徑設定錯誤、目標檔案不存在，或目前使用者沒有該檔案的存取權限。

因此，當「文件讀取節點」的錯誤處理方式設定為「預設值」時，系統會提供「預設值生效範圍」設定，用於控制預設值的套用方式。

選擇「僅出錯項」時，即使某個檔案讀取失敗，節點仍會繼續運作。失敗的檔案變數會輸出預設值，其他成功讀取的檔案變數仍會正常輸出真實內容。

選擇「所有項」時，只要有任一檔案讀取失敗，目前節點下的所有輸出變數都會統一回退至預設值。

此機制適用於同一節點同時讀取多個檔案的情境，可避免因單一檔案讀取失敗，導致整個節點沒有可用輸出。

簡單案例展示

AirDroid家長控制軟體用戶助手（服務式工作流程）：回答用戶關於如何使用AirDroid家長控制的任何疑問。

• 開始節點：添加一個 "問題" 變數來輸入用戶的問題。
• 文件讀取節點：上傳並讀取「文件」中的「AirDroid家長控制用戶指南」檔案。
• 大模型節點：
  • 系統：您是AirDroid家長控制的產品助理，請回答用戶關於如何使用AirDroid家長控制的問題。
  • 用戶：插入用戶的問題，即 "問題" 變數。
• 結束節點：選擇由大模型節點輸出的變數，即「文字 (字串)」。

注意事項

• 您最多只能添加10個檔案。
• 如果文件裡的檔案更新，則需要重新訓練並測試輸出結果是否準確。
• 必須填寫輸出變數名稱，否則無法選擇。