@alicloud/agentcore20260804 3.0.0 → 3.1.0

package/src/models/UpdateIdentityProviderScimshrinkRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class UpdateIdentityProviderSCIMShrinkRequest extends $dara.Model {
   /**
    * @remarks
-   * Submits business parameters as described in this API. The body parameters of the public API are mapped to the backend wrapper by the gateway. Do not mix them with the backend direct connection body wrapper.
+   * Submits the business parameters as described in this API. The body parameters of the public API are mapped to the backend wrapper by the gateway. Do not mix them with the backend direct connection body wrapper.
    * 
    * This parameter is required.
    */

package/src/models/UpdateIdentityProviderShrinkRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class UpdateIdentityProviderShrinkRequest extends $dara.Model {
   /**
    * @remarks
-   * The configuration fields to be modified. For DingTalk and Lark, you must submit at least one of loginEnabled, syncEnabled, metadata, and syncScope. For CustomSSO, use protocol, saml, and loginEnabled. You cannot submit vendor metadata, syncEnabled, or syncScope.
+   * The configuration fields to be modified. For DingTalk and Feishu, you must submit at least one of the following fields: loginEnabled, syncEnabled, metadata, and syncScope. For CustomSSO, use the protocol, saml, and loginEnabled fields. You cannot submit the vendor metadata, syncEnabled, or syncScope fields.
    */
   bodyShrink?: string;
   static names(): { [key: string]: string } {

package/src/models/UpdateManagedAgentRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class UpdateManagedAgentRequestBodyAgenticFsMounts extends $dara.Model {
   /**
    * @remarks
-   * The subdirectory under /mnt/agenticfs/ in the container. Required for each mount item as validated by the backend. Mount targets must not be duplicated or have parent-child overlaps.
+   * The subdirectory under /mnt/agenticfs/ in the container. This parameter is required and validated by the backend for each mount item. Mount targets must not be duplicated or overlap in parent-child relationships.
    * 
    * @example
    * /mnt/agenticfs/data
@@ -13,7 +13,7 @@ export class UpdateManagedAgentRequestBodyAgenticFsMounts extends $dara.Model {
   mountPath?: string;
   /**
    * @remarks
-   * A non-empty relative directory that exists under the AccessPoint. Required for each mount item as validated by the backend. Root directories, absolute paths, and parent directory segments are not allowed.
+   * The existing non-empty relative directory under the access point. This parameter is required and validated by the backend for each mount item. Root directories, absolute paths, and parent directory segments are not allowed.
    * 
    * @example
    * workspace/data
@@ -21,7 +21,7 @@ export class UpdateManagedAgentRequestBodyAgenticFsMounts extends $dara.Model {
   path?: string;
   /**
    * @remarks
-   * Specifies whether to mount in read-only mode. Default value: false. This is not a RAM role read-only policy.
+   * Specifies whether to mount the file system in read-only mode. If omitted, the default value is false. This parameter does not represent a read-only policy for a RAM role.
    * 
    * @example
    * false
@@ -29,7 +29,7 @@ export class UpdateManagedAgentRequestBodyAgenticFsMounts extends $dara.Model {
   readOnly?: boolean;
   /**
    * @remarks
-   * The AccessPoint domain name. Required for each mount item as validated by the backend. Do not include the protocol, port, or path. Use the DomainName value from the NAS ListAccessPoints response.
+   * The domain name of the access point. This parameter is required and validated by the backend for each mount item. Do not include the protocol, port, or path. Use the DomainName value from the NAS ListAccessPoints response.
    * 
    * @example
    * ap-0123456789abcdef0.0123456789-vlm36.cn-hangzhou.nas.aliyuncs.com
@@ -181,7 +181,7 @@ export class UpdateManagedAgentRequestBodyEnvironment extends $dara.Model {
 export class UpdateManagedAgentRequestBodyHarnessConfiguration extends $dara.Model {
   /**
    * @remarks
-   * The Connector Service Account Key.
+   * The connector service account key.
    * 
    * @example
    * key-xxxx
@@ -189,7 +189,7 @@ export class UpdateManagedAgentRequestBodyHarnessConfiguration extends $dara.Mod
   connectorServiceAccountKey?: string;
   /**
    * @remarks
-   * The Connector Service Account Name.
+   * The connector service account name.
    * 
    * @example
    * my-connector-key
@@ -221,12 +221,12 @@ export class UpdateManagedAgentRequestBodyHarnessConfiguration extends $dara.Mod
 export class UpdateManagedAgentRequestBodyHarness extends $dara.Model {
   /**
    * @remarks
-   * The runtime harness configuration.
+   * The runtime framework configuration.
    */
   configuration?: UpdateManagedAgentRequestBodyHarnessConfiguration;
   /**
    * @remarks
-   * The runtime harness type.
+   * The type of the runtime framework.
    * 
    * @example
    * qodercli
@@ -261,7 +261,7 @@ export class UpdateManagedAgentRequestBodyHarness extends $dara.Model {
 export class UpdateManagedAgentRequestBodyModelQuota extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to enable the token quota. Default value: true. Set to false to disable and delete existing quota rules.
+   * Specifies whether to enable the token quota. If not specified, the default value is true. If set to false, the quota is disabled and existing quota rules are deleted.
    * 
    * @example
    * true
@@ -269,7 +269,7 @@ export class UpdateManagedAgentRequestBodyModelQuota extends $dara.Model {
   enabled?: boolean;
   /**
    * @remarks
-   * The quota limit type. Required when the quota is enabled, as validated by the backend. Fixed value: token.
+   * The quota limit type. This parameter is required and validated by the backend when the quota is enabled. Valid value: token.
    * 
    * @example
    * token
@@ -277,7 +277,7 @@ export class UpdateManagedAgentRequestBodyModelQuota extends $dara.Model {
   limitType?: string;
   /**
    * @remarks
-   * The statistical period for the quota. Required when the quota is enabled, as validated by the backend. Valid values: day (daily) and month (monthly).
+   * The statistical period for the quota. This parameter is required and validated by the backend when the quota is enabled. Valid values: day (daily) and month (monthly).
    * 
    * @example
    * day
@@ -285,7 +285,7 @@ export class UpdateManagedAgentRequestBodyModelQuota extends $dara.Model {
   periodType?: string;
   /**
    * @remarks
-   * The maximum number of tokens that can be consumed within a single period. Required when the quota is enabled, as validated by the backend. The value must be greater than 0.
+   * The maximum number of tokens allowed to be consumed within a single period. This parameter is required and validated by the backend when the quota is enabled. The value must be greater than 0.
    * 
    * @example
    * 1000000
@@ -339,7 +339,7 @@ export class UpdateManagedAgentRequestBodyModel extends $dara.Model {
   modelName?: string;
   /**
    * @remarks
-   * The model token quota configuration. If not specified, no quota is configured.
+   * The model token quota configuration. If this parameter is not passed, no quota is configured.
    */
   quota?: UpdateManagedAgentRequestBodyModelQuota;
   static names(): { [key: string]: string } {
@@ -373,7 +373,7 @@ export class UpdateManagedAgentRequestBodyModel extends $dara.Model {
 export class UpdateManagedAgentRequestBodyNetworkAccessInternet extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to allow public network access.
+   * Specifies whether to allow access to the Internet.
    * 
    * @example
    * false
@@ -403,7 +403,7 @@ export class UpdateManagedAgentRequestBodyNetworkAccessInternet extends $dara.Mo
 export class UpdateManagedAgentRequestBodyNetworkAccessVpc extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to allow VPC access.
+   * Specifies whether to allow access to the VPC.
    * 
    * @example
    * true
@@ -473,7 +473,7 @@ export class UpdateManagedAgentRequestBodyNetwork extends $dara.Model {
 export class UpdateManagedAgentRequestBodyOssMounts extends $dara.Model {
   /**
    * @remarks
-   * The OSS bucket name. Required for each mount item as validated by the backend.
+   * The name of the OSS bucket. This parameter is required and validated by the backend for each mount item.
    * 
    * @example
    * bucket-001
@@ -481,7 +481,7 @@ export class UpdateManagedAgentRequestBodyOssMounts extends $dara.Model {
   bucketName?: string;
   /**
    * @remarks
-   * The absolute mount path in the container. Required for each mount item as validated by the backend.
+   * The absolute mount path in the container. This parameter is required and validated by the backend for each mount item.
    * 
    * @example
    * /mnt/oss/datasets
@@ -489,7 +489,7 @@ export class UpdateManagedAgentRequestBodyOssMounts extends $dara.Model {
   mountPath?: string;
   /**
    * @remarks
-   * The relative object prefix within the bucket. If not specified, the entire bucket is mounted.
+   * The relative object prefix in the bucket. If not specified, the entire bucket is mounted.
    * 
    * @example
    * datasets
@@ -497,7 +497,7 @@ export class UpdateManagedAgentRequestBodyOssMounts extends $dara.Model {
   path?: string;
   /**
    * @remarks
-   * Specifies whether to mount in read-only mode. Default value: false.
+   * Specifies whether to mount the bucket in read-only mode. If not specified, the default value is false.
    */
   readOnly?: boolean;
   static names(): { [key: string]: string } {
@@ -527,6 +527,56 @@ export class UpdateManagedAgentRequestBodyOssMounts extends $dara.Model {
   }
 }
 
+export class UpdateManagedAgentRequestBodyPromptVariables extends $dara.Model {
+  /**
+   * @remarks
+   * The default value.
+   * 
+   * @example
+   * default
+   */
+  defaultValue?: string;
+  /**
+   * @remarks
+   * The description of the variable.
+   * 
+   * @example
+   * desc
+   */
+  description?: string;
+  /**
+   * @remarks
+   * The name of the variable.
+   * 
+   * @example
+   * brand
+   */
+  name?: string;
+  static names(): { [key: string]: string } {
+    return {
+      defaultValue: 'defaultValue',
+      description: 'description',
+      name: 'name',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      defaultValue: 'string',
+      description: 'string',
+      name: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class UpdateManagedAgentRequestBodyRuntimeCompute extends $dara.Model {
   /**
    * @remarks
@@ -562,12 +612,12 @@ export class UpdateManagedAgentRequestBodyRuntimeCompute extends $dara.Model {
 export class UpdateManagedAgentRequestBodyRuntimeHpa extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to enable auto scaling. Required when hpa is present, as validated by the backend.
+   * Specifies whether auto-scaling is enabled. This parameter is required and validated by the backend when HPA is configured.
    */
   enabled?: boolean;
   /**
    * @remarks
-   * The maximum number of active sessions per Sandbox. Required when hpa is present, as validated by the backend.
+   * The maximum number of active sessions per sandbox. This parameter is required and validated by the backend when HPA is configured.
    * 
    * @example
    * 5
@@ -575,7 +625,7 @@ export class UpdateManagedAgentRequestBodyRuntimeHpa extends $dara.Model {
   maxConcurrentSessionsPerSandbox?: number;
   /**
    * @remarks
-   * The maximum number of Sandboxes. Required when HPA is enabled and must be greater than or equal to the minimum value.
+   * The maximum number of sandboxes. This parameter is required when HPA is enabled and must not be less than the minimum value.
    * 
    * @example
    * 3
@@ -583,7 +633,7 @@ export class UpdateManagedAgentRequestBodyRuntimeHpa extends $dara.Model {
   maxSandboxCount?: number;
   /**
    * @remarks
-   * The minimum number of Sandboxes. Required when HPA is enabled.
+   * The minimum number of sandboxes. This parameter is required when HPA is enabled.
    * 
    * @example
    * 1
@@ -591,7 +641,7 @@ export class UpdateManagedAgentRequestBodyRuntimeHpa extends $dara.Model {
   minSandboxCount?: number;
   /**
    * @remarks
-   * The time-to-live (TTL) for a session after inactivity, in seconds. Required when hpa is present, as validated by the backend.
+   * The time in seconds before an inactive session is reclaimed. This parameter is required and validated by the backend when HPA is configured.
    * 
    * @example
    * 3600
@@ -629,7 +679,7 @@ export class UpdateManagedAgentRequestBodyRuntimeHpa extends $dara.Model {
 export class UpdateManagedAgentRequestBodyRuntimeSessionPolicy extends $dara.Model {
   /**
    * @remarks
-   * The name of the HTTP header 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
@@ -678,7 +728,7 @@ export class UpdateManagedAgentRequestBodyRuntime extends $dara.Model {
   compute?: UpdateManagedAgentRequestBodyRuntimeCompute;
   /**
    * @remarks
-   * The Sandbox auto scaling and session configuration.
+   * The sandbox auto-scaling and session configuration.
    */
   hpa?: UpdateManagedAgentRequestBodyRuntimeHpa;
   /**
@@ -725,9 +775,7 @@ export class UpdateManagedAgentRequestBodyRuntime extends $dara.Model {
 export class UpdateManagedAgentRequestBodySkillsVersionSelector extends $dara.Model {
   /**
    * @remarks
-   * The version selector type. Valid values:
-   * - LABEL: select by label.
-   * - VERSION: select by specific version.
+   * The version selector type. Valid values: LABEL (selects by tag) and VERSION (selects by specific version).
    * 
    * @example
    * LABEL
@@ -735,7 +783,7 @@ export class UpdateManagedAgentRequestBodySkillsVersionSelector extends $dara.Mo
   type?: string;
   /**
    * @remarks
-   * The selector value. If the type is LABEL, specify a label name such as latest. If the type is VERSION, specify a specific version number.
+   * The value of the selector. When the type is LABEL, this is the tag name, such as latest. When the type is VERSION, this is the specific version number.
    * 
    * @example
    * latest
@@ -777,9 +825,7 @@ export class UpdateManagedAgentRequestBodySkills extends $dara.Model {
   name?: string;
   /**
    * @remarks
-   * The skill source type. Valid values:
-   * - REFERENCE: referenced from AI Registry.
-   * - STATIC: statically bundled with the package.
+   * The skill source type. Valid values: REFERENCE (references the AI Registry) and STATIC (statically provided with the package).
    * 
    * @example
    * REFERENCE
@@ -795,7 +841,7 @@ export class UpdateManagedAgentRequestBodySkills extends $dara.Model {
   version?: string;
   /**
    * @remarks
-   * The version selector for the reference. Defaults to LABEL/latest if omitted. Currently supports LABEL/latest.
+   * The referenced version selector. If omitted, the default value is LABEL/latest. Currently, only LABEL/latest is supported.
    */
   versionSelector?: UpdateManagedAgentRequestBodySkillsVersionSelector;
   static names(): { [key: string]: string } {
@@ -831,7 +877,7 @@ export class UpdateManagedAgentRequestBodySkills extends $dara.Model {
 export class UpdateManagedAgentRequestBodySubAgentsSkills extends $dara.Model {
   /**
    * @remarks
-   * The skill name used by the sub-agent. Declared as optional for compatibility, but the backend validates that each entry is required.
+   * The skill name.
    * 
    * @example
    * web-search
@@ -839,7 +885,7 @@ export class UpdateManagedAgentRequestBodySubAgentsSkills extends $dara.Model {
   name?: string;
   /**
    * @remarks
-   * The optional version number. If omitted, set to null, or left blank, the latest version is resolved.
+   * The skill version.
    * 
    * @example
    * 1.0.0
@@ -876,7 +922,7 @@ export class UpdateManagedAgentRequestBodySubAgents extends $dara.Model {
    * This parameter is required.
    * 
    * @example
-   * Please review the code
+   * Review the code
    */
   instruction?: string;
   /**
@@ -891,7 +937,7 @@ export class UpdateManagedAgentRequestBodySubAgents extends $dara.Model {
   name?: string;
   /**
    * @remarks
-   * The skills exclusively used by this sub-agent. Skill names must be unique within the same sub-agent. If this parameter is not specified or an empty array is passed, no skills are configured.
+   * The list of sub-agent skills.
    */
   skills?: UpdateManagedAgentRequestBodySubAgentsSkills[];
   static names(): { [key: string]: string } {
@@ -925,7 +971,7 @@ export class UpdateManagedAgentRequestBodySubAgents extends $dara.Model {
 export class UpdateManagedAgentRequestBodyTemplateAiRegistry extends $dara.Model {
   /**
    * @remarks
-   * The name of the template in AI Registry.
+   * The name of the template in the AI registry.
    * 
    * This parameter is required.
    * 
@@ -935,7 +981,7 @@ export class UpdateManagedAgentRequestBodyTemplateAiRegistry extends $dara.Model
   name?: string;
   /**
    * @remarks
-   * The version of the template in AI Registry.
+   * The version of the template in the AI registry.
    * 
    * @example
    * 1.0.0
@@ -967,7 +1013,7 @@ export class UpdateManagedAgentRequestBodyTemplateAiRegistry extends $dara.Model
 export class UpdateManagedAgentRequestBodyTemplate extends $dara.Model {
   /**
    * @remarks
-   * The AI Registry template configuration.
+   * The AI registry template configuration.
    */
   aiRegistry?: UpdateManagedAgentRequestBodyTemplateAiRegistry;
   static names(): { [key: string]: string } {
@@ -1041,7 +1087,7 @@ export class UpdateManagedAgentRequestBodyTools extends $dara.Model {
 export class UpdateManagedAgentRequestBody extends $dara.Model {
   /**
    * @remarks
-   * Omit to retain existing values, pass [] to clear, or pass a non-empty array for full replacement. null is rejected. Combined with OSS mounts, a maximum of 10 items are allowed.
+   * The AgenticFS mounts. If omitted during an update, the existing mounts are retained. If an empty array is passed, the mounts are cleared. If a non-empty array is passed, the mounts are fully replaced. Null values are rejected. The total number of AgenticFS and OSS mounts cannot exceed 10.
    */
   agenticFsMounts?: UpdateManagedAgentRequestBodyAgenticFsMounts[];
   /**
@@ -1049,7 +1095,7 @@ export class UpdateManagedAgentRequestBody extends $dara.Model {
    * The description of the managed agent.
    * 
    * @example
-   * An agent for code review
+   * Agent for code review
    */
   description?: string;
   /**
@@ -1059,12 +1105,12 @@ export class UpdateManagedAgentRequestBody extends $dara.Model {
   environment?: UpdateManagedAgentRequestBodyEnvironment;
   /**
    * @remarks
-   * The agent runtime harness.
+   * The agent runtime framework.
    */
   harness?: UpdateManagedAgentRequestBodyHarness;
   /**
    * @remarks
-   * The agent instruction that guides the behavior of the agent.
+   * The agent instructions used to guide the behavior of the agent.
    * 
    * @example
    * You are a code review assistant
@@ -1093,6 +1139,11 @@ export class UpdateManagedAgentRequestBody extends $dara.Model {
    * The list of OSS mounts. A maximum of 10 items are allowed. Pass an empty array to clear existing mounts.
    */
   ossMounts?: UpdateManagedAgentRequestBodyOssMounts[];
+  /**
+   * @remarks
+   * The prompt variable declarations.
+   */
+  promptVariables?: UpdateManagedAgentRequestBodyPromptVariables[];
   /**
    * @remarks
    * The runtime configuration.
@@ -1129,6 +1180,7 @@ export class UpdateManagedAgentRequestBody extends $dara.Model {
       name: 'name',
       network: 'network',
       ossMounts: 'ossMounts',
+      promptVariables: 'promptVariables',
       runtime: 'runtime',
       skills: 'skills',
       subAgents: 'subAgents',
@@ -1148,6 +1200,7 @@ export class UpdateManagedAgentRequestBody extends $dara.Model {
       name: 'string',
       network: UpdateManagedAgentRequestBodyNetwork,
       ossMounts: { 'type': 'array', 'itemType': UpdateManagedAgentRequestBodyOssMounts },
+      promptVariables: { 'type': 'array', 'itemType': UpdateManagedAgentRequestBodyPromptVariables },
       runtime: UpdateManagedAgentRequestBodyRuntime,
       skills: { 'type': 'array', 'itemType': UpdateManagedAgentRequestBodySkills },
       subAgents: { 'type': 'array', 'itemType': UpdateManagedAgentRequestBodySubAgents },
@@ -1175,6 +1228,9 @@ export class UpdateManagedAgentRequestBody extends $dara.Model {
     if(Array.isArray(this.ossMounts)) {
       $dara.Model.validateArray(this.ossMounts);
     }
+    if(Array.isArray(this.promptVariables)) {
+      $dara.Model.validateArray(this.promptVariables);
+    }
     if(this.runtime && typeof (this.runtime as any).validate === 'function') {
       (this.runtime as any).validate();
     }
@@ -1206,7 +1262,7 @@ export class UpdateManagedAgentRequest extends $dara.Model {
   body?: UpdateManagedAgentRequestBody;
   /**
    * @remarks
-   * The reserved idempotency token. The backend does not provide idempotency guarantees in the current release.
+   * The reserved idempotency token. The backend does not provide idempotency guarantees in the current phase.
    * 
    * @example
    * client-token-1