@alicloud/agentcore20260804 1.2.2 → 2.0.1

package/src/models/CreateManagedAgentRequest.ts

@@ -37,7 +37,7 @@ export class CreateManagedAgentRequestBodyEnvironmentCredentialReferences extend
 export class CreateManagedAgentRequestBodyEnvironmentVariables extends $dara.Model {
   /**
    * @remarks
-   * The environment variable name.
+   * The name of the environment variable.
    * 
    * This parameter is required.
    * 
@@ -47,7 +47,7 @@ export class CreateManagedAgentRequestBodyEnvironmentVariables extends $dara.Mod
   name?: string;
   /**
    * @remarks
-   * The environment variable value.
+   * The value of the environment variable.
    * 
    * This parameter is required.
    * 
@@ -118,6 +118,148 @@ export class CreateManagedAgentRequestBodyEnvironment extends $dara.Model {
   }
 }
 
+export class CreateManagedAgentRequestBodyHarnessConfiguration extends $dara.Model {
+  /**
+   * @remarks
+   * The Key ID used to bind a Service Account Key of the QoderCLI Connector. This parameter can be omitted when only one key exists, but is required when multiple keys exist.
+   * 
+   * @example
+   * key-xxxx
+   */
+  connectorServiceAccountKey?: string;
+  /**
+   * @remarks
+   * The Connector Key name that is populated during queries. This parameter is not used as a binding criterion during writes.
+   * 
+   * @example
+   * my-connector-key
+   */
+  connectorServiceAccountName?: string;
+  static names(): { [key: string]: string } {
+    return {
+      connectorServiceAccountKey: 'connectorServiceAccountKey',
+      connectorServiceAccountName: 'connectorServiceAccountName',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      connectorServiceAccountKey: 'string',
+      connectorServiceAccountName: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class CreateManagedAgentRequestBodyHarness extends $dara.Model {
+  /**
+   * @remarks
+   * The Connector binding configuration for the qodercli harness.
+   */
+  configuration?: CreateManagedAgentRequestBodyHarnessConfiguration;
+  /**
+   * @remarks
+   * The harness type. Valid values: qwenpaw and qodercli. When the type is qodercli, binding is performed based on configuration.connectorServiceAccountKey, and the name is also populated during queries.
+   * 
+   * @example
+   * qodercli
+   */
+  type?: string;
+  static names(): { [key: string]: string } {
+    return {
+      configuration: 'configuration',
+      type: 'type',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      configuration: CreateManagedAgentRequestBodyHarnessConfiguration,
+      type: 'string',
+    };
+  }
+
+  validate() {
+    if(this.configuration && typeof (this.configuration as any).validate === 'function') {
+      (this.configuration as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class CreateManagedAgentRequestBodyModelQuota extends $dara.Model {
+  /**
+   * @remarks
+   * Specifies whether to enable the token quota. Default value: true. If you set this parameter to false, the token quota is disabled and existing quota rules are deleted.
+   * 
+   * @example
+   * true
+   */
+  enabled?: boolean;
+  /**
+   * @remarks
+   * The quota limit type. This parameter is required by backend validation when the quota is enabled. Fixed value: token.
+   * 
+   * @example
+   * token
+   */
+  limitType?: string;
+  /**
+   * @remarks
+   * The quota statistical period. This parameter is required by backend validation when the quota is enabled. Valid values:
+   * - day: daily.
+   * - month: monthly.
+   * 
+   * @example
+   * day
+   */
+  periodType?: string;
+  /**
+   * @remarks
+   * The maximum number of tokens that can be consumed within a single period. This parameter is required by backend validation when the 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 CreateManagedAgentRequestBodyModel extends $dara.Model {
   /**
    * @remarks
@@ -133,16 +275,20 @@ export class CreateManagedAgentRequestBodyModel extends $dara.Model {
    * @remarks
    * The upstream model name.
    * 
-   * This parameter is required.
-   * 
    * @example
    * qwen-max
    */
   modelName?: string;
+  /**
+   * @remarks
+   * The model token quota configuration. If this parameter is not specified, no quota is configured.
+   */
+  quota?: CreateManagedAgentRequestBodyModelQuota;
   static names(): { [key: string]: string } {
     return {
       modelConnectionId: 'modelConnectionId',
       modelName: 'modelName',
+      quota: 'quota',
     };
   }
 
@@ -150,10 +296,14 @@ export class CreateManagedAgentRequestBodyModel extends $dara.Model {
     return {
       modelConnectionId: 'string',
       modelName: 'string',
+      quota: CreateManagedAgentRequestBodyModelQuota,
     };
   }
 
   validate() {
+    if(this.quota && typeof (this.quota as any).validate === 'function') {
+      (this.quota as any).validate();
+    }
     super.validate();
   }
 
@@ -165,9 +315,7 @@ export class CreateManagedAgentRequestBodyModel extends $dara.Model {
 export class CreateManagedAgentRequestBodyNetworkAccessInternet extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to allow access to the Internet.
-   * 
-   * This parameter is required.
+   * Specifies whether to allow public network access.
    * 
    * @example
    * false
@@ -197,9 +345,7 @@ export class CreateManagedAgentRequestBodyNetworkAccessInternet extends $dara.Mo
 export class CreateManagedAgentRequestBodyNetworkAccessVpc extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to allow access to the VPC.
-   * 
-   * This parameter is required.
+   * Specifies whether to allow VPC access.
    * 
    * @example
    * true
@@ -266,10 +412,58 @@ export class CreateManagedAgentRequestBodyNetwork extends $dara.Model {
   }
 }
 
+export class CreateManagedAgentRequestBodyOssMounts extends $dara.Model {
+  /**
+   * @remarks
+   * The OSS bucket name. This parameter is required by backend validation for each mount entry.
+   */
+  bucketName?: string;
+  /**
+   * @remarks
+   * The absolute mount path inside the container. This parameter is required by backend validation for each mount entry.
+   */
+  mountPath?: string;
+  /**
+   * @remarks
+   * The relative object prefix within the bucket. If this parameter is not specified, the entire bucket is mounted.
+   */
+  path?: string;
+  /**
+   * @remarks
+   * Specifies whether to mount in read-only mode. Default value: false.
+   */
+  readOnly?: boolean;
+  static names(): { [key: string]: string } {
+    return {
+      bucketName: 'bucketName',
+      mountPath: 'mountPath',
+      path: 'path',
+      readOnly: 'readOnly',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      bucketName: 'string',
+      mountPath: 'string',
+      path: 'string',
+      readOnly: 'boolean',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class CreateManagedAgentRequestBodyRuntimeCompute extends $dara.Model {
   /**
    * @remarks
-   * The compute specification.
+   * The compute class.
    * 
    * This parameter is required.
    * 
@@ -298,10 +492,65 @@ export class CreateManagedAgentRequestBodyRuntimeCompute extends $dara.Model {
   }
 }
 
+export class CreateManagedAgentRequestBodyRuntimeHpa extends $dara.Model {
+  /**
+   * @remarks
+   * Specifies whether to enable auto scaling. This parameter is required by backend validation when hpa is present.
+   */
+  enabled?: boolean;
+  /**
+   * @remarks
+   * The maximum number of active sessions per sandbox. This parameter is required by backend validation when hpa is present.
+   */
+  maxConcurrentSessionsPerSandbox?: number;
+  /**
+   * @remarks
+   * The maximum number of sandboxes. This parameter is required when HPA is enabled and the value must be no less than the minimum value.
+   */
+  maxSandboxCount?: number;
+  /**
+   * @remarks
+   * The minimum number of sandboxes. This parameter is required when HPA is enabled.
+   */
+  minSandboxCount?: number;
+  /**
+   * @remarks
+   * The session reclamation time after inactivity, in seconds. This parameter is required by backend validation when hpa is present.
+   */
+  sessionTtlSeconds?: number;
+  static names(): { [key: string]: string } {
+    return {
+      enabled: 'enabled',
+      maxConcurrentSessionsPerSandbox: 'maxConcurrentSessionsPerSandbox',
+      maxSandboxCount: 'maxSandboxCount',
+      minSandboxCount: 'minSandboxCount',
+      sessionTtlSeconds: 'sessionTtlSeconds',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      enabled: 'boolean',
+      maxConcurrentSessionsPerSandbox: 'number',
+      maxSandboxCount: 'number',
+      minSandboxCount: 'number',
+      sessionTtlSeconds: 'number',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class CreateManagedAgentRequestBodyRuntimeSessionPolicy extends $dara.Model {
   /**
    * @remarks
-   * The HTTP header name used for session affinity. This parameter takes effect only when sessionPolicy.type is set to ISOLATED_HEADER_FIELD.
+   * The name of the HTTP header used for session affinity. This parameter takes effect when sessionPolicy.type is set to ISOLATED_HEADER_FIELD.
    * 
    * @example
    * X-Session-Id
@@ -348,6 +597,11 @@ export class CreateManagedAgentRequestBodyRuntime extends $dara.Model {
    * This parameter is required.
    */
   compute?: CreateManagedAgentRequestBodyRuntimeCompute;
+  /**
+   * @remarks
+   * The sandbox auto scaling and session configuration.
+   */
+  hpa?: CreateManagedAgentRequestBodyRuntimeHpa;
   /**
    * @remarks
    * The session policy configuration.
@@ -358,6 +612,7 @@ export class CreateManagedAgentRequestBodyRuntime extends $dara.Model {
   static names(): { [key: string]: string } {
     return {
       compute: 'compute',
+      hpa: 'hpa',
       sessionPolicy: 'sessionPolicy',
     };
   }
@@ -365,6 +620,7 @@ export class CreateManagedAgentRequestBodyRuntime extends $dara.Model {
   static types(): { [key: string]: any } {
     return {
       compute: CreateManagedAgentRequestBodyRuntimeCompute,
+      hpa: CreateManagedAgentRequestBodyRuntimeHpa,
       sessionPolicy: CreateManagedAgentRequestBodyRuntimeSessionPolicy,
     };
   }
@@ -373,6 +629,9 @@ export class CreateManagedAgentRequestBodyRuntime extends $dara.Model {
     if(this.compute && typeof (this.compute as any).validate === 'function') {
       (this.compute as any).validate();
     }
+    if(this.hpa && typeof (this.hpa as any).validate === 'function') {
+      (this.hpa as any).validate();
+    }
     if(this.sessionPolicy && typeof (this.sessionPolicy as any).validate === 'function') {
       (this.sessionPolicy as any).validate();
     }
@@ -434,7 +693,7 @@ export class CreateManagedAgentRequestBodySubAgents extends $dara.Model {
    * This parameter is required.
    * 
    * @example
-   * Please review the code
+   * Review the code
    */
   instruction?: string;
   /**
@@ -485,6 +744,8 @@ export class CreateManagedAgentRequestBodyTemplateAiRegistry extends $dara.Model
    * @remarks
    * The version of the template in the AI registry.
    * 
+   * This parameter is required.
+   * 
    * @example
    * 1.0.0
    */
@@ -600,6 +861,11 @@ export class CreateManagedAgentRequestBody extends $dara.Model {
    * The environment configuration.
    */
   environment?: CreateManagedAgentRequestBodyEnvironment;
+  /**
+   * @remarks
+   * The harness for the managed agent. Valid values: qwenpaw and qodercli.
+   */
+  harness?: CreateManagedAgentRequestBodyHarness;
   /**
    * @remarks
    * The agent instruction that guides the behavior of the agent.
@@ -630,6 +896,11 @@ export class CreateManagedAgentRequestBody extends $dara.Model {
    * The network configuration.
    */
   network?: CreateManagedAgentRequestBodyNetwork;
+  /**
+   * @remarks
+   * The list of OSS mounts. A maximum of 10 entries are supported.
+   */
+  ossMounts?: CreateManagedAgentRequestBodyOssMounts[];
   /**
    * @remarks
    * The runtime configuration.
@@ -654,17 +925,19 @@ export class CreateManagedAgentRequestBody extends $dara.Model {
   template?: CreateManagedAgentRequestBodyTemplate;
   /**
    * @remarks
-   * The list of tool configurations.
+   * The tool configuration list.
    */
   tools?: CreateManagedAgentRequestBodyTools[];
   static names(): { [key: string]: string } {
     return {
       description: 'description',
       environment: 'environment',
+      harness: 'harness',
       instruction: 'instruction',
       model: 'model',
       name: 'name',
       network: 'network',
+      ossMounts: 'ossMounts',
       runtime: 'runtime',
       skills: 'skills',
       subAgents: 'subAgents',
@@ -677,10 +950,12 @@ export class CreateManagedAgentRequestBody extends $dara.Model {
     return {
       description: 'string',
       environment: CreateManagedAgentRequestBodyEnvironment,
+      harness: CreateManagedAgentRequestBodyHarness,
       instruction: 'string',
       model: CreateManagedAgentRequestBodyModel,
       name: 'string',
       network: CreateManagedAgentRequestBodyNetwork,
+      ossMounts: { 'type': 'array', 'itemType': CreateManagedAgentRequestBodyOssMounts },
       runtime: CreateManagedAgentRequestBodyRuntime,
       skills: { 'type': 'array', 'itemType': CreateManagedAgentRequestBodySkills },
       subAgents: { 'type': 'array', 'itemType': CreateManagedAgentRequestBodySubAgents },
@@ -693,12 +968,18 @@ export class CreateManagedAgentRequestBody extends $dara.Model {
     if(this.environment && typeof (this.environment as any).validate === 'function') {
       (this.environment as any).validate();
     }
+    if(this.harness && typeof (this.harness as any).validate === 'function') {
+      (this.harness as any).validate();
+    }
     if(this.model && typeof (this.model as any).validate === 'function') {
       (this.model as any).validate();
     }
     if(this.network && typeof (this.network as any).validate === 'function') {
       (this.network as any).validate();
     }
+    if(Array.isArray(this.ossMounts)) {
+      $dara.Model.validateArray(this.ossMounts);
+    }
     if(this.runtime && typeof (this.runtime as any).validate === 'function') {
       (this.runtime as any).validate();
     }
@@ -730,7 +1011,7 @@ export class CreateManagedAgentRequest extends $dara.Model {
   body?: CreateManagedAgentRequestBody;
   /**
    * @remarks
-   * The reserved idempotency token. The backend does not provide idempotency guarantees in the current phase.
+   * The reserved idempotency token. The backend does not provide idempotency guarantees in the current version.
    * 
    * @example
    * client-token-1