@alicloud/gpdb20160503 3.4.1 → 3.6.0

package/src/models/QueryKnowledgeBasesContentRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class QueryKnowledgeBasesContentRequestMergeMethodArgsRrf extends $dara.Model {
   /**
    * @remarks
-   * The smoothing constant k in the formula to calculate the score: 1/(k + rank_i). The k constant must be a positive integer greater than 1.
+   * The constant `k` in the scoring formula `1/(k+rank_i)`. It must be a positive integer greater than 1.
    * 
    * @example
    * 60
@@ -35,7 +35,7 @@ export class QueryKnowledgeBasesContentRequestMergeMethodArgsRrf extends $dara.M
 export class QueryKnowledgeBasesContentRequestMergeMethodArgsWeight extends $dara.Model {
   /**
    * @remarks
-   * An array of weights for each SourceCollection.
+   * An array of weights for each source collection.
    */
   weights?: number[];
   static names(): { [key: string]: string } {
@@ -65,12 +65,12 @@ export class QueryKnowledgeBasesContentRequestMergeMethodArgsWeight extends $dar
 export class QueryKnowledgeBasesContentRequestMergeMethodArgs extends $dara.Model {
   /**
    * @remarks
-   * The parameter that can be configured when the MergeMethod parameter is set to RRF.
+   * The parameters that you can configure when `MergeMethod` is set to `RRF`.
    */
   rrf?: QueryKnowledgeBasesContentRequestMergeMethodArgsRrf;
   /**
    * @remarks
-   * The parameter that you can configure when you set the MergeMethod parameter to Weight.
+   * The parameters that you can configure when `MergeMethod` is set to `Weight`.
    */
   weight?: QueryKnowledgeBasesContentRequestMergeMethodArgsWeight;
   static names(): { [key: string]: string } {
@@ -103,7 +103,21 @@ export class QueryKnowledgeBasesContentRequestMergeMethodArgs extends $dara.Mode
 }
 
 export class QueryKnowledgeBasesContentRequestRerankModel extends $dara.Model {
+  /**
+   * @remarks
+   * This parameter can be set only when `RerankModel.Name` is `qwen3-rerank`. Use this parameter to provide a custom instruction that guides the model\\"s ranking strategy.
+   * 
+   * @example
+   * Given a web search query, retrieve relevant passages that answer the query
+   */
   instruct?: string;
+  /**
+   * @remarks
+   * The name of the rerank model. Valid values: `qwen3-rerank` and `gte-rerank-v2`.
+   * 
+   * @example
+   * qwen3-rerank
+   */
   name?: string;
   static names(): { [key: string]: string } {
     return {
@@ -131,7 +145,7 @@ export class QueryKnowledgeBasesContentRequestRerankModel extends $dara.Model {
 export class QueryKnowledgeBasesContentRequestSourceCollectionQueryParamsGraphSearchArgs extends $dara.Model {
   /**
    * @remarks
-   * Returns the top number of entities and relationship edges. Default value: 60.
+   * The number of top entities and relationship edges to return. The default value is 60.
    * 
    * @example
    * 60
@@ -159,7 +173,21 @@ export class QueryKnowledgeBasesContentRequestSourceCollectionQueryParamsGraphSe
 }
 
 export class QueryKnowledgeBasesContentRequestSourceCollectionQueryParamsRerankModel extends $dara.Model {
+  /**
+   * @remarks
+   * This parameter can be set only when `RerankModel.Name` is `qwen3-rerank`. Use this parameter to provide a custom instruction that guides the model\\"s ranking strategy.
+   * 
+   * @example
+   * Given a web search query, retrieve relevant passages that answer the query
+   */
   instruct?: string;
+  /**
+   * @remarks
+   * The name of the rerank model. Valid values: `qwen3-rerank` and `gte-rerank-v2`.
+   * 
+   * @example
+   * qwen3-rerank
+   */
   name?: string;
   static names(): { [key: string]: string } {
     return {
@@ -187,11 +215,9 @@ export class QueryKnowledgeBasesContentRequestSourceCollectionQueryParamsRerankM
 export class QueryKnowledgeBasesContentRequestSourceCollectionQueryParams extends $dara.Model {
   /**
    * @remarks
-   * The filter condition that is used to query data. Specify this parameter in a format that is the same as the WHERE clause. The parameter is an expression that returns a Boolean value of TRUE or FALSE. The condition can be a simple comparison using operators such as equal (=), not equal (<> or !=), greater than (>), less than (<), greater than or equal (>=), or less than or equal (<=). It can also be a more complex expression combining multiple conditions with logical operators (AND, OR, NOT), or use keywords such as IN, BETWEEN, and LIKE.
-   * 
-   * > 
+   * A filter expression for the data to retrieve, formatted as a SQL `WHERE` clause. This is a Boolean expression that evaluates to `true` or `false`. The expression can include simple comparison operators (such as `=`, `<>`, `!=`, `>`, `<`, `>=`, and `<=`), logical operators (`AND`, `OR`, `NOT`), and keywords such as `IN`, `BETWEEN`, and `LIKE`.
    * 
-   * *   For the syntax, see https://www.postgresqltutorial.com/postgresql-tutorial/postgresql-where/.
+   * > - For syntax details, see [PostgreSQL WHERE](https://www.postgresqltutorial.com/postgresql-tutorial/postgresql-where/).
    * 
    * @example
    * id = \\"llm-52tvykqt6u67iw73_j6ovptwjk7_file_6ce3da1f7e69495d9f491f2180c86973_11967297\\"
@@ -199,7 +225,7 @@ export class QueryKnowledgeBasesContentRequestSourceCollectionQueryParams extend
   filter?: string;
   /**
    * @remarks
-   * Whether to enable knowledge graph enhancement. Default value: false.
+   * Specifies whether to enable knowledge graph enhancement. The default value is `false`.
    * 
    * @example
    * true
@@ -207,18 +233,20 @@ export class QueryKnowledgeBasesContentRequestSourceCollectionQueryParams extend
   graphEnhance?: boolean;
   /**
    * @remarks
-   * Returns the top number of entities and relationship edges. Default value: 60.
+   * Parameters for the graph search.
    */
   graphSearchArgs?: QueryKnowledgeBasesContentRequestSourceCollectionQueryParamsGraphSearchArgs;
   /**
    * @remarks
-   * The dual-path retrieval algorithm. This parameter is empty by default, which specifies that scores of vector retrieval and full-text retrieval are directly compared and sorted together.
+   * The hybrid search algorithm. If this parameter is not specified, the system directly compares and sorts the scores from dense vector and full-text searches.
    * 
    * Valid values:
    * 
-   * *   RRF: The reciprocal rank fusion (RRF) algorithm uses a constant k to control the fusion effect. For more information, see the description of the HybridSearchArgs parameter.
-   * *   Weight: This algorithm uses the alpha parameter to specify the proportion of the vector search score and the full-text search score and then sorts by weight. For more information, see the description of the HybridSearchArgs parameter.
-   * *   Cascaded: This algorithm performs first full-text retrieval and then vector retrieval.
+   * - `RRF`: Reciprocal rank fusion. Uses a parameter `k` to control the fusion effect. For more information, see the `HybridSearchArgs` parameter.
+   * 
+   * - `Weight`: Weighted ranking. Uses parameters to control the score weights from different retrieval paths, such as dense vector and full-text searches, before sorting. For more information, see the `HybridSearchArgs` parameter.
+   * 
+   * - `Cascaded`: Performs a full-text search first, and then performs a vector search on the results.
    * 
    * @example
    * Cascaded
@@ -226,36 +254,62 @@ export class QueryKnowledgeBasesContentRequestSourceCollectionQueryParams extend
   hybridSearch?: string;
   /**
    * @remarks
-   * The parameters of the dual-path retrieval algorithm. RRF and Weight are supported at this time:
-   * 
-   * *   RRF: Specifies the smoothing constant k in the formula to calculate the score: `1/(k + rank_i)`. The k constant must be a positive integer greater than 1. The format:
-   * 
-   * <!---->
-   * 
-   *     { 
-   *        "RRF": {
-   *         "k": 60
-   *        }
-   *     }
-   * 
-   * *   Weight: The score is computed as `alpha * vector_score + (1 - alpha) * text_score`. The parameter alpha controls the weighting between vector search and full-text search scores, with a valid range of [0, 1]. 0 specifies only full-text search score. 1 specifies only vector search score.
-   * 
-   * <!---->
-   * 
-   *     { 
-   *        "Weight": {
-   *         "alpha": 0.5
-   *        }
-   *     }
+   * The parameters for the hybrid search algorithm. `RRF` and `Weight` are supported. `HybridPathsSetting` specifies the retrieval paths: dense vectors (`dense`), sparse vectors (`sparse`), and full-text search (`fulltext`). If this parameter is not specified, the default paths are `dense` and `fulltext`.
+   * 
+   * - `RRF`: Specifies the constant `k` in the scoring formula `1/(k+rank_i)`. `k` must be a positive integer greater than 1. Format:
+   * 
+   * ```
+   * {
+   *   "HybridPathsSetting": {
+   *     "paths": "dense,fulltext"
+   *   },
+   *   "RRF": {
+   *     "k": 60
+   *   }
+   * }
+   * ```
+   * 
+   * - `Weight`:
+   * 
+   *   - Two-path retrieval (the default if you do not specify `HybridPathsSetting`):
+   * 
+   *     - Scoring formula: `alpha * dense_score + (1-alpha) * fulltext_score`. The `alpha` parameter represents the score weight of dense vectors relative to full-text search. The value must be in the range of [0, 1]. A value of 0 indicates full-text search only, and a value of 1 indicates dense vector search only.
+   * 
+   * ```
+   * { 
+   *    "Weight": {
+   *     "alpha": 0.5
+   *    }
+   * }
+   * ```
+   * 
+   * - Three-path retrieval:
+   * 
+   *   - Scoring formula: `normalized_dense * dense_score + normalized_sparse * sparse_score + normalized_fulltext * fulltext_score`. The `dense`, `sparse`, and `fulltext` parameters represent the weights for dense vectors, sparse vectors, and full-text search, respectively. The value of each weight must be greater than or equal to 0. The system automatically normalizes the weights to a range of [0, 1] (for example, `normalized_x = x / (dense + sparse + fulltext)`).
+   * 
+   * ```
+   * {
+   *   "HybridPathsSetting": {
+   *      "paths": "dense,sparse,fulltext"
+   *    },
+   *   "Weight": {
+   *     "dense": 0.5,
+   *     "sparse": 0.3,
+   *     "fulltext": 0.2
+   *   }
+   * }
+   * ```
    */
   hybridSearchArgs?: { [key: string]: any };
   /**
    * @remarks
-   * The method that is used to create vector indexes. Valid values:
+   * The distance metric used for building the vector index. Valid values:
    * 
-   * *   l2: Euclidean distance.
-   * *   ip: Inner product distance.
-   * *   cosine: Cosine similarity.
+   * - `l2`: Euclidean distance.
+   * 
+   * - `ip`: Inner product distance.
+   * 
+   * - `cosine`: Cosine similarity.
    * 
    * @example
    * cosine
@@ -263,7 +317,7 @@ export class QueryKnowledgeBasesContentRequestSourceCollectionQueryParams extend
   metrics?: string;
   /**
    * @remarks
-   * Offset for pagination.
+   * The offset for paged queries.
    * 
    * @example
    * 20
@@ -271,11 +325,11 @@ export class QueryKnowledgeBasesContentRequestSourceCollectionQueryParams extend
   offset?: number;
   /**
    * @remarks
-   * The fields by which to sort the results. This parameter is empty by default.
+   * Specifies the field by which to sort the results. By default, this parameter is empty.
    * 
-   * The field must be either a metadata field or a default field in the table (e.g., id). Supported formats include:
+   * The field must be a metadata field or a default field in the table, such as `id`. The following formats are supported:
    * 
-   * Single field, such as chunk_id. Multiple fields that are separated by commas (,), such as block_id,chunk_id. Descending order is supported, such as block_id DESC,chunk_id DESC.
+   * A single field, such as `chunk_id`. Multiple fields separated by commas, such as `block_id, chunk_id`. Descending order, such as `block_id DESC, chunk_id DESC`.
    * 
    * @example
    * file_id,sort_num
@@ -283,33 +337,33 @@ export class QueryKnowledgeBasesContentRequestSourceCollectionQueryParams extend
   orderBy?: string;
   /**
    * @remarks
-   * The retrieval window. If you specify this parameter, the context of the retrieved result is added in the output. Format: List\\<A, B>. Valid values: -10<=A<=0 and 0<=B<=10.
-   * 
-   * > 
+   * The recall window. If specified, adds context from surrounding document chunks to the search results. The format is a two-element array `[A, B]`, where `-10 <= A <= 0` and `0 <= B <= 10`.
    * 
-   * *   We recommend that you specify this parameter if the source document is segmented into large numbers of pieces, which may result in loss of contextual information during retrieval.
-   * 
-   * *   Perform re-ranking before windowing.
+   * > - This parameter is recommended for finely chunked documents where retrieval might otherwise lose context.
+   * >
+   * > - The system applies reranking before applying the recall window.
    */
   recallWindow?: number[];
   /**
    * @remarks
-   * The rerank factor. If you specify this parameter, the vector retrieval results are reranked once more. Valid values: 1\\<RerankFactor<=5.
-   * 
-   * > 
-   * 
-   * *   If the document is segmented into sparse parts, reranking is inefficient.
+   * The reranking factor. If specified, the system reranks the results from this source collection before they are merged. Valid values: 1 < RerankFactor <= 5.
    * 
-   * *   We recommend that the number of reranked results (the ceiling of TopK × RerankFactor) not exceed 50.
+   * > - Sparse document chunking reduces reranking efficiency.
+   * >
+   * > - We recommend that the number of items to rerank (TopK × Factor, rounded up) does not exceed 50.
    * 
    * @example
    * 2.0
    */
   rerankFactor?: number;
+  /**
+   * @remarks
+   * Parameters for the rerank model applied to the results from this specific source collection before the final merge.
+   */
   rerankModel?: QueryKnowledgeBasesContentRequestSourceCollectionQueryParamsRerankModel;
   /**
    * @remarks
-   * The number of top results.
+   * The number of top results to return from this source collection.
    * 
    * @example
    * 776
@@ -317,7 +371,7 @@ export class QueryKnowledgeBasesContentRequestSourceCollectionQueryParams extend
   topK?: number;
   /**
    * @remarks
-   * Specifies whether to use full-text retrieval (dual-path retrieval). The default value is false, which means only vector retrieval is used.
+   * Specifies whether to use full-text search, which enables two-path retrieval. The default value is `false`, which indicates that only vector retrieval is performed.
    * 
    * @example
    * false
@@ -383,9 +437,9 @@ export class QueryKnowledgeBasesContentRequestSourceCollectionQueryParams extend
 export class QueryKnowledgeBasesContentRequestSourceCollection extends $dara.Model {
   /**
    * @remarks
-   * The name of the document collection.
+   * The document collection name.
    * 
-   * >  You can call the [CreateDocumentCollection](https://help.aliyun.com/document_detail/2618448.html) operation to create a document collection and call the [ListDocumentCollections](https://help.aliyun.com/document_detail/2618452.html) operation to query a list of document collections.
+   * > To create a document collection, call the [CreateDocumentCollection](https://help.aliyun.com/document_detail/2618448.html) operation. To view existing document collections, call the [ListDocumentCollections](https://help.aliyun.com/document_detail/2618452.html) operation.
    * 
    * This parameter is required.
    * 
@@ -397,7 +451,7 @@ export class QueryKnowledgeBasesContentRequestSourceCollection extends $dara.Mod
    * @remarks
    * The namespace.
    * 
-   * >  You can call the [CreateNamespace](https://help.aliyun.com/document_detail/2401495.html) operation to create a namespace and call the [ListNamespaces](https://help.aliyun.com/document_detail/2401502.html) operation to query a list of namespaces.
+   * > You can call the [CreateNamespace](https://help.aliyun.com/document_detail/2401495.html) operation to create a namespace and call the [ListNamespaces](https://help.aliyun.com/document_detail/2401502.html) operation to view existing namespaces.
    * 
    * @example
    * ns_cloud_index
@@ -405,9 +459,9 @@ export class QueryKnowledgeBasesContentRequestSourceCollection extends $dara.Mod
   namespace?: string;
   /**
    * @remarks
-   * The password of the namespace.
+   * The password for the namespace.
    * 
-   * >  The value of this parameter is specified when you call the [CreateNamespace](https://help.aliyun.com/document_detail/2401495.html) operation.
+   * > You specify this value when you call the [CreateNamespace](https://help.aliyun.com/document_detail/2401495.html) operation.
    * 
    * This parameter is required.
    * 
@@ -417,7 +471,7 @@ export class QueryKnowledgeBasesContentRequestSourceCollection extends $dara.Mod
   namespacePassword?: string;
   /**
    * @remarks
-   * The condition that is used to filter the data to be updated. Specify this parameter in a format that is the same as the WHERE clause.
+   * The query parameters for the source collection.
    */
   queryParams?: QueryKnowledgeBasesContentRequestSourceCollectionQueryParams;
   static names(): { [key: string]: string } {
@@ -453,16 +507,19 @@ export class QueryKnowledgeBasesContentRequestSourceCollection extends $dara.Mod
 export class QueryKnowledgeBasesContentRequest extends $dara.Model {
   /**
    * @remarks
-   * The text content for retrieval.
+   * The text content to search for.
    * 
    * This parameter is required.
+   * 
+   * @example
+   * What is ADBPG?
    */
   content?: string;
   /**
    * @remarks
-   * The cluster ID.
+   * The instance ID.
    * 
-   * >  You can call the [DescribeDBInstances](https://help.aliyun.com/document_detail/86911.html) operation to query the information about all AnalyticDB for PostgreSQL instances within a region, including instance IDs.
+   * > You can call the [DescribeDBInstances](https://help.aliyun.com/document_detail/86911.html) operation to view the details of all AnalyticDB for PostgreSQL instances in a specific region, including their instance IDs.
    * 
    * This parameter is required.
    * 
@@ -472,10 +529,11 @@ export class QueryKnowledgeBasesContentRequest extends $dara.Model {
   DBInstanceId?: string;
   /**
    * @remarks
-   * The method used to merge multiple knowledge bases. Default value: RRF. Valid values:
+   * The method for merging results from multiple knowledge bases. The default value is `RRF`. Valid values:
+   * 
+   * - RRF
    * 
-   * *   RRF
-   * *   Weight
+   * - Weight
    * 
    * @example
    * RRF
@@ -483,13 +541,13 @@ export class QueryKnowledgeBasesContentRequest extends $dara.Model {
   mergeMethod?: string;
   /**
    * @remarks
-   * The parameters of the merge method for each SourceCollection.
+   * The arguments for the specified `MergeMethod`.
    */
   mergeMethodArgs?: QueryKnowledgeBasesContentRequestMergeMethodArgs;
   ownerId?: number;
   /**
    * @remarks
-   * The region ID.
+   * The region ID of the instance.
    * 
    * This parameter is required.
    * 
@@ -499,29 +557,31 @@ export class QueryKnowledgeBasesContentRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The rerank factor. If you specify this parameter, the vector retrieval results are reranked once more. Valid values: 1\\<RerankFactor<=5.
+   * The reranking factor. If specified, the system reranks the final merged results. Valid values: 1 < RerankFactor <= 5.
    * 
-   * > 
-   * 
-   * *   If the document is segmented into sparse parts, reranking is inefficient.
-   * 
-   * *   We recommend that the number of reranked results (the ceiling of TopK × RerankFactor) not exceed 50.
+   * > - Sparse document chunking reduces reranking efficiency.
+   * >
+   * > - We recommend that the number of items to rerank (TopK × Factor, rounded up) does not exceed 50.
    * 
    * @example
    * 2
    */
   rerankFactor?: number;
+  /**
+   * @remarks
+   * Parameters for the rerank model applied to the final merged results.
+   */
   rerankModel?: QueryKnowledgeBasesContentRequestRerankModel;
   /**
    * @remarks
-   * The information about collections to retrieve from.
+   * The source collections to search.
    * 
    * This parameter is required.
    */
   sourceCollection?: QueryKnowledgeBasesContentRequestSourceCollection[];
   /**
    * @remarks
-   * Set the number of top results to be returned after merging results from multiple path retrieval.
+   * The number of top results to return after the results from all recall paths are merged.
    * 
    * @example
    * 10

package/src/models/QueryKnowledgeBasesContentResponseBody.ts

@@ -203,9 +203,9 @@ export class QueryKnowledgeBasesContentResponseBodyRelations extends $dara.Model
 export class QueryKnowledgeBasesContentResponseBodyUsage extends $dara.Model {
   /**
    * @remarks
-   * The number of entries that are used during vectorization.
+   * The number of entries used for vectorization.
    * 
-   * >  An entry refers to a single unit of vectorization processing. Processing one text input counts as 1 entry, while processing one image counts as 2 entries.
+   * > An entry is a unit of processing for vectorization. For example, vectorizing a piece of text counts as one entry, and vectorizing an image counts as two entries.
    * 
    * @example
    * 10
@@ -213,9 +213,9 @@ export class QueryKnowledgeBasesContentResponseBodyUsage extends $dara.Model {
   embeddingEntries?: string;
   /**
    * @remarks
-   * The number of tokens that are used for vectorization.
+   * The number of tokens used for vectorization.
    * 
-   * >  A token is the minimum unit for splitting text. A token can be a word, phrase, punctuation, or character.
+   * > A token is the smallest unit of processed text, such as a word, phrase, punctuation mark, or character.
    * 
    * @example
    * 475
@@ -247,28 +247,40 @@ export class QueryKnowledgeBasesContentResponseBodyUsage extends $dara.Model {
 export class QueryKnowledgeBasesContentResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The number of tokens that are used during vectorization.
+   * The number of tokens used for vectorization.
    * 
-   * >  A token is the minimum unit for segmenting text. A token can be a word, phrase, punctuation, or character.
+   * > A token is the smallest unit of processed text, such as a word, phrase, punctuation mark, or character.
    * 
    * @example
    * 100
    */
   embeddingTokens?: string;
+  /**
+   * @remarks
+   * The extracted entities.
+   */
   entities?: QueryKnowledgeBasesContentResponseBodyEntities;
+  /**
+   * @remarks
+   * The matched data.
+   */
   matches?: QueryKnowledgeBasesContentResponseBodyMatches;
   /**
    * @remarks
-   * The returned information.
+   * The response message.
    * 
    * @example
    * success
    */
   message?: string;
+  /**
+   * @remarks
+   * The extracted relationships.
+   */
   relations?: QueryKnowledgeBasesContentResponseBodyRelations;
   /**
    * @remarks
-   * The unique ID of the request.
+   * The request ID.
    * 
    * @example
    * ABB39CC3-4488-4857-905D-2E4A051D0521
@@ -276,10 +288,11 @@ export class QueryKnowledgeBasesContentResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The status of the operation. Valid values:
+   * The status of the request. Valid values:
+   * 
+   * - **success**: The request succeeded.
    * 
-   * *   **success**.
-   * *   **fail**.
+   * - **fail**: The request failed.
    * 
    * @example
    * success
@@ -287,7 +300,7 @@ export class QueryKnowledgeBasesContentResponseBody extends $dara.Model {
   status?: string;
   /**
    * @remarks
-   * The total number of tokens that are consumed by this query.
+   * The resource usage for the query.
    */
   usage?: QueryKnowledgeBasesContentResponseBodyUsage;
   static names(): { [key: string]: string } {

package/src/models/QueryKnowledgeBasesContentShrinkRequest.ts

@@ -5,16 +5,19 @@ import * as $dara from '@darabonba/typescript';
 export class QueryKnowledgeBasesContentShrinkRequest extends $dara.Model {
   /**
    * @remarks
-   * The text content for retrieval.
+   * The text content to search for.
    * 
    * This parameter is required.
+   * 
+   * @example
+   * What is ADBPG?
    */
   content?: string;
   /**
    * @remarks
-   * The cluster ID.
+   * The instance ID.
    * 
-   * >  You can call the [DescribeDBInstances](https://help.aliyun.com/document_detail/86911.html) operation to query the information about all AnalyticDB for PostgreSQL instances within a region, including instance IDs.
+   * > You can call the [DescribeDBInstances](https://help.aliyun.com/document_detail/86911.html) operation to view the details of all AnalyticDB for PostgreSQL instances in a specific region, including their instance IDs.
    * 
    * This parameter is required.
    * 
@@ -24,10 +27,11 @@ export class QueryKnowledgeBasesContentShrinkRequest extends $dara.Model {
   DBInstanceId?: string;
   /**
    * @remarks
-   * The method used to merge multiple knowledge bases. Default value: RRF. Valid values:
+   * The method for merging results from multiple knowledge bases. The default value is `RRF`. Valid values:
    * 
-   * *   RRF
-   * *   Weight
+   * - RRF
+   * 
+   * - Weight
    * 
    * @example
    * RRF
@@ -35,13 +39,13 @@ export class QueryKnowledgeBasesContentShrinkRequest extends $dara.Model {
   mergeMethod?: string;
   /**
    * @remarks
-   * The parameters of the merge method for each SourceCollection.
+   * The arguments for the specified `MergeMethod`.
    */
   mergeMethodArgsShrink?: string;
   ownerId?: number;
   /**
    * @remarks
-   * The region ID.
+   * The region ID of the instance.
    * 
    * This parameter is required.
    * 
@@ -51,29 +55,31 @@ export class QueryKnowledgeBasesContentShrinkRequest extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The rerank factor. If you specify this parameter, the vector retrieval results are reranked once more. Valid values: 1\\<RerankFactor<=5.
-   * 
-   * > 
+   * The reranking factor. If specified, the system reranks the final merged results. Valid values: 1 < RerankFactor <= 5.
    * 
-   * *   If the document is segmented into sparse parts, reranking is inefficient.
-   * 
-   * *   We recommend that the number of reranked results (the ceiling of TopK × RerankFactor) not exceed 50.
+   * > - Sparse document chunking reduces reranking efficiency.
+   * >
+   * > - We recommend that the number of items to rerank (TopK × Factor, rounded up) does not exceed 50.
    * 
    * @example
    * 2
    */
   rerankFactor?: number;
+  /**
+   * @remarks
+   * Parameters for the rerank model applied to the final merged results.
+   */
   rerankModelShrink?: string;
   /**
    * @remarks
-   * The information about collections to retrieve from.
+   * The source collections to search.
    * 
    * This parameter is required.
    */
   sourceCollectionShrink?: string;
   /**
    * @remarks
-   * Set the number of top results to be returned after merging results from multiple path retrieval.
+   * The number of top results to return after the results from all recall paths are merged.
    * 
    * @example
    * 10

package/src/models/ReleaseInstancePublicConnectionRequest.ts

@@ -11,7 +11,7 @@ export class ReleaseInstancePublicConnectionRequest extends $dara.Model {
    * *   **cluster**: cluster endpoint. This type of endpoints can be created only for instances that have multiple coordinator nodes.
    * 
    * @example
-   * Intranet
+   * primary
    */
   addressType?: string;
   /**

package/src/models/RerankRequest.ts

@@ -18,6 +18,9 @@ export class RerankRequest extends $dara.Model {
   /**
    * @remarks
    * List of documents to be re-ordered.
+   * 
+   * @example
+   * ADBPG is an Alibaba Cloud OLAP database.
    */
   documents?: string[];
   /**

package/src/models/RerankShrinkRequest.ts

@@ -18,6 +18,9 @@ export class RerankShrinkRequest extends $dara.Model {
   /**
    * @remarks
    * List of documents to be re-ordered.
+   * 
+   * @example
+   * ADBPG is an Alibaba Cloud OLAP database.
    */
   documentsShrink?: string;
   /**