跳至主要内容
版本:PrivStation 2.6.0
Markdown 原文

Commit知識版本

此 API 用於將指定的 Fileset 提交為一個可查詢的知識版本。一旦執行 Commit,系統會:

  1. 針對 Fileset 中所有檔案根據解析模式進行內容解析與切段

  2. 將每段內容進行語意向量化(embedding)處理

  3. 提交後的版本具有穩定性與可追溯性,可在後續的 RAG 查詢中指定使用。

備註:已 Commit 的 Fileset 內容不可再修改,若需更新,請建立新的 Fileset 並重新 Commit。

curl -X 'POST' \
'http://127.0.0.1:8000/v1/filesets/{fileset_id}/commit' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <your-api-key>'

Request Headers​

KeyValue
Request MethodPOST
acceptapplication/json
AuthorizationBearer <your-api-key>
Content-Typeapplication/json

Query Parameters​

FieldTypeNoteRequired
fileset_idstringuuidtrue

Request Payload​

{
"embedding_model": "llama-3.2-nv-embedqa-1b-v2",
"parsing_mode": "HQ"
}

Field Explanation

FieldTypeDetailRequired
embedding_modelstring指定轉換成向量資料庫的模型true
parsing_modestring指定轉換的解析模式,包含 HQ、LQ、STDfalse

Response Body​

{
"detail": "Commit fileset with ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}