全部產品
Search
文件中心

:ListChunks - 查詢索引下的分區列表

更新時間:Aug 13, 2025

對於非結構化知識庫,擷取指定文檔的所有切片的詳細資料;對於結構化知識庫,擷取所有文本切片的詳細資料。

介面說明

  • RAM 使用者(子帳號)需要首先擷取阿里雲百鍊的 API 許可權(需要AliyunBailianDataFullAccess,已包括 sfm:ChunkList 許可權點),並加入一個業務空間後,方可調用本介面。阿里雲帳號(主帳號)可直接調用無須授權。建議您通過最新版阿里雲百鍊 SDK來調用本介面。

  • 調用本介面前,請確保您的知識庫已經建立完成且未被刪除(即知識庫 IDIndexId有效)。

  • 本介面具有等冪性。

限流說明: 本介面頻繁調用會被限流,頻率請勿超過 10 次/秒。如遇限流,請稍後重試。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

sfm:ChunkList

list

*全部資源

*

請求文法

POST /{WorkspaceId}/index/list_chunks HTTP/1.1

請求參數

名稱

類型

必填

描述

樣本值

WorkspaceId

string

知識庫所屬的業務空間 ID。擷取方式請參見如何使用業務空間

llm-3z7uw7fwz0vxxxx

body

object

請求參數的主體資訊。

Fields

array

Fields 是一個欄位名數組,用於對本介面返回的 Metadata 欄位中的非私人 Field(以_底線為首碼)進行過濾。預設 Fields 為空白時,Metadata 欄位中的所有非私人的 Field 都會返回。若您希望返回的 Metadata 欄位只包含指定的非私人 Field,比如只包含 title,則此處傳入 title 即可。

預設值為空白。

string

欄位名。

name

Filed

string

本欄位為阿里雲百鍊舊版 SDK 中的文檔 ID 欄位。具體用法和預設值與FileId欄位完全一致。如果您使用的阿里雲百鍊 SDK 是以下版本(或更新版本),推薦改用 FileId 欄位指定文檔 ID。如果您使用的是 SWIFT 語言的阿里雲百鍊 SDK,請繼續使用本欄位。

  • Java(非同步):1.0.18

  • Java:1.10.2

  • TypeScript:1.10.2

  • Go:1.10.2

  • PHP:1.10.2

  • Python:1.10.2

  • C#:1.10.2

  • C++:1.10.17

說明

如何查看阿里雲百鍊 SDK 版本:訪問阿里雲百鍊 SDK 中心,單擊左側導覽列中的“安裝”,API 版本選擇“2023-12-29”,然後選擇您的開發語言,再單擊“歷史版本”即可查看。

file_5f03dfea56da4050ab68d61871fc4cb3_xxxxxxxx

FileId

string

文檔 ID,即 AddFile 介面返回的FileId。結構化知識庫不用傳入此欄位;非結構化知識庫必須傳入此欄位。您也可以在 應用資料頁面,單擊檔案名稱旁的 ID 表徵圖擷取。可以通過文檔 ID 篩選返回的切片。預設值為空白。

file_5f03dfea56da4050ab68d61871fc4cb3_xxxxxxxx

IndexId

string

知識庫 ID,即 CreateIndex 介面返回的Data.Id

otoru9xxxx

PageNum

integer

指定要查詢的頁碼。起始值為 1,預設值為 1。

1

PageSize

integer

指定分頁查詢時每頁展示的文本切片數量。最大為 100。預設值為 10。

10

返回參數

名稱

類型

描述

樣本值

object

Code

string

錯誤狀態代碼。

Index.InvalidParameter

Data

object

介面返回的業務欄位。

Nodes

array<object>

文本切片列表。

object

文本切片對象。

Metadata

any

文本切片的中繼資料 Map。

{ "file_path": "https://bailian-***", "parent": "阿里雲百鍊是一站式的大模型開發及應用構建平台。不論是開發人員還是業務人員,都能深入參與大模型應用的設計和構建。您可以通過簡單的介面操作,在 5分鐘內開發出一款大模型應用,或在幾小時內訓練出一個專屬模型,從而將更多精力專註於應用創新。", "is_displayed_chunk_content": "true", "image_url": [], "nid": "83***", "source": "0", "_score": 0, "title": "", "doc_id": "file_24e***", "content": "阿里雲百鍊是一站式的大模型開發及應用構建平台。不論是開發人員還是業務人員,都能深入參與大模型應用的設計和構建。您可以通過簡單的介面操作,在 5分鐘內開發出一款大模型應用,或在幾小時內訓練出一個專屬模型,從而將更多精力專註於應用創新。", "_rc_score": 0, "workspace_id": "llm-zna***", "hier_title": "", "doc_name": "什麼是阿里雲百鍊", "pipeline_id": "j6b***", "_id": "llm-zna5***" }

Score

number

文本切片的相似性得分。

0

Text

string

文本切片內容。

阿里雲百鍊是一站式的大模型開發及應用構建平台。不論是開發人員還是業務人員,都能深入參與大模型應用的設計和構建。您可以通過簡單的介面操作,在 5分鐘內開發出一款大模型應用,或在幾小時內訓練出一個專屬模型,從而將更多精力專註於應用創新。

Total

integer

返回結果的總條數。

1

Message

string

錯誤資訊。

Required parameter(%s) missing or invalid, please check the request parameters.

RequestId

string

請求 ID。

8F97A63B-xxxx-527F-9D6E-467B6A7E8CF1

Status

string

介面返回的狀態代碼。

200

Success

boolean

介面調用是否成功,可能值:

  • true:成功。

  • false:失敗。

true

樣本

正常返回樣本

JSON格式

{
  "Code": "Index.InvalidParameter",
  "Data": {
    "Nodes": [
      {
        "Metadata": "{\n          \"file_path\": \"https://bailian-***\",\n          \"parent\": \"阿里雲百鍊是一站式的大模型開發及應用構建平台。不論是開發人員還是業務人員,都能深入參與大模型應用的設計和構建。您可以通過簡單的介面操作,在 5分鐘內開發出一款大模型應用,或在幾小時內訓練出一個專屬模型,從而將更多精力專註於應用創新。\",\n          \"is_displayed_chunk_content\": \"true\",\n          \"image_url\": [],\n          \"nid\": \"83***\",\n          \"source\": \"0\",\n          \"_score\": 0,\n          \"title\": \"\",\n          \"doc_id\": \"file_24e***\",\n          \"content\": \"阿里雲百鍊是一站式的大模型開發及應用構建平台。不論是開發人員還是業務人員,都能深入參與大模型應用的設計和構建。您可以通過簡單的介面操作,在 5分鐘內開發出一款大模型應用,或在幾小時內訓練出一個專屬模型,從而將更多精力專註於應用創新。\",\n          \"_rc_score\": 0,\n          \"workspace_id\": \"llm-zna***\",\n          \"hier_title\": \"\",\n          \"doc_name\": \"什麼是阿里雲百鍊\",\n          \"pipeline_id\": \"j6b***\",\n          \"_id\": \"llm-zna5***\"\n        }",
        "Score": 0,
        "Text": "阿里雲百鍊是一站式的大模型開發及應用構建平台。不論是開發人員還是業務人員,都能深入參與大模型應用的設計和構建。您可以通過簡單的介面操作,在 5分鐘內開發出一款大模型應用,或在幾小時內訓練出一個專屬模型,從而將更多精力專註於應用創新。"
      }
    ],
    "Total": 1
  },
  "Message": "Required parameter(%s) missing or invalid, please check the request parameters.",
  "RequestId": "8F97A63B-xxxx-527F-9D6E-467B6A7E8CF1",
  "Status": "200",
  "Success": true
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情