@alicloud/polardb20170801 8.2.0 → 8.2.2

package/src/models/UpdateKbsyncLinkRequest.ts

@@ -5,6 +5,24 @@ import * as $dara from '@darabonba/typescript';
 export class UpdateKBSyncLinkRequest extends $dara.Model {
   /**
    * @remarks
+   * The client ID.
+   * 
+   * @example
+   * cli_xxxxxxbe8
+   */
+  clientId?: string;
+  /**
+   * @remarks
+   * The client secret.
+   * 
+   * @example
+   * ******
+   */
+  clientSecret?: string;
+  /**
+   * @remarks
+   * The unique identifier of the knowledge base.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -13,6 +31,8 @@ export class UpdateKBSyncLinkRequest extends $dara.Model {
   knowledgeBaseId?: string;
   /**
    * @remarks
+   * The synchronization link ID.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -21,6 +41,16 @@ export class UpdateKBSyncLinkRequest extends $dara.Model {
   linkId?: string;
   /**
    * @remarks
+   * The MCP Server address for DingTalk documents.
+   * 
+   * @example
+   * https://mcp-gw.dingtalk.com/server/1a2b3cxxxxxx789?key=d5e6fxxxxxx876
+   */
+  mcpEndpoint?: string;
+  /**
+   * @remarks
+   * The region ID.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -28,25 +58,64 @@ export class UpdateKBSyncLinkRequest extends $dara.Model {
    */
   regionId?: string;
   /**
+   * @remarks
+   * The MCP Server address for DingTalk spreadsheets.
+   * 
+   * @example
+   * https://mcp-gw.dingtalk.com/server/1a2b3cxxxxxx567?key=d5e6fxxxxxx543
+   */
+  sheetMcpEndpoint?: string;
+  /**
+   * @remarks
+   * Specifies whether to enable automatic synchronization. This parameter can only be modified independently and cannot be changed together with other configurations.
+   * 
+   * @example
+   * false
+   */
+  syncEnabled?: boolean;
+  /**
+   * @remarks
+   * 20
+   * 
    * @example
    * 20
    */
   syncIntervalMinutes?: number;
+  /**
+   * @remarks
+   * The DingTalk user ID for the operation.
+   * 
+   * @example
+   * 123***56
+   */
+  userId?: string;
   static names(): { [key: string]: string } {
     return {
+      clientId: 'ClientId',
+      clientSecret: 'ClientSecret',
       knowledgeBaseId: 'KnowledgeBaseId',
       linkId: 'LinkId',
+      mcpEndpoint: 'McpEndpoint',
       regionId: 'RegionId',
+      sheetMcpEndpoint: 'SheetMcpEndpoint',
+      syncEnabled: 'SyncEnabled',
       syncIntervalMinutes: 'SyncIntervalMinutes',
+      userId: 'UserId',
     };
   }
 
   static types(): { [key: string]: any } {
     return {
+      clientId: 'string',
+      clientSecret: 'string',
       knowledgeBaseId: 'string',
       linkId: 'string',
+      mcpEndpoint: 'string',
       regionId: 'string',
+      sheetMcpEndpoint: 'string',
+      syncEnabled: 'boolean',
       syncIntervalMinutes: 'number',
+      userId: 'string',
     };
   }
 

package/src/models/UpdateKbsyncLinkResponseBody.ts

@@ -4,15 +4,25 @@ import * as $dara from '@darabonba/typescript';
 
 export class UpdateKBSyncLinkResponseBody extends $dara.Model {
   /**
+   * @remarks
+   * The synchronization link ID.
+   * 
    * @example
    * pkbl-xxxxx
    */
   linkId?: string;
   /**
+   * @remarks
+   * Id of the request
+   * 
    * @example
    * EBEAA83D-1734-42E3-85E3-E25F6E******
    */
   requestId?: string;
+  /**
+   * @remarks
+   * The scheduling time of the synchronization task.
+   */
   syncSchedule?: string;
   static names(): { [key: string]: string } {
     return {

package/src/models/UpdateKnowledgeBaseFileShardingStrategyRequest.ts

@@ -4,11 +4,17 @@ import * as $dara from '@darabonba/typescript';
 
 export class UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfigDefaultStrategyParameters extends $dara.Model {
   /**
+   * @remarks
+   * The maximum number of tokens per chunk. The value must be a positive integer. This parameter takes effect only when Type is set to hybrid.
+   * 
    * @example
    * 512
    */
   maxTokens?: number;
   /**
+   * @remarks
+   * Specifies whether to merge adjacent small chunks under the same heading. This parameter takes effect only when Type is set to hybrid.
+   * 
    * @example
    * true
    */
@@ -37,9 +43,17 @@ export class UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfi
 }
 
 export class UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfigDefaultStrategy extends $dara.Model {
+  /**
+   * @remarks
+   * The parameters of the default chunking strategy. MaxTokens and MergePeers are supported only when Type is set to hybrid.
+   */
   parameters?: UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfigDefaultStrategyParameters;
   /**
    * @remarks
+   * The type of the default chunking strategy. Valid values:
+   * - hybrid: Splits by document structure and limits the token count.
+   * - hierarchical: Splits only by document structure.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -74,6 +88,9 @@ export class UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfi
 
 export class UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfigRulesMatch extends $dara.Model {
   /**
+   * @remarks
+   * The content type. Currently, only table is supported, which matches content that is parsed as tables.
+   * 
    * @example
    * table
    */
@@ -101,11 +118,20 @@ export class UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfi
 
 export class UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfigRulesStrategyParameters extends $dara.Model {
   /**
+   * @remarks
+   * The Markdown table processing mode. Valid values:
+   * - auto: Automatically determines the processing mode.
+   * - on: Forcefully enables Markdown table processing.
+   * - off: Disables Markdown table processing.
+   * 
    * @example
    * auto
    */
   markdownTables?: string;
   /**
+   * @remarks
+   * The maximum number of tokens per chunk for matched content. The value must be a positive integer. This parameter takes effect only when Type is set to hybrid.
+   * 
    * @example
    * 512
    */
@@ -134,9 +160,17 @@ export class UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfi
 }
 
 export class UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfigRulesStrategy extends $dara.Model {
+  /**
+   * @remarks
+   * The chunking strategy parameters of the override rule. MaxTokens takes effect only when Type is set to hybrid. MarkdownTables supports auto, on, or off.
+   */
   parameters?: UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfigRulesStrategyParameters;
   /**
    * @remarks
+   * The chunking strategy type of the override rule. Valid values:
+   * - hybrid
+   * - hierarchical
+   * 
    * This parameter is required.
    * 
    * @example
@@ -172,11 +206,15 @@ export class UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfi
 export class UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfigRules extends $dara.Model {
   /**
    * @remarks
+   * The rule match condition. Currently, only exact matching by content type for table content is supported.
+   * 
    * This parameter is required.
    */
   match?: UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfigRulesMatch;
   /**
    * @remarks
+   * The chunking strategy to use when the rule is matched.
+   * 
    * This parameter is required.
    */
   strategy?: UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfigRulesStrategy;
@@ -212,9 +250,15 @@ export class UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfi
 export class UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfig extends $dara.Model {
   /**
    * @remarks
+   * The default chunking strategy. This strategy is used when no rule is matched.
+   * 
    * This parameter is required.
    */
   defaultStrategy?: UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfigDefaultStrategy;
+  /**
+   * @remarks
+   * The list of override rules that are matched in order. Currently, a maximum of one exact-match rule with ContentType set to table is supported.
+   */
   rules?: UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfigRules[];
   static names(): { [key: string]: string } {
     return {
@@ -248,6 +292,8 @@ export class UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfi
 export class UpdateKnowledgeBaseFileShardingStrategyRequest extends $dara.Model {
   /**
    * @remarks
+   * The unique ID of the knowledge base file.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -255,12 +301,17 @@ export class UpdateKnowledgeBaseFileShardingStrategyRequest extends $dara.Model
    */
   fileId?: string;
   /**
+   * @remarks
+   * Specifies whether to restore inheritance of the chunking strategy from the knowledge space. When this parameter is set to true, ShardingStrategyConfig cannot be specified at the same time.
+   * 
    * @example
    * false
    */
   inheritSpaceStrategy?: boolean;
   /**
    * @remarks
+   * The unique ID of the knowledge base.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -269,12 +320,18 @@ export class UpdateKnowledgeBaseFileShardingStrategyRequest extends $dara.Model
   knowledgeBaseId?: string;
   /**
    * @remarks
+   * The ID of the region where the knowledge base resides.
+   * 
    * This parameter is required.
    * 
    * @example
    * cn-beijing
    */
   regionId?: string;
+  /**
+   * @remarks
+   * The file-level chunking strategy configuration. This parameter is required when InheritSpaceStrategy is not set to true.
+   */
   shardingStrategyConfig?: UpdateKnowledgeBaseFileShardingStrategyRequestShardingStrategyConfig;
   static names(): { [key: string]: string } {
     return {

package/src/models/UpdateKnowledgeBaseFileShardingStrategyResponseBody.ts

@@ -4,6 +4,9 @@ import * as $dara from '@darabonba/typescript';
 
 export class UpdateKnowledgeBaseFileShardingStrategyResponseBody extends $dara.Model {
   /**
+   * @remarks
+   * The request ID.
+   * 
    * @example
    * 019F7F29-BF69-1734-AE5A-02D391385BAC
    */

package/src/models/UpdateKnowledgeBaseFileShardingStrategyShrinkRequest.ts

@@ -5,6 +5,8 @@ import * as $dara from '@darabonba/typescript';
 export class UpdateKnowledgeBaseFileShardingStrategyShrinkRequest extends $dara.Model {
   /**
    * @remarks
+   * The unique ID of the knowledge base file.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -12,12 +14,17 @@ export class UpdateKnowledgeBaseFileShardingStrategyShrinkRequest extends $dara.
    */
   fileId?: string;
   /**
+   * @remarks
+   * Specifies whether to restore inheritance of the chunking strategy from the knowledge space. When this parameter is set to true, ShardingStrategyConfig cannot be specified at the same time.
+   * 
    * @example
    * false
    */
   inheritSpaceStrategy?: boolean;
   /**
    * @remarks
+   * The unique ID of the knowledge base.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -26,12 +33,18 @@ export class UpdateKnowledgeBaseFileShardingStrategyShrinkRequest extends $dara.
   knowledgeBaseId?: string;
   /**
    * @remarks
+   * The ID of the region where the knowledge base resides.
+   * 
    * This parameter is required.
    * 
    * @example
    * cn-beijing
    */
   regionId?: string;
+  /**
+   * @remarks
+   * The file-level chunking strategy configuration. This parameter is required when InheritSpaceStrategy is not set to true.
+   */
   shardingStrategyConfigShrink?: string;
   static names(): { [key: string]: string } {
     return {

package/src/models/UpdateKnowledgeBaseRequest.ts

@@ -4,12 +4,17 @@ import * as $dara from '@darabonba/typescript';
 
 export class UpdateKnowledgeBaseRequest extends $dara.Model {
   /**
+   * @remarks
+   * The description of the knowledge base.
+   * 
    * @example
    * test desc
    */
   description?: string;
   /**
    * @remarks
+   * The unique ID of the knowledge base.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -17,12 +22,17 @@ export class UpdateKnowledgeBaseRequest extends $dara.Model {
    */
   knowledgeBaseId?: string;
   /**
+   * @remarks
+   * The name of the knowledge base.
+   * 
    * @example
    * testName
    */
   name?: string;
   /**
    * @remarks
+   * The region ID.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -30,6 +40,15 @@ export class UpdateKnowledgeBaseRequest extends $dara.Model {
    */
   regionId?: string;
   /**
+   * @remarks
+   * The search mode. Valid values:
+   * 
+   * * balanced (default): balanced mode.
+   * * precise: precise mode.
+   * * semantic: semantic mode.
+   * * knn: KNN mode.
+   * * rrf: reciprocal rank fusion (RRF) mode.
+   * 
    * @example
    * balanced
    */

package/src/models/UpdateKnowledgeBaseResponseBody.ts

@@ -4,11 +4,17 @@ import * as $dara from '@darabonba/typescript';
 
 export class UpdateKnowledgeBaseResponseBody extends $dara.Model {
   /**
+   * @remarks
+   * The unique ID of the knowledge base.
+   * 
    * @example
    * pkb-xxxxx
    */
   knowledgeBaseId?: string;
   /**
+   * @remarks
+   * Id of the request
+   * 
    * @example
    * EB07CFF0-D8A4-5C76-AED7-D00E26FC2***
    */

package/src/models/UpdateKnowledgeSpaceRequest.ts

@@ -4,11 +4,17 @@ import * as $dara from '@darabonba/typescript';
 
 export class UpdateKnowledgeSpaceRequestShardingStrategyConfigDefaultStrategyParameters extends $dara.Model {
   /**
+   * @remarks
+   * The maximum number of tokens per chunk. The value must be a positive integer.
+   * 
    * @example
    * 512
    */
   maxTokens?: number;
   /**
+   * @remarks
+   * Specifies whether to merge adjacent small chunks under the same heading.
+   * 
    * @example
    * true
    */
@@ -37,8 +43,15 @@ export class UpdateKnowledgeSpaceRequestShardingStrategyConfigDefaultStrategyPar
 }
 
 export class UpdateKnowledgeSpaceRequestShardingStrategyConfigDefaultStrategy extends $dara.Model {
+  /**
+   * @remarks
+   * The parameters of the default chunking strategy. MaxTokens and MergePeers take effect only when Type is set to hybrid.
+   */
   parameters?: UpdateKnowledgeSpaceRequestShardingStrategyConfigDefaultStrategyParameters;
   /**
+   * @remarks
+   * The type of the default chunking strategy. Valid values: hybrid or hierarchical.
+   * 
    * @example
    * hybrid
    */
@@ -71,6 +84,9 @@ export class UpdateKnowledgeSpaceRequestShardingStrategyConfigDefaultStrategy ex
 
 export class UpdateKnowledgeSpaceRequestShardingStrategyConfigRulesMatch extends $dara.Model {
   /**
+   * @remarks
+   * The content type. Currently, only table is supported.
+   * 
    * @example
    * table
    */
@@ -98,11 +114,17 @@ export class UpdateKnowledgeSpaceRequestShardingStrategyConfigRulesMatch extends
 
 export class UpdateKnowledgeSpaceRequestShardingStrategyConfigRulesStrategyParameters extends $dara.Model {
   /**
+   * @remarks
+   * The processing mode for Markdown tables. Valid values: auto, on, or off.
+   * 
    * @example
    * auto
    */
   markdownTables?: string;
   /**
+   * @remarks
+   * The maximum number of tokens per chunk for matched content. The value must be a positive integer.
+   * 
    * @example
    * 512
    */
@@ -131,8 +153,15 @@ export class UpdateKnowledgeSpaceRequestShardingStrategyConfigRulesStrategyParam
 }
 
 export class UpdateKnowledgeSpaceRequestShardingStrategyConfigRulesStrategy extends $dara.Model {
+  /**
+   * @remarks
+   * The chunking strategy parameters for the override rule. MaxTokens takes effect only when Type is set to hybrid. MarkdownTables supports auto, on, or off.
+   */
   parameters?: UpdateKnowledgeSpaceRequestShardingStrategyConfigRulesStrategyParameters;
   /**
+   * @remarks
+   * The type of the chunking strategy to use when the rule is matched. Valid values: hybrid or hierarchical.
+   * 
    * @example
    * hierarchical
    */
@@ -164,7 +193,15 @@ export class UpdateKnowledgeSpaceRequestShardingStrategyConfigRulesStrategy exte
 }
 
 export class UpdateKnowledgeSpaceRequestShardingStrategyConfigRules extends $dara.Model {
+  /**
+   * @remarks
+   * The match condition of the rule. Currently, only exact matching of table content by content type is supported.
+   */
   match?: UpdateKnowledgeSpaceRequestShardingStrategyConfigRulesMatch;
+  /**
+   * @remarks
+   * The chunking strategy to use when the rule is matched.
+   */
   strategy?: UpdateKnowledgeSpaceRequestShardingStrategyConfigRulesStrategy;
   static names(): { [key: string]: string } {
     return {
@@ -196,7 +233,15 @@ export class UpdateKnowledgeSpaceRequestShardingStrategyConfigRules extends $dar
 }
 
 export class UpdateKnowledgeSpaceRequestShardingStrategyConfig extends $dara.Model {
+  /**
+   * @remarks
+   * The default chunking strategy. This strategy is used when no rule is matched.
+   */
   defaultStrategy?: UpdateKnowledgeSpaceRequestShardingStrategyConfigDefaultStrategy;
+  /**
+   * @remarks
+   * The list of override rules that are matched in order. Currently, a maximum of one exact-match rule with ContentType set to table is supported.
+   */
   rules?: UpdateKnowledgeSpaceRequestShardingStrategyConfigRules[];
   static names(): { [key: string]: string } {
     return {
@@ -229,12 +274,17 @@ export class UpdateKnowledgeSpaceRequestShardingStrategyConfig extends $dara.Mod
 
 export class UpdateKnowledgeSpaceRequest extends $dara.Model {
   /**
+   * @remarks
+   * The description of the knowledge space. The description can be up to 512 characters in length.
+   * 
    * @example
    * testDesc
    */
   description?: string;
   /**
    * @remarks
+   * The unique identifier of the knowledge space.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -242,17 +292,25 @@ export class UpdateKnowledgeSpaceRequest extends $dara.Model {
    */
   knowledgeSpaceId?: string;
   /**
+   * @remarks
+   * The name of the large language model.
+   * 
    * @example
    * qwen3.6-plus
    */
   LLMModel?: string;
   /**
+   * @remarks
+   * The name of the knowledge space. The name must be 1 to 128 characters in length.
+   * 
    * @example
    * testName
    */
   name?: string;
   /**
    * @remarks
+   * The region ID.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -260,10 +318,17 @@ export class UpdateKnowledgeSpaceRequest extends $dara.Model {
    */
   regionId?: string;
   /**
+   * @remarks
+   * The name of the reranking model.
+   * 
    * @example
    * qwen3-rerank
    */
   rerankModel?: string;
+  /**
+   * @remarks
+   * The default chunking strategy configuration for the knowledge space. Both simple strategies and composite strategies that match by content type are supported.
+   */
   shardingStrategyConfig?: UpdateKnowledgeSpaceRequestShardingStrategyConfig;
   static names(): { [key: string]: string } {
     return {

package/src/models/UpdateKnowledgeSpaceResponseBody.ts

@@ -4,16 +4,25 @@ import * as $dara from '@darabonba/typescript';
 
 export class UpdateKnowledgeSpaceResponseBody extends $dara.Model {
   /**
+   * @remarks
+   * The unique identifier of the knowledge space.
+   * 
    * @example
    * pks-xxxxxx
    */
   knowledgeSpaceId?: string;
   /**
+   * @remarks
+   * Id of the request
+   * 
    * @example
    * CD35F3-F3-44CA-AFFF-BAF869******
    */
   requestId?: string;
   /**
+   * @remarks
+   * The ID of the asynchronous workflow task. This value is empty if no actual model change occurs.
+   * 
    * @example
    * 52*****03
    */

package/src/models/UpdateKnowledgeSpaceShrinkRequest.ts

@@ -4,12 +4,17 @@ import * as $dara from '@darabonba/typescript';
 
 export class UpdateKnowledgeSpaceShrinkRequest extends $dara.Model {
   /**
+   * @remarks
+   * The description of the knowledge space. The description can be up to 512 characters in length.
+   * 
    * @example
    * testDesc
    */
   description?: string;
   /**
    * @remarks
+   * The unique identifier of the knowledge space.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -17,17 +22,25 @@ export class UpdateKnowledgeSpaceShrinkRequest extends $dara.Model {
    */
   knowledgeSpaceId?: string;
   /**
+   * @remarks
+   * The name of the large language model.
+   * 
    * @example
    * qwen3.6-plus
    */
   LLMModel?: string;
   /**
+   * @remarks
+   * The name of the knowledge space. The name must be 1 to 128 characters in length.
+   * 
    * @example
    * testName
    */
   name?: string;
   /**
    * @remarks
+   * The region ID.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -35,10 +48,17 @@ export class UpdateKnowledgeSpaceShrinkRequest extends $dara.Model {
    */
   regionId?: string;
   /**
+   * @remarks
+   * The name of the reranking model.
+   * 
    * @example
    * qwen3-rerank
    */
   rerankModel?: string;
+  /**
+   * @remarks
+   * The default chunking strategy configuration for the knowledge space. Both simple strategies and composite strategies that match by content type are supported.
+   */
   shardingStrategyConfigShrink?: string;
   static names(): { [key: string]: string } {
     return {