查看和更新知識庫文檔切片（ListChunks、UpdateChunks） - Tablestore

文檔上傳後由系統自動切片（Chunk）。每個 Chunk 儲存向量資料和原文內容，是檢索的最小單元。通過以下介面查看和調整切片內容。

查看切片

調用 list_chunks 分頁查詢指定文檔的切片列表。

請求參數

參數	類型	說明
`knowledgeBaseName`	string	知識庫名稱（必填）
`subspace`	string	子空間名稱。開啟 subspace 時必填
`docId`	string	文檔 ID。與 `ossKey` 二選一
`ossKey`	string	OSS 路徑。與 `docId` 二選一
`maxResults`	int	返回數量。預設為 10，最大 1000
`nextToken`	string	翻頁 token

程式碼範例

resp = client.list_chunks({
    "knowledgeBaseName": "product_docs_kb",
    "docId": "fc6ed97f-...",
    "maxResults": 5
})

for chunk in resp["data"]["chunkDetails"]:
    print(f"[Chunk {chunk['chunkId']}] ({chunk['status']}) {chunk['content'][:80]}...")

響應說明

欄位	類型	說明
`chunkDetails[].subspace`	string	所屬子空間
`chunkDetails[].chunkId`	int	切片 ID
`chunkDetails[].content`	string	切片內容
`chunkDetails[].title`	string	切片標題
`chunkDetails[].chunkType`	string	切片類型，如 `TEXT`
`chunkDetails[].status`	string	`active`（可檢索）或 `inactive`（不可檢索）
`chunkDetails[].docId`	string	所屬文檔 ID
`chunkDetails[].ossKey`	string	所屬文檔 OSS 路徑
`chunkDetails[].createdAt`	int	建立時間戳記
`chunkDetails[].updatedAt`	int	更新時間戳記
`nextToken`	string	翻頁 token，為空白表示最後一頁

更新切片

調用 update_chunks 批次更新切片的標題、內容或狀態。

請求參數

參數	類型	說明
`knowledgeBaseName`	string	知識庫名稱（必填）
`subspace`	string	子空間名稱。開啟 subspace 時必填
`chunks`	list<object>	要更新的切片列表（必填）。單次請求最多 10 個切片。說明如需提升請提交工單或加入Table Store技術交流群36165029092後聯絡支援人員。
`chunks[].docId`	string	文檔 ID。與 `ossKey` 二選一
`chunks[].ossKey`	string	OSS 路徑。與 `docId` 二選一
`chunks[].chunkId`	int	切片 ID（必填）
`chunks[].title`	string	更新標題
`chunks[].content`	string	更新內容
`chunks[].status`	string	修改狀態：`active`（可檢索）或 `inactive`（不可檢索）

程式碼範例

修改切片內容：

resp = client.update_chunks({
    "knowledgeBaseName": "product_docs_kb",
    "chunks": [
        {
            "docId": "fc6ed97f-...",
            "chunkId": 1,
            "title": "更新後的標題",
            "content": "更新後的內容"
        }
    ]
})

屏蔽不準確的切片（設為不可檢索）：

resp = client.update_chunks({
    "knowledgeBaseName": "product_docs_kb",
    "chunks": [
        {
            "docId": "fc6ed97f-...",
            "chunkId": 0,
            "status": "inactive"
        }
    ]
})

響應說明

欄位	類型	說明
`updateDetails[].docId`	string	文檔 ID
`updateDetails[].ossKey`	string	OSS 路徑
`updateDetails[].chunkId`	int	切片 ID
`updateDetails[].updateStatus`	string	`succeed` 或 `failed`
`updateDetails[].failureReason`	string	失敗原因，僅 failed 時

注意事項

將切片的 status 設為 inactive 後，該切片不會出現在 Retrieve 結果中。可用於臨時屏蔽不準確的內容，無需刪除整個文檔。