@alicloud/bailian20231229 2.13.0 → 2.14.0

package/dist/client.js

@@ -48,7 +48,11 @@ __exportStar(require("./models/model"), exports);
 class Client extends openapi_core_1.default {
     constructor(config) {
         super(config);
-        this._endpointRule = "";
+        this._endpointRule = "regional";
+        this._endpointMap = {
+            'cn-beijing': "bailian.cn-beijing.aliyuncs.com",
+            'ap-southeast-1': "bailian.ap-southeast-1.aliyuncs.com",
+        };
         this.checkConfig(config);
         this._endpoint = this.getEndpoint("bailian", this._regionId, this._endpointRule, this._network, this._suffix, this._endpointMap, this._endpoint);
     }
@@ -62,14 +66,13 @@ class Client extends openapi_core_1.default {
         return openapi_core_2.OpenApiUtil.getEndpointRules(productId, regionId, endpointRule, network, suffix);
     }
     /**
-     * Creates a category in the specified workspace to categorize and manage documents. You can create up to 1,000 categories in each workspace.
+     * Creates a category in a specified workspace to classify and manage files. Each workspace supports a maximum of 500 categories.
      *
      * @remarks
-     *   You cannot use API to create structured table. To create a table, go to [Data Management](https://bailian.console.alibabacloud.com/#/data-center) in the console. You can associate a knowledge base with ApsaraDB for RDS to automatically update structured knowledge base. For more information, see [Knowledge base](https://help.aliyun.com/document_detail/2807740.html).
-     * *   If you are using a RAM user, you must first obtain the OpenAPI management permissions (namely sfm:AddCategory) 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.
-     * *   You can create up to 1,000 categories in each workspace.
-     * *   This interface is not 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.
+     * - You cannot use an API to add data tables. To add data tables, go to the [Application Data](https://modelstudio.console.alibabacloud.com/?tab=app#/data-center) page in the console.
+     * - A RAM user must obtain the required [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before calling this operation. The `AliyunBailianDataFullAccess` permission, which includes the `sfm:AddCategory` permission, is required. An Alibaba Cloud account can call this operation directly without requiring authorization. To call this operation, use the latest version of the [Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - This operation is not idempotent.
+     * **Rate limiting:** Frequent calls to this operation are subject to rate limiting. Do not exceed a frequency of 5 calls per second. If rate limiting is triggered, try again later.
      *
      * @param request - AddCategoryRequest
      * @param headers - map
@@ -109,14 +112,13 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.AddCategoryResponse({}));
     }
     /**
-     * Creates a category in the specified workspace to categorize and manage documents. You can create up to 1,000 categories in each workspace.
+     * Creates a category in a specified workspace to classify and manage files. Each workspace supports a maximum of 500 categories.
      *
      * @remarks
-     *   You cannot use API to create structured table. To create a table, go to [Data Management](https://bailian.console.alibabacloud.com/#/data-center) in the console. You can associate a knowledge base with ApsaraDB for RDS to automatically update structured knowledge base. For more information, see [Knowledge base](https://help.aliyun.com/document_detail/2807740.html).
-     * *   If you are using a RAM user, you must first obtain the OpenAPI management permissions (namely sfm:AddCategory) 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.
-     * *   You can create up to 1,000 categories in each workspace.
-     * *   This interface is not 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.
+     * - You cannot use an API to add data tables. To add data tables, go to the [Application Data](https://modelstudio.console.alibabacloud.com/?tab=app#/data-center) page in the console.
+     * - A RAM user must obtain the required [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before calling this operation. The `AliyunBailianDataFullAccess` permission, which includes the `sfm:AddCategory` permission, is required. An Alibaba Cloud account can call this operation directly without requiring authorization. To call this operation, use the latest version of the [Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - This operation is not idempotent.
+     * **Rate limiting:** Frequent calls to this operation are subject to rate limiting. Do not exceed a frequency of 5 calls per second. If rate limiting is triggered, try again later.
      *
      * @param request - AddCategoryRequest
      * @returns AddCategoryResponse
@@ -127,7 +129,84 @@ class Client extends openapi_core_1.default {
         return await this.addCategoryWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * 创建连接器
+     * Adds chunks to a document search (document), data query (table), or image Q&A (image) knowledge base.
+     *
+     * @remarks
+     * - This operation adds chunk content to a specified knowledge base of the document search (document), data query (table), or image Q&A (image) type. Operations on multimedia search (multimedia) knowledge bases are not supported. For data query and image Q&A knowledge bases, this operation takes effect only when the data source is a spreadsheet connector (excel).
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (requiring `AliyunBailianDataFullAccess`, which includes the sfm:ChunkList permission) and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Use the latest [Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this operation.
+     * - Before invoking this operation, make sure that your knowledge base has been created and has not been deleted (that is, the knowledge base ID `IndexId` is valid).
+     * - This operation has idempotence.
+     * **Related operations:**
+     * **Throttling:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If throttled, retry later.
+     *
+     * @param tmpReq - AddChunkRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns AddChunkResponse
+     */
+    async addChunkWithOptions(WorkspaceId, tmpReq, headers, runtime) {
+        tmpReq.validate();
+        let request = new $_model.AddChunkShrinkRequest({});
+        openapi_core_2.OpenApiUtil.convert(tmpReq, request);
+        if (!$dara.isNull(tmpReq.field)) {
+            request.fieldShrink = openapi_core_2.OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.field, "field", "json");
+        }
+        let query = {};
+        if (!$dara.isNull(request.pipelineId)) {
+            query["PipelineId"] = request.pipelineId;
+        }
+        if (!$dara.isNull(request.dataId)) {
+            query["dataId"] = request.dataId;
+        }
+        if (!$dara.isNull(request.fieldShrink)) {
+            query["field"] = request.fieldShrink;
+        }
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+            query: openapi_core_2.OpenApiUtil.query(query),
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "AddChunk",
+            version: "2023-12-29",
+            protocol: "HTTPS",
+            pathname: `/${$dara.URL.percentEncode(WorkspaceId)}/chunk/create`,
+            method: "POST",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.AddChunkResponse({}));
+    }
+    /**
+     * Adds chunks to a document search (document), data query (table), or image Q&A (image) knowledge base.
+     *
+     * @remarks
+     * - This operation adds chunk content to a specified knowledge base of the document search (document), data query (table), or image Q&A (image) type. Operations on multimedia search (multimedia) knowledge bases are not supported. For data query and image Q&A knowledge bases, this operation takes effect only when the data source is a spreadsheet connector (excel).
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (requiring `AliyunBailianDataFullAccess`, which includes the sfm:ChunkList permission) and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Use the latest [Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this operation.
+     * - Before invoking this operation, make sure that your knowledge base has been created and has not been deleted (that is, the knowledge base ID `IndexId` is valid).
+     * - This operation has idempotence.
+     * **Related operations:**
+     * **Throttling:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If throttled, retry later.
+     *
+     * @param request - AddChunkRequest
+     * @returns AddChunkResponse
+     */
+    async addChunk(WorkspaceId, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.addChunkWithOptions(WorkspaceId, request, headers, runtime);
+    }
+    /**
+     * Creates a connector. This API currently supports only file connectors.
+     *
+     * @remarks
+     * - To call this operation, a RAM user (sub-account) must first have the required [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio and be a member of a [business space](https://help.aliyun.com/document_detail/2851098.html). This requires the `AliyunBailianDataFullAccess` policy, which includes the sfm:AddCategory permission. A primary account can call this operation directly without authorization. We recommend using the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * - This operation is not idempotent.
+     * **Throttling:**
+     * Do not call this operation more than 5 times per second. If a request is throttled, try again later.
      *
      * @param tmpReq - AddConnectorRequest
      * @param headers - map
@@ -172,7 +251,13 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.AddConnectorResponse({}));
     }
     /**
-     * 创建连接器
+     * Creates a connector. This API currently supports only file connectors.
+     *
+     * @remarks
+     * - To call this operation, a RAM user (sub-account) must first have the required [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio and be a member of a [business space](https://help.aliyun.com/document_detail/2851098.html). This requires the `AliyunBailianDataFullAccess` policy, which includes the sfm:AddCategory permission. A primary account can call this operation directly without authorization. We recommend using the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * - This operation is not idempotent.
+     * **Throttling:**
+     * Do not call this operation more than 5 times per second. If a request is throttled, try again later.
      *
      * @param request - AddConnectorRequest
      * @returns AddConnectorResponse
@@ -183,14 +268,13 @@ class Client extends openapi_core_1.default {
         return await this.addConnectorWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * Imports an unstructured document stored in the temporary storage space to Data Management. You cannot use the API to import structured documents. Use the console instead.
+     * Imports a file from the temporary storage of Alibaba Cloud Model Studio into an Alibaba Cloud Model Studio data connection (formerly known as application data).
      *
      * @remarks
-     *   Before you call this operation, make sure that you have obtained the lease and uploaded the document to the temporary storage space by using the [ApplyFileUploadLease](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-applyfileuploadlease) operation. For more information, see [Upload files by calling API](https://www.alibabacloud.com/help/en/model-studio/developer-reference/upload-files-by-calling-api).
-     * >  After you call this operation, the used lease ID expires immediately. Do not use the same lease ID to submit new requests.
-     * *   You must call this operation within 12 hours after you call the [ApplyFileUploadLease](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-applyfileuploadlease) operation. Otherwise, the lease expires and the request fails.
-     * *   After you call this operation, the system parses and imports your document. The process takes some time.
-     * *   This interface is not idempotent.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (requires `AliyunBailianDataFullAccess`, which includes the sfm:AddFile permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Invoke this operation by using the latest <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - This operation is not idempotent.
+     * **Throttling:**
+     * This operation is subject to throttling. Do not exceed 10 calls per second. If you are throttled, retry later.
      *
      * @param tmpReq - AddFileRequest
      * @param headers - map
@@ -247,14 +331,13 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.AddFileResponse({}));
     }
     /**
-     * Imports an unstructured document stored in the temporary storage space to Data Management. You cannot use the API to import structured documents. Use the console instead.
+     * Imports a file from the temporary storage of Alibaba Cloud Model Studio into an Alibaba Cloud Model Studio data connection (formerly known as application data).
      *
      * @remarks
-     *   Before you call this operation, make sure that you have obtained the lease and uploaded the document to the temporary storage space by using the [ApplyFileUploadLease](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-applyfileuploadlease) operation. For more information, see [Upload files by calling API](https://www.alibabacloud.com/help/en/model-studio/developer-reference/upload-files-by-calling-api).
-     * >  After you call this operation, the used lease ID expires immediately. Do not use the same lease ID to submit new requests.
-     * *   You must call this operation within 12 hours after you call the [ApplyFileUploadLease](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-applyfileuploadlease) operation. Otherwise, the lease expires and the request fails.
-     * *   After you call this operation, the system parses and imports your document. The process takes some time.
-     * *   This interface is not idempotent.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (requires `AliyunBailianDataFullAccess`, which includes the sfm:AddFile permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Invoke this operation by using the latest <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - This operation is not idempotent.
+     * **Throttling:**
+     * This operation is subject to throttling. Do not exceed 10 calls per second. If you are throttled, retry later.
      *
      * @param request - AddFileRequest
      * @returns AddFileResponse
@@ -265,7 +348,17 @@ class Client extends openapi_core_1.default {
         return await this.addFileWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * 将已授权OSS Bucket中的文件添加到百炼应用数据
+     * Imports files from an authorized OSS bucket into Alibaba Cloud Model Studio application data.
+     *
+     * @remarks
+     * - Make sure the OSS bucket belongs to the same Alibaba Cloud account as Model Studio and that authorization has been completed as described in [Importing data from OSS configuration instructions](https://help.aliyun.com/document_detail/2782155.html).
+     *
+     *      - Supported bucket storage types do not include Archive, Cold Archive, or Deep Cold Archive. Buckets with content encryption enabled are supported. Buckets with public read/write, public read, or private access are supported.
+     *      - To use a bucket with [Referer-based hotlink protection](https://help.aliyun.com/document_detail/2636937.html) enabled, add the domain name `*.console.aliyun.com` to the Referer whitelist as described in [Allow access only from trusted websites](https://help.aliyun.com/document_detail/2636937.html).
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (the `AliyunBailianDataFullAccess` permission is required, which includes the sfm:AddFilesFromAuthorizedOss permission) and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Call this operation by using the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - This operation does not have idempotence.
+     * **Rate limit:**
+     * This operation is throttled if called too frequently. Do not exceed 5 calls per second. If throttled, retry later.
      *
      * @param tmpReq - AddFilesFromAuthorizedOssRequest
      * @param headers - map
@@ -322,7 +415,17 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.AddFilesFromAuthorizedOssResponse({}));
     }
     /**
-     * 将已授权OSS Bucket中的文件添加到百炼应用数据
+     * Imports files from an authorized OSS bucket into Alibaba Cloud Model Studio application data.
+     *
+     * @remarks
+     * - Make sure the OSS bucket belongs to the same Alibaba Cloud account as Model Studio and that authorization has been completed as described in [Importing data from OSS configuration instructions](https://help.aliyun.com/document_detail/2782155.html).
+     *
+     *      - Supported bucket storage types do not include Archive, Cold Archive, or Deep Cold Archive. Buckets with content encryption enabled are supported. Buckets with public read/write, public read, or private access are supported.
+     *      - To use a bucket with [Referer-based hotlink protection](https://help.aliyun.com/document_detail/2636937.html) enabled, add the domain name `*.console.aliyun.com` to the Referer whitelist as described in [Allow access only from trusted websites](https://help.aliyun.com/document_detail/2636937.html).
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (the `AliyunBailianDataFullAccess` permission is required, which includes the sfm:AddFilesFromAuthorizedOss permission) and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Call this operation by using the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - This operation does not have idempotence.
+     * **Rate limit:**
+     * This operation is throttled if called too frequently. Do not exceed 5 calls per second. If throttled, retry later.
      *
      * @param request - AddFilesFromAuthorizedOssRequest
      * @returns AddFilesFromAuthorizedOssResponse
@@ -333,7 +436,13 @@ class Client extends openapi_core_1.default {
         return await this.addFilesFromAuthorizedOssWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * 添加表格
+     * Add a table for the table data connector.
+     *
+     * @remarks
+     * - RAM users (sub-accounts) must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Chinese China Bailian (requires `AliyunBailianDataFullAccess`, which includes the sfm:AddTable permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before calling this API. Alibaba Cloud accounts (primary accounts) can call this API directly without authorization. We recommend that you call this API by using the latest <props="china">[Chinese China Bailian SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Chinese China Bailian SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - This API is not idempotent.
+     * **Throttling:**
+     * This API is subject to throttling when called frequently. Do not exceed 10 calls per second. If throttling is triggered, retry later.
      *
      * @param tmpReq - AddTableRequest
      * @param headers - map
@@ -354,6 +463,9 @@ class Client extends openapi_core_1.default {
         if (!$dara.isNull(request.tableColumnsShrink)) {
             body["TableColumns"] = request.tableColumnsShrink;
         }
+        if (!$dara.isNull(request.tableDesc)) {
+            body["TableDesc"] = request.tableDesc;
+        }
         if (!$dara.isNull(request.tableName)) {
             body["TableName"] = request.tableName;
         }
@@ -375,7 +487,13 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.AddTableResponse({}));
     }
     /**
-     * 添加表格
+     * Add a table for the table data connector.
+     *
+     * @remarks
+     * - RAM users (sub-accounts) must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Chinese China Bailian (requires `AliyunBailianDataFullAccess`, which includes the sfm:AddTable permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before calling this API. Alibaba Cloud accounts (primary accounts) can call this API directly without authorization. We recommend that you call this API by using the latest <props="china">[Chinese China Bailian SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Chinese China Bailian SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - This API is not idempotent.
+     * **Throttling:**
+     * This API is subject to throttling when called frequently. Do not exceed 10 calls per second. If throttling is triggered, retry later.
      *
      * @param request - AddTableRequest
      * @returns AddTableResponse
@@ -386,13 +504,13 @@ class Client extends openapi_core_1.default {
         return await this.addTableWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * Applies for a document upload lease to upload a document. You cannot use the API to upload structured documents. Use the console instead.
+     * Request an upload lease for uploading knowledge base files or files for agent application conversational interactions.
      *
      * @remarks
-     *   This operation returns an HTTP URL that can be used to upload an unstructured document (the lease) and parameters required for the upload. Structured documents are not supported.
-     * *   The HTTP URL returned by this operation is valid only for minutes. Upload the document before the URL expires.
-     * *   After you apply for a lease and upload a document, the document is stored in a temporary storage space for 12 hours.
-     * *   This interface is not idempotent.
+     * - RAM users (sub-accounts) must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (requires `AliyunBailianDataFullAccess`, which includes the sfm:ApplyFileUploadLease permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before calling this API. Alibaba Cloud accounts (primary accounts) can directly call this API without authorization. We recommend that you call this API by using the latest <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - This API is not idempotent.
+     * **Throttling:**
+     * This API is subject to throttling if called too frequently. The frequency must not exceed 10 calls per second. If throttled, please retry later.
      *
      * @param request - ApplyFileUploadLeaseRequest
      * @param headers - map
@@ -435,13 +553,13 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ApplyFileUploadLeaseResponse({}));
     }
     /**
-     * Applies for a document upload lease to upload a document. You cannot use the API to upload structured documents. Use the console instead.
+     * Request an upload lease for uploading knowledge base files or files for agent application conversational interactions.
      *
      * @remarks
-     *   This operation returns an HTTP URL that can be used to upload an unstructured document (the lease) and parameters required for the upload. Structured documents are not supported.
-     * *   The HTTP URL returned by this operation is valid only for minutes. Upload the document before the URL expires.
-     * *   After you apply for a lease and upload a document, the document is stored in a temporary storage space for 12 hours.
-     * *   This interface is not idempotent.
+     * - RAM users (sub-accounts) must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (requires `AliyunBailianDataFullAccess`, which includes the sfm:ApplyFileUploadLease permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before calling this API. Alibaba Cloud accounts (primary accounts) can directly call this API without authorization. We recommend that you call this API by using the latest <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - This API is not idempotent.
+     * **Throttling:**
+     * This API is subject to throttling if called too frequently. The frequency must not exceed 10 calls per second. If throttled, please retry later.
      *
      * @param request - ApplyFileUploadLeaseRequest
      * @returns ApplyFileUploadLeaseResponse
@@ -503,7 +621,7 @@ class Client extends openapi_core_1.default {
         return await this.applyTempStorageLeaseWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * 批量更新文档Tag
+     * This operation updates document tags in a data connection in batches.
      *
      * @param tmpReq - BatchUpdateFileTagRequest
      * @param headers - map
@@ -542,7 +660,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.BatchUpdateFileTagResponse({}));
     }
     /**
-     * 批量更新文档Tag
+     * This operation updates document tags in a data connection in batches.
      *
      * @param request - BatchUpdateFileTagRequest
      * @returns BatchUpdateFileTagResponse
@@ -553,7 +671,13 @@ class Client extends openapi_core_1.default {
         return await this.batchUpdateFileTagWithOptions(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.
+     * Configures the parsing method for specific file types. For example, specifies large model document parsing for .pdf files or Qwen VL parsing for .jpg files.
+     *
+     * @remarks
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (requires `AliyunBailianDataFullAccess`, which includes the sfm:ChangeParseSetting permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Invoke this operation by using the latest <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - This operation is not idempotent.
+     * **Throttling:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If throttled, retry later.
      *
      * @param tmpReq - ChangeParseSettingRequest
      * @param headers - map
@@ -598,7 +722,13 @@ 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.
+     * Configures the parsing method for specific file types. For example, specifies large model document parsing for .pdf files or Qwen VL parsing for .jpg files.
+     *
+     * @remarks
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (requires `AliyunBailianDataFullAccess`, which includes the sfm:ChangeParseSetting permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Invoke this operation by using the latest <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - This operation is not idempotent.
+     * **Throttling:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If throttled, retry later.
      *
      * @param request - ChangeParseSettingRequest
      * @returns ChangeParseSettingResponse
@@ -671,17 +801,17 @@ class Client extends openapi_core_1.default {
         return await this.createAndPulishAgentWithOptions(workspaceId, request, headers, runtime);
     }
     /**
-     * Create a knowledge base of the document search type.
+     * Use this API to create two types of knowledge bases: unstructured knowledge bases for documents, audio, or video, and structured knowledge bases for data queries or image Q&A.
      *
      * @remarks
-     *   **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.
+     * - **Permissions**:
+     *   - **RAM user**: A RAM user must obtain the required [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before calling this operation. You can use the `AliyunBailianDataFullAccess` policy, which includes the \\`sfm:CreateIndex\\` permission required for this operation.
+     *   - **Alibaba Cloud account**: By default, Alibaba Cloud accounts have the required permissions and can call this operation directly.
+     * - **How to call**: Use the latest version of the <props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation. The SDK handles the complex signature calculation logic to simplify the process.
+     * - **What to do next**: This operation only initializes a knowledge base creation job. After calling this operation, you must call the **SubmitIndexJob** operation to complete the creation. Otherwise, an empty knowledge base is created. For related code examples, see [Knowledge base API guide](https://help.aliyun.com/document_detail/2852772.html).
+     * - **Idempotence**: This operation is not idempotent. Repeated calls may create multiple knowledge bases with the same name. To ensure idempotence, query for the knowledge base before you create it.
+     * **Rate limiting:**
+     * Frequent calls to this operation are subject to rate limiting. Do not exceed a frequency of 10 calls per second. If you encounter rate limiting, retry the call later.
      *
      * @param tmpReq - CreateIndexRequest
      * @param headers - map
@@ -828,17 +958,17 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateIndexResponse({}));
     }
     /**
-     * Create a knowledge base of the document search type.
+     * Use this API to create two types of knowledge bases: unstructured knowledge bases for documents, audio, or video, and structured knowledge bases for data queries or image Q&A.
      *
      * @remarks
-     *   **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.
+     * - **Permissions**:
+     *   - **RAM user**: A RAM user must obtain the required [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before calling this operation. You can use the `AliyunBailianDataFullAccess` policy, which includes the \\`sfm:CreateIndex\\` permission required for this operation.
+     *   - **Alibaba Cloud account**: By default, Alibaba Cloud accounts have the required permissions and can call this operation directly.
+     * - **How to call**: Use the latest version of the <props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation. The SDK handles the complex signature calculation logic to simplify the process.
+     * - **What to do next**: This operation only initializes a knowledge base creation job. After calling this operation, you must call the **SubmitIndexJob** operation to complete the creation. Otherwise, an empty knowledge base is created. For related code examples, see [Knowledge base API guide](https://help.aliyun.com/document_detail/2852772.html).
+     * - **Idempotence**: This operation is not idempotent. Repeated calls may create multiple knowledge bases with the same name. To ensure idempotence, query for the knowledge base before you create it.
+     * **Rate limiting:**
+     * Frequent calls to this operation are subject to rate limiting. Do not exceed a frequency of 10 calls per second. If you encounter rate limiting, retry the call later.
      *
      * @param request - CreateIndexRequest
      * @returns CreateIndexResponse
@@ -849,7 +979,14 @@ class Client extends openapi_core_1.default {
         return await this.createIndexWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * 创建Memory
+     * Creates a long-term memory.
+     *
+     * @remarks
+     * - You can store specific information from conversations (memory nodes. For more information, see [Long-term memory](https://www.alibabacloud.com/help/en/model-studio/user-guide/long-term-memory)) in a long-term memory. Agent applications can then reference this information in subsequent conversations. This is not an automatic creation procedure. You must first invoke the [CreateMemory](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-creatememory) operation to create a long-term memory and obtain the `memoryId`. Then pass the `memoryId` when you [invoke the agent application through the API](https://www.alibabacloud.com/help/en/model-studio/user-guide/application-calling).
+     *     > Long-term memory does not support storing and managing user profiles through the API. Perform related operations in the console. For more information, see [Long-term memory](https://www.alibabacloud.com/help/en/model-studio/user-guide/long-term-memory#578ebae524m6l).
+     * - If you pass a `memoryId`, the system uses automatic creation to generate memory nodes (MemoryNode) under the specified long-term memory based on conversation records. You can also invoke the [CreateMemoryNode](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-creatememorynode) operation to manually create memory nodes.
+     * - This operation does not support idempotence.
+     * **Throttling:** Ensure that the interval between two consecutive requests is at least 1 second. Otherwise, throttling may be triggered. If throttling occurs, retry later.
      *
      * @param request - CreateMemoryRequest
      * @param headers - map
@@ -880,7 +1017,14 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateMemoryResponse({}));
     }
     /**
-     * 创建Memory
+     * Creates a long-term memory.
+     *
+     * @remarks
+     * - You can store specific information from conversations (memory nodes. For more information, see [Long-term memory](https://www.alibabacloud.com/help/en/model-studio/user-guide/long-term-memory)) in a long-term memory. Agent applications can then reference this information in subsequent conversations. This is not an automatic creation procedure. You must first invoke the [CreateMemory](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-creatememory) operation to create a long-term memory and obtain the `memoryId`. Then pass the `memoryId` when you [invoke the agent application through the API](https://www.alibabacloud.com/help/en/model-studio/user-guide/application-calling).
+     *     > Long-term memory does not support storing and managing user profiles through the API. Perform related operations in the console. For more information, see [Long-term memory](https://www.alibabacloud.com/help/en/model-studio/user-guide/long-term-memory#578ebae524m6l).
+     * - If you pass a `memoryId`, the system uses automatic creation to generate memory nodes (MemoryNode) under the specified long-term memory based on conversation records. You can also invoke the [CreateMemoryNode](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-creatememorynode) operation to manually create memory nodes.
+     * - This operation does not support idempotence.
+     * **Throttling:** Ensure that the interval between two consecutive requests is at least 1 second. Otherwise, throttling may be triggered. If throttling occurs, retry later.
      *
      * @param request - CreateMemoryRequest
      * @returns CreateMemoryResponse
@@ -891,7 +1035,7 @@ class Client extends openapi_core_1.default {
         return await this.createMemoryWithOptions(workspaceId, request, headers, runtime);
     }
     /**
-     * 创建记忆Node
+     * Creates a memory node.
      *
      * @param request - CreateMemoryNodeRequest
      * @param headers - map
@@ -922,7 +1066,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateMemoryNodeResponse({}));
     }
     /**
-     * 创建记忆Node
+     * Creates a memory node.
      *
      * @param request - CreateMemoryNodeRequest
      * @returns CreateMemoryNodeResponse
@@ -933,7 +1077,10 @@ class Client extends openapi_core_1.default {
         return await this.createMemoryNodeWithOptions(workspaceId, memoryId, request, headers, runtime);
     }
     /**
-     * Creates a prompt template.
+     * Create a prompt template.
+     *
+     * @remarks
+     * This API does not currently support the creation of text-to-image prompt templates.
      *
      * @param request - CreatePromptTemplateRequest
      * @param headers - map
@@ -967,7 +1114,10 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreatePromptTemplateResponse({}));
     }
     /**
-     * Creates a prompt template.
+     * Create a prompt template.
+     *
+     * @remarks
+     * This API does not currently support the creation of text-to-image prompt templates.
      *
      * @param request - CreatePromptTemplateRequest
      * @returns CreatePromptTemplateResponse
@@ -1015,7 +1165,13 @@ class Client extends openapi_core_1.default {
         return await this.deleteAgentWithOptions(workspaceId, appCode, request, headers, runtime);
     }
     /**
-     * Deletes a specified category permanently.
+     * Permanently deletes a specified category.
+     *
+     * @remarks
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (requiring `AliyunBailianDataFullAccess`, which includes the sfm:DeleteCategory permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before calling this operation. Alibaba Cloud accounts can call this operation directly without authorization. Use the latest <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * - This operation is idempotent.
+     * **Rate limiting:**
+     * This operation is subject to rate limiting. Do not exceed 5 calls per second. If you are throttled, retry later.
      *
      * @param request - DeleteCategoryRequest
      * @param headers - map
@@ -1041,7 +1197,13 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteCategoryResponse({}));
     }
     /**
-     * Deletes a specified category permanently.
+     * Permanently deletes a specified category.
+     *
+     * @remarks
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (requiring `AliyunBailianDataFullAccess`, which includes the sfm:DeleteCategory permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before calling this operation. Alibaba Cloud accounts can call this operation directly without authorization. Use the latest <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * - This operation is idempotent.
+     * **Rate limiting:**
+     * This operation is subject to rate limiting. Do not exceed 5 calls per second. If you are throttled, retry later.
      *
      * @param request - DeleteCategoryRequest
      * @returns DeleteCategoryResponse
@@ -1052,18 +1214,18 @@ class Client extends openapi_core_1.default {
         return await this.deleteCategoryWithOptions(CategoryId, WorkspaceId, request, headers, runtime);
     }
     /**
-     * Deletes a specified text chunk from a knowledge base. The deleted chunk cannot be retrieved or recalled.
+     * Deletes specified text chunks from a knowledge base. Deleted text chunks 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.
+     * <warning>  Deleted text chunks cannot be recovered (hard delete). Proceed with caution.
+     * - **Permission requirements**:
+     *   - **Resource Access Management (RAM) user**: Obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio first (you can use the `AliyunBailianDataFullAccess` policy, which includes the sfm:DeleteChunk permission required by this operation), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation.
+     *   - **Alibaba Cloud account**: Has permissions by default and can invoke this operation directly.
+     * - **Invocation method**: Use the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29). The SDK provides encapsulation of complex signature calculation logic and simplifies the invocation procedure.
+     * - **Effective latency**: Changes typically take effect immediately. During peak hours, there may be a slight delay (seconds).
+     * - **Idempotence**: This operation is idempotent. Repeated calls to delete an already deleted text chunk return a success response.
+     * **Rate limit:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If throttled, retry later.
      *
      * @param tmpReq - DeleteChunkRequest
      * @param headers - map
@@ -1102,18 +1264,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.
+     * Deletes specified text chunks from a knowledge base. Deleted text chunks 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.
+     * <warning>  Deleted text chunks cannot be recovered (hard delete). Proceed with caution.
+     * - **Permission requirements**:
+     *   - **Resource Access Management (RAM) user**: Obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio first (you can use the `AliyunBailianDataFullAccess` policy, which includes the sfm:DeleteChunk permission required by this operation), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation.
+     *   - **Alibaba Cloud account**: Has permissions by default and can invoke this operation directly.
+     * - **Invocation method**: Use the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29). The SDK provides encapsulation of complex signature calculation logic and simplifies the invocation procedure.
+     * - **Effective latency**: Changes typically take effect immediately. During peak hours, there may be a slight delay (seconds).
+     * - **Idempotence**: This operation is idempotent. Repeated calls to delete an already deleted text chunk return a success response.
+     * **Rate limit:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If throttled, retry later.
      *
      * @param request - DeleteChunkRequest
      * @returns DeleteChunkResponse
@@ -1126,6 +1288,12 @@ class Client extends openapi_core_1.default {
     /**
      * 删除连接器
      *
+     * @remarks
+     * - RAM用户（子账号）需要首先获取阿里云百炼的[API权限](https://help.aliyun.com/document_detail/2848578.html)（需要`AliyunBailianDataFullAccess`，已包括sfm:DeleteConnector权限点），并[加入一个业务空间](https://help.aliyun.com/document_detail/2851098.html)后，方可调用本接口。阿里云账号（主账号）可直接调用无须授权。建议您通过最新版[阿里云百炼SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)[阿里云百炼SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29)来调用本接口。
+     * - 本接口不具备幂等性。
+     * **限流说明：**
+     * 本接口频繁调用会被限流，频率请勿超过5次/秒。如遇限流，请稍后重试。
+     *
      * @param request - DeleteConnectorRequest
      * @param headers - map
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1152,6 +1320,12 @@ class Client extends openapi_core_1.default {
     /**
      * 删除连接器
      *
+     * @remarks
+     * - RAM用户（子账号）需要首先获取阿里云百炼的[API权限](https://help.aliyun.com/document_detail/2848578.html)（需要`AliyunBailianDataFullAccess`，已包括sfm:DeleteConnector权限点），并[加入一个业务空间](https://help.aliyun.com/document_detail/2851098.html)后，方可调用本接口。阿里云账号（主账号）可直接调用无须授权。建议您通过最新版[阿里云百炼SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)[阿里云百炼SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29)来调用本接口。
+     * - 本接口不具备幂等性。
+     * **限流说明：**
+     * 本接口频繁调用会被限流，频率请勿超过5次/秒。如遇限流，请稍后重试。
+     *
      * @param request - DeleteConnectorRequest
      * @returns DeleteConnectorResponse
      */
@@ -1161,7 +1335,16 @@ class Client extends openapi_core_1.default {
         return await this.deleteConnectorWithOptions(ConnectorId, WorkspaceId, request, headers, runtime);
     }
     /**
-     * Deletes a specified unstructured document permanently. You cannot use the API to delete structured documents, see the Usage notes section of this topic.
+     * Permanently delete a specified file from application data. Deleting data tables via API is not supported. For details, see the API Guide below.
+     *
+     * @remarks
+     * - Deleting data tables via API is not supported. To delete a data table or specific data within a table, go to <props="china">[Application Data](https://bailian.console.aliyun.com/?tab=app#/data-center)<props="intl">[Application Data](https://modelstudio.console.alibabacloud.com/?tab=app#/data-center) to perform the operation.
+     * - This API is used to delete files in <props="china">[Application Data](https://bailian.console.aliyun.com/?tab=app#/data-center)<props="intl">[Application Data](https://modelstudio.console.alibabacloud.com/?tab=app#/data-center) and does not affect any knowledge bases that have already been built. To delete a file from a knowledge base, invoke the **DeleteIndexDocument** API.
+     * - A RAM user must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (requiring `AliyunBailianDataFullAccess`, which includes the `sfm:DeleteFile` permission point) and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this API. An Alibaba Cloud account can invoke this API directly without authorization. We recommend that you use the latest version of the <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this API.
+     * - This API can only delete files whose status is either Failed to Parse (`PARSE_FAILED`) or Parse Succeeded (`PARSE_SUCCESS`).
+     * - This API is idempotent.
+     * **Rate Limiting Notice:**
+     * Frequent invocation of this API will trigger rate limiting. Do not exceed 10 requests per second. If rate limited, retry after a short wait.
      *
      * @param request - DeleteFileRequest
      * @param headers - map
@@ -1187,7 +1370,16 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteFileResponse({}));
     }
     /**
-     * Deletes a specified unstructured document permanently. You cannot use the API to delete structured documents, see the Usage notes section of this topic.
+     * Permanently delete a specified file from application data. Deleting data tables via API is not supported. For details, see the API Guide below.
+     *
+     * @remarks
+     * - Deleting data tables via API is not supported. To delete a data table or specific data within a table, go to <props="china">[Application Data](https://bailian.console.aliyun.com/?tab=app#/data-center)<props="intl">[Application Data](https://modelstudio.console.alibabacloud.com/?tab=app#/data-center) to perform the operation.
+     * - This API is used to delete files in <props="china">[Application Data](https://bailian.console.aliyun.com/?tab=app#/data-center)<props="intl">[Application Data](https://modelstudio.console.alibabacloud.com/?tab=app#/data-center) and does not affect any knowledge bases that have already been built. To delete a file from a knowledge base, invoke the **DeleteIndexDocument** API.
+     * - A RAM user must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (requiring `AliyunBailianDataFullAccess`, which includes the `sfm:DeleteFile` permission point) and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this API. An Alibaba Cloud account can invoke this API directly without authorization. We recommend that you use the latest version of the <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this API.
+     * - This API can only delete files whose status is either Failed to Parse (`PARSE_FAILED`) or Parse Succeeded (`PARSE_SUCCESS`).
+     * - This API is idempotent.
+     * **Rate Limiting Notice:**
+     * Frequent invocation of this API will trigger rate limiting. Do not exceed 10 requests per second. If rate limited, retry after a short wait.
      *
      * @param request - DeleteFileRequest
      * @returns DeleteFileResponse
@@ -1198,7 +1390,16 @@ class Client extends openapi_core_1.default {
         return await this.deleteFileWithOptions(FileId, WorkspaceId, request, headers, runtime);
     }
     /**
-     * 批量删除文档
+     * Delete files in batch
+     *
+     * @remarks
+     * - Deleting data tables through the API is not supported. To delete a data table or specific data in a table, go to <props="china">[Application Data](https://bailian.console.aliyun.com/?tab=app#/data-center)<props="intl">[Application Data](https://modelstudio.console.alibabacloud.com/?tab=app#/data-center).
+     * - This API is used to delete files in <props="china">[Application Data](https://bailian.console.aliyun.com/?tab=app#/data-center)<props="intl">[Application Data](https://modelstudio.console.alibabacloud.com/?tab=app#/data-center). It does not affect knowledge bases that have already been built. To delete files in a knowledge base, call the **DeleteIndexDocument** operation.
+     * - A RAM user (sub-account) must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (requires `AliyunBailianDataFullAccess`, which already includes the sfm:DeleteFiles permission) and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before calling this operation. The Alibaba Cloud account (main account) can call this operation directly without authorization. We recommend that you use the latest version of the <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * - This operation can only delete files whose status is parsing failed (PARSE_FAILED) or parsing succeeded (PARSE_SUCCESS).
+     * - This operation is idempotent.
+     * **Throttling:**
+     * Frequent calls to this operation are throttled. Do not exceed 10 queries per second (QPS). If you are throttled, try again later.
      *
      * @param tmpReq - DeleteFilesRequest
      * @param headers - map
@@ -1234,7 +1435,16 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteFilesResponse({}));
     }
     /**
-     * 批量删除文档
+     * Delete files in batch
+     *
+     * @remarks
+     * - Deleting data tables through the API is not supported. To delete a data table or specific data in a table, go to <props="china">[Application Data](https://bailian.console.aliyun.com/?tab=app#/data-center)<props="intl">[Application Data](https://modelstudio.console.alibabacloud.com/?tab=app#/data-center).
+     * - This API is used to delete files in <props="china">[Application Data](https://bailian.console.aliyun.com/?tab=app#/data-center)<props="intl">[Application Data](https://modelstudio.console.alibabacloud.com/?tab=app#/data-center). It does not affect knowledge bases that have already been built. To delete files in a knowledge base, call the **DeleteIndexDocument** operation.
+     * - A RAM user (sub-account) must first obtain the [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (requires `AliyunBailianDataFullAccess`, which already includes the sfm:DeleteFiles permission) and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before calling this operation. The Alibaba Cloud account (main account) can call this operation directly without authorization. We recommend that you use the latest version of the <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * - This operation can only delete files whose status is parsing failed (PARSE_FAILED) or parsing succeeded (PARSE_SUCCESS).
+     * - This operation is idempotent.
+     * **Throttling:**
+     * Frequent calls to this operation are throttled. Do not exceed 10 queries per second (QPS). If you are throttled, try again later.
      *
      * @param request - DeleteFilesRequest
      * @returns DeleteFilesResponse
@@ -1245,14 +1455,17 @@ class Client extends openapi_core_1.default {
         return await this.deleteFilesWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * Deletes a specified knowledge base permanently.
+     * Permanently deletes a specified knowledge base.
      *
      * @remarks
-     *   Before you call this operation, make sure that your knowledge base is created and is not deleted. That is, the primary key ID of the knowledge base `IndexId` is valid.
-     * *   If a knowledge base is being called by an application, disassociate the knowledge base before you can delete it. To disassociate the knowledge base, you must use the console. For more information, see [Create a knowledge base](https://www.alibabacloud.com/help/en/model-studio/user-guide/rag-knowledge-base).
-     * *   After you delete a knowledge base, it cannot be recovered. We recommend that you proceed with caution.
-     * *   Imported documents are not deleted from the [Data Management](https://bailian.console.aliyun.com/#/data-center) if you call this operation.
-     * *   This interface is idempotent.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (requiring `AliyunBailianDataFullAccess`, which includes the sfm:DeleteIndex permission) and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Use the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this operation.
+     * - Before invoking this operation, make sure that your knowledge base has been created and has not been deleted (that is, the knowledge base ID `IndexId` is valid).
+     * - If the knowledge base is associated with an application, you must first dissociate it from the application before deleting it. This can currently only be done through the console. For more information, see [Knowledge base](https://help.aliyun.com/document_detail/2807740.html).
+     * - Deletion is irreversible. A deleted knowledge base cannot be recovered. Proceed with caution.
+     * - Invoking this operation does not delete files that have been imported into <props="china">[Application Data](https://bailian.console.aliyun.com/?tab=app#/data-center)<props="intl">[Application Data](https://modelstudio.console.alibabacloud.com/?tab=app#/data-center).
+     * - This operation has idempotence.
+     * **Rate limit:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If you are throttled, retry later.
      *
      * @param request - DeleteIndexRequest
      * @param headers - map
@@ -1283,14 +1496,17 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteIndexResponse({}));
     }
     /**
-     * Deletes a specified knowledge base permanently.
+     * Permanently deletes a specified knowledge base.
      *
      * @remarks
-     *   Before you call this operation, make sure that your knowledge base is created and is not deleted. That is, the primary key ID of the knowledge base `IndexId` is valid.
-     * *   If a knowledge base is being called by an application, disassociate the knowledge base before you can delete it. To disassociate the knowledge base, you must use the console. For more information, see [Create a knowledge base](https://www.alibabacloud.com/help/en/model-studio/user-guide/rag-knowledge-base).
-     * *   After you delete a knowledge base, it cannot be recovered. We recommend that you proceed with caution.
-     * *   Imported documents are not deleted from the [Data Management](https://bailian.console.aliyun.com/#/data-center) if you call this operation.
-     * *   This interface is idempotent.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (requiring `AliyunBailianDataFullAccess`, which includes the sfm:DeleteIndex permission) and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Use the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this operation.
+     * - Before invoking this operation, make sure that your knowledge base has been created and has not been deleted (that is, the knowledge base ID `IndexId` is valid).
+     * - If the knowledge base is associated with an application, you must first dissociate it from the application before deleting it. This can currently only be done through the console. For more information, see [Knowledge base](https://help.aliyun.com/document_detail/2807740.html).
+     * - Deletion is irreversible. A deleted knowledge base cannot be recovered. Proceed with caution.
+     * - Invoking this operation does not delete files that have been imported into <props="china">[Application Data](https://bailian.console.aliyun.com/?tab=app#/data-center)<props="intl">[Application Data](https://modelstudio.console.alibabacloud.com/?tab=app#/data-center).
+     * - This operation has idempotence.
+     * **Rate limit:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If you are throttled, retry later.
      *
      * @param request - DeleteIndexRequest
      * @returns DeleteIndexResponse
@@ -1301,14 +1517,18 @@ class Client extends openapi_core_1.default {
         return await this.deleteIndexWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * Deletes one or more documents from a specified unstructured knowledge base permanently. You cannot use the API to delete structured documents, see the Usage notes section of this topic.
+     * Permanently deletes files from a specified knowledge base.
      *
      * @remarks
-     *   Before you call this operation, make sure that your knowledge base is created and is not deleted. That is, the primary key ID of the knowledge base `IndexId` is valid.
-     * *   Only documents with the INSERT_ERROR and FINISH states can be deleted. To query the status of documents in a specified knowledge base, call the [ListIndexDocuments](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-listindexdocuments) operation.
-     * *   After you delete a document, it cannot be recovered and the [Retrieve](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-retrieve) operation cannot query information about the document. We recommend that you proceed with caution.
-     * *   Imported documents are not deleted from the [Data Management](https://bailian.console.aliyun.com/#/data-center) if you call this operation.
-     * *   This interface is idempotent.
+     * - This operation does not support deleting data from data query or image Q&A knowledge bases. Use the Model Studio console instead.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (requiring `AliyunBailianDataFullAccess`, which includes the sfm:DeleteIndexDocument permission), before calling this operation. Alibaba Cloud accounts can call this operation directly without authorization. Use the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * - Before calling this operation, make sure that your knowledge base has been created and has not been deleted (that is, the knowledge base ID `IndexId` is valid).
+     * - You can only delete files whose status is import failed (INSERT_ERROR) or import succeeded (FINISH) in the knowledge base. To query the file status in a specified knowledge base, call the **ListIndexDocuments** operation.
+     * - Deletion is irreversible. The content of deleted files cannot be recovered, and the **Retrieve** operation can no longer retrieve related information. Proceed with caution.
+     * - Calling this operation does not delete documents that have been imported into <props="china">[Application Data](https://bailian.console.aliyun.com/?tab=app#/data-center)<props="intl">[Application Data](https://modelstudio.console.alibabacloud.com/?tab=app#/data-center).
+     * - This operation is idempotent.
+     * **Throttling:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If you are throttled, retry later.
      *
      * @param tmpReq - DeleteIndexDocumentRequest
      * @param headers - map
@@ -1347,14 +1567,18 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteIndexDocumentResponse({}));
     }
     /**
-     * Deletes one or more documents from a specified unstructured knowledge base permanently. You cannot use the API to delete structured documents, see the Usage notes section of this topic.
+     * Permanently deletes files from a specified knowledge base.
      *
      * @remarks
-     *   Before you call this operation, make sure that your knowledge base is created and is not deleted. That is, the primary key ID of the knowledge base `IndexId` is valid.
-     * *   Only documents with the INSERT_ERROR and FINISH states can be deleted. To query the status of documents in a specified knowledge base, call the [ListIndexDocuments](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-listindexdocuments) operation.
-     * *   After you delete a document, it cannot be recovered and the [Retrieve](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-retrieve) operation cannot query information about the document. We recommend that you proceed with caution.
-     * *   Imported documents are not deleted from the [Data Management](https://bailian.console.aliyun.com/#/data-center) if you call this operation.
-     * *   This interface is idempotent.
+     * - This operation does not support deleting data from data query or image Q&A knowledge bases. Use the Model Studio console instead.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (requiring `AliyunBailianDataFullAccess`, which includes the sfm:DeleteIndexDocument permission), before calling this operation. Alibaba Cloud accounts can call this operation directly without authorization. Use the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * - Before calling this operation, make sure that your knowledge base has been created and has not been deleted (that is, the knowledge base ID `IndexId` is valid).
+     * - You can only delete files whose status is import failed (INSERT_ERROR) or import succeeded (FINISH) in the knowledge base. To query the file status in a specified knowledge base, call the **ListIndexDocuments** operation.
+     * - Deletion is irreversible. The content of deleted files cannot be recovered, and the **Retrieve** operation can no longer retrieve related information. Proceed with caution.
+     * - Calling this operation does not delete documents that have been imported into <props="china">[Application Data](https://bailian.console.aliyun.com/?tab=app#/data-center)<props="intl">[Application Data](https://modelstudio.console.alibabacloud.com/?tab=app#/data-center).
+     * - This operation is idempotent.
+     * **Throttling:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If you are throttled, retry later.
      *
      * @param request - DeleteIndexDocumentRequest
      * @returns DeleteIndexDocumentResponse
@@ -1365,7 +1589,13 @@ class Client extends openapi_core_1.default {
         return await this.deleteIndexDocumentWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * 删除memory
+     * Permanently deletes a specified long-term memory.
+     *
+     * @remarks
+     * - Before calling this operation, make sure that your long-term memory has been created and has not been deleted (that is, the memoryId is valid).
+     * - The delete operation is irreversible. The deleted long-term memory, including all of its long-term memory nodes, cannot be recovered. The [GetMemory](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-getmemory) operation will no longer be able to retrieve its information. Proceed with caution.
+     * - This operation is idempotent.
+     * **Rate limit:** Make sure that the interval between two requests is at least 1 second. Otherwise, throttling may be triggered. If throttling occurs, retry later.
      *
      * @param request - DeleteMemoryRequest
      * @param headers - map
@@ -1391,7 +1621,13 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteMemoryResponse({}));
     }
     /**
-     * 删除memory
+     * Permanently deletes a specified long-term memory.
+     *
+     * @remarks
+     * - Before calling this operation, make sure that your long-term memory has been created and has not been deleted (that is, the memoryId is valid).
+     * - The delete operation is irreversible. The deleted long-term memory, including all of its long-term memory nodes, cannot be recovered. The [GetMemory](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-getmemory) operation will no longer be able to retrieve its information. Proceed with caution.
+     * - This operation is idempotent.
+     * **Rate limit:** Make sure that the interval between two requests is at least 1 second. Otherwise, throttling may be triggered. If throttling occurs, retry later.
      *
      * @param request - DeleteMemoryRequest
      * @returns DeleteMemoryResponse
@@ -1402,7 +1638,7 @@ class Client extends openapi_core_1.default {
         return await this.deleteMemoryWithOptions(workspaceId, memoryId, request, headers, runtime);
     }
     /**
-     * 删除记忆Node
+     * Deletes a memory fragment.
      *
      * @param request - DeleteMemoryNodeRequest
      * @param headers - map
@@ -1428,7 +1664,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteMemoryNodeResponse({}));
     }
     /**
-     * 删除记忆Node
+     * Deletes a memory fragment.
      *
      * @param request - DeleteMemoryNodeRequest
      * @returns DeleteMemoryNodeResponse
@@ -1476,13 +1712,13 @@ class Client extends openapi_core_1.default {
         return await this.deletePromptTemplateWithOptions(workspaceId, promptTemplateId, request, headers, runtime);
     }
     /**
-     * Obtains the basic information of a document, including the document name, type, and status.
+     * Queries the basic information of a file in application data, including the file name, type, and status.
      *
      * @remarks
-     * Before you call this API, make sure that your document is uploaded to the [Data Management](https://bailian.console.aliyun.com/knowledge-base#/data-center) page of Alibaba Cloud Model Studio.
-     * *   You can also call this operation to query unstructured documents that you upload on the [Data Management](https://bailian.console.aliyun.com/knowledge-base#/data-center) page.
-     * *   This operation is idempotent.
-     * **Throttling:** Make sure that the interval between the two queries is at least 15 seconds. Otherwise, you may trigger system throttling. If throttling is triggered, try again later.
+     * - A Resource Access Management (RAM) user must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (`AliyunBailianDataFullAccess` or `AliyunBailianDataReadOnlyAccess`, both of which include the sfm:DescribeFile permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. An Alibaba Cloud account can invoke this operation directly without authorization. Use the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this operation.
+     * - This operation is idempotent.
+     * **Throttling:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If you are throttled, retry later.
      *
      * @param request - DescribeFileRequest
      * @param headers - map
@@ -1508,13 +1744,13 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeFileResponse({}));
     }
     /**
-     * Obtains the basic information of a document, including the document name, type, and status.
+     * Queries the basic information of a file in application data, including the file name, type, and status.
      *
      * @remarks
-     * Before you call this API, make sure that your document is uploaded to the [Data Management](https://bailian.console.aliyun.com/knowledge-base#/data-center) page of Alibaba Cloud Model Studio.
-     * *   You can also call this operation to query unstructured documents that you upload on the [Data Management](https://bailian.console.aliyun.com/knowledge-base#/data-center) page.
-     * *   This operation is idempotent.
-     * **Throttling:** Make sure that the interval between the two queries is at least 15 seconds. Otherwise, you may trigger system throttling. If throttling is triggered, try again later.
+     * - A Resource Access Management (RAM) user must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (`AliyunBailianDataFullAccess` or `AliyunBailianDataReadOnlyAccess`, both of which include the sfm:DescribeFile permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. An Alibaba Cloud account can invoke this operation directly without authorization. Use the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this operation.
+     * - This operation is idempotent.
+     * **Throttling:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If you are throttled, retry later.
      *
      * @param request - DescribeFileRequest
      * @returns DescribeFileResponse
@@ -1525,7 +1761,7 @@ class Client extends openapi_core_1.default {
         return await this.describeFileWithOptions(WorkspaceId, FileId, request, headers, runtime);
     }
     /**
-     * 查询支付宝打赏状态
+     * Queries the tipping status of the Alipay wallet bound to an application.
      *
      * @param request - GetAlipayTransferStatusRequest
      * @param headers - map
@@ -1559,7 +1795,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetAlipayTransferStatusResponse({}));
     }
     /**
-     * 查询支付宝打赏状态
+     * Queries the tipping status of the Alipay wallet bound to an application.
      *
      * @param request - GetAlipayTransferStatusRequest
      * @returns GetAlipayTransferStatusResponse
@@ -1570,7 +1806,7 @@ class Client extends openapi_core_1.default {
         return await this.getAlipayTransferStatusWithOptions(request, headers, runtime);
     }
     /**
-     * 支付宝打赏链接
+     * Retrieves the Alipay tipping URL for an application.
      *
      * @param request - GetAlipayUrlRequest
      * @param headers - map
@@ -1604,7 +1840,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetAlipayUrlResponse({}));
     }
     /**
-     * 支付宝打赏链接
+     * Retrieves the Alipay tipping URL for an application.
      *
      * @param request - GetAlipayUrlRequest
      * @returns GetAlipayUrlResponse
@@ -1617,6 +1853,12 @@ class Client extends openapi_core_1.default {
     /**
      * Lists all supported parser types based on the input file type (file extension).
      *
+     * @remarks
+     * - RAM用户（子账号）需要首先获取阿里云百炼的[API权限](https://help.aliyun.com/document_detail/2848578.html)（`AliyunBailianDataFullAccess`或`AliyunBailianDataReadOnlyAccess`均可，已包括sfm:GetAvailableParserTypes权限点），并[加入一个业务空间](https://help.aliyun.com/document_detail/2851098.html)后，方可调用本接口。阿里云账号（主账号）可直接调用无须授权。建议您通过最新版<props="china">[阿里云百炼SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[阿里云百炼SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29)来调用本接口。
+     * - 本接口具有幂等性。
+     * **限流说明：**
+     * 本接口频繁调用会被限流，频率请勿超过10次/秒。如遇限流，请稍后重试。
+     *
      * @param request - GetAvailableParserTypesRequest
      * @param headers - map
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1648,6 +1890,12 @@ class Client extends openapi_core_1.default {
     /**
      * Lists all supported parser types based on the input file type (file extension).
      *
+     * @remarks
+     * - RAM用户（子账号）需要首先获取阿里云百炼的[API权限](https://help.aliyun.com/document_detail/2848578.html)（`AliyunBailianDataFullAccess`或`AliyunBailianDataReadOnlyAccess`均可，已包括sfm:GetAvailableParserTypes权限点），并[加入一个业务空间](https://help.aliyun.com/document_detail/2851098.html)后，方可调用本接口。阿里云账号（主账号）可直接调用无须授权。建议您通过最新版<props="china">[阿里云百炼SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[阿里云百炼SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29)来调用本接口。
+     * - 本接口具有幂等性。
+     * **限流说明：**
+     * 本接口频繁调用会被限流，频率请勿超过10次/秒。如遇限流，请稍后重试。
+     *
      * @param request - GetAvailableParserTypesRequest
      * @returns GetAvailableParserTypesResponse
      */
@@ -1657,7 +1905,13 @@ class Client extends openapi_core_1.default {
         return await this.getAvailableParserTypesWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * GetConnector
+     * Retrieves details about a connector. This operation currently supports only file connectors.
+     *
+     * @remarks
+     * - To call this operation, a RAM user (sub-account) must have the required [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio and must [join a business space](https://help.aliyun.com/document_detail/2851098.html). This requires the `AliyunBailianDataFullAccess` policy, which includes the sfm:GetConnector permission. An Alibaba Cloud account (primary account) can call this operation directly. We recommend using the latest [Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * - This operation is idempotent.
+     * **Throttling:**
+     * This operation is subject to throttling. Do not exceed a frequency of 5 calls per second. If a request is throttled, try again later.
      *
      * @param request - GetConnectorRequest
      * @param headers - map
@@ -1691,7 +1945,13 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetConnectorResponse({}));
     }
     /**
-     * GetConnector
+     * Retrieves details about a connector. This operation currently supports only file connectors.
+     *
+     * @remarks
+     * - To call this operation, a RAM user (sub-account) must have the required [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio and must [join a business space](https://help.aliyun.com/document_detail/2851098.html). This requires the `AliyunBailianDataFullAccess` policy, which includes the sfm:GetConnector permission. An Alibaba Cloud account (primary account) can call this operation directly. We recommend using the latest [Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * - This operation is idempotent.
+     * **Throttling:**
+     * This operation is subject to throttling. Do not exceed a frequency of 5 calls per second. If a request is throttled, try again later.
      *
      * @param request - GetConnectorRequest
      * @returns GetConnectorResponse
@@ -1702,12 +1962,13 @@ class Client extends openapi_core_1.default {
         return await this.getConnectorWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * Queries the current status of a specified knowledge base creation or add document job.
+     * Queries the current status of a specified knowledge base creation task or knowledge base document append task.
      *
      * @remarks
-     * 1.  A knowledge base job is running. You can call the [SubmitIndexJob](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-submitindexjob) operation to create a creation job or the [SubmitIndexAddDocumentsJob](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-submitindexadddocumentsjob) operation to create a add document job. Then, obtain the `JobId` returned by the operations.
-     * 2.  We recommend that you call this operation at intervals of more than 5 seconds.
-     * 3.  This interface is idempotent.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (`AliyunBailianDataFullAccess` or `AliyunBailianDataReadOnlyAccess`, both of which include the sfm:GetIndexJobStatus permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Use the latest <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this operation.
+     * - You must have a knowledge base job that is in progress. You can create a knowledge base creation task by invoking the **SubmitIndexJob** operation, or create a knowledge base document append task by invoking the **SubmitIndexAddDocumentsJob** operation. Obtain the corresponding `JobId`.
+     * - Invoke this operation at intervals of 5 seconds or more.
+     * - This operation supports idempotence.
      *
      * @param request - GetIndexJobStatusRequest
      * @param headers - map
@@ -1747,12 +2008,13 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetIndexJobStatusResponse({}));
     }
     /**
-     * Queries the current status of a specified knowledge base creation or add document job.
+     * Queries the current status of a specified knowledge base creation task or knowledge base document append task.
      *
      * @remarks
-     * 1.  A knowledge base job is running. You can call the [SubmitIndexJob](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-submitindexjob) operation to create a creation job or the [SubmitIndexAddDocumentsJob](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-submitindexadddocumentsjob) operation to create a add document job. Then, obtain the `JobId` returned by the operations.
-     * 2.  We recommend that you call this operation at intervals of more than 5 seconds.
-     * 3.  This interface is idempotent.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (`AliyunBailianDataFullAccess` or `AliyunBailianDataReadOnlyAccess`, both of which include the sfm:GetIndexJobStatus permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Use the latest <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this operation.
+     * - You must have a knowledge base job that is in progress. You can create a knowledge base creation task by invoking the **SubmitIndexJob** operation, or create a knowledge base document append task by invoking the **SubmitIndexAddDocumentsJob** operation. Obtain the corresponding `JobId`.
+     * - Invoke this operation at intervals of 5 seconds or more.
+     * - This operation supports idempotence.
      *
      * @param request - GetIndexJobStatusRequest
      * @returns GetIndexJobStatusResponse
@@ -1763,7 +2025,13 @@ class Client extends openapi_core_1.default {
         return await this.getIndexJobStatusWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * \\<props="intl">Currently, this API is not supported.\\
+     * You can call the GetIndexMonitor operation to query monitoring data for a specified knowledge base within a specific time range. This data is crucial for App Performance Analytics, capacity planning, and cost management. The monitoring data includes two main dimensions: storage and retrieval. Storage monitoring retrieves the index storage limit and current usage of the knowledge base. Retrieval monitoring retrieves performance metrics for the query period, such as peak queries per second (QPS), total requests, and average QPS. The metrics are provided as totals and are also broken down by time window. The requests are categorized as successful, failed, and rate-limited.
+     *
+     * @remarks
+     * <props="intl">
+     * This operation is not available on the Alibaba Cloud International Website (www\\.alibabacloud.com).
+     * <props="china">
+     * - Before you call this operation, a RAM user must obtain the required [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (which requires the `AliyunBailianDataFullAccess` permission) and [join a workspace](https://help.aliyun.com/document_detail/2851098.html). Alibaba Cloud accounts can call this operation directly without authorization. You can call this operation using the latest version of the [Alibaba Cloud Model Studio software development kit (SDK)](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29). Before you call this operation, make sure that the specified knowledge base has been created and has not been deleted. This means that the knowledge base ID (`IndexId`) must be valid. This operation is idempotent. The maximum query time range (EndTimestamp - StartTimestamp) is 30 days. The granularity of the time window in the returned data is dynamically adjusted based on the query time range.
      *
      * @param request - GetIndexMonitorRequest
      * @param headers - map
@@ -1800,7 +2068,13 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetIndexMonitorResponse({}));
     }
     /**
-     * \\<props="intl">Currently, this API is not supported.\\
+     * You can call the GetIndexMonitor operation to query monitoring data for a specified knowledge base within a specific time range. This data is crucial for App Performance Analytics, capacity planning, and cost management. The monitoring data includes two main dimensions: storage and retrieval. Storage monitoring retrieves the index storage limit and current usage of the knowledge base. Retrieval monitoring retrieves performance metrics for the query period, such as peak queries per second (QPS), total requests, and average QPS. The metrics are provided as totals and are also broken down by time window. The requests are categorized as successful, failed, and rate-limited.
+     *
+     * @remarks
+     * <props="intl">
+     * This operation is not available on the Alibaba Cloud International Website (www\\.alibabacloud.com).
+     * <props="china">
+     * - Before you call this operation, a RAM user must obtain the required [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (which requires the `AliyunBailianDataFullAccess` permission) and [join a workspace](https://help.aliyun.com/document_detail/2851098.html). Alibaba Cloud accounts can call this operation directly without authorization. You can call this operation using the latest version of the [Alibaba Cloud Model Studio software development kit (SDK)](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29). Before you call this operation, make sure that the specified knowledge base has been created and has not been deleted. This means that the knowledge base ID (`IndexId`) must be valid. This operation is idempotent. The maximum query time range (EndTimestamp - StartTimestamp) is 30 days. The granularity of the time window in the returned data is dynamically adjusted based on the query time range.
      *
      * @param request - GetIndexMonitorRequest
      * @returns GetIndexMonitorResponse
@@ -1811,7 +2085,11 @@ class Client extends openapi_core_1.default {
         return await this.getIndexMonitorWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * 获取memory
+     * Retrieves the description of a specified long-term memory.
+     *
+     * @remarks
+     * - This operation is idempotent.
+     * **Rate limit:** Ensure that the interval between two consecutive requests is at least 1 second. Otherwise, throttling may be triggered. If throttling occurs, retry later.
      *
      * @param request - GetMemoryRequest
      * @param headers - map
@@ -1837,7 +2115,11 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetMemoryResponse({}));
     }
     /**
-     * 获取memory
+     * Retrieves the description of a specified long-term memory.
+     *
+     * @remarks
+     * - This operation is idempotent.
+     * **Rate limit:** Ensure that the interval between two consecutive requests is at least 1 second. Otherwise, throttling may be triggered. If throttling occurs, retry later.
      *
      * @param request - GetMemoryRequest
      * @returns GetMemoryResponse
@@ -1848,7 +2130,7 @@ class Client extends openapi_core_1.default {
         return await this.getMemoryWithOptions(workspaceId, memoryId, request, headers, runtime);
     }
     /**
-     * 获取记忆Node
+     * Retrieves a memory fragment.
      *
      * @param request - GetMemoryNodeRequest
      * @param headers - map
@@ -1874,7 +2156,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetMemoryNodeResponse({}));
     }
     /**
-     * 获取记忆Node
+     * Retrieves a memory fragment.
      *
      * @param request - GetMemoryNodeRequest
      * @returns GetMemoryNodeResponse
@@ -1887,6 +2169,12 @@ class Client extends openapi_core_1.default {
     /**
      * Queries the data parsing settings in a specified category.
      *
+     * @remarks
+     * - RAM用户（子账号）需要首先获取阿里云百炼的[API权限](https://help.aliyun.com/document_detail/2848578.html)（`AliyunBailianDataFullAccess`或`AliyunBailianDataReadOnlyAccess`均可，已包括sfm:GetParseSettings权限点），并[加入一个业务空间](https://help.aliyun.com/document_detail/2851098.html)后，方可调用本接口。阿里云账号（主账号）可直接调用无须授权。建议您通过最新版<props="china">[阿里云百炼SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[阿里云百炼SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29)来调用本接口。
+     * - 本接口具有幂等性。
+     * **限流说明：**
+     * 本接口频繁调用会被限流，频率请勿超过10次/秒。如遇限流，请稍后重试。
+     *
      * @param request - GetParseSettingsRequest
      * @param headers - map
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1918,6 +2206,12 @@ class Client extends openapi_core_1.default {
     /**
      * Queries the data parsing settings in a specified category.
      *
+     * @remarks
+     * - RAM用户（子账号）需要首先获取阿里云百炼的[API权限](https://help.aliyun.com/document_detail/2848578.html)（`AliyunBailianDataFullAccess`或`AliyunBailianDataReadOnlyAccess`均可，已包括sfm:GetParseSettings权限点），并[加入一个业务空间](https://help.aliyun.com/document_detail/2851098.html)后，方可调用本接口。阿里云账号（主账号）可直接调用无须授权。建议您通过最新版<props="china">[阿里云百炼SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[阿里云百炼SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29)来调用本接口。
+     * - 本接口具有幂等性。
+     * **限流说明：**
+     * 本接口频繁调用会被限流，频率请勿超过10次/秒。如遇限流，请稍后重试。
+     *
      * @param request - GetParseSettingsRequest
      * @returns GetParseSettingsResponse
      */
@@ -2058,7 +2352,14 @@ class Client extends openapi_core_1.default {
         return await this.highCodeDeployWithOptions(workspaceId, request, headers, runtime);
     }
     /**
-     * Lists the details about the next or multiple categories in a specified workspace.
+     * Retrieves the details of one or more categories in a specified workspace.
+     *
+     * @remarks
+     * - This API does not support querying data tables.
+     * - To call this API, a RAM user must first obtain the required [API permission](https://help.aliyun.com/document_detail/2848578.html) for Model Studio and [join a workspace](https://help.aliyun.com/document_detail/2851098.html). This requires the `AliyunBailianDataFullAccess` permission, which includes the `sfm:ListCategory` permission. Alibaba Cloud accounts can call this API directly. Use the latest version of the <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - This operation supports pagination. When making your first request, set the `MaxResults` parameter to specify the maximum number of items to return. If more items are available, the response includes a `NextToken`. To retrieve the next page of results, set the `NextToken` parameter to the value from the previous response and specify `MaxResults` again. An empty `NextToken` indicates that no more results are available.
+     * - This operation is idempotent.
+     * **Rate limiting:** This API is subject to rate limiting. Do not exceed 5 requests per second. If the system throttles a request, retry it after a short interval.
      *
      * @param request - ListCategoryRequest
      * @param headers - map
@@ -2104,7 +2405,14 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListCategoryResponse({}));
     }
     /**
-     * Lists the details about the next or multiple categories in a specified workspace.
+     * Retrieves the details of one or more categories in a specified workspace.
+     *
+     * @remarks
+     * - This API does not support querying data tables.
+     * - To call this API, a RAM user must first obtain the required [API permission](https://help.aliyun.com/document_detail/2848578.html) for Model Studio and [join a workspace](https://help.aliyun.com/document_detail/2851098.html). This requires the `AliyunBailianDataFullAccess` permission, which includes the `sfm:ListCategory` permission. Alibaba Cloud accounts can call this API directly. Use the latest version of the <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - This operation supports pagination. When making your first request, set the `MaxResults` parameter to specify the maximum number of items to return. If more items are available, the response includes a `NextToken`. To retrieve the next page of results, set the `NextToken` parameter to the value from the previous response and specify `MaxResults` again. An empty `NextToken` indicates that no more results are available.
+     * - This operation is idempotent.
+     * **Rate limiting:** This API is subject to rate limiting. Do not exceed 5 requests per second. If the system throttles a request, retry it after a short interval.
      *
      * @param request - ListCategoryRequest
      * @returns ListCategoryResponse
@@ -2115,11 +2423,15 @@ class Client extends openapi_core_1.default {
         return await this.listCategoryWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * For unstructured knowledge base, obtains the details of all chunks of a specified document; for structured knowledge base, obtains the details of all chunks.
+     * Queries the list and information of text chunks.
      *
      * @remarks
-     *   Before you call this operation, make sure that your knowledge base is created and is not deleted. That is, the primary key ID of the knowledge base `IndexId` is valid.
-     * *   This interface is idempotent.
+     * - For document search<props="china"> or audio/video search knowledge bases, this operation queries all chunks of a specified file. For data query or image Q&A knowledge bases, this operation retrieves information about all text chunks.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (requires `AliyunBailianDataFullAccess`, which includes the sfm:ChunkList permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Use the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this operation.
+     * - Before invoking this operation, make sure that your knowledge base has been created and has not been deleted (that is, the knowledge base ID `IndexId` is valid).
+     * - This operation has idempotence.
+     * **Rate limit:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If you are throttled, retry later.
      *
      * @param request - ListChunksRequest
      * @param headers - map
@@ -2165,11 +2477,15 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListChunksResponse({}));
     }
     /**
-     * For unstructured knowledge base, obtains the details of all chunks of a specified document; for structured knowledge base, obtains the details of all chunks.
+     * Queries the list and information of text chunks.
      *
      * @remarks
-     *   Before you call this operation, make sure that your knowledge base is created and is not deleted. That is, the primary key ID of the knowledge base `IndexId` is valid.
-     * *   This interface is idempotent.
+     * - For document search<props="china"> or audio/video search knowledge bases, this operation queries all chunks of a specified file. For data query or image Q&A knowledge bases, this operation retrieves information about all text chunks.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (requires `AliyunBailianDataFullAccess`, which includes the sfm:ChunkList permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Use the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this operation.
+     * - Before invoking this operation, make sure that your knowledge base has been created and has not been deleted (that is, the knowledge base ID `IndexId` is valid).
+     * - This operation has idempotence.
+     * **Rate limit:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If you are throttled, retry later.
      *
      * @param request - ListChunksRequest
      * @returns ListChunksResponse
@@ -2180,13 +2496,14 @@ 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.
+     * Retrieves 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.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (requires `AliyunBailianDataFullAccess`, which includes the sfm:ListFile permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Invoke this operation by using the latest <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - For paging on the first page, only set `MaxResults` to limit the number of entries returned. The `NextToken` in the response serves as the credential for querying subsequent pages. When querying subsequent pages, set the `NextToken` parameter to the `NextToken` value obtained from the previous response (if `NextToken` is empty, all results have been returned and no further requests are needed), and set `MaxResults` to limit the number of entries returned.
+     * - This operation is idempotent.
+     * **Rate limit:**
+     * This operation is throttled if called too frequently. Do not exceed 5 calls per second. If throttled, retry later.
      *
      * @param tmpReq - ListFileRequest
      * @param headers - map
@@ -2234,13 +2551,14 @@ 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.
+     * Retrieves 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.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (requires `AliyunBailianDataFullAccess`, which includes the sfm:ListFile permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Invoke this operation by using the latest <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - For paging on the first page, only set `MaxResults` to limit the number of entries returned. The `NextToken` in the response serves as the credential for querying subsequent pages. When querying subsequent pages, set the `NextToken` parameter to the `NextToken` value obtained from the previous response (if `NextToken` is empty, all results have been returned and no further requests are needed), and set `MaxResults` to limit the number of entries returned.
+     * - This operation is idempotent.
+     * **Rate limit:**
+     * This operation is throttled if called too frequently. Do not exceed 5 calls per second. If throttled, retry later.
      *
      * @param request - ListFileRequest
      * @returns ListFileResponse
@@ -2251,11 +2569,14 @@ class Client extends openapi_core_1.default {
         return await this.listFileWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * Queries the details of one or more documents in a specified knowledge base.
+     * Retrieves files and their summary information from a specified knowledge base.
      *
      * @remarks
-     *   Before you call this operation, make sure that your knowledge base is created and is not deleted. That is, the primary key ID of the knowledge base `IndexId` is valid.
-     * *   This interface is idempotent.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (requires `AliyunBailianDataFullAccess`, which includes the sfm:ListIndexFiles permission) and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Use the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this operation.
+     * - Before invoking this operation, make sure that your knowledge base has been created and has not been deleted (that is, the knowledge base ID `IndexId` is valid).
+     * - This operation has idempotence.
+     * **Throttling:**
+     * This operation is throttled if called too frequently. Do not exceed 15 calls per second. If you are throttled, retry later.
      *
      * @param request - ListIndexDocumentsRequest
      * @param headers - map
@@ -2301,11 +2622,14 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListIndexDocumentsResponse({}));
     }
     /**
-     * Queries the details of one or more documents in a specified knowledge base.
+     * Retrieves files and their summary information from a specified knowledge base.
      *
      * @remarks
-     *   Before you call this operation, make sure that your knowledge base is created and is not deleted. That is, the primary key ID of the knowledge base `IndexId` is valid.
-     * *   This interface is idempotent.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (requires `AliyunBailianDataFullAccess`, which includes the sfm:ListIndexFiles permission) and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Use the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this operation.
+     * - Before invoking this operation, make sure that your knowledge base has been created and has not been deleted (that is, the knowledge base ID `IndexId` is valid).
+     * - This operation has idempotence.
+     * **Throttling:**
+     * This operation is throttled if called too frequently. Do not exceed 15 calls per second. If you are throttled, retry later.
      *
      * @param request - ListIndexDocumentsRequest
      * @returns ListIndexDocumentsResponse
@@ -2316,7 +2640,12 @@ class Client extends openapi_core_1.default {
         return await this.listIndexDocumentsWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * 查询Index文件详情
+     * Retrieves the files in a specified knowledge base along with their details.
+     *
+     * @remarks
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (`AliyunBailianDataFullAccess` is required, which includes the sfm:ListIndexFiles permission), before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Use the latest <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this operation.
+     * - Before invoking this operation, make sure that your knowledge base has been created and has not been deleted (that is, the knowledge base ID `IndexId` is valid).
+     * - This operation has idempotence.
      *
      * @param request - ListIndexFileDetailsRequest
      * @param headers - map
@@ -2362,7 +2691,12 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListIndexFileDetailsResponse({}));
     }
     /**
-     * 查询Index文件详情
+     * Retrieves the files in a specified knowledge base along with their details.
+     *
+     * @remarks
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (`AliyunBailianDataFullAccess` is required, which includes the sfm:ListIndexFiles permission), before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Use the latest <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this operation.
+     * - Before invoking this operation, make sure that your knowledge base has been created and has not been deleted (that is, the knowledge base ID `IndexId` is valid).
+     * - This operation has idempotence.
      *
      * @param request - ListIndexFileDetailsRequest
      * @returns ListIndexFileDetailsResponse
@@ -2373,10 +2707,13 @@ class Client extends openapi_core_1.default {
         return await this.listIndexFileDetailsWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * Lists the details about the next or multiple knowledge bases in a specified workspace.
+     * Retrieves the list of knowledge bases in a specified workspace.
      *
      * @remarks
-     * This interface is idempotent.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (requires `AliyunBailianDataFullAccess`, which includes the sfm:ListIndex permission) before calling this operation. Alibaba Cloud accounts can call this operation directly without authorization. Use the latest <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * - This operation is idempotent.
+     * **Rate limit:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If throttled, retry later.
      *
      * @param request - ListIndicesRequest
      * @param headers - map
@@ -2413,10 +2750,13 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListIndicesResponse({}));
     }
     /**
-     * Lists the details about the next or multiple knowledge bases in a specified workspace.
+     * Retrieves the list of knowledge bases in a specified workspace.
      *
      * @remarks
-     * This interface is idempotent.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (requires `AliyunBailianDataFullAccess`, which includes the sfm:ListIndex permission) before calling this operation. Alibaba Cloud accounts can call this operation directly without authorization. Use the latest <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * - This operation is idempotent.
+     * **Rate limit:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If throttled, retry later.
      *
      * @param request - ListIndicesRequest
      * @returns ListIndicesResponse
@@ -2427,7 +2767,12 @@ class Client extends openapi_core_1.default {
         return await this.listIndicesWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * 获取memory
+     * Retrieves the details of one or more long-term memory entities in a specified workspace.
+     *
+     * @remarks
+     * - When querying the first page of a paging query, set only `MaxResults` to limit the number of entries returned. The `NextToken` value in the response serves as the credential for querying subsequent pages. When querying subsequent pages, set the `NextToken` parameter to the `NextToken` value obtained from the previous response as the query credential (if `NextToken` is empty, all results have been returned and no further requests are needed), and settings `MaxResults` to limit the number of entries returned.
+     * - This operation supports idempotence.
+     * **Rate limit:** Ensure that the interval between two consecutive requests is at least 1 second. Otherwise, throttling may be triggered. If throttling occurs, retry later.
      *
      * @param request - ListMemoriesRequest
      * @param headers - map
@@ -2461,7 +2806,12 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListMemoriesResponse({}));
     }
     /**
-     * 获取memory
+     * Retrieves the details of one or more long-term memory entities in a specified workspace.
+     *
+     * @remarks
+     * - When querying the first page of a paging query, set only `MaxResults` to limit the number of entries returned. The `NextToken` value in the response serves as the credential for querying subsequent pages. When querying subsequent pages, set the `NextToken` parameter to the `NextToken` value obtained from the previous response as the query credential (if `NextToken` is empty, all results have been returned and no further requests are needed), and settings `MaxResults` to limit the number of entries returned.
+     * - This operation supports idempotence.
+     * **Rate limit:** Ensure that the interval between two consecutive requests is at least 1 second. Otherwise, throttling may be triggered. If throttling occurs, retry later.
      *
      * @param request - ListMemoriesRequest
      * @returns ListMemoriesResponse
@@ -2472,7 +2822,7 @@ class Client extends openapi_core_1.default {
         return await this.listMemoriesWithOptions(workspaceId, request, headers, runtime);
     }
     /**
-     * 获取记忆Node列表
+     * Retrieves a list of memory nodes.
      *
      * @param request - ListMemoryNodesRequest
      * @param headers - map
@@ -2506,7 +2856,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListMemoryNodesResponse({}));
     }
     /**
-     * 获取记忆Node列表
+     * Retrieves a list of memory nodes.
      *
      * @param request - ListMemoryNodesRequest
      * @returns ListMemoryNodesResponse
@@ -2613,12 +2963,23 @@ class Client extends openapi_core_1.default {
         return await this.listPublishedAgentWithOptions(workspaceId, request, headers, runtime);
     }
     /**
-     * Queries information from a specified knowledge base.
+     * Retrieves information from a specified knowledge base.
      *
      * @remarks
-     *   Before you call this operation, make sure that your knowledge base is created and is not deleted. That is, the primary key ID of the knowledge base `IndexId` is valid.
-     * *   The response time may be long because this operation involves complex retrieval and matching. We recommend that you set appropriate timeout and retry policy for requests.
-     * *   This interface is idempotent.
+     * <props="china">
+     * - **How to call**: To retrieve information from a knowledge base, use the latest [Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29) with an [AccessKey](https://help.aliyun.com/document_detail/116401.html) or [Spring AI Alibaba](https://help.aliyun.com/document_detail/2990886.html) with an Alibaba Cloud Model Studio [API key](https://help.aliyun.com/document_detail/2712195.html). Both tools simplify your API calls by handling the complex signature calculation.
+     * - **Required permissions**:
+     *   - **RAM user (sub-account)**: To call this API, a RAM user must be granted [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio and [join a workspace](https://help.aliyun.com/document_detail/2851098.html). You can use the `AliyunBailianDataFullAccess` policy, which includes the required `sfm:Retrieve` permission.
+     *   - **Alibaba Cloud account (main account)**: This account has the required permissions by default and can call the API directly.
+     * - **Response latency**: This API call involves complex retrieval and matching operations, which can cause longer response times. We recommend configuring appropriate request timeouts and retry strategies.
+     * - **Idempotency**: This API is idempotent.
+     * <props="intl">
+     * - **How to call**: We recommend using the latest [Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this API. The SDK simplifies API calls by handling the complex signature calculation.
+     * - **Required permissions**:
+     *   - **RAM user (sub-account)**: To call this API, a RAM user must be granted [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio and [join a workspace](https://help.aliyun.com/document_detail/2851098.html). You can use the `AliyunBailianDataFullAccess` policy, which includes the required `sfm:Retrieve` permission.
+     *   - **Alibaba Cloud account (main account)**: This account has the required permissions by default and can call the API directly.
+     * - **Response latency**: This API call involves complex retrieval and matching operations, which can cause longer response times. We recommend configuring appropriate request timeouts and retry strategies.
+     * - **Idempotency**: This API is idempotent.
      *
      * @param tmpReq - RetrieveRequest
      * @param headers - map
@@ -2711,12 +3072,23 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.RetrieveResponse({}));
     }
     /**
-     * Queries information from a specified knowledge base.
+     * Retrieves information from a specified knowledge base.
      *
      * @remarks
-     *   Before you call this operation, make sure that your knowledge base is created and is not deleted. That is, the primary key ID of the knowledge base `IndexId` is valid.
-     * *   The response time may be long because this operation involves complex retrieval and matching. We recommend that you set appropriate timeout and retry policy for requests.
-     * *   This interface is idempotent.
+     * <props="china">
+     * - **How to call**: To retrieve information from a knowledge base, use the latest [Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29) with an [AccessKey](https://help.aliyun.com/document_detail/116401.html) or [Spring AI Alibaba](https://help.aliyun.com/document_detail/2990886.html) with an Alibaba Cloud Model Studio [API key](https://help.aliyun.com/document_detail/2712195.html). Both tools simplify your API calls by handling the complex signature calculation.
+     * - **Required permissions**:
+     *   - **RAM user (sub-account)**: To call this API, a RAM user must be granted [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio and [join a workspace](https://help.aliyun.com/document_detail/2851098.html). You can use the `AliyunBailianDataFullAccess` policy, which includes the required `sfm:Retrieve` permission.
+     *   - **Alibaba Cloud account (main account)**: This account has the required permissions by default and can call the API directly.
+     * - **Response latency**: This API call involves complex retrieval and matching operations, which can cause longer response times. We recommend configuring appropriate request timeouts and retry strategies.
+     * - **Idempotency**: This API is idempotent.
+     * <props="intl">
+     * - **How to call**: We recommend using the latest [Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this API. The SDK simplifies API calls by handling the complex signature calculation.
+     * - **Required permissions**:
+     *   - **RAM user (sub-account)**: To call this API, a RAM user must be granted [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio and [join a workspace](https://help.aliyun.com/document_detail/2851098.html). You can use the `AliyunBailianDataFullAccess` policy, which includes the required `sfm:Retrieve` permission.
+     *   - **Alibaba Cloud account (main account)**: This account has the required permissions by default and can call the API directly.
+     * - **Response latency**: This API call involves complex retrieval and matching operations, which can cause longer response times. We recommend configuring appropriate request timeouts and retry strategies.
+     * - **Idempotency**: This API is idempotent.
      *
      * @param request - RetrieveRequest
      * @returns RetrieveResponse
@@ -2727,13 +3099,19 @@ class Client extends openapi_core_1.default {
         return await this.retrieveWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * Adds parsed documents to an unstructured knowledge base. You cannot use the API to add knowledge to structured knowledge bases, see the Usage notes section of this topic.
+     * Adds parsed files to the specified knowledge base.
      *
      * @remarks
-     *   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).
-     * *   Before you call this operation, make sure that your knowledge base is created and is not deleted. That is, the primary key ID of the knowledge base `IndexId` is valid.
-     * *   After you call this operation, you can call the [GetIndexJobStatus](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-getindexjobstatus) operation to query the status of the job. More than 20 calls to the GetIndexJobStatus operation per minute may trigger throttling.
-     * *   Execution takes a period of time after this operation is called. Do not make new request before the request is returned. This interface is not idempotent.
+     * <props="china">
+     * - This API does not support knowledge bases for data queries or image Q\\&A. To update these knowledge bases, see the [knowledge base](https://help.aliyun.com/document_detail/2807740.html) documentation.
+     * <props="intl">
+     * - This API does not support knowledge bases for data queries or image Q\\&A. To update these knowledge bases, see the [knowledge base](https://help.aliyun.com/document_detail/2807740.html) documentation.
+     * - A RAM user (sub-account) can call this API only after being granted the required [api permission](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (specifically, the `AliyunBailianDataFullAccess` policy, which includes the `sfm:SubmitIndexAddDocumentsJob` permission) and joining a [workspace](https://help.aliyun.com/document_detail/2851098.html). An Alibaba Cloud account can call this API directly without authorization. We recommend using the latest version of the <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this API.
+     * - Before calling this API, ensure your knowledge base exists and has a valid knowledge base ID (`IndexId`).
+     * - Before calling this API, you must first upload files to Alibaba Cloud Model Studio using the **AddFile** API.
+     * - After calling this API, the job runs in the background and may take several hours to complete, especially during peak times. Do not submit duplicate requests until the job is complete. To check the job status, call the **GetIndexJobStatus** API. The `Documents` file list returned by the GetIndexJobStatus API contains all files for the job, which is uniquely identified by the `job_id` you provided. You can check this list to verify whether each file was imported (parsed) successfully. Note that frequent calls to the GetIndexJobStatus API are subject to rate limiting. Do not exceed 20 calls per minute.
+     * - A successful API call indicates the job has been submitted for processing, which takes time. This API is not idempotent, so do not send duplicate requests; doing so will create multiple jobs.
+     * **Rate limiting:** This API is limited to 10 calls per second. If you exceed this limit, wait before retrying.
      *
      * @param tmpReq - SubmitIndexAddDocumentsJobRequest
      * @param headers - map
@@ -2802,13 +3180,19 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.SubmitIndexAddDocumentsJobResponse({}));
     }
     /**
-     * Adds parsed documents to an unstructured knowledge base. You cannot use the API to add knowledge to structured knowledge bases, see the Usage notes section of this topic.
+     * Adds parsed files to the specified knowledge base.
      *
      * @remarks
-     *   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).
-     * *   Before you call this operation, make sure that your knowledge base is created and is not deleted. That is, the primary key ID of the knowledge base `IndexId` is valid.
-     * *   After you call this operation, you can call the [GetIndexJobStatus](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-getindexjobstatus) operation to query the status of the job. More than 20 calls to the GetIndexJobStatus operation per minute may trigger throttling.
-     * *   Execution takes a period of time after this operation is called. Do not make new request before the request is returned. This interface is not idempotent.
+     * <props="china">
+     * - This API does not support knowledge bases for data queries or image Q\\&A. To update these knowledge bases, see the [knowledge base](https://help.aliyun.com/document_detail/2807740.html) documentation.
+     * <props="intl">
+     * - This API does not support knowledge bases for data queries or image Q\\&A. To update these knowledge bases, see the [knowledge base](https://help.aliyun.com/document_detail/2807740.html) documentation.
+     * - A RAM user (sub-account) can call this API only after being granted the required [api permission](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (specifically, the `AliyunBailianDataFullAccess` policy, which includes the `sfm:SubmitIndexAddDocumentsJob` permission) and joining a [workspace](https://help.aliyun.com/document_detail/2851098.html). An Alibaba Cloud account can call this API directly without authorization. We recommend using the latest version of the <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this API.
+     * - Before calling this API, ensure your knowledge base exists and has a valid knowledge base ID (`IndexId`).
+     * - Before calling this API, you must first upload files to Alibaba Cloud Model Studio using the **AddFile** API.
+     * - After calling this API, the job runs in the background and may take several hours to complete, especially during peak times. Do not submit duplicate requests until the job is complete. To check the job status, call the **GetIndexJobStatus** API. The `Documents` file list returned by the GetIndexJobStatus API contains all files for the job, which is uniquely identified by the `job_id` you provided. You can check this list to verify whether each file was imported (parsed) successfully. Note that frequent calls to the GetIndexJobStatus API are subject to rate limiting. Do not exceed 20 calls per minute.
+     * - A successful API call indicates the job has been submitted for processing, which takes time. This API is not idempotent, so do not send duplicate requests; doing so will create multiple jobs.
+     * **Rate limiting:** This API is limited to 10 calls per second. If you exceed this limit, wait before retrying.
      *
      * @param request - SubmitIndexAddDocumentsJobRequest
      * @returns SubmitIndexAddDocumentsJobResponse
@@ -2819,13 +3203,16 @@ class Client extends openapi_core_1.default {
         return await this.submitIndexAddDocumentsJobWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * Submits a specified CreateIndex job to complete knowledge base creation.
+     * Submits a specified CreateIndex task to complete knowledge base creation.
      *
      * @remarks
-     * 1.  Before you call this operation, you must call the [CreateIndex](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-createindex) operation and obtain the `IndexId`.
-     * 2.  Execution takes a period of time after this operation is called. Do not make new request before the request is returned.
-     * 3.  If you want to query the execution status of the job after you call this operation, call the [GetIndexJobStatus](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-getindexjobstatus) operation.
-     * 4.  This interface is not idempotent.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (requires `AliyunBailianDataFullAccess`, which includes the sfm:SubmitIndexJob permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Use the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this operation.
+     * - Before invoking this operation, you must invoke the **CreateIndex** operation and obtain the corresponding `IndexId`.
+     * - After invoking this operation, the node requires time to execute and may take several hours during peak periods. Do not submit duplicate requests before the node completes. To query the node execution status, invoke the **GetIndexJobStatus** operation.
+     * - After the knowledge base is created, you can associate it with an agent application<props="china"> or workflow application in the same workspace through <props="china">[Application Management](https://bailian.console.aliyun.com/?tab=app#/app-center)<props="intl">[Application Management](https://modelstudio.console.alibabacloud.com/?tab=app#/app-center) (or pass the `IndexID` through `rag_options` in [Application Calls](https://help.aliyun.com/document_detail/2846132.html)) to supplement your Model Studio application with private knowledge and up-to-date information. You can also choose not to use a Model Studio application and directly query the knowledge base by invoking the **Retrieve** operation.
+     * - This operation does not support idempotence.
+     * **Rate limit:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If throttled, retry later.
      *
      * @param request - SubmitIndexJobRequest
      * @param headers - map
@@ -2856,13 +3243,16 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.SubmitIndexJobResponse({}));
     }
     /**
-     * Submits a specified CreateIndex job to complete knowledge base creation.
+     * Submits a specified CreateIndex task to complete knowledge base creation.
      *
      * @remarks
-     * 1.  Before you call this operation, you must call the [CreateIndex](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-createindex) operation and obtain the `IndexId`.
-     * 2.  Execution takes a period of time after this operation is called. Do not make new request before the request is returned.
-     * 3.  If you want to query the execution status of the job after you call this operation, call the [GetIndexJobStatus](https://www.alibabacloud.com/help/en/model-studio/developer-reference/api-bailian-2023-12-29-getindexjobstatus) operation.
-     * 4.  This interface is not idempotent.
+     * - Resource Access Management (RAM) users must first obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (requires `AliyunBailianDataFullAccess`, which includes the sfm:SubmitIndexJob permission), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before invoking this operation. Alibaba Cloud accounts can invoke this operation directly without authorization. Use the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to invoke this operation.
+     * - Before invoking this operation, you must invoke the **CreateIndex** operation and obtain the corresponding `IndexId`.
+     * - After invoking this operation, the node requires time to execute and may take several hours during peak periods. Do not submit duplicate requests before the node completes. To query the node execution status, invoke the **GetIndexJobStatus** operation.
+     * - After the knowledge base is created, you can associate it with an agent application<props="china"> or workflow application in the same workspace through <props="china">[Application Management](https://bailian.console.aliyun.com/?tab=app#/app-center)<props="intl">[Application Management](https://modelstudio.console.alibabacloud.com/?tab=app#/app-center) (or pass the `IndexID` through `rag_options` in [Application Calls](https://help.aliyun.com/document_detail/2846132.html)) to supplement your Model Studio application with private knowledge and up-to-date information. You can also choose not to use a Model Studio application and directly query the knowledge base by invoking the **Retrieve** operation.
+     * - This operation does not support idempotence.
+     * **Rate limit:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If throttled, retry later.
      *
      * @param request - SubmitIndexJobRequest
      * @returns SubmitIndexJobResponse
@@ -2997,17 +3387,18 @@ 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.
+     * Modifies the content and title of a specified text chunk in a knowledge base, and specifies 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.
+     * - **Key limits**: This operation supports only document search knowledge bases. Data query and image Q&A knowledge bases are not supported.
+     * - **Permission requirements**:
+     *   - **Resource Access Management (RAM) user**: Before invoking this operation, obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (you can use the `AliyunBailianDataFullAccess` policy, which includes the sfm:UpdateChunk permission required by this operation), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html).
+     *   - **Alibaba Cloud account**: Has permissions by default and can invoke this operation directly.
+     * - **Calling method**: Use the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29). The SDK provides encapsulation of complex signature calculation logic and simplifies the invocation procedure.
+     * - **Effective latency**: Updates typically take effect immediately. During peak hours, a slight delay (seconds) may occur.
+     * - **Idempotence**: This operation is idempotent. If you repeat the operation on a text chunk that has already been updated, the operation returns a success response.
+     * **Rate limit:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If you are throttled, retry later.
      *
      * @param request - UpdateChunkRequest
      * @param headers - map
@@ -3053,17 +3444,18 @@ 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.
+     * Modifies the content and title of a specified text chunk in a knowledge base, and specifies 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.
+     * - **Key limits**: This operation supports only document search knowledge bases. Data query and image Q&A knowledge bases are not supported.
+     * - **Permission requirements**:
+     *   - **Resource Access Management (RAM) user**: Before invoking this operation, obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Model Studio (you can use the `AliyunBailianDataFullAccess` policy, which includes the sfm:UpdateChunk permission required by this operation), and [join a workspace](https://help.aliyun.com/document_detail/2851098.html).
+     *   - **Alibaba Cloud account**: Has permissions by default and can invoke this operation directly.
+     * - **Calling method**: Use the latest <props="china">[Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29). The SDK provides encapsulation of complex signature calculation logic and simplifies the invocation procedure.
+     * - **Effective latency**: Updates typically take effect immediately. During peak hours, a slight delay (seconds) may occur.
+     * - **Idempotence**: This operation is idempotent. If you repeat the operation on a text chunk that has already been updated, the operation returns a success response.
+     * **Rate limit:**
+     * This operation is throttled if called too frequently. Do not exceed 10 calls per second. If you are throttled, retry later.
      *
      * @param request - UpdateChunkRequest
      * @returns UpdateChunkResponse
@@ -3074,7 +3466,12 @@ class Client extends openapi_core_1.default {
         return await this.updateChunkWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * 编辑连接器
+     * Updates a connector.
+     *
+     * @remarks
+     * - A RAM user can call this operation only after they join a workspace and are granted the required [API permission](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (Bailian). The `AliyunBailianDataFullAccess` policy, which includes the `sfm:UpdateConnector` permission, is required. An Alibaba Cloud account can call this operation directly. Use the latest version of the <props="china">[Alibaba Cloud Model Studio (Bailian) SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio (Bailian) SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * - This operation is not idempotent.
+     * **Throttling:** If you call this operation too frequently, the system may throttle your requests. Do not exceed a frequency of 5 calls per second. If a request is throttled, try again later.
      *
      * @param request - UpdateConnectorRequest
      * @param headers - map
@@ -3108,7 +3505,12 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateConnectorResponse({}));
     }
     /**
-     * 编辑连接器
+     * Updates a connector.
+     *
+     * @remarks
+     * - A RAM user can call this operation only after they join a workspace and are granted the required [API permission](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (Bailian). The `AliyunBailianDataFullAccess` policy, which includes the `sfm:UpdateConnector` permission, is required. An Alibaba Cloud account can call this operation directly. Use the latest version of the <props="china">[Alibaba Cloud Model Studio (Bailian) SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio (Bailian) SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * - This operation is not idempotent.
+     * **Throttling:** If you call this operation too frequently, the system may throttle your requests. Do not exceed a frequency of 5 calls per second. If a request is throttled, try again later.
      *
      * @param request - UpdateConnectorRequest
      * @returns UpdateConnectorResponse
@@ -3119,7 +3521,11 @@ class Client extends openapi_core_1.default {
         return await this.updateConnectorWithOptions(WorkspaceId, ConnectorId, request, headers, runtime);
     }
     /**
-     * Updates the tags of a specified document.
+     * Updates the tags for a specified file.
+     *
+     * @remarks
+     * - A RAM User (sub-account) must be granted the required [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (the `AliyunBailianDataFullAccess` policy, which includes the `sfm:UpdateFileTag` permission) and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before calling this operation. An Alibaba Cloud account (main account) can call this operation directly without authorization. We recommend using the latest version of the <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * **Throttling:** Do not call this operation more than 5 times per second. If a request is throttled, try again later.
      *
      * @param tmpReq - UpdateFileTagRequest
      * @param headers - map
@@ -3155,7 +3561,11 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateFileTagResponse({}));
     }
     /**
-     * Updates the tags of a specified document.
+     * Updates the tags for a specified file.
+     *
+     * @remarks
+     * - A RAM User (sub-account) must be granted the required [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio (the `AliyunBailianDataFullAccess` policy, which includes the `sfm:UpdateFileTag` permission) and [join a workspace](https://help.aliyun.com/document_detail/2851098.html) before calling this operation. An Alibaba Cloud account (main account) can call this operation directly without authorization. We recommend using the latest version of the <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29)<props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29) to call this operation.
+     * **Throttling:** Do not call this operation more than 5 times per second. If a request is throttled, try again later.
      *
      * @param request - UpdateFileTagRequest
      * @returns UpdateFileTagResponse
@@ -3166,7 +3576,13 @@ class Client extends openapi_core_1.default {
         return await this.updateFileTagWithOptions(WorkspaceId, FileId, request, headers, runtime);
     }
     /**
-     * \\<props="intl">Currently, this API is not supported.\\
+     * Updates the configuration of a specified knowledge base.
+     *
+     * @remarks
+     * <props="intl">This operation is not available on the Alibaba Cloud International Website (www\\.alibabacloud.com).<props="china">
+     * Before a RAM user can call this operation, the RAM user must have the `AliyunBailianDataFullAccess` permission for Alibaba Cloud Model Studio. For more information, see [Grant permissions](https://help.aliyun.com/document_detail/2848578.html). The RAM user must also be added to a workspace. For more information, see [Add a member to a workspace](https://help.aliyun.com/document_detail/2851098.html). An Alibaba Cloud account can call this operation without authorization. Use the latest version of the Alibaba Cloud Model Studio SDK to call this operation. For more information, see [Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29).
+     * Before you call this operation, ensure that the knowledge base is created and has not been deleted. The knowledge base ID (`Id`) must be valid.
+     * This operation is idempotent.
      *
      * @param request - UpdateIndexRequest
      * @param headers - map
@@ -3218,7 +3634,13 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateIndexResponse({}));
     }
     /**
-     * \\<props="intl">Currently, this API is not supported.\\
+     * Updates the configuration of a specified knowledge base.
+     *
+     * @remarks
+     * <props="intl">This operation is not available on the Alibaba Cloud International Website (www\\.alibabacloud.com).<props="china">
+     * Before a RAM user can call this operation, the RAM user must have the `AliyunBailianDataFullAccess` permission for Alibaba Cloud Model Studio. For more information, see [Grant permissions](https://help.aliyun.com/document_detail/2848578.html). The RAM user must also be added to a workspace. For more information, see [Add a member to a workspace](https://help.aliyun.com/document_detail/2851098.html). An Alibaba Cloud account can call this operation without authorization. Use the latest version of the Alibaba Cloud Model Studio SDK to call this operation. For more information, see [Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29).
+     * Before you call this operation, ensure that the knowledge base is created and has not been deleted. The knowledge base ID (`Id`) must be valid.
+     * This operation is idempotent.
      *
      * @param request - UpdateIndexRequest
      * @returns UpdateIndexResponse
@@ -3229,7 +3651,11 @@ class Client extends openapi_core_1.default {
         return await this.updateIndexWithOptions(WorkspaceId, request, headers, runtime);
     }
     /**
-     * 更新memory
+     * Updates the description of a specified long-term memory.
+     *
+     * @remarks
+     * - This operation is idempotent.
+     * **Rate limit:** Ensure that the interval between two requests is at least 1 second. Otherwise, throttling may be triggered. If throttling occurs, retry later.
      *
      * @param request - UpdateMemoryRequest
      * @param headers - map
@@ -3260,7 +3686,11 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateMemoryResponse({}));
     }
     /**
-     * 更新memory
+     * Updates the description of a specified long-term memory.
+     *
+     * @remarks
+     * - This operation is idempotent.
+     * **Rate limit:** Ensure that the interval between two requests is at least 1 second. Otherwise, throttling may be triggered. If throttling occurs, retry later.
      *
      * @param request - UpdateMemoryRequest
      * @returns UpdateMemoryResponse
@@ -3271,7 +3701,7 @@ class Client extends openapi_core_1.default {
         return await this.updateMemoryWithOptions(workspaceId, memoryId, request, headers, runtime);
     }
     /**
-     * 更新记忆Node
+     * Updates a memory fragment.
      *
      * @param request - UpdateMemoryNodeRequest
      * @param headers - map
@@ -3302,7 +3732,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateMemoryNodeResponse({}));
     }
     /**
-     * 更新记忆Node
+     * Updates a memory fragment.
      *
      * @param request - UpdateMemoryNodeRequest
      * @returns UpdateMemoryNodeResponse
@@ -3358,7 +3788,15 @@ class Client extends openapi_core_1.default {
         return await this.updatePromptTemplateWithOptions(workspaceId, promptTemplateId, request, headers, runtime);
     }
     /**
-     * 从oss上传table
+     * Update a table in an Alibaba Cloud Model Studio data connector using a file from an authorized OSS bucket.
+     *
+     * @remarks
+     * - Ensure that the OSS bucket belongs to the same Alibaba Cloud account as your Alibaba Cloud Model Studio instance. You must also complete the authorization steps described in [Configure data import from OSS](https://help.aliyun.com/document_detail/2782155.html).
+     *   - The bucket storage class must not be Archive, Cold Archive, or Deep Cold Archive. Buckets with server-side encryption are supported. public-read-write, public-read, and private buckets are also supported.
+     *   - If you use a bucket with [Referer-based hotlink protection](https://help.aliyun.com/document_detail/2636937.html), you must add `*.console.aliyun.com` to the Referer whitelist. For more information, see [Allow access only from trusted websites](https://help.aliyun.com/document_detail/2636937.html).
+     * - Before a RAM user (sub-account) can call this operation, they must obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio and [join a workspace](https://help.aliyun.com/document_detail/2851098.html). The AliyunBailianDataFullAccess policy includes the required `sfm:UpdateTableFromAuthorizedOss` permission. An Alibaba Cloud account (root account) can call this operation directly without additional permissions. We recommend that you use the latest version of the <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29) or <props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - This operation is not idempotent.
+     * **Rate limiting:** This operation is subject to rate limiting. Do not call it more than five times per second. If you reach the limit, wait before you try again.
      *
      * @param request - UpdateTableFromAuthorizedOssRequest
      * @param headers - map
@@ -3398,7 +3836,15 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateTableFromAuthorizedOssResponse({}));
     }
     /**
-     * 从oss上传table
+     * Update a table in an Alibaba Cloud Model Studio data connector using a file from an authorized OSS bucket.
+     *
+     * @remarks
+     * - Ensure that the OSS bucket belongs to the same Alibaba Cloud account as your Alibaba Cloud Model Studio instance. You must also complete the authorization steps described in [Configure data import from OSS](https://help.aliyun.com/document_detail/2782155.html).
+     *   - The bucket storage class must not be Archive, Cold Archive, or Deep Cold Archive. Buckets with server-side encryption are supported. public-read-write, public-read, and private buckets are also supported.
+     *   - If you use a bucket with [Referer-based hotlink protection](https://help.aliyun.com/document_detail/2636937.html), you must add `*.console.aliyun.com` to the Referer whitelist. For more information, see [Allow access only from trusted websites](https://help.aliyun.com/document_detail/2636937.html).
+     * - Before a RAM user (sub-account) can call this operation, they must obtain [API permissions](https://help.aliyun.com/document_detail/2848578.html) for Alibaba Cloud Model Studio and [join a workspace](https://help.aliyun.com/document_detail/2851098.html). The AliyunBailianDataFullAccess policy includes the required `sfm:UpdateTableFromAuthorizedOss` permission. An Alibaba Cloud account (root account) can call this operation directly without additional permissions. We recommend that you use the latest version of the <props="china">[Alibaba Cloud Model Studio SDK](https://api.aliyun.com/api-tools/sdk/bailian?version=2023-12-29) or <props="intl">[Alibaba Cloud Model Studio SDK](https://api.alibabacloud.com/api-tools/sdk/bailian?version=2023-12-29).
+     * - This operation is not idempotent.
+     * **Rate limiting:** This operation is subject to rate limiting. Do not call it more than five times per second. If you reach the limit, wait before you try again.
      *
      * @param request - UpdateTableFromAuthorizedOssRequest
      * @returns UpdateTableFromAuthorizedOssResponse