@alicloud/polardb20170801 8.2.0 → 8.2.2

package/src/client.ts

@@ -52,28 +52,6 @@ export default class Client extends OpenApi {
       'cn-zhengzhou-nebula-1': "polardb.aliyuncs.com",
       'eu-west-1-oxs': "polardb.aliyuncs.com",
       'rus-west-1-pop': "polardb.aliyuncs.com",
-      'cn-hongkong': "polardb.cn-hongkong.aliyuncs.com",
-      'cn-zhangjiakou': "polardb.cn-zhangjiakou.aliyuncs.com",
-      'cn-shenzhen': "polardb.cn-shenzhen.aliyuncs.com",
-      'ap-northeast-2': "polardb.ap-northeast-2.aliyuncs.com",
-      'ap-northeast-1': "polardb.ap-northeast-1.aliyuncs.com",
-      'cn-chengdu': "polardb.cn-chengdu.aliyuncs.com",
-      'cn-guangzhou': "polardb.cn-guangzhou.aliyuncs.com",
-      'ap-southeast-1': "polardb.ap-southeast-1.aliyuncs.com",
-      'ap-southeast-3': "polardb.ap-southeast-3.aliyuncs.com",
-      'cn-huhehaote': "polardb.cn-huhehaote.aliyuncs.com",
-      'ap-southeast-5': "polardb.ap-southeast-5.aliyuncs.com",
-      'ap-southeast-6': "polardb.ap-southeast-6.aliyuncs.com",
-      'ap-southeast-7': "polardb.ap-southeast-7.aliyuncs.com",
-      'ap-southeast-8': "polardb.ap-southeast-8.aliyuncs.com",
-      'na-south-1': "polardb.na-south-1.aliyuncs.com",
-      'eu-central-1': "polardb.eu-central-1.aliyuncs.com",
-      'us-west-1': "polardb.us-west-1.aliyuncs.com",
-      'eu-west-1': "polardb.eu-west-1.aliyuncs.com",
-      'us-east-1': "polardb.us-east-1.aliyuncs.com",
-      'me-east-1': "polardb.me-east-1.aliyuncs.com",
-      'cn-shanghai-finance-1': "polardb.cn-shanghai-finance-1.aliyuncs.com",
-      'cn-shenzhen-finance-1': "polardb.cn-shenzhen-finance-1.aliyuncs.com",
     };
     this.checkConfig(config);
     this._endpoint = this.getEndpoint("polardb", this._regionId, this._endpointRule, this._network, this._suffix, this._endpointMap, this._endpoint);
@@ -613,7 +591,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 知识库单轮问答
+   * Performs a single-round knowledge base question answering.
    * 
    * @param request - AnswerKnowledgeBaseRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -684,7 +662,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 知识库单轮问答
+   * Performs a single-round knowledge base question answering.
    * 
    * @param request - AnswerKnowledgeBaseRequest
    * @returns AnswerKnowledgeBaseResponse
@@ -5487,7 +5465,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 创建知识库同步链路
+   * Creates a knowledge base synchronization link.
    * 
    * @param request - CreateKBSyncLinkRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -5516,10 +5494,18 @@ export default class Client extends OpenApi {
       query["LinkName"] = request.linkName;
     }
 
+    if (!$dara.isNull(request.mcpEndpoint)) {
+      query["McpEndpoint"] = request.mcpEndpoint;
+    }
+
     if (!$dara.isNull(request.regionId)) {
       query["RegionId"] = request.regionId;
     }
 
+    if (!$dara.isNull(request.sheetMcpEndpoint)) {
+      query["SheetMcpEndpoint"] = request.sheetMcpEndpoint;
+    }
+
     if (!$dara.isNull(request.sourceDir)) {
       query["SourceDir"] = request.sourceDir;
     }
@@ -5536,6 +5522,10 @@ export default class Client extends OpenApi {
       query["TenantId"] = request.tenantId;
     }
 
+    if (!$dara.isNull(request.userId)) {
+      query["UserId"] = request.userId;
+    }
+
     let req = new $OpenApiUtil.OpenApiRequest({
       query: OpenApiUtil.query(query),
     });
@@ -5554,7 +5544,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 创建知识库同步链路
+   * Creates a knowledge base synchronization link.
    * 
    * @param request - CreateKBSyncLinkRequest
    * @returns CreateKBSyncLinkResponse
@@ -8063,7 +8053,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Deletes a custom cluster endpoint for a PolarDB cluster.
+   * Releases a custom cluster endpoint of a PolarDB cluster.
    * 
    * @param request - DeleteDBClusterEndpointRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -8118,7 +8108,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Deletes a custom cluster endpoint for a PolarDB cluster.
+   * Releases a custom cluster endpoint of a PolarDB cluster.
    * 
    * @param request - DeleteDBClusterEndpointRequest
    * @returns DeleteDBClusterEndpointResponse
@@ -8981,7 +8971,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 删除知识库同步链路
+   * Deletes a knowledge base synchronization link.
    * 
    * @param request - DeleteKBSyncLinkRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -9020,7 +9010,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 删除知识库同步链路
+   * Deletes a knowledge base synchronization link.
    * 
    * @param request - DeleteKBSyncLinkRequest
    * @returns DeleteKBSyncLinkResponse
@@ -9077,7 +9067,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 删除知识库文件
+   * Deletes a knowledge base file.
    * 
    * @param request - DeleteKnowledgeBaseFileRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -9116,7 +9106,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 删除知识库文件
+   * Deletes a knowledge base file.
    * 
    * @param request - DeleteKnowledgeBaseFileRequest
    * @returns DeleteKnowledgeBaseFileResponse
@@ -15111,10 +15101,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Retrieves the details of the current kernel version for a PolarDB for MySQL cluster.
+   * Queries the details of the current Milvus version of a PolarDB for MySQL cluster.
    * 
    * @remarks
-   * > For more information about the kernel versions of PolarDB for MySQL clusters, see [Kernel version guide](https://help.aliyun.com/document_detail/471239.html) and [Kernel release notes](https://help.aliyun.com/document_detail/423884.html).
+   * >For more information about the minor Milvus versions and details of PolarDB for MySQL Cluster Edition, see [Minor Milvus version description](https://help.aliyun.com/document_detail/471239.html) and [Release notes](https://help.aliyun.com/document_detail/423884.html).
    * 
    * @param request - DescribeDBClusterVersionRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -15165,10 +15155,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Retrieves the details of the current kernel version for a PolarDB for MySQL cluster.
+   * Queries the details of the current Milvus version of a PolarDB for MySQL cluster.
    * 
    * @remarks
-   * > For more information about the kernel versions of PolarDB for MySQL clusters, see [Kernel version guide](https://help.aliyun.com/document_detail/471239.html) and [Kernel release notes](https://help.aliyun.com/document_detail/423884.html).
+   * >For more information about the minor Milvus versions and details of PolarDB for MySQL Cluster Edition, see [Minor Milvus version description](https://help.aliyun.com/document_detail/471239.html) and [Release notes](https://help.aliyun.com/document_detail/423884.html).
    * 
    * @param request - DescribeDBClusterVersionRequest
    * @returns DescribeDBClusterVersionResponse
@@ -17639,7 +17629,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询知识库同步列表
+   * Queries the synchronization list of a knowledge base.
    * 
    * @param request - DescribeKBSyncLinksRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -17678,7 +17668,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询知识库同步列表
+   * Queries the synchronization list of a knowledge base.
    * 
    * @param request - DescribeKBSyncLinksRequest
    * @returns DescribeKBSyncLinksResponse
@@ -17689,7 +17679,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询知识库单轮问答结果
+   * Queries the result of a single-turn Q&A task in a knowledge base.
    * 
    * @param request - DescribeKnowledgeBaseAnswerRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -17728,7 +17718,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询知识库单轮问答结果
+   * Queries the result of a single-turn Q&A task in a knowledge base.
    * 
    * @param request - DescribeKnowledgeBaseAnswerRequest
    * @returns DescribeKnowledgeBaseAnswerResponse
@@ -17785,7 +17775,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询知识库文件分片列表
+   * Queries the list of file shards in a knowledge base.
    * 
    * @param request - DescribeKnowledgeBaseFileShardsRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -17832,7 +17822,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询知识库文件分片列表
+   * Queries the list of file shards in a knowledge base.
    * 
    * @param request - DescribeKnowledgeBaseFileShardsRequest
    * @returns DescribeKnowledgeBaseFileShardsResponse
@@ -17843,7 +17833,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询知识库文件列表
+   * Queries the list of files in a knowledge base.
    * 
    * @param request - DescribeKnowledgeBaseFilesRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -17902,7 +17892,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询知识库文件列表
+   * Queries the list of files in a knowledge base.
    * 
    * @param request - DescribeKnowledgeBaseFilesRequest
    * @returns DescribeKnowledgeBaseFilesResponse
@@ -17975,7 +17965,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询知识空间详情
+   * Queries the details of a knowledge space.
    * 
    * @param request - DescribeKnowledgeSpaceAttributeRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -18010,7 +18000,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询知识空间详情
+   * Queries the details of a knowledge space.
    * 
    * @param request - DescribeKnowledgeSpaceAttributeRequest
    * @returns DescribeKnowledgeSpaceAttributeResponse
@@ -21570,7 +21560,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Disables steady-state serverless.
+   * Disables steady-state Serverless.
    * 
    * @param request - DisableDBClusterServerlessRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -21629,7 +21619,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Disables steady-state serverless.
+   * Disables steady-state Serverless.
    * 
    * @param request - DisableDBClusterServerlessRequest
    * @returns DisableDBClusterServerlessResponse
@@ -26211,11 +26201,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Modifies the parameters of a PolarDB cluster or applies an existing parameter template to a destination cluster.
+   * Modifies the parameters of a PolarDB cluster or applies an existing parameter template to the specified cluster.
    * 
    * @remarks
-   * The parameter template feature in PolarDB lets you centrally manage parameters and apply them to your clusters. For more information, see [Use parameter templates](https://help.aliyun.com/document_detail/207009.html).
-   * > The parameter template feature is available only for PolarDB for MySQL.
+   * PolarDB provides the parameter template feature. You can use parameter templates to centrally manage parameters and quickly apply them to clusters. For more information, see [Use parameter templates](https://help.aliyun.com/document_detail/207009.html).
+   * > Currently, only PolarDB for MySQL supports the parameter template feature.
    * 
    * @param request - ModifyDBClusterParametersRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -26286,11 +26276,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Modifies the parameters of a PolarDB cluster or applies an existing parameter template to a destination cluster.
+   * Modifies the parameters of a PolarDB cluster or applies an existing parameter template to the specified cluster.
    * 
    * @remarks
-   * The parameter template feature in PolarDB lets you centrally manage parameters and apply them to your clusters. For more information, see [Use parameter templates](https://help.aliyun.com/document_detail/207009.html).
-   * > The parameter template feature is available only for PolarDB for MySQL.
+   * PolarDB provides the parameter template feature. You can use parameter templates to centrally manage parameters and quickly apply them to clusters. For more information, see [Use parameter templates](https://help.aliyun.com/document_detail/207009.html).
+   * > Currently, only PolarDB for MySQL supports the parameter template feature.
    * 
    * @param request - ModifyDBClusterParametersRequest
    * @returns ModifyDBClusterParametersResponse
@@ -26457,7 +26447,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Enables or performs shutdown of the Secure Sockets Layer (SSL) encryption feature for a PolarDB cluster, or updates the CA certificate of a PolarDB cluster.
+   * Enables or shuts down the Secure Sockets Layer (SSL) encryption feature for a PolarDB cluster, or updates the CA certificate of a PolarDB cluster.
    * 
    * @param request - ModifyDBClusterSSLRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -26532,7 +26522,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Enables or performs shutdown of the Secure Sockets Layer (SSL) encryption feature for a PolarDB cluster, or updates the CA certificate of a PolarDB cluster.
+   * Enables or shuts down the Secure Sockets Layer (SSL) encryption feature for a PolarDB cluster, or updates the CA certificate of a PolarDB cluster.
    * 
    * @param request - ModifyDBClusterSSLRequest
    * @returns ModifyDBClusterSSLResponse
@@ -30387,7 +30377,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 检索知识库
+   * Retrieves information from a knowledge base.
    * 
    * @param request - RetrievalKnowledgeBaseRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -30438,7 +30428,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 检索知识库
+   * Retrieves information from a knowledge base.
    * 
    * @param request - RetrievalKnowledgeBaseRequest
    * @returns RetrievalKnowledgeBaseResponse
@@ -30449,7 +30439,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 批量重试知识库失败文件
+   * Retries failed files in a knowledge base in batches.
    * 
    * @param request - RetryKnowledgeBaseFilesRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -30488,7 +30478,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 批量重试知识库失败文件
+   * Retries failed files in a knowledge base in batches.
    * 
    * @param request - RetryKnowledgeBaseFilesRequest
    * @returns RetryKnowledgeBaseFilesResponse
@@ -31025,7 +31015,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Temporarily Modifies the configuration of a node.
+   * Temporarily changes the specifications of a cluster.
    * 
    * @param request - TempModifyDBNodeRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -31100,7 +31090,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Temporarily Modifies the configuration of a node.
+   * Temporarily changes the specifications of a cluster.
    * 
    * @param request - TempModifyDBNodeRequest
    * @returns TempModifyDBNodeResponse
@@ -31114,11 +31104,9 @@ export default class Client extends OpenApi {
    * Changes the billing method of a PolarDB cluster.
    * 
    * @remarks
-   * > - PolarDB clusters support two billing methods: subscription and pay-as-you-go. You can change the billing method of a cluster from subscription to pay-as-you-go, or from pay-as-you-go to subscription. For more information, see [Change the billing method from subscription to pay-as-you-go](https://help.aliyun.com/document_detail/172886.html) and [Change the billing method from pay-as-you-go to subscription](https://help.aliyun.com/document_detail/84076.html).
-   * >
-   * > - You cannot change the billing method from pay-as-you-go to subscription if your Alibaba Cloud account has an insufficient balance.
-   * >
-   * > - When you change the billing method from subscription to pay-as-you-go, the system automatically refunds your remaining prepaid fees.
+   * > - PolarDB clusters support subscription and pay-as-you-go billing methods. You can change the billing method from subscription to pay-as-you-go or from pay-as-you-go to subscription based on your business requirements. For more information, see [Change from subscription to pay-as-you-go](https://help.aliyun.com/document_detail/172886.html) and [Change from pay-as-you-go to subscription](https://help.aliyun.com/document_detail/84076.html).
+   * >- If your Alibaba Cloud account balance is insufficient, you cannot change the pay-as-you-go billing method to subscription.
+   * >- When you change the billing method from subscription to pay-as-you-go, the system automatically refunds the remaining balance of the fees that you have paid.
    * 
    * @param request - TransformDBClusterPayTypeRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -31200,11 +31188,9 @@ export default class Client extends OpenApi {
    * Changes the billing method of a PolarDB cluster.
    * 
    * @remarks
-   * > - PolarDB clusters support two billing methods: subscription and pay-as-you-go. You can change the billing method of a cluster from subscription to pay-as-you-go, or from pay-as-you-go to subscription. For more information, see [Change the billing method from subscription to pay-as-you-go](https://help.aliyun.com/document_detail/172886.html) and [Change the billing method from pay-as-you-go to subscription](https://help.aliyun.com/document_detail/84076.html).
-   * >
-   * > - You cannot change the billing method from pay-as-you-go to subscription if your Alibaba Cloud account has an insufficient balance.
-   * >
-   * > - When you change the billing method from subscription to pay-as-you-go, the system automatically refunds your remaining prepaid fees.
+   * > - PolarDB clusters support subscription and pay-as-you-go billing methods. You can change the billing method from subscription to pay-as-you-go or from pay-as-you-go to subscription based on your business requirements. For more information, see [Change from subscription to pay-as-you-go](https://help.aliyun.com/document_detail/172886.html) and [Change from pay-as-you-go to subscription](https://help.aliyun.com/document_detail/84076.html).
+   * >- If your Alibaba Cloud account balance is insufficient, you cannot change the pay-as-you-go billing method to subscription.
+   * >- When you change the billing method from subscription to pay-as-you-go, the system automatically refunds the remaining balance of the fees that you have paid.
    * 
    * @param request - TransformDBClusterPayTypeRequest
    * @returns TransformDBClusterPayTypeResponse
@@ -31215,7 +31201,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 触发知识库同步
+   * Triggers knowledge base synchronization.
    * 
    * @param request - TriggerKnowledgeBaseSyncRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -31254,7 +31240,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 触发知识库同步
+   * Triggers knowledge base synchronization.
    * 
    * @param request - TriggerKnowledgeBaseSyncRequest
    * @returns TriggerKnowledgeBaseSyncResponse
@@ -31657,7 +31643,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 更新知识库同步链路
+   * Updates a knowledge base synchronization link.
    * 
    * @param request - UpdateKBSyncLinkRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -31666,6 +31652,14 @@ export default class Client extends OpenApi {
   async updateKBSyncLinkWithOptions(request: $_model.UpdateKBSyncLinkRequest, runtime: $dara.RuntimeOptions): Promise<$_model.UpdateKBSyncLinkResponse> {
     request.validate();
     let query = { };
+    if (!$dara.isNull(request.clientId)) {
+      query["ClientId"] = request.clientId;
+    }
+
+    if (!$dara.isNull(request.clientSecret)) {
+      query["ClientSecret"] = request.clientSecret;
+    }
+
     if (!$dara.isNull(request.knowledgeBaseId)) {
       query["KnowledgeBaseId"] = request.knowledgeBaseId;
     }
@@ -31674,14 +31668,30 @@ export default class Client extends OpenApi {
       query["LinkId"] = request.linkId;
     }
 
+    if (!$dara.isNull(request.mcpEndpoint)) {
+      query["McpEndpoint"] = request.mcpEndpoint;
+    }
+
     if (!$dara.isNull(request.regionId)) {
       query["RegionId"] = request.regionId;
     }
 
+    if (!$dara.isNull(request.sheetMcpEndpoint)) {
+      query["SheetMcpEndpoint"] = request.sheetMcpEndpoint;
+    }
+
+    if (!$dara.isNull(request.syncEnabled)) {
+      query["SyncEnabled"] = request.syncEnabled;
+    }
+
     if (!$dara.isNull(request.syncIntervalMinutes)) {
       query["SyncIntervalMinutes"] = request.syncIntervalMinutes;
     }
 
+    if (!$dara.isNull(request.userId)) {
+      query["UserId"] = request.userId;
+    }
+
     let req = new $OpenApiUtil.OpenApiRequest({
       query: OpenApiUtil.query(query),
     });
@@ -31700,7 +31710,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 更新知识库同步链路
+   * Updates a knowledge base synchronization link.
    * 
    * @param request - UpdateKBSyncLinkRequest
    * @returns UpdateKBSyncLinkResponse
@@ -31711,7 +31721,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 更新知识库
+   * Updates a knowledge base.
    * 
    * @param request - UpdateKnowledgeBaseRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -31758,7 +31768,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 更新知识库
+   * Updates a knowledge base.
    * 
    * @param request - UpdateKnowledgeBaseRequest
    * @returns UpdateKnowledgeBaseResponse
@@ -31769,7 +31779,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 更新知识库文件分块策略
+   * Updates the chunking strategy for a file in a knowledge base.
    * 
    * @param tmpReq - UpdateKnowledgeBaseFileShardingStrategyRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -31822,7 +31832,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 更新知识库文件分块策略
+   * Updates the chunking strategy for a file in a knowledge base.
    * 
    * @param request - UpdateKnowledgeBaseFileShardingStrategyRequest
    * @returns UpdateKnowledgeBaseFileShardingStrategyResponse
@@ -31833,7 +31843,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 更新知识空间
+   * Updates a knowledge space.
    * 
    * @param tmpReq - UpdateKnowledgeSpaceRequest
    * @param runtime - runtime options for this request RuntimeOptions
@@ -31894,7 +31904,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 更新知识空间
+   * Updates a knowledge space.
    * 
    * @param request - UpdateKnowledgeSpaceRequest
    * @returns UpdateKnowledgeSpaceResponse

package/src/models/AnswerKnowledgeBaseRequest.ts

@@ -5,6 +5,8 @@ import * as $dara from '@darabonba/typescript';
 export class AnswerKnowledgeBaseRequest extends $dara.Model {
   /**
    * @remarks
+   * The unique ID of the knowledge base.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -12,20 +14,27 @@ export class AnswerKnowledgeBaseRequest extends $dara.Model {
    */
   knowledgeBaseId?: string;
   /**
+   * @remarks
+   * The maximum number of context characters. Valid values: 1000 to 32000.
+   * 
    * @example
    * 16000
    */
   maxContextChars?: number;
   /**
    * @remarks
+   * The user query text.
+   * 
    * This parameter is required.
    * 
    * @example
-   * 总结下今年财报
+   * Summarize this year\\"s financial report
    */
   queryText?: string;
   /**
    * @remarks
+   * The region ID.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -33,36 +42,57 @@ export class AnswerKnowledgeBaseRequest extends $dara.Model {
    */
   regionId?: string;
   /**
+   * @remarks
+   * Specifies whether to enable reranking. Default value: false.
+   * 
    * @example
    * false
    */
   rerankEnabled?: boolean;
   /**
+   * @remarks
+   * Specifies whether to return citation sources. Default value: true.
+   * 
    * @example
    * true
    */
   returnSources?: boolean;
   /**
+   * @remarks
+   * The similarity score threshold.
+   * 
    * @example
    * 0.7
    */
   scoreThreshold?: number;
   /**
+   * @remarks
+   * The search mode. Valid values: knn, rrf, precise, semantic, and balanced.
+   * 
    * @example
    * semantic
    */
   searchMode?: string;
   /**
+   * @remarks
+   * The system prompt.
+   * 
    * @example
    * This is a minimal test prompt for security verification.
    */
   systemPrompt?: string;
   /**
+   * @remarks
+   * The number of results to recall during retrieval.
+   * 
    * @example
    * 10
    */
   topK?: number;
   /**
+   * @remarks
+   * The supplementary user instructions.
+   * 
    * @example
    * Return a short summary and test result.
    */

package/src/models/AnswerKnowledgeBaseResponseBody.ts

@@ -4,16 +4,25 @@ import * as $dara from '@darabonba/typescript';
 
 export class AnswerKnowledgeBaseResponseBody extends $dara.Model {
   /**
+   * @remarks
+   * The unique ID of the Q&A task.
+   * 
    * @example
    * R3BGbnBqcXN******.2a5a23c9-******-179970533d30
    */
   queryId?: string;
   /**
+   * @remarks
+   * Id of the request
+   * 
    * @example
    * A7E6A8FD-C50B-46B2-BA85-D8B8D3******
    */
   requestId?: string;
   /**
+   * @remarks
+   * The status of the Q&A task.
+   * 
    * @example
    * Running
    */