刪除知識庫中的指定文本切片,被刪的文本切片將無法被檢索和召回。
介面說明
警告 文本切片被刪除後無法恢複(硬刪除),請謹慎操作。
- 許可權要求:
- 調用方式:推薦使用最新版阿里雲百鍊 SDK調用,SDK 已封裝複雜的簽名計算邏輯,可簡化您的調用過程。
- 生效延遲:更新後通常立即生效,高峰期可能稍有延遲(秒級)。
- 等冪性:本介面具有等冪性。對已成功刪除的文本切片進行重複操作時,介面將返回成功響應。
限流說明: 本介面頻繁調用會被限流,頻率請勿超過 10 次/秒。如遇限流,請稍後重試。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
授權資訊
下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:
- 操作:是指具體的許可權點。
- 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支援授權的資源類型。具體說明如下:
- 對於必選的資源類型,用前面加 * 表示。
- 對於不支援資源級授權的操作,用
全部資源表示。
- 條件關鍵字:是指雲產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。
| 操作 | 存取層級 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| sfm:DeleteChunk | delete | *全部資源 * |
| 無 |
請求文法
POST /{WorkspaceId}/chunk/delete HTTP/1.1
請求參數
| 名稱 | 類型 | 必填 | 描述 | 樣本值 |
|---|---|---|---|---|
| PipelineId | string | 是 | 知識庫 ID,即 CreateIndex 介面返回的 | 79c0alxxxx |
| WorkspaceId | string | 是 | 知識庫所屬的業務空間 ID。擷取方式請參見如何使用業務空間。 | llm-3z7uw7fwz0vexxxx |
| ChunkIds | array | 是 | 需要刪除的文本切片列表(單次最多傳入 10 個文本切片 ID)。 | |
| string | 是 | 文本切片 ID,即 ListChunks 介面返回的 Node 對象裡 | llm-5ip55o1zrzxx_09fe52x_xxxxx_033b551e10024029992e79767b151fxx_10024xx_0 |
返回參數
樣本
正常返回樣本
JSON格式
{
"RequestId": "35A267BF-xxxx-54DB-8394-AA3B0742D833\n",
"Code": "",
"Message": "",
"Success": true,
"Data": true,
"Status": 200
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
