在使用 Dify 知識庫 API 過程中,很多開發者在調用 /datasets/{dataset_id}/document/update-by-text
接口時,常常會產生一個疑問:
?? 這個接口到底是 “智能差異更新” 還是 “純覆蓋更新”?
網上的資料并不多,很多人根據接口名誤以為是增量更新。今天我結合官方源碼 + 實際測試,給大家全面拆解一下 Dify 知識庫 API 中 “根據文本更新文檔” 的真實行為,避免大家踩坑!
?? 1?? API 接口名稱解析
Dify 提供的接口路徑如下:
/datasets/{dataset_id}/document/update-by-text
從名字 update-by-text
看起來像是 “更新已有文檔”,容易誤解成 智能 diff 更新 或 增量追加。
但實際行為和名字并不完全一致!