@alicloud/bailian20231229 2.5.0 → 2.6.0

package/dist/client.d.ts

@@ -107,7 +107,25 @@ export default class Client extends OpenApi {
      */
     applyFileUploadLease(CategoryId: string, WorkspaceId: string, request: $_model.ApplyFileUploadLeaseRequest): Promise<$_model.ApplyFileUploadLeaseResponse>;
     /**
-     * 修改类目解析配置
+     * 申请临时文件存储上传许可
+     *
+     * @param request - ApplyTempStorageLeaseRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns ApplyTempStorageLeaseResponse
+     */
+    applyTempStorageLeaseWithOptions(WorkspaceId: string, request: $_model.ApplyTempStorageLeaseRequest, headers: {
+        [key: string]: string;
+    }, runtime: $dara.RuntimeOptions): Promise<$_model.ApplyTempStorageLeaseResponse>;
+    /**
+     * 申请临时文件存储上传许可
+     *
+     * @param request - ApplyTempStorageLeaseRequest
+     * @returns ApplyTempStorageLeaseResponse
+     */
+    applyTempStorageLease(WorkspaceId: string, request: $_model.ApplyTempStorageLeaseRequest): Promise<$_model.ApplyTempStorageLeaseResponse>;
+    /**
+     * Configure the parsing method for a specific file type. For example, use LLM parsing for .pdf files, or use Qwen VL parsing for .jpg files.
      *
      * @param tmpReq - ChangeParseSettingRequest
      * @param headers - map
@@ -118,7 +136,7 @@ export default class Client extends OpenApi {
         [key: string]: string;
     }, runtime: $dara.RuntimeOptions): Promise<$_model.ChangeParseSettingResponse>;
     /**
-     * 修改类目解析配置
+     * Configure the parsing method for a specific file type. For example, use LLM parsing for .pdf files, or use Qwen VL parsing for .jpg files.
      *
      * @param request - ChangeParseSettingRequest
      * @returns ChangeParseSettingResponse
@@ -143,12 +161,17 @@ export default class Client extends OpenApi {
      */
     createAndPulishAgent(workspaceId: string, request: $_model.CreateAndPulishAgentRequest): Promise<$_model.CreateAndPulishAgentResponse>;
     /**
-     * Creates an unstructured knowledge base and imports one or more parsed documents into the knowledge base. You cannot create a structured knowledge base by calling an API operation. Use the console instead.
+     * Create a knowledge base of the document search type.
      *
      * @remarks
-     * 1.  You must first upload documents to [Data Management](https://bailian.console.aliyun.com/#/data-center) and obtain the `FileId`. The documents are the knowledge source of the knowledge base. For more information, see [Import Data](https://www.alibabacloud.com/help/en/model-studio/user-guide/data-import-instructions).
-     * 2.  This operation only initializes a knowledge base creation job. You must also call the [SubmitIndexJob](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-submitindexjob) operation to complete the job.
-     * 3.  This interface is not idempotent.
+     *   **Limits**: This operation can create only knowledge base of the document search type. Data query and image Q\\&A types are not supported. Use the console instead.
+     * *   **Required permissions**
+     *     *   **RAM users**: Must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) of Model Studio (such as the `AliyunBailianDataFullAccess` policy, which includes the sfm:CreateIndex permission required), and [become member of a workspace](https://help.aliyun.com/document_detail/2851098.html).
+     *     *   **Alibaba Cloud account**: Has the permission by default, and can call the operation directly.
+     * *   **Call method**: We recommend using the latest version of the [GenAI Service Platform SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29). The SDK encapsulates complex signature computational logic to simplify the call process.
+     * *   **What to do next**: This operation only initializes knowledge base creation job. After that, call **SubmitIndexJob** to complete the creation. Otherwise, you will get an empty knowledge base. For more information about the sample code, see [Knowledge base API guide](https://help.aliyun.com/document_detail/2852772.html).
+     * *   **Idempotence**: This operation is not idempotent. If you call the operation for multiple times, you may create several knowledge bases with the same name. We recommend following a "query first, then create" logic.
+     * **Rate limit:** Rate limiting will be triggered if you call this operation frequently. Do not exceed 10 times per second. If limiting is triggered, try again later.
      *
      * @param tmpReq - CreateIndexRequest
      * @param headers - map
@@ -159,12 +182,17 @@ export default class Client extends OpenApi {
         [key: string]: string;
     }, runtime: $dara.RuntimeOptions): Promise<$_model.CreateIndexResponse>;
     /**
-     * Creates an unstructured knowledge base and imports one or more parsed documents into the knowledge base. You cannot create a structured knowledge base by calling an API operation. Use the console instead.
+     * Create a knowledge base of the document search type.
      *
      * @remarks
-     * 1.  You must first upload documents to [Data Management](https://bailian.console.aliyun.com/#/data-center) and obtain the `FileId`. The documents are the knowledge source of the knowledge base. For more information, see [Import Data](https://www.alibabacloud.com/help/en/model-studio/user-guide/data-import-instructions).
-     * 2.  This operation only initializes a knowledge base creation job. You must also call the [SubmitIndexJob](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-submitindexjob) operation to complete the job.
-     * 3.  This interface is not idempotent.
+     *   **Limits**: This operation can create only knowledge base of the document search type. Data query and image Q\\&A types are not supported. Use the console instead.
+     * *   **Required permissions**
+     *     *   **RAM users**: Must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) of Model Studio (such as the `AliyunBailianDataFullAccess` policy, which includes the sfm:CreateIndex permission required), and [become member of a workspace](https://help.aliyun.com/document_detail/2851098.html).
+     *     *   **Alibaba Cloud account**: Has the permission by default, and can call the operation directly.
+     * *   **Call method**: We recommend using the latest version of the [GenAI Service Platform SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29). The SDK encapsulates complex signature computational logic to simplify the call process.
+     * *   **What to do next**: This operation only initializes knowledge base creation job. After that, call **SubmitIndexJob** to complete the creation. Otherwise, you will get an empty knowledge base. For more information about the sample code, see [Knowledge base API guide](https://help.aliyun.com/document_detail/2852772.html).
+     * *   **Idempotence**: This operation is not idempotent. If you call the operation for multiple times, you may create several knowledge bases with the same name. We recommend following a "query first, then create" logic.
+     * **Rate limit:** Rate limiting will be triggered if you call this operation frequently. Do not exceed 10 times per second. If limiting is triggered, try again later.
      *
      * @param request - CreateIndexRequest
      * @returns CreateIndexResponse
@@ -255,7 +283,18 @@ export default class Client extends OpenApi {
      */
     deleteCategory(CategoryId: string, WorkspaceId: string): Promise<$_model.DeleteCategoryResponse>;
     /**
-     * 删除切片信息
+     * Deletes a specified text chunk from a knowledge base. The deleted chunk cannot be retrieved or recalled.
+     *
+     * @remarks
+     * *
+     * **Warning** After a text chunk is deleted, it cannot be restored. Proceed with caution.
+     * *   **Required permissions**:
+     *     *   **RAM users**: Must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) of Model Studio (such as the `AliyunBailianDataFullAccess` policy, which includes the sfm:DeleteChunk permission required), and [become member of a workspace](https://help.aliyun.com/document_detail/2851098.html).
+     *     *   **Alibaba Cloud account**: Has the permission by default, and can call the operation directly.
+     * *   **Call method**: We recommend using the latest version of the [GenAI Service Platform SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29). The SDK encapsulates complex signature computational logic to simplify the call process.
+     * *   **Delay**: The update takes effect immediately. During peak hours, the update may take place in seconds.
+     * *   **Idempotence**: This operation is idempotent. If you perform a repeated operation on a chunk that has already been deleted, the interface returns a success.
+     * **Rate limit:** Rate limiting will be triggered if you call this operation frequently. Do not exceed 10 times per second. If limiting is triggered, try again later.
      *
      * @param tmpReq - DeleteChunkRequest
      * @param headers - map
@@ -266,7 +305,18 @@ export default class Client extends OpenApi {
         [key: string]: string;
     }, runtime: $dara.RuntimeOptions): Promise<$_model.DeleteChunkResponse>;
     /**
-     * 删除切片信息
+     * Deletes a specified text chunk from a knowledge base. The deleted chunk cannot be retrieved or recalled.
+     *
+     * @remarks
+     * *
+     * **Warning** After a text chunk is deleted, it cannot be restored. Proceed with caution.
+     * *   **Required permissions**:
+     *     *   **RAM users**: Must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) of Model Studio (such as the `AliyunBailianDataFullAccess` policy, which includes the sfm:DeleteChunk permission required), and [become member of a workspace](https://help.aliyun.com/document_detail/2851098.html).
+     *     *   **Alibaba Cloud account**: Has the permission by default, and can call the operation directly.
+     * *   **Call method**: We recommend using the latest version of the [GenAI Service Platform SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29). The SDK encapsulates complex signature computational logic to simplify the call process.
+     * *   **Delay**: The update takes effect immediately. During peak hours, the update may take place in seconds.
+     * *   **Idempotence**: This operation is idempotent. If you perform a repeated operation on a chunk that has already been deleted, the interface returns a success.
+     * **Rate limit:** Rate limiting will be triggered if you call this operation frequently. Do not exceed 10 times per second. If limiting is triggered, try again later.
      *
      * @param request - DeleteChunkRequest
      * @returns DeleteChunkResponse
@@ -460,7 +510,7 @@ export default class Client extends OpenApi {
      */
     getAlipayUrl(request: $_model.GetAlipayUrlRequest): Promise<$_model.GetAlipayUrlResponse>;
     /**
-     * 获取文件支持的解析器类型
+     * Lists all supported parser types based on the input file type (file extension).
      *
      * @param request - GetAvailableParserTypesRequest
      * @param headers - map
@@ -471,7 +521,7 @@ export default class Client extends OpenApi {
         [key: string]: string;
     }, runtime: $dara.RuntimeOptions): Promise<$_model.GetAvailableParserTypesResponse>;
     /**
-     * 获取文件支持的解析器类型
+     * Lists all supported parser types based on the input file type (file extension).
      *
      * @param request - GetAvailableParserTypesRequest
      * @returns GetAvailableParserTypesResponse
@@ -536,7 +586,7 @@ export default class Client extends OpenApi {
      */
     getMemoryNode(workspaceId: string, memoryId: string, memoryNodeId: string): Promise<$_model.GetMemoryNodeResponse>;
     /**
-     * 获取类目解析配置
+     * Queries the data parsing settings in a specified category.
      *
      * @param request - GetParseSettingsRequest
      * @param headers - map
@@ -547,7 +597,7 @@ export default class Client extends OpenApi {
         [key: string]: string;
     }, runtime: $dara.RuntimeOptions): Promise<$_model.GetParseSettingsResponse>;
     /**
-     * 获取类目解析配置
+     * Queries the data parsing settings in a specified category.
      *
      * @param request - GetParseSettingsRequest
      * @returns GetParseSettingsResponse
@@ -646,7 +696,13 @@ export default class Client extends OpenApi {
      */
     listChunks(WorkspaceId: string, request: $_model.ListChunksRequest): Promise<$_model.ListChunksResponse>;
     /**
-     * 获取文档列表
+     * Queries the details of one or more documents in a specified category.
+     *
+     * @remarks
+     *   If you are using a RAM user, you must first obtain the OpenAPI management permissions (namely sfm:ListFile) of Model Studio. For more information, see [Grant OpenAPI permissions to a RAM user](https://help.aliyun.com/document_detail/2848578.html). If you are using the Alibaba Cloud account, you do not need permissions. We recommend that you use [the latest version of the SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * *   During a paged query, set `MaxResults` to specify the maximum number of entries to return. The return value of `NextToken` is a pagination token that can be used in the next call to retrieve a new page of results. When you query subsequent pages, set the `NextToken` parameter to the `NextToken` obtained in the last returned result. You can also set the `MaxResults` parameter to limit the number of entries to be returned. If no `NextToken` is returned, the result is completely returned and no more requests are required.
+     * *   This operation is idempotent.
+     * **Throttling:** Throttling will be triggered if you call this operation frequently. Do not exceed 5 times per second. If throttling is triggered, try again later.
      *
      * @param request - ListFileRequest
      * @param headers - map
@@ -657,7 +713,13 @@ export default class Client extends OpenApi {
         [key: string]: string;
     }, runtime: $dara.RuntimeOptions): Promise<$_model.ListFileResponse>;
     /**
-     * 获取文档列表
+     * Queries the details of one or more documents in a specified category.
+     *
+     * @remarks
+     *   If you are using a RAM user, you must first obtain the OpenAPI management permissions (namely sfm:ListFile) of Model Studio. For more information, see [Grant OpenAPI permissions to a RAM user](https://help.aliyun.com/document_detail/2848578.html). If you are using the Alibaba Cloud account, you do not need permissions. We recommend that you use [the latest version of the SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * *   During a paged query, set `MaxResults` to specify the maximum number of entries to return. The return value of `NextToken` is a pagination token that can be used in the next call to retrieve a new page of results. When you query subsequent pages, set the `NextToken` parameter to the `NextToken` obtained in the last returned result. You can also set the `MaxResults` parameter to limit the number of entries to be returned. If no `NextToken` is returned, the result is completely returned and no more requests are required.
+     * *   This operation is idempotent.
+     * **Throttling:** Throttling will be triggered if you call this operation frequently. Do not exceed 5 times per second. If throttling is triggered, try again later.
      *
      * @param request - ListFileRequest
      * @returns ListFileResponse
@@ -928,7 +990,17 @@ export default class Client extends OpenApi {
      */
     updateAndPublishAgentSelective(workspaceId: string, appCode: string, request: $_model.UpdateAndPublishAgentSelectiveRequest): Promise<$_model.UpdateAndPublishAgentSelectiveResponse>;
     /**
-     * 更新切片信息
+     * Modifies the content and title of a specified text chunk in the knowledge base, and sets whether the chunk participates in knowledge base retrieval.
+     *
+     * @remarks
+     *   **Limits**: This operation supports only knowledge base of the document search type. Data query and image Q\\&A types are not supported.
+     * *   **Required permissions**:
+     *     *   **RAM users**: Must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) of Model Studio (such as the `AliyunBailianDataFullAccess` policy, which includes the sfm:UpdateChunk permission required), and [become member of a workspace](https://help.aliyun.com/document_detail/2851098.html).
+     *     *   **Alibaba Cloud account**: Has the permission by default, and can call the operation directly.
+     * *   **Call method**: We recommend using the latest version of the [GenAI Service Platform SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29). The SDK encapsulates complex signature computational logic to simplify the call process.
+     * *   **Delay**: The update takes effect immediately. During peak hours, the update may take place in seconds.
+     * *   **Idempotence**: This operation is idempotent. If you perform a repeated operation on a chunk that has already been updated, the interface returns a success.
+     * **Rate limit:** Rate limiting will be triggered if you call this operation frequently. Do not exceed 10 times per second. If limiting is triggered, try again later.
      *
      * @param request - UpdateChunkRequest
      * @param headers - map
@@ -939,7 +1011,17 @@ export default class Client extends OpenApi {
         [key: string]: string;
     }, runtime: $dara.RuntimeOptions): Promise<$_model.UpdateChunkResponse>;
     /**
-     * 更新切片信息
+     * Modifies the content and title of a specified text chunk in the knowledge base, and sets whether the chunk participates in knowledge base retrieval.
+     *
+     * @remarks
+     *   **Limits**: This operation supports only knowledge base of the document search type. Data query and image Q\\&A types are not supported.
+     * *   **Required permissions**:
+     *     *   **RAM users**: Must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) of Model Studio (such as the `AliyunBailianDataFullAccess` policy, which includes the sfm:UpdateChunk permission required), and [become member of a workspace](https://help.aliyun.com/document_detail/2851098.html).
+     *     *   **Alibaba Cloud account**: Has the permission by default, and can call the operation directly.
+     * *   **Call method**: We recommend using the latest version of the [GenAI Service Platform SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29). The SDK encapsulates complex signature computational logic to simplify the call process.
+     * *   **Delay**: The update takes effect immediately. During peak hours, the update may take place in seconds.
+     * *   **Idempotence**: This operation is idempotent. If you perform a repeated operation on a chunk that has already been updated, the interface returns a success.
+     * **Rate limit:** Rate limiting will be triggered if you call this operation frequently. Do not exceed 10 times per second. If limiting is triggered, try again later.
      *
      * @param request - UpdateChunkRequest
      * @returns UpdateChunkResponse

package/dist/client.js

@@ -320,7 +320,52 @@ class Client extends openapi_core_1.default {
         return await this.applyFileUploadLeaseWithOptions(CategoryId, WorkspaceId, request, headers, runtime);
     }
     /**
-     * 修改类目解析配置
+     * 申请临时文件存储上传许可
+     *
+     * @param request - ApplyTempStorageLeaseRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns ApplyTempStorageLeaseResponse
+     */
+    async applyTempStorageLeaseWithOptions(WorkspaceId, request, headers, runtime) {
+        request.validate();
+        let body = {};
+        if (!$dara.isNull(request.fileName)) {
+            body["FileName"] = request.fileName;
+        }
+        if (!$dara.isNull(request.sizeInBytes)) {
+            body["SizeInBytes"] = request.sizeInBytes;
+        }
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+            body: openapi_core_2.OpenApiUtil.parseToMap(body),
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "ApplyTempStorageLease",
+            version: "2023-12-29",
+            protocol: "HTTPS",
+            pathname: `/${$dara.URL.percentEncode(WorkspaceId)}/datacenter`,
+            method: "POST",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "formData",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.ApplyTempStorageLeaseResponse({}));
+    }
+    /**
+     * 申请临时文件存储上传许可
+     *
+     * @param request - ApplyTempStorageLeaseRequest
+     * @returns ApplyTempStorageLeaseResponse
+     */
+    async applyTempStorageLease(WorkspaceId, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.applyTempStorageLeaseWithOptions(WorkspaceId, request, headers, runtime);
+    }
+    /**
+     * Configure the parsing method for a specific file type. For example, use LLM parsing for .pdf files, or use Qwen VL parsing for .jpg files.
      *
      * @param tmpReq - ChangeParseSettingRequest
      * @param headers - map
@@ -365,7 +410,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ChangeParseSettingResponse({}));
     }
     /**
-     * 修改类目解析配置
+     * Configure the parsing method for a specific file type. For example, use LLM parsing for .pdf files, or use Qwen VL parsing for .jpg files.
      *
      * @param request - ChangeParseSettingRequest
      * @returns ChangeParseSettingResponse
@@ -438,12 +483,17 @@ class Client extends openapi_core_1.default {
         return await this.createAndPulishAgentWithOptions(workspaceId, request, headers, runtime);
     }
     /**
-     * Creates an unstructured knowledge base and imports one or more parsed documents into the knowledge base. You cannot create a structured knowledge base by calling an API operation. Use the console instead.
+     * Create a knowledge base of the document search type.
      *
      * @remarks
-     * 1.  You must first upload documents to [Data Management](https://bailian.console.aliyun.com/#/data-center) and obtain the `FileId`. The documents are the knowledge source of the knowledge base. For more information, see [Import Data](https://www.alibabacloud.com/help/en/model-studio/user-guide/data-import-instructions).
-     * 2.  This operation only initializes a knowledge base creation job. You must also call the [SubmitIndexJob](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-submitindexjob) operation to complete the job.
-     * 3.  This interface is not idempotent.
+     *   **Limits**: This operation can create only knowledge base of the document search type. Data query and image Q\\&A types are not supported. Use the console instead.
+     * *   **Required permissions**
+     *     *   **RAM users**: Must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) of Model Studio (such as the `AliyunBailianDataFullAccess` policy, which includes the sfm:CreateIndex permission required), and [become member of a workspace](https://help.aliyun.com/document_detail/2851098.html).
+     *     *   **Alibaba Cloud account**: Has the permission by default, and can call the operation directly.
+     * *   **Call method**: We recommend using the latest version of the [GenAI Service Platform SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29). The SDK encapsulates complex signature computational logic to simplify the call process.
+     * *   **What to do next**: This operation only initializes knowledge base creation job. After that, call **SubmitIndexJob** to complete the creation. Otherwise, you will get an empty knowledge base. For more information about the sample code, see [Knowledge base API guide](https://help.aliyun.com/document_detail/2852772.html).
+     * *   **Idempotence**: This operation is not idempotent. If you call the operation for multiple times, you may create several knowledge bases with the same name. We recommend following a "query first, then create" logic.
+     * **Rate limit:** Rate limiting will be triggered if you call this operation frequently. Do not exceed 10 times per second. If limiting is triggered, try again later.
      *
      * @param tmpReq - CreateIndexRequest
      * @param headers - map
@@ -560,12 +610,17 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateIndexResponse({}));
     }
     /**
-     * Creates an unstructured knowledge base and imports one or more parsed documents into the knowledge base. You cannot create a structured knowledge base by calling an API operation. Use the console instead.
+     * Create a knowledge base of the document search type.
      *
      * @remarks
-     * 1.  You must first upload documents to [Data Management](https://bailian.console.aliyun.com/#/data-center) and obtain the `FileId`. The documents are the knowledge source of the knowledge base. For more information, see [Import Data](https://www.alibabacloud.com/help/en/model-studio/user-guide/data-import-instructions).
-     * 2.  This operation only initializes a knowledge base creation job. You must also call the [SubmitIndexJob](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-submitindexjob) operation to complete the job.
-     * 3.  This interface is not idempotent.
+     *   **Limits**: This operation can create only knowledge base of the document search type. Data query and image Q\\&A types are not supported. Use the console instead.
+     * *   **Required permissions**
+     *     *   **RAM users**: Must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) of Model Studio (such as the `AliyunBailianDataFullAccess` policy, which includes the sfm:CreateIndex permission required), and [become member of a workspace](https://help.aliyun.com/document_detail/2851098.html).
+     *     *   **Alibaba Cloud account**: Has the permission by default, and can call the operation directly.
+     * *   **Call method**: We recommend using the latest version of the [GenAI Service Platform SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29). The SDK encapsulates complex signature computational logic to simplify the call process.
+     * *   **What to do next**: This operation only initializes knowledge base creation job. After that, call **SubmitIndexJob** to complete the creation. Otherwise, you will get an empty knowledge base. For more information about the sample code, see [Knowledge base API guide](https://help.aliyun.com/document_detail/2852772.html).
+     * *   **Idempotence**: This operation is not idempotent. If you call the operation for multiple times, you may create several knowledge bases with the same name. We recommend following a "query first, then create" logic.
+     * **Rate limit:** Rate limiting will be triggered if you call this operation frequently. Do not exceed 10 times per second. If limiting is triggered, try again later.
      *
      * @param request - CreateIndexRequest
      * @returns CreateIndexResponse
@@ -771,7 +826,18 @@ class Client extends openapi_core_1.default {
         return await this.deleteCategoryWithOptions(CategoryId, WorkspaceId, headers, runtime);
     }
     /**
-     * 删除切片信息
+     * Deletes a specified text chunk from a knowledge base. The deleted chunk cannot be retrieved or recalled.
+     *
+     * @remarks
+     * *
+     * **Warning** After a text chunk is deleted, it cannot be restored. Proceed with caution.
+     * *   **Required permissions**:
+     *     *   **RAM users**: Must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) of Model Studio (such as the `AliyunBailianDataFullAccess` policy, which includes the sfm:DeleteChunk permission required), and [become member of a workspace](https://help.aliyun.com/document_detail/2851098.html).
+     *     *   **Alibaba Cloud account**: Has the permission by default, and can call the operation directly.
+     * *   **Call method**: We recommend using the latest version of the [GenAI Service Platform SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29). The SDK encapsulates complex signature computational logic to simplify the call process.
+     * *   **Delay**: The update takes effect immediately. During peak hours, the update may take place in seconds.
+     * *   **Idempotence**: This operation is idempotent. If you perform a repeated operation on a chunk that has already been deleted, the interface returns a success.
+     * **Rate limit:** Rate limiting will be triggered if you call this operation frequently. Do not exceed 10 times per second. If limiting is triggered, try again later.
      *
      * @param tmpReq - DeleteChunkRequest
      * @param headers - map
@@ -810,7 +876,18 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteChunkResponse({}));
     }
     /**
-     * 删除切片信息
+     * Deletes a specified text chunk from a knowledge base. The deleted chunk cannot be retrieved or recalled.
+     *
+     * @remarks
+     * *
+     * **Warning** After a text chunk is deleted, it cannot be restored. Proceed with caution.
+     * *   **Required permissions**:
+     *     *   **RAM users**: Must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) of Model Studio (such as the `AliyunBailianDataFullAccess` policy, which includes the sfm:DeleteChunk permission required), and [become member of a workspace](https://help.aliyun.com/document_detail/2851098.html).
+     *     *   **Alibaba Cloud account**: Has the permission by default, and can call the operation directly.
+     * *   **Call method**: We recommend using the latest version of the [GenAI Service Platform SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29). The SDK encapsulates complex signature computational logic to simplify the call process.
+     * *   **Delay**: The update takes effect immediately. During peak hours, the update may take place in seconds.
+     * *   **Idempotence**: This operation is idempotent. If you perform a repeated operation on a chunk that has already been deleted, the interface returns a success.
+     * **Rate limit:** Rate limiting will be triggered if you call this operation frequently. Do not exceed 10 times per second. If limiting is triggered, try again later.
      *
      * @param request - DeleteChunkRequest
      * @returns DeleteChunkResponse
@@ -1208,7 +1285,7 @@ class Client extends openapi_core_1.default {
         return await this.getAlipayUrlWithOptions(request, headers, runtime);
     }
     /**
-     * 获取文件支持的解析器类型
+     * Lists all supported parser types based on the input file type (file extension).
      *
      * @param request - GetAvailableParserTypesRequest
      * @param headers - map
@@ -1239,7 +1316,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetAvailableParserTypesResponse({}));
     }
     /**
-     * 获取文件支持的解析器类型
+     * Lists all supported parser types based on the input file type (file extension).
      *
      * @param request - GetAvailableParserTypesRequest
      * @returns GetAvailableParserTypesResponse
@@ -1377,7 +1454,7 @@ class Client extends openapi_core_1.default {
         return await this.getMemoryNodeWithOptions(workspaceId, memoryId, memoryNodeId, headers, runtime);
     }
     /**
-     * 获取类目解析配置
+     * Queries the data parsing settings in a specified category.
      *
      * @param request - GetParseSettingsRequest
      * @param headers - map
@@ -1408,7 +1485,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetParseSettingsResponse({}));
     }
     /**
-     * 获取类目解析配置
+     * Queries the data parsing settings in a specified category.
      *
      * @param request - GetParseSettingsRequest
      * @returns GetParseSettingsResponse
@@ -1661,7 +1738,13 @@ class Client extends openapi_core_1.default {
         return await this.listChunksWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * 获取文档列表
+     * Queries the details of one or more documents in a specified category.
+     *
+     * @remarks
+     *   If you are using a RAM user, you must first obtain the OpenAPI management permissions (namely sfm:ListFile) of Model Studio. For more information, see [Grant OpenAPI permissions to a RAM user](https://help.aliyun.com/document_detail/2848578.html). If you are using the Alibaba Cloud account, you do not need permissions. We recommend that you use [the latest version of the SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * *   During a paged query, set `MaxResults` to specify the maximum number of entries to return. The return value of `NextToken` is a pagination token that can be used in the next call to retrieve a new page of results. When you query subsequent pages, set the `NextToken` parameter to the `NextToken` obtained in the last returned result. You can also set the `MaxResults` parameter to limit the number of entries to be returned. If no `NextToken` is returned, the result is completely returned and no more requests are required.
+     * *   This operation is idempotent.
+     * **Throttling:** Throttling will be triggered if you call this operation frequently. Do not exceed 5 times per second. If throttling is triggered, try again later.
      *
      * @param request - ListFileRequest
      * @param headers - map
@@ -1701,7 +1784,13 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListFileResponse({}));
     }
     /**
-     * 获取文档列表
+     * Queries the details of one or more documents in a specified category.
+     *
+     * @remarks
+     *   If you are using a RAM user, you must first obtain the OpenAPI management permissions (namely sfm:ListFile) of Model Studio. For more information, see [Grant OpenAPI permissions to a RAM user](https://help.aliyun.com/document_detail/2848578.html). If you are using the Alibaba Cloud account, you do not need permissions. We recommend that you use [the latest version of the SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * *   During a paged query, set `MaxResults` to specify the maximum number of entries to return. The return value of `NextToken` is a pagination token that can be used in the next call to retrieve a new page of results. When you query subsequent pages, set the `NextToken` parameter to the `NextToken` obtained in the last returned result. You can also set the `MaxResults` parameter to limit the number of entries to be returned. If no `NextToken` is returned, the result is completely returned and no more requests are required.
+     * *   This operation is idempotent.
+     * **Throttling:** Throttling will be triggered if you call this operation frequently. Do not exceed 5 times per second. If throttling is triggered, try again later.
      *
      * @param request - ListFileRequest
      * @returns ListFileResponse
@@ -2446,7 +2535,17 @@ class Client extends openapi_core_1.default {
         return await this.updateAndPublishAgentSelectiveWithOptions(workspaceId, appCode, request, headers, runtime);
     }
     /**
-     * 更新切片信息
+     * Modifies the content and title of a specified text chunk in the knowledge base, and sets whether the chunk participates in knowledge base retrieval.
+     *
+     * @remarks
+     *   **Limits**: This operation supports only knowledge base of the document search type. Data query and image Q\\&A types are not supported.
+     * *   **Required permissions**:
+     *     *   **RAM users**: Must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) of Model Studio (such as the `AliyunBailianDataFullAccess` policy, which includes the sfm:UpdateChunk permission required), and [become member of a workspace](https://help.aliyun.com/document_detail/2851098.html).
+     *     *   **Alibaba Cloud account**: Has the permission by default, and can call the operation directly.
+     * *   **Call method**: We recommend using the latest version of the [GenAI Service Platform SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29). The SDK encapsulates complex signature computational logic to simplify the call process.
+     * *   **Delay**: The update takes effect immediately. During peak hours, the update may take place in seconds.
+     * *   **Idempotence**: This operation is idempotent. If you perform a repeated operation on a chunk that has already been updated, the interface returns a success.
+     * **Rate limit:** Rate limiting will be triggered if you call this operation frequently. Do not exceed 10 times per second. If limiting is triggered, try again later.
      *
      * @param request - UpdateChunkRequest
      * @param headers - map
@@ -2492,7 +2591,17 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateChunkResponse({}));
     }
     /**
-     * 更新切片信息
+     * Modifies the content and title of a specified text chunk in the knowledge base, and sets whether the chunk participates in knowledge base retrieval.
+     *
+     * @remarks
+     *   **Limits**: This operation supports only knowledge base of the document search type. Data query and image Q\\&A types are not supported.
+     * *   **Required permissions**:
+     *     *   **RAM users**: Must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) of Model Studio (such as the `AliyunBailianDataFullAccess` policy, which includes the sfm:UpdateChunk permission required), and [become member of a workspace](https://help.aliyun.com/document_detail/2851098.html).
+     *     *   **Alibaba Cloud account**: Has the permission by default, and can call the operation directly.
+     * *   **Call method**: We recommend using the latest version of the [GenAI Service Platform SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29). The SDK encapsulates complex signature computational logic to simplify the call process.
+     * *   **Delay**: The update takes effect immediately. During peak hours, the update may take place in seconds.
+     * *   **Idempotence**: This operation is idempotent. If you perform a repeated operation on a chunk that has already been updated, the interface returns a success.
+     * **Rate limit:** Rate limiting will be triggered if you call this operation frequently. Do not exceed 10 times per second. If limiting is triggered, try again later.
      *
      * @param request - UpdateChunkRequest
      * @returns UpdateChunkResponse