知識同步
你們的系統把整批會改版的文件送進 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