@alicloud/agentcore20260804 2.0.0 → 2.1.0

package/src/models/CreateAgentImchannelRequest.ts

@@ -45,7 +45,6 @@ export class CreateAgentIMChannelRequestBody extends $dara.Model {
   /**
    * @remarks
    * The IM channel type. Valid values:
-   * 
    * - DINGTALK: DingTalk.
    * - FEISHU: Lark.
    * - WECOM: WeCom.
@@ -58,19 +57,19 @@ export class CreateAgentIMChannelRequestBody extends $dara.Model {
   channelType?: string;
   /**
    * @remarks
-   * The channel credentials. All fields must be provided and field values must be non-empty strings. DingTalk uses clientID and clientSecret. Lark uses appId and appSecret. WeCom uses botId and secret.
+   * The channel credential. All fields must be provided and field values must be non-empty strings. DingTalk uses clientID and clientSecret. Lark uses appId and appSecret. WeCom uses botId and secret.
    * 
    * This parameter is required.
    */
   credential?: { [key: string]: string };
   /**
    * @remarks
-   * Specifies whether to enable the IM channel. Default value: true.
+   * Specifies whether to enable the IM channel. Default value during creation: true.
    */
   enabled?: boolean;
   /**
    * @remarks
-   * The ID of the ServiceEndpoint to bind. The endpoint must belong to the specified agent and its current version, be in the ready state, and have a public network address.
+   * The ID of the bound ServiceEndpoint. The endpoint must belong to the specified agent and its current version, be in the ready state, and have a public network address.
    * 
    * This parameter is required.
    * 
@@ -121,7 +120,7 @@ export class CreateAgentIMChannelRequest extends $dara.Model {
   body?: CreateAgentIMChannelRequestBody;
   /**
    * @remarks
-   * A reserved idempotency token. The backend does not provide persistent idempotency guarantees in the current phase.
+   * The reserved idempotency token. The backend does not provide persistent idempotency guarantees in the current phase.
    * 
    * @example
    * client-token-1

package/src/models/CreateAgentImchannelResponseBody.ts

@@ -93,7 +93,6 @@ export class CreateAgentIMChannelResponseBodyData extends $dara.Model {
   /**
    * @remarks
    * The IM channel type. Valid values:
-   * 
    * - DINGTALK: DingTalk.
    * - FEISHU: Lark.
    * - WECOM: WeCom.
@@ -117,7 +116,7 @@ export class CreateAgentIMChannelResponseBodyData extends $dara.Model {
   credentialSummary?: CreateAgentIMChannelResponseBodyDataCredentialSummary;
   /**
    * @remarks
-   * Specifies whether to enable the IM channel. Default value: true.
+   * Specifies whether to enable the IM channel. Default value during creation: true.
    */
   enabled?: boolean;
   /**
@@ -138,7 +137,7 @@ export class CreateAgentIMChannelResponseBodyData extends $dara.Model {
   imChannelId?: string;
   /**
    * @remarks
-   * The ID of the ServiceEndpoint to bind. The endpoint must belong to the specified agent and its current version, be in the ready state, and have a public network address.
+   * The ID of the bound ServiceEndpoint. The endpoint must belong to the specified agent and its current version, be in the ready state, and have a public network address.
    * 
    * @example
    * se-1
@@ -147,7 +146,6 @@ export class CreateAgentIMChannelResponseBodyData extends $dara.Model {
   /**
    * @remarks
    * The IM channel status. Valid values:
-   * 
    * - CREATING: Being created.
    * - READY: Ready.
    * - UPDATING: Being updated.
@@ -161,7 +159,7 @@ export class CreateAgentIMChannelResponseBodyData extends $dara.Model {
   status?: string;
   /**
    * @remarks
-   * The reason for the current IM channel status.
+   * The reason for the current status of the IM channel.
    * 
    * @example
    * AppFlow creation failed
@@ -237,7 +235,7 @@ export class CreateAgentIMChannelResponseBodyData extends $dara.Model {
 export class CreateAgentIMChannelResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The business status code. The value SUCCESS indicates success.
+   * The business status code. The value is SUCCESS when the request succeeds.
    * 
    * @example
    * SUCCESS
@@ -250,7 +248,7 @@ export class CreateAgentIMChannelResponseBody extends $dara.Model {
   data?: CreateAgentIMChannelResponseBodyData;
   /**
    * @remarks
-   * The HTTP status code. The value 200 indicates success.
+   * The HTTP status code. The value is 200 when the request succeeds.
    * 
    * @example
    * 200

package/src/models/CreateAgentImchannelShrinkRequest.ts

@@ -10,7 +10,7 @@ export class CreateAgentIMChannelShrinkRequest extends $dara.Model {
   bodyShrink?: string;
   /**
    * @remarks
-   * A reserved idempotency token. The backend does not provide persistent idempotency guarantees in the current phase.
+   * The reserved idempotency token. The backend does not provide persistent idempotency guarantees in the current phase.
    * 
    * @example
    * client-token-1

package/src/models/CreateAgentSpecVersionRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CreateAgentSpecVersionRequestBody extends $dara.Model {
   /**
    * @remarks
-   * The existing version on which to base the draft.
+   * The existing version on which the draft is based.
    * 
    * @example
    * 1.0.0
@@ -13,7 +13,7 @@ export class CreateAgentSpecVersionRequestBody extends $dara.Model {
   basedOnVersion?: string;
   /**
    * @remarks
-   * The version number for the draft. If not specified, the version number is automatically incremented.
+   * The version number of the draft. If this parameter is not specified, the version number is automatically incremented.
    * 
    * @example
    * 2.0.0

package/src/models/CreateExternalAgentBootstrapTokenResponseBody.ts

@@ -63,7 +63,7 @@ export class CreateExternalAgentBootstrapTokenResponseBodyData extends $dara.Mod
   agentId?: string;
   /**
    * @remarks
-   * The Bootstrap Token used for connecting the external agent.
+   * The bootstrap token used for connecting the external agent.
    * 
    * @example
    * bootstrap-token
@@ -86,7 +86,7 @@ export class CreateExternalAgentBootstrapTokenResponseBodyData extends $dara.Mod
   networkType?: string;
   /**
    * @remarks
-   * The fingerprint of the Bootstrap Token.
+   * The fingerprint of the bootstrap token.
    * 
    * @example
    * fingerprint
@@ -137,7 +137,7 @@ export class CreateExternalAgentBootstrapTokenResponseBodyData extends $dara.Mod
 export class CreateExternalAgentBootstrapTokenResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The business status code. The value SUCCESS indicates success.
+   * The business status code. The value SUCCESS is returned if the request is successful.
    * 
    * @example
    * SUCCESS
@@ -145,12 +145,12 @@ export class CreateExternalAgentBootstrapTokenResponseBody extends $dara.Model {
   code?: string;
   /**
    * @remarks
-   * The Bootstrap Token and CMS configuration required for connecting the external agent.
+   * The bootstrap token and CMS configuration required for connecting the external agent.
    */
   data?: CreateExternalAgentBootstrapTokenResponseBodyData;
   /**
    * @remarks
-   * The HTTP status code. The value 200 indicates success.
+   * The HTTP status code. The value 200 is returned if the request is successful.
    * 
    * @example
    * 200
@@ -158,7 +158,7 @@ export class CreateExternalAgentBootstrapTokenResponseBody extends $dara.Model {
   httpStatusCode?: number;
   /**
    * @remarks
-   * The message indicating the request processing result.
+   * The message that indicates the result of the request.
    * 
    * @example
    * success

package/src/models/CreateExternalAgentRequest.ts

@@ -2,6 +2,66 @@
 import * as $dara from '@darabonba/typescript';
 
 
+export class CreateExternalAgentRequestBodyModelQuota extends $dara.Model {
+  /**
+   * @remarks
+   * Specifies whether to enable token quota. Defaults to true if not specified. Set to false to disable and delete existing quota rules.
+   * 
+   * @example
+   * true
+   */
+  enabled?: boolean;
+  /**
+   * @remarks
+   * The quota limit type. Required by backend validation when quota is enabled. Fixed value: token.
+   * 
+   * @example
+   * token
+   */
+  limitType?: string;
+  /**
+   * @remarks
+   * The quota statistical period. Required by backend validation when quota is enabled. Valid values: day (daily) and month (monthly).
+   * 
+   * @example
+   * day
+   */
+  periodType?: string;
+  /**
+   * @remarks
+   * The maximum number of tokens that can be consumed within a single period. Required by backend validation when quota is enabled. The value must be greater than 0.
+   * 
+   * @example
+   * 1000000
+   */
+  usageLimit?: number;
+  static names(): { [key: string]: string } {
+    return {
+      enabled: 'enabled',
+      limitType: 'limitType',
+      periodType: 'periodType',
+      usageLimit: 'usageLimit',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      enabled: 'boolean',
+      limitType: 'string',
+      periodType: 'string',
+      usageLimit: 'number',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class CreateExternalAgentRequestBodyModel extends $dara.Model {
   /**
    * @remarks
@@ -23,10 +83,16 @@ export class CreateExternalAgentRequestBodyModel extends $dara.Model {
    * qwen-max
    */
   modelName?: string;
+  /**
+   * @remarks
+   * The model token quota configuration. If not specified, no quota is configured.
+   */
+  quota?: CreateExternalAgentRequestBodyModelQuota;
   static names(): { [key: string]: string } {
     return {
       modelConnectionId: 'modelConnectionId',
       modelName: 'modelName',
+      quota: 'quota',
     };
   }
 
@@ -34,10 +100,14 @@ export class CreateExternalAgentRequestBodyModel extends $dara.Model {
     return {
       modelConnectionId: 'string',
       modelName: 'string',
+      quota: CreateExternalAgentRequestBodyModelQuota,
     };
   }
 
   validate() {
+    if(this.quota && typeof (this.quota as any).validate === 'function') {
+      (this.quota as any).validate();
+    }
     super.validate();
   }
 
@@ -176,7 +246,6 @@ export class CreateExternalAgentRequestBodyTools extends $dara.Model {
   /**
    * @remarks
    * The tool type. Valid values:
-   * 
    * - MCP: MCP tool.
    * 
    * This parameter is required.
@@ -232,10 +301,9 @@ export class CreateExternalAgentRequestBody extends $dara.Model {
   model?: CreateExternalAgentRequestBodyModel;
   /**
    * @remarks
-   * The source of the model configuration. Valid values:
-   * 
-   * - PLATFORM: The platform parses and delivers the model configuration.
-   * - RUNTIME: The external runtime manages the model on its own. You cannot specify model at the same time.
+   * The model configuration source. PLATFORM indicates that the platform parses and delivers the model configuration. RUNTIME indicates that the external runtime manages the model independently, and the model parameter cannot be specified at the same time. Valid values:
+   * - PLATFORM: platform model.
+   * - RUNTIME: runtime model.
    * 
    * @example
    * PLATFORM
@@ -321,7 +389,7 @@ export class CreateExternalAgentRequest extends $dara.Model {
   body?: CreateExternalAgentRequestBody;
   /**
    * @remarks
-   * The reserved idempotency token. The backend does not provide idempotency guarantees in the current version.
+   * The reserved idempotency token. The backend does not provide idempotency guarantee in the current phase.
    * 
    * @example
    * client-token-1

package/src/models/CreateExternalAgentResponseBody.ts

@@ -16,7 +16,7 @@ export class CreateExternalAgentResponseBodyDataExternalAgentStatus extends $dar
   heartbeatStatus?: string;
   /**
    * @remarks
-   * The last active time of the external agent in RFC 3339 format.
+   * The time when the external agent was last active, in RFC 3339 format.
    * 
    * @example
    * 2026-01-01T00:00:00Z
@@ -24,7 +24,7 @@ export class CreateExternalAgentResponseBodyDataExternalAgentStatus extends $dar
   lastActiveAt?: string;
   /**
    * @remarks
-   * The last heartbeat time of the external agent in RFC 3339 format.
+   * The time of the last heartbeat from the external agent, in RFC 3339 format.
    * 
    * @example
    * 2026-01-01T00:00:00Z
@@ -75,13 +75,101 @@ export class CreateExternalAgentResponseBodyDataExternalAgentStatus extends $dar
   }
 }
 
+export class CreateExternalAgentResponseBodyDataModelQuota extends $dara.Model {
+  /**
+   * @remarks
+   * Indicates whether the quota is enabled. This field is not returned if no quota is configured.
+   * 
+   * @example
+   * true
+   */
+  enabled?: boolean;
+  /**
+   * @remarks
+   * The quota limit type. Currently, only token is supported.
+   * 
+   * @example
+   * token
+   */
+  limitType?: string;
+  /**
+   * @remarks
+   * Indicates whether the quota has been exceeded in the current cycle. This is a read-only field returned by the backend.
+   * 
+   * @example
+   * false
+   */
+  overLimit?: boolean;
+  /**
+   * @remarks
+   * The quota statistical period. day indicates a daily period. month indicates a monthly period.
+   * 
+   * @example
+   * day
+   */
+  periodType?: string;
+  /**
+   * @remarks
+   * The gateway quota rule status. This is a read-only field returned by the backend.
+   * 
+   * @example
+   * ACTIVE
+   */
+  ruleStatus?: string;
+  /**
+   * @remarks
+   * The maximum number of tokens that can be consumed within a single cycle.
+   * 
+   * @example
+   * 1000000
+   */
+  usageLimit?: number;
+  /**
+   * @remarks
+   * The number of tokens consumed in the current cycle. This is a read-only field returned by the backend.
+   * 
+   * @example
+   * 12345
+   */
+  usedAmount?: number;
+  static names(): { [key: string]: string } {
+    return {
+      enabled: 'enabled',
+      limitType: 'limitType',
+      overLimit: 'overLimit',
+      periodType: 'periodType',
+      ruleStatus: 'ruleStatus',
+      usageLimit: 'usageLimit',
+      usedAmount: 'usedAmount',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      enabled: 'boolean',
+      limitType: 'string',
+      overLimit: 'boolean',
+      periodType: 'string',
+      ruleStatus: 'string',
+      usageLimit: 'number',
+      usedAmount: 'number',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class CreateExternalAgentResponseBodyDataModel extends $dara.Model {
   /**
    * @remarks
    * The model connection ID.
    * 
-   * This parameter is required.
-   * 
    * @example
    * mc-1
    */
@@ -90,16 +178,20 @@ export class CreateExternalAgentResponseBodyDataModel extends $dara.Model {
    * @remarks
    * The upstream model name.
    * 
-   * This parameter is required.
-   * 
    * @example
    * qwen-max
    */
   modelName?: string;
+  /**
+   * @remarks
+   * The model token quota configuration and the quota usage status in the current cycle. This field is empty if no quota is configured.
+   */
+  quota?: CreateExternalAgentResponseBodyDataModelQuota;
   static names(): { [key: string]: string } {
     return {
       modelConnectionId: 'modelConnectionId',
       modelName: 'modelName',
+      quota: 'quota',
     };
   }
 
@@ -107,10 +199,14 @@ export class CreateExternalAgentResponseBodyDataModel extends $dara.Model {
     return {
       modelConnectionId: 'string',
       modelName: 'string',
+      quota: CreateExternalAgentResponseBodyDataModelQuota,
     };
   }
 
   validate() {
+    if(this.quota && typeof (this.quota as any).validate === 'function') {
+      (this.quota as any).validate();
+    }
     super.validate();
   }
 
@@ -249,7 +345,6 @@ export class CreateExternalAgentResponseBodyDataTools extends $dara.Model {
   /**
    * @remarks
    * The tool type. Valid values:
-   * 
    * - MCP: MCP tool.
    * 
    * This parameter is required.
@@ -364,10 +459,9 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
   model?: CreateExternalAgentResponseBodyDataModel;
   /**
    * @remarks
-   * The source of the model configuration. Valid values:
-   * 
-   * - PLATFORM: The platform parses and delivers the model configuration.
-   * - RUNTIME: The external runtime manages the model on its own. You cannot specify model at the same time.
+   * The model configuration source. PLATFORM indicates that the platform parses and delivers the model configuration. RUNTIME indicates that the external runtime manages the model independently, and the model parameter cannot be specified at the same time. Valid values:
+   * - PLATFORM: platform model.
+   * - RUNTIME: runtime model.
    * 
    * @example
    * PLATFORM
@@ -540,7 +634,7 @@ export class CreateExternalAgentResponseBody extends $dara.Model {
   httpStatusCode?: number;
   /**
    * @remarks
-   * The message that indicates the result of the request.
+   * The request processing result message.
    * 
    * @example
    * success

package/src/models/CreateExternalAgentShrinkRequest.ts

@@ -10,7 +10,7 @@ export class CreateExternalAgentShrinkRequest extends $dara.Model {
   bodyShrink?: string;
   /**
    * @remarks
-   * The reserved idempotency token. The backend does not provide idempotency guarantees in the current version.
+   * The reserved idempotency token. The backend does not provide idempotency guarantee in the current phase.
    * 
    * @example
    * client-token-1

package/src/models/CreateIdentityProviderRequest.ts

@@ -21,7 +21,7 @@ export class CreateIdentityProviderRequestBodyMetadata extends $dara.Model {
   appKey?: string;
   /**
    * @remarks
-   * Required. The secret of the external identity provider application. This parameter is used only for write operations. The query API does not return this field.
+   * Required. The secret of the external identity provider application. This parameter is write-only and is not returned by query operations.
    * 
    * @example
    * example-app-secret
@@ -29,7 +29,7 @@ export class CreateIdentityProviderRequestBodyMetadata extends $dara.Model {
   appSecret?: string;
   /**
    * @remarks
-   * The CorpId of the DingTalk enterprise. This parameter is required when the binding type is DingTalk.
+   * The CorpId of the DingTalk organization. This parameter is required when the binding type is DingTalk.
    * 
    * @example
    * dingexamplecorpid01
@@ -37,7 +37,7 @@ export class CreateIdentityProviderRequestBodyMetadata extends $dara.Model {
   corpId?: string;
   /**
    * @remarks
-   * The data encryption key for event subscription. The value must be the same as the one configured in the external identity provider application. This parameter is used only for write operations. The query API does not return this field.
+   * The data encryption key for event subscriptions. The value must be the same as the one configured in the external identity provider application. This parameter is write-only and is not returned by query operations.
    * 
    * @example
    * example-encrypt-key
@@ -45,7 +45,7 @@ export class CreateIdentityProviderRequestBodyMetadata extends $dara.Model {
   encryptKey?: string;
   /**
    * @remarks
-   * The verification token for event subscription. The value must be the same as the one configured in the external identity provider application. This parameter is used only for write operations. The query API does not return this field.
+   * The verification token for event subscriptions. The value must be the same as the one configured in the external identity provider application. This parameter is write-only and is not returned by query operations.
    * 
    * @example
    * example-verification-token
@@ -85,7 +85,9 @@ export class CreateIdentityProviderRequestBodyMetadata extends $dara.Model {
 export class CreateIdentityProviderRequestBody extends $dara.Model {
   /**
    * @remarks
-   * The type of the external identity provider. Valid values: DingTalk, Feishu.
+   * The type of the external identity provider. Valid values:
+   * - DingTalk
+   * - Feishu
    * 
    * This parameter is required.
    * 

package/src/models/CreateIdentityProviderResponseBody.ts

@@ -5,7 +5,9 @@ import * as $dara from '@darabonba/typescript';
 export class CreateIdentityProviderResponseBodyData extends $dara.Model {
   /**
    * @remarks
-   * The type of the external identity provider. Valid values: DingTalk, Feishu.
+   * The type of the external identity provider. Valid values:
+   * - DingTalk
+   * - Feishu
    * 
    * @example
    * DingTalk
@@ -99,7 +101,7 @@ export class CreateIdentityProviderResponseBody extends $dara.Model {
   httpStatusCode?: number;
   /**
    * @remarks
-   * The response message. An error description is returned if the request fails.
+   * The response message. An error description is returned if the request failed.
    * 
    * @example
    * success