修改知識庫中指定文本切片的內容(content)和標題(title),並設定是否參與知識庫檢索。
介面說明
- 關鍵限制:本介面僅支援文檔搜尋類知識庫,不支援資料查詢和圖片問答類知識庫。
- 許可權要求:
- 調用方式:推薦使用最新版阿里雲百鍊 SDK調用,SDK 已封裝複雜的簽名計算邏輯,可簡化您的調用過程。
- 生效延遲:更新後通常立即生效,高峰期可能稍有延遲(秒級)。
- 等冪性:本介面具有等冪性。對已成功更新的文本切片進行重複操作時,介面將返回成功響應。
限流說明: 本介面頻繁調用會被限流,頻率請勿超過 10 次/秒。如遇限流,請稍後重試。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
授權資訊
下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:
- 操作:是指具體的許可權點。
- 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支援授權的資源類型。具體說明如下:
- 對於必選的資源類型,用前面加 * 表示。
- 對於不支援資源級授權的操作,用
全部資源表示。
- 條件關鍵字:是指雲產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。
| 操作 | 存取層級 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| sfm:UpdateChunk | update | *全部資源 * |
| 無 |
請求文法
POST /{WorkspaceId}/chunk/update HTTP/1.1
請求參數
| 名稱 | 類型 | 必填 | 描述 | 樣本值 |
|---|---|---|---|---|
| PipelineId | string | 是 | 知識庫 ID,即通過 CreateIndex 介面建立時返回的 | 79c0alxxxx |
| DataId | string | 是 | 檔案 ID,即 AddFile 介面返回的 | doc_c134aa2073204a5d936d870bf960f56axxxxxxxx |
| ChunkId | string | 是 | 需要修改的文本切片 ID,可通過 ListChunks 介面擷取,其值位於返回結果中 Node.Metadata._id 欄位。 | llm-5ip55o1zrzxx_09fe52x_xxxxx_033b551e10024029992e79767b151fxx_10024xx_0 |
| IsDisplayedChunkContent | boolean | 是 | 指定此文本切片是否參與知識庫檢索。可能值:
預設值為 true。 | true |
| content | string | 是 | 文本切片的新內容。內容長度必須在 10 到 6000 個字元之間,且不能超過建立知識庫時設定的最大分段長度。 | 在哲學中所獲得的確定性類型不是科學的確定性(即對每個人的理智來說都一樣的確定性),而是一種要在人類的整體本質中才能獲得的親證。哲學的每一形態都不同於科學,因為所有的哲學都沒有得到一致的認可... |
| WorkspaceId | string | 是 | 知識庫所屬的業務空間 ID。擷取方式請參見如何使用業務空間。 | llm-3z7uw7fwz0vexxxx |
| title | string | 否 | 文本切片的新標題。長度限制為 0-50 個字元,允許傳入Null 字元串。如果傳入Null 字元串,將清空已有標題;如果不傳此參數,則保持原標題不變。 | 什麼是哲學 |
返回參數
樣本
正常返回樣本
JSON格式
{
"RequestId": "35A267BF-xxxx-54DB-8394-AA3B0742D833",
"Code": "",
"Message": "",
"Success": true,
"Data": true,
"Status": 200
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
