跳到內容

知識同步

你們的系統把整批會改版的文件送進 agent 的知識庫,例如規格書、作業標準。用你們自己的文件編號新增、更新、刪除,也可以列出來對帳。

規格書、作業標準這類文件常常改版。用知識同步,你們的系統一改版就送一次,agent 查到的永遠是最新版。我們用你們的文件編號認文件,不用標題。

你們的系統把文件送進知識庫示意圖
你們的系統用文件編號把文件送進知識庫。建好索引之後,agent 就查得到。改版或刪除也用同一個編號。

開始之前

請設定的人在 API 串接 上打開 能寫入的知識庫。這裡只列 agent 能編輯的知識庫。每個知識庫下面有它的 知識庫編號,網址裡要用它。

新增或更新一份文件

PUT /api/v1/kb/{知識庫編號}/documents/{文件編號}

送文字(Markdown 或純文字,最多 5 MB):

curl -X PUT "https://<你的網址>/api/v1/kb/<知識庫編號>/documents/SPEC-001" \
  -H "Authorization: Bearer dak_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "A100 規格書", "text": "# A100\n最大電流 20A。"}'

送檔案(PDF、Word、Excel 這類,跟上傳到知識庫一樣):

curl -X PUT "https://<你的網址>/api/v1/kb/<知識庫編號>/documents/SPEC-001" \
  -H "Authorization: Bearer dak_…" \
  -F "file=@A100.pdf" -F "title=A100 規格書"

回應:

{ "result": "created", "document": { "external_id": "SPEC-001", "title": "A100 規格書", "status": "queued", "error": null, "chunks": 0, "mime": "text/markdown", "size": 31, "updated_at": "…" } }
  • result 是 created(新的)、updated(換了內容)或 unchanged(內容與標題都一樣,不重建索引)。
  • 文件編號最多 200 個字,不能有斜線。
  • 一個編號對一份文件。壓縮檔請拆開,一份一份送。

看文件的狀態

GET /api/v1/kb/{知識庫編號}/documents/{文件編號}

status 意思
queued 排隊中
indexing 正在建索引
ready agent 查得到了
failed 失敗。error 寫了原因

對帳

GET /api/v1/kb/{知識庫編號}/documents 列出這個串接送進這個知識庫的全部文件,依文件編號排。用它找出你們那邊已經刪掉、這裡還在的文件。

刪除

DELETE /api/v1/kb/{知識庫編號}/documents/{文件編號}

段落、知識圖譜與原始檔一起刪掉。

在主控台看起來怎樣

  • 知識庫頁上,這些文件標著 API · 串接名稱。
  • 在主控台不能改內容,也不能改名。改了會被下次同步蓋掉。
  • 可以刪。刪了以後,下次同步會再加回來。
零散的文件用對話就好

偶爾一兩份文件,可以在對話裡附上檔案,請 agent 加進知識庫。agent 要有那個知識庫的編輯權限。

會遇到的狀況

狀況 原因 怎麼辦
404 not_found 串接沒打開這個知識庫,或 agent 沒有它的編輯權限 請設定的人打開,或給 agent 編輯權限
413 too_large 單一檔案超過上限 把檔案拆小
507 storage_full 團隊的知識庫空間滿了 請設定的人清掉不用的文件
failed,原因是解析失敗 檔案讀不出文字 改送文字,或換成 PDF

相關頁

本頁對應 v0.168.0