@alicloud/agentcore20260804 3.0.1 → 3.1.0

package/src/models/UpdateCustomAgentRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class UpdateCustomAgentRequestBodyAgenticFsMounts extends $dara.Model {
   /**
    * @remarks
-   * The subdirectory under /mnt/agenticfs/ in the container. This field is required for each mount item. Mount targets must not be duplicated or form parent-child overrides.
+   * The subdirectory under /mnt/agenticfs/ in the container. This field is required for each mount item and is validated by the backend. Mount targets cannot be duplicated or overlap in a parent-child relationship.
    * 
    * @example
    * /mnt/agenticfs/data
@@ -13,7 +13,7 @@ export class UpdateCustomAgentRequestBodyAgenticFsMounts extends $dara.Model {
   mountPath?: string;
   /**
    * @remarks
-   * The existing non-empty relative directory under the access point. This field is required for each mount item. Root directories, absolute paths, and parent directory traversals are not allowed.
+   * The existing non-empty relative directory under the access point. This field is required for each mount item and is validated by the backend. Root directories, absolute paths, and parent directory traversals are not allowed.
    * 
    * @example
    * workspace/data
@@ -21,7 +21,7 @@ export class UpdateCustomAgentRequestBodyAgenticFsMounts extends $dara.Model {
   path?: string;
   /**
    * @remarks
-   * Specifies whether the mount is read-only. A value of true indicates read-only, and a value of false indicates read and write. If this field is omitted, the default value is false.
+   * Specifies whether the mount is read-only. A value of true indicates read-only, and a value of false indicates read and write. If omitted, the default value is false.
    * 
    * @example
    * false
@@ -29,7 +29,7 @@ export class UpdateCustomAgentRequestBodyAgenticFsMounts extends $dara.Model {
   readOnly?: boolean;
   /**
    * @remarks
-   * The domain name of the access point. This field is required for each mount item. Use the DomainName value from the response of the NAS ListAccessPoints operation. Do not include the protocol, port, or path.
+   * The domain name of the access point. This field is required for each mount item and is validated by the backend. Use the DomainName value from the ListAccessPoints response of NAS. Do not include the protocol, port, or path.
    * 
    * @example
    * ap-0123456789abcdef0.0123456789-vlm36.cn-hangzhou.nas.aliyuncs.com
@@ -65,9 +65,7 @@ export class UpdateCustomAgentRequestBodyAgenticFsMounts extends $dara.Model {
 export class UpdateCustomAgentRequestBodyArtifactCode extends $dara.Model {
   /**
    * @remarks
-   * The startup command for the code package. This field is required in code package mode. The working directory is the extracted code root directory /code, such as python main.py. Quotes and escapes are supported. Environment variables, pipes, and logical operations are not automatically expanded. For complex commands, use scripts within the package.
-   * 
-   * This parameter is required.
+   * The startup command for the code package. This field is required in code package mode. The working directory is the extracted code root directory /code, such as python main.py. Quotes and escapes are supported. Environment variables, pipes, and logical operations are not automatically expanded. Use scripts within the package for complex commands.
    * 
    * @example
    * python main.py
@@ -75,9 +73,7 @@ export class UpdateCustomAgentRequestBodyArtifactCode extends $dara.Model {
   entrypoint?: string;
   /**
    * @remarks
-   * The code runtime environment identifier, such as python3.12. When creating or switching environments, use the identifier returned by the ListAgentCodeRuntimes operation. The identifier is validated by the current version catalog and is not a fixed enumeration.
-   * 
-   * This parameter is required.
+   * The code runtime environment identifier, such as python3.12. When you create or switch environments, use the identifier returned by ListAgentCodeRuntimes. The identifier is validated by the current version catalog and is not a fixed enumeration.
    * 
    * @example
    * python3.12
@@ -85,9 +81,7 @@ export class UpdateCustomAgentRequestBodyArtifactCode extends $dara.Model {
   languageRuntime?: string;
   /**
    * @remarks
-   * The source address of the code package. This field supports oss:// addresses or HTTPS object addresses of standard OSS public domain names, including OSS signed URLs. Arbitrary external sites, custom domain names, and additional authentication request headers are not supported. After a local upload, use the sourceUri returned by the GetAgentCodePackageUploadUrl operation. The address is revalidated and transferred during creation or updates. After the transfer is saved, the platform returns a fixed oss:// address. This fixed address can be reused for regular updates.
-   * 
-   * This parameter is required.
+   * The source address of the code package. This field supports oss:// addresses or HTTPS object addresses of standard OSS public domain names, including OSS signed URLs. External sites, custom domain names, and additional authentication request headers are not supported. For local uploads, use the sourceUri returned by GetAgentCodePackageUploadUrl. The address is revalidated and transferred during creation or update. After the address is saved, a fixed oss:// address of the platform is returned. You can reuse this fixed address for regular updates.
    * 
    * @example
    * oss://my-agent-bucket/packages/main.zip
@@ -121,7 +115,7 @@ export class UpdateCustomAgentRequestBodyArtifactCode extends $dara.Model {
 export class UpdateCustomAgentRequestBodyArtifactContainer extends $dara.Model {
   /**
    * @remarks
-   * The optional executable program and startup parameters. If specified, this field must be a non-empty string. When updating the artifact, omitting this field uses the default startup method of the image. To retain the original custom startup command, provide this field together.
+   * The optional executable program and startup parameters. If specified, this field must be a non-empty string. When you update the artifact, omitting this field uses the default startup method of the image. To retain the original custom startup command, you must provide this field.
    * 
    * @example
    * python app.py
@@ -131,8 +125,6 @@ export class UpdateCustomAgentRequestBodyArtifactContainer extends $dara.Model {
    * @remarks
    * The ID of the ACR instance to which the image repository belongs. This field cannot be empty.
    * 
-   * This parameter is required.
-   * 
    * @example
    * cri-a1b2c3d4e5f6
    */
@@ -141,8 +133,6 @@ export class UpdateCustomAgentRequestBodyArtifactContainer extends $dara.Model {
    * @remarks
    * The namespace to which the ACR image repository belongs. This field cannot be empty.
    * 
-   * This parameter is required.
-   * 
    * @example
    * my-agent
    */
@@ -151,17 +141,13 @@ export class UpdateCustomAgentRequestBodyArtifactContainer extends $dara.Model {
    * @remarks
    * The name of the image repository in the ACR namespace. This field cannot be empty.
    * 
-   * This parameter is required.
-   * 
    * @example
    * chat-agent
    */
   repo?: string;
   /**
    * @remarks
-   * The image tag used for deployment. This field cannot be empty. When updating the tag, you must also provide artifact.port and other required image fields.
-   * 
-   * This parameter is required.
+   * The image tag used for deployment. This field cannot be empty. When you update the tag, you must also provide artifact.port and other required image fields.
    * 
    * @example
    * v1.0.0
@@ -169,9 +155,7 @@ export class UpdateCustomAgentRequestBodyArtifactContainer extends $dara.Model {
   tag?: string;
   /**
    * @remarks
-   * The image source type. Currently, only acr is supported, which indicates Alibaba Cloud Container Registry (ACR).
-   * 
-   * This parameter is required.
+   * The image source type. Only acr is supported, which indicates Container Registry.
    * 
    * @example
    * acr
@@ -223,8 +207,6 @@ export class UpdateCustomAgentRequestBodyArtifact extends $dara.Model {
    * @remarks
    * The TCP port listened by the agent service. Valid values: 1 to 65535.
    * 
-   * This parameter is required.
-   * 
    * @example
    * 8080
    */
@@ -260,6 +242,136 @@ export class UpdateCustomAgentRequestBodyArtifact extends $dara.Model {
   }
 }
 
+export class UpdateCustomAgentRequestBodyCustomImagePullNetwork extends $dara.Model {
+  /**
+   * @remarks
+   * The ID of the security group. This field is required when type is set to vpc and must belong to the selected VPC.
+   * 
+   * @example
+   * sg-example
+   */
+  securityGroupId?: string;
+  /**
+   * @remarks
+   * The type of the pull network. This field is required when you submit pullNetwork and is validated by the backend. The default value for a new configuration is public network, which is independent of the agent runtime network.
+   * 
+   * @example
+   * public
+   */
+  type?: string;
+  /**
+   * @remarks
+   * The ID of the security group. This field is required when type is set to vpc and must belong to the selected VPC.
+   * 
+   * @example
+   * vsw-example
+   */
+  vSwitchId?: string;
+  /**
+   * @remarks
+   * The ID of the VPC. This field is required when type is set to vpc. The associated account and region are validated by the backend.
+   * 
+   * @example
+   * vpc-example
+   */
+  vpcId?: string;
+  static names(): { [key: string]: string } {
+    return {
+      securityGroupId: 'securityGroupId',
+      type: 'type',
+      vSwitchId: 'vSwitchId',
+      vpcId: 'vpcId',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      securityGroupId: 'string',
+      type: 'string',
+      vSwitchId: 'string',
+      vpcId: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class UpdateCustomAgentRequestBodyCustomImage extends $dara.Model {
+  /**
+   * @remarks
+   * The custom image address. This field is required when you submit customImage and is validated by the backend. Specify the full registry[:port]/repository:tag or registry[:port]/repository@sha256:digest format. Multi-level paths are supported. Do not include the protocol or user information.
+   * 
+   * @example
+   * registry.example.com/team/agent:v1
+   */
+  image?: string;
+  /**
+   * @remarks
+   * The repository password or token for the current task. Submit a non-empty value in pairs with the username field. The value is not trimmed and cannot be null, an empty string, or a masked value. This field is used only for the current task and is not permanently saved or returned. To use anonymous access, omit both fields.
+   * 
+   * @example
+   * example-registry-token
+   */
+  password?: string;
+  /**
+   * @remarks
+   * The independent network configuration for pulling images. This field is required when you submit customImage and is validated by the backend. For public networks, only pass type=public.
+   */
+  pullNetwork?: UpdateCustomAgentRequestBodyCustomImagePullNetwork;
+  /**
+   * @remarks
+   * Specifies whether to skip HTTPS certificate verification. If omitted, the default value is false. This field does not accept null. HTTP fallback semantics are still under discussion and do not affect the current field definition. The image address does not include a protocol.
+   * 
+   * @example
+   * false
+   */
+  skipTlsVerify?: boolean;
+  /**
+   * @remarks
+   * The repository username for the current task. When you create or explicitly update a private source, resubmit this field in pairs with the password field. Existing copies also require verification. To use anonymous access, omit both fields. A read-only username is not automatically used as the input for the current task.
+   * 
+   * @example
+   * reader
+   */
+  username?: string;
+  static names(): { [key: string]: string } {
+    return {
+      image: 'image',
+      password: 'password',
+      pullNetwork: 'pullNetwork',
+      skipTlsVerify: 'skipTlsVerify',
+      username: 'username',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      image: 'string',
+      password: 'string',
+      pullNetwork: UpdateCustomAgentRequestBodyCustomImagePullNetwork,
+      skipTlsVerify: 'boolean',
+      username: 'string',
+    };
+  }
+
+  validate() {
+    if(this.pullNetwork && typeof (this.pullNetwork as any).validate === 'function') {
+      (this.pullNetwork as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class UpdateCustomAgentRequestBodyEnvironmentVariables extends $dara.Model {
   /**
    * @remarks
@@ -273,7 +385,7 @@ export class UpdateCustomAgentRequestBodyEnvironmentVariables extends $dara.Mode
   name?: string;
   /**
    * @remarks
-   * The value of the environment variable. This field must be a string. Empty strings are allowed.
+   * The value of the environment variable. This field must be a string and can be an empty string.
    * 
    * This parameter is required.
    * 
@@ -337,15 +449,17 @@ export class UpdateCustomAgentRequestBodyEnvironment extends $dara.Model {
 export class UpdateCustomAgentRequestBodyHealthCheck extends $dara.Model {
   /**
    * @remarks
-   * This parameter currently does not take effect. Omit this field.
+   * This parameter does not take effect. Omit this parameter.
    * 
    * @example
    * 1
+   * 
+   * @deprecated
    */
   healthyThreshold?: number;
   /**
    * @remarks
-   * The interval between two health checks, in seconds. This field must be a positive integer. If this field is omitted, the default value is 10.
+   * The interval between two consecutive health checks, in seconds. The value must be a positive integer. Default value: 10.
    * 
    * @example
    * 10
@@ -353,7 +467,7 @@ export class UpdateCustomAgentRequestBodyHealthCheck extends $dara.Model {
   intervalSeconds?: number;
   /**
    * @remarks
-   * The HTTP health check path. This field must start with a forward slash (/). If this field is omitted, the default value is /healthz.
+   * The HTTP health check path. The path must start with a forward slash (/). Default value: /healthz.
    * 
    * @example
    * /healthz
@@ -361,7 +475,7 @@ export class UpdateCustomAgentRequestBodyHealthCheck extends $dara.Model {
   path?: string;
   /**
    * @remarks
-   * The port accessed by the health check. This field is required when configuring a health check. Valid values: 1 to 65535.
+   * The port used for health checks. This field is required when you configure a health check. Valid values: 1 to 65535.
    * 
    * @example
    * 8080
@@ -369,7 +483,7 @@ export class UpdateCustomAgentRequestBodyHealthCheck extends $dara.Model {
   port?: number;
   /**
    * @remarks
-   * The timeout period for a single health check, in seconds. This field must be a positive integer and less than intervalSeconds. If this field is omitted, the default value is 2.
+   * The timeout period for a single health check, in seconds. The value must be a positive integer and less than the value of intervalSeconds. Default value: 2.
    * 
    * @example
    * 2
@@ -377,7 +491,7 @@ export class UpdateCustomAgentRequestBodyHealthCheck extends $dara.Model {
   timeoutSeconds?: number;
   /**
    * @remarks
-   * The number of consecutive health check failures before the agent is considered unhealthy. This field must be a positive integer. If this field is omitted, the default value is 3.
+   * The number of consecutive health check failures required to mark the target as unhealthy. The value must be a positive integer. Default value: 3.
    * 
    * @example
    * 3
@@ -417,7 +531,7 @@ export class UpdateCustomAgentRequestBodyHealthCheck extends $dara.Model {
 export class UpdateCustomAgentRequestBodyLoggingSls extends $dara.Model {
   /**
    * @remarks
-   * The name of the SLS logstore that receives agent logs.
+   * The name of the SLS Logstore that receives agent logs.
    * 
    * @example
    * agent-runtime
@@ -457,7 +571,7 @@ export class UpdateCustomAgentRequestBodyLoggingSls extends $dara.Model {
 export class UpdateCustomAgentRequestBodyLogging extends $dara.Model {
   /**
    * @remarks
-   * The SLS log delivery destination. When updating this object, you must provide both the project and logstore fields, and they cannot be empty.
+   * The SLS log delivery destination. When you update this object, you must provide both the project and logstore fields, and they cannot be empty.
    */
   sls?: UpdateCustomAgentRequestBodyLoggingSls;
   static names(): { [key: string]: string } {
@@ -487,7 +601,7 @@ export class UpdateCustomAgentRequestBodyLogging extends $dara.Model {
 export class UpdateCustomAgentRequestBodyNetworkAccessInternet extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to allow the agent to access the Internet. When configuring accessInternet, you must provide a Boolean value. For this configuration to take effect, the workspace must also allow Internet access.
+   * Specifies whether to allow the agent to access the Internet. A Boolean value is required when you configure accessInternet. For this setting to take effect, Internet access must also be allowed by the workspace.
    */
   enabled?: boolean;
   static names(): { [key: string]: string } {
@@ -514,7 +628,7 @@ export class UpdateCustomAgentRequestBodyNetworkAccessInternet extends $dara.Mod
 export class UpdateCustomAgentRequestBodyNetworkAccessVpc extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to allow the agent to access the user VPC configured in the workspace. When configuring accessVpc, you must provide a Boolean value. For this configuration to take effect, the workspace must also allow VPC access.
+   * Specifies whether to allow the agent to access the user VPC configured for the workspace. A Boolean value is required when you configure accessVpc. For this setting to take effect, VPC access must also be allowed by the workspace.
    */
   enabled?: boolean;
   static names(): { [key: string]: string } {
@@ -541,12 +655,12 @@ export class UpdateCustomAgentRequestBodyNetworkAccessVpc extends $dara.Model {
 export class UpdateCustomAgentRequestBodyNetwork extends $dara.Model {
   /**
    * @remarks
-   * The Internet access configuration. When this access item is omitted, the agent does not restrict Internet access. However, the workspace must still allow Internet access.
+   * The Internet access configuration. If this access item is omitted, the agent does not restrict Internet access. However, Internet access must still be allowed by the workspace.
    */
   accessInternet?: UpdateCustomAgentRequestBodyNetworkAccessInternet;
   /**
    * @remarks
-   * The user VPC access configuration. When this access item is omitted, the agent does not restrict VPC access. However, the workspace must still be configured to allow access to the user VPC.
+   * The user VPC access configuration. If this access item is omitted, the agent does not restrict VPC access. However, the workspace must be configured to allow access to the user VPC.
    */
   accessVpc?: UpdateCustomAgentRequestBodyNetworkAccessVpc;
   static names(): { [key: string]: string } {
@@ -608,7 +722,7 @@ export class UpdateCustomAgentRequestBodyObservability extends $dara.Model {
 export class UpdateCustomAgentRequestBodyOssMounts extends $dara.Model {
   /**
    * @remarks
-   * The name of the OSS bucket. This parameter is required for each mount item. The name must be 3 to 63 characters in length and can contain only lowercase letters, digits, and hyphens. It cannot start or end with a hyphen.
+   * The name of the OSS bucket. This field is required for each mount item. The name must be 3 to 63 characters in length and can contain only lowercase letters, digits, and hyphens (-). It cannot start or end with a hyphen.
    * 
    * @example
    * my-agent-data
@@ -616,7 +730,7 @@ export class UpdateCustomAgentRequestBodyOssMounts extends $dara.Model {
   bucketName?: string;
   /**
    * @remarks
-   * The subdirectory under /mnt/oss/ in the container. This parameter is required for each mount item. Mount targets must not be duplicated or form parent-child overlaps.
+   * The subdirectory under /mnt/oss/ in the container. This field is required for each mount item. Mount targets cannot be duplicated or form parent-child overlaps.
    * 
    * @example
    * /mnt/oss/train
@@ -624,7 +738,7 @@ export class UpdateCustomAgentRequestBodyOssMounts extends $dara.Model {
   mountPath?: string;
   /**
    * @remarks
-   * The non-empty object directory prefix in the bucket, such as datasets/train. Leading and trailing slashes are removed. The root directory is not supported. Do not use parent directory navigation.
+   * The non-empty object directory prefix in the bucket, such as datasets/train. Leading and trailing forward slashes (/) are removed. The root directory is not supported. Do not use parent directory navigation.
    * 
    * @example
    * datasets/train
@@ -632,7 +746,7 @@ export class UpdateCustomAgentRequestBodyOssMounts extends $dara.Model {
   path?: string;
   /**
    * @remarks
-   * Specifies whether the mount is read-only. A value of true indicates read-only, and a value of false indicates read and write. If this field is omitted, the default value is false.
+   * Specifies whether the mount is read-only. A value of true indicates read-only, and a value of false indicates read and write. If omitted, the default value is false.
    */
   readOnly?: boolean;
   static names(): { [key: string]: string } {
@@ -665,7 +779,7 @@ export class UpdateCustomAgentRequestBodyOssMounts extends $dara.Model {
 export class UpdateCustomAgentRequestBodyProtocolPaths extends $dara.Model {
   /**
    * @remarks
-   * The usage description of the current API path.
+   * The purpose description of the current API path.
    * 
    * @example
    * AG-UI conversation API
@@ -673,7 +787,7 @@ export class UpdateCustomAgentRequestBodyProtocolPaths extends $dara.Model {
   description?: string;
   /**
    * @remarks
-   * The non-empty API path for the current protocol.
+   * The non-empty API path corresponding to the current protocol.
    * 
    * This parameter is required.
    * 
@@ -712,7 +826,7 @@ export class UpdateCustomAgentRequestBodyProtocol extends $dara.Model {
   headers?: { [key: string]: string };
   /**
    * @remarks
-   * The list of API paths for the current protocol.
+   * The list of API paths corresponding to the current protocol.
    */
   paths?: UpdateCustomAgentRequestBodyProtocolPaths[];
   /**
@@ -762,7 +876,7 @@ export class UpdateCustomAgentRequestBodyProtocol extends $dara.Model {
 export class UpdateCustomAgentRequestBodyRuntimeCompute extends $dara.Model {
   /**
    * @remarks
-   * The compute specification. Valid values:
+   * The computing specification. Valid values:
    * - INTERACTIVE: 1 vCPU and 2 GiB of memory.
    * - STANDARD: 2 vCPUs and 4 GiB of memory.
    * - HEAVY: 4 vCPUs and 8 GiB of memory.
@@ -797,10 +911,7 @@ export class UpdateCustomAgentRequestBodyRuntimeCompute extends $dara.Model {
 export class UpdateCustomAgentRequestBodyRuntimeHpa extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to enable elastic scaling. Valid values:
-   * - true: Enabled.
-   * - false: Disabled.
-   * Default value: false. This default value applies when runtime is provided and this field is omitted.
+   * Specifies whether to enable elastic scaling. A value of true indicates that elastic scaling is enabled. A value of false indicates that elastic scaling is disabled. When runtime is provided, omitting this field defaults to false.
    * 
    * This parameter is required.
    */
@@ -815,7 +926,7 @@ export class UpdateCustomAgentRequestBodyRuntimeHpa extends $dara.Model {
   maxConcurrentSessionsPerSandbox?: number;
   /**
    * @remarks
-   * The maximum number of runtime instances. Valid values: 1 to 100. The value cannot be less than minSandboxCount. When runtime is provided, omitting this field uses the default value of 10.
+   * The maximum number of runtime instances. Valid values: 1 to 100. The value cannot be less than the value of minSandboxCount. When runtime is provided, omitting this field uses the default value of 10.
    * 
    * @example
    * 10
@@ -823,7 +934,7 @@ export class UpdateCustomAgentRequestBodyRuntimeHpa extends $dara.Model {
   maxSandboxCount?: number;
   /**
    * @remarks
-   * The minimum number of runtime instances. Valid values: 1 to 100. The value cannot be greater than maxSandboxCount. When runtime is provided, omitting this field uses the default value of 1.
+   * The minimum number of runtime instances. Valid values: 1 to 100. The value cannot be greater than the value of maxSandboxCount. When runtime is provided, omitting this field uses the default value of 1.
    * 
    * @example
    * 1
@@ -831,7 +942,7 @@ export class UpdateCustomAgentRequestBodyRuntimeHpa extends $dara.Model {
   minSandboxCount?: number;
   /**
    * @remarks
-   * The session idle timeout in seconds. Valid values: 60 to 86400. When runtime is provided, omitting this field uses the default value of 600.
+   * The session idle timeout limit, in seconds. Valid values: 60 to 86400. When runtime is provided, omitting this field uses the default value of 600.
    * 
    * @example
    * 600
@@ -869,7 +980,7 @@ export class UpdateCustomAgentRequestBodyRuntimeHpa extends $dara.Model {
 export class UpdateCustomAgentRequestBodyRuntimeSessionPolicy extends $dara.Model {
   /**
    * @remarks
-   * The name of the HTTP request header used by the session policy. This parameter is required when type is set to ISOLATED_HEADER_FIELD and must be a valid HTTP request header name. Omit this parameter for other policies.
+   * The name of the HTTP request header used by the session policy. This field is required when type is set to ISOLATED_HEADER_FIELD and must be a valid HTTP request header name. Omit this field for other policies.
    * 
    * @example
    * X-Session-Id
@@ -879,9 +990,9 @@ export class UpdateCustomAgentRequestBodyRuntimeSessionPolicy extends $dara.Mode
    * @remarks
    * The session policy type. Valid values:
    * - AFFINITY: Session affinity.
-   * - ISOLATED_HEADER_FIELD: Associates sessions by using the request header specified by headerName.
-   * - ISOLATED_COOKIE: Cookie-based session policy. This value is not recommended.
-   * - DISABLED: Compatibility option. The response returns AFFINITY.
+   * - ISOLATED_HEADER_FIELD: Associates sessions by using the request header specified in headerName.
+   * - ISOLATED_COOKIE: Not recommended.
+   * - DISABLED: A compatibility option. The response returns AFFINITY.
    * 
    * This parameter is required.
    * 
@@ -922,12 +1033,12 @@ export class UpdateCustomAgentRequestBodyRuntime extends $dara.Model {
   compute?: UpdateCustomAgentRequestBodyRuntimeCompute;
   /**
    * @remarks
-   * The optional elastic policy. When runtime is provided, omitting hpa or its fields uses the default values: enabled is false, the minimum number of instances is 1, the maximum number of instances is 10, the maximum number of concurrent sessions per instance is 100, and the session idle timeout is 600 seconds. To retain the original policy during an update, provide the complete hpa configuration.
+   * The optional elastic policy. When runtime is provided, omitting hpa or its fields uses the following default values: enabled is false, the minimum number of instances is 1, the maximum number of instances is 10, the maximum number of concurrent sessions per instance is 100, and the session idle timeout is 600 seconds. To retain the original policy during an update, provide the complete hpa configuration.
    */
   hpa?: UpdateCustomAgentRequestBodyRuntimeHpa;
   /**
    * @remarks
-   * The session policy configuration used to set the session association method for requests.
+   * The session policy configuration used to set the session affinity method for requests.
    * 
    * This parameter is required.
    */
@@ -969,17 +1080,22 @@ export class UpdateCustomAgentRequestBodyRuntime extends $dara.Model {
 export class UpdateCustomAgentRequestBody extends $dara.Model {
   /**
    * @remarks
-   * The list of additional AgenticFS mounts. The total number of AgenticFS mounts and ossMounts cannot exceed 10. During creation, omitting this field or passing an empty array [] indicates no additional mounts. During an update, omitting this field retains the original value, and passing an empty array [] clears the list. You cannot pass null.
+   * The list of additional AgenticFS mounts. The total number of AgenticFS mounts and OSS mounts cannot exceed 10. If you omit this field or pass an empty array [] during creation, no additional mounts are configured. During an update, omitting this field retains the original value, and passing an empty array [] clears the list. You cannot pass null.
    */
   agenticFsMounts?: UpdateCustomAgentRequestBodyAgenticFsMounts[];
   /**
    * @remarks
-   * The deployment artifact configuration. You must specify the service listening port in the port field and choose either the code or container deployment method. During an update, you must provide the required fields for the selected method.
+   * The deployment artifact configuration. You must specify the service listening port and choose either code or container as the deployment method. During an update, you must provide the required fields for the selected method.
    */
   artifact?: UpdateCustomAgentRequestBodyArtifact;
   /**
    * @remarks
-   * The description of the agent purpose. The maximum length is 1,024 characters after leading and trailing whitespaces are removed. Omitting this field retains the original value. Pass null to clear the description.
+   * The custom image configuration. Omitting this field retains the original source. Submitting the complete configuration indicates an active update of the custom image. You do not need to submit this field if only the port and startup command change.
+   */
+  customImage?: UpdateCustomAgentRequestBodyCustomImage;
+  /**
+   * @remarks
+   * The description of the agent purpose. The description can be up to 1,024 characters in length after leading and trailing spaces are removed. If omitted, the original value is retained. Pass null to clear the description.
    * 
    * @example
    * Custom agent that provides conversation services
@@ -992,17 +1108,17 @@ export class UpdateCustomAgentRequestBody extends $dara.Model {
   environment?: UpdateCustomAgentRequestBodyEnvironment;
   /**
    * @remarks
-   * The optional HTTP health check configuration. When providing this object, you must specify the port field. Other unspecified items use default values. Omitting this field during creation indicates no configuration. During an update, omitting this top-level field retains the original configuration, and passing null removes the health check.
+   * The optional HTTP health check configuration. When this object is provided, the port field is required, and other unspecified fields use default values. Omitting this object during creation means no health check is configured. During an update, omitting this top-level field retains the original configuration, and passing null removes the health check.
    */
   healthCheck?: UpdateCustomAgentRequestBodyHealthCheck;
   /**
    * @remarks
-   * The log delivery configuration for the agent. You can specify the Simple Log Service (SLS) project and logstore. After a successful creation or update, verify whether logs are delivered properly.
+   * The log delivery configuration for the agent. You can specify the Simple Log Service (SLS) project and Logstore. After a successful creation or update, verify that logs are delivered as expected.
    */
   logging?: UpdateCustomAgentRequestBodyLogging;
   /**
    * @remarks
-   * The name of the custom agent. The length is 1 to 128 characters after leading and trailing whitespaces are removed. The name must be unique within the same workspace. Omitting this field retains the original value. You cannot pass null or a blank name.
+   * The custom name of the agent. The name must be 1 to 128 characters in length after leading and trailing spaces are removed, and must be unique within the same workspace. Omitting this field retains the original value. You cannot pass null or an empty name.
    * 
    * @example
    * my-custom-agent
@@ -1010,7 +1126,7 @@ export class UpdateCustomAgentRequestBody extends $dara.Model {
   name?: string;
   /**
    * @remarks
-   * The network access configuration for the agent. When providing this object, omitted access items are treated as allowed. The actual accessible range is still restricted by the workspace network configuration. To retain the original restrictions during an update, specify both accessInternet and accessVpc.
+   * The network access configuration for the agent. When this object is provided, omitted access items are treated as allowed. The actual accessible scope is still restricted by the network configuration of the workspace. To retain the original restrictions during an update, specify both accessInternet and accessVpc.
    */
   network?: UpdateCustomAgentRequestBodyNetwork;
   /**
@@ -1020,17 +1136,17 @@ export class UpdateCustomAgentRequestBody extends $dara.Model {
   observability?: UpdateCustomAgentRequestBodyObservability;
   /**
    * @remarks
-   * The OSS mount list. A maximum of 10 items in total with agenticFsMounts. Each item must include bucketName, path, and mountPath. Mount targets must not be duplicated or overlap. The entire list is replaced during an update. Pass an empty array to clear the list.
+   * The list of Object Storage Service (OSS) mounts. The total number of OSS mounts and agenticFsMounts cannot exceed 10. For each item, you must specify bucketName, path, and mountPath. Mount targets cannot be duplicated or overlap with each other. During an update, this list is replaced entirely. Pass an empty array to clear all mounts.
    */
   ossMounts?: UpdateCustomAgentRequestBodyOssMounts[];
   /**
    * @remarks
-   * The list of invocation protocols supported by the agent. Each item includes the protocol type and optional paths and request headers. The entire list is replaced during an update.
+   * The list of invocation protocols supported by the agent. Each item includes the protocol type and optional paths and request headers. During an update, this list is replaced entirely.
    */
   protocol?: UpdateCustomAgentRequestBodyProtocol[];
   /**
    * @remarks
-   * The ARN of the RAM role used when the agent accesses user cloud resources. The role must have permissions to access the cloud resources.
+   * The Alibaba Cloud Resource Name (ARN) of the Resource Access Management (RAM) role used by the agent to access user cloud resources. The role must have the required permissions for the accessed cloud resources.
    * 
    * @example
    * acs:ram::1234567890123456:role/agentcore-runtime-role
@@ -1038,12 +1154,12 @@ export class UpdateCustomAgentRequestBody extends $dara.Model {
   roleArn?: string;
   /**
    * @remarks
-   * The runtime configuration. When this object is provided, compute and sessionPolicy must be present at the same time. To retain the original elastic policy, provide the complete hpa configuration. Omitting the top-level runtime field retains the original configuration.
+   * The runtime configuration. When this object is provided, both compute and sessionPolicy must be present. To retain the original elastic policy, provide the complete hpa configuration. Omitting the top-level runtime field retains the original configuration.
    */
   runtime?: UpdateCustomAgentRequestBodyRuntime;
   /**
    * @remarks
-   * If this parameter is not passed during an update, the original value is retained. Explicitly set this parameter to true or false. The system does not automatically supplement false. The new contract rejects null and invalid types. Existing compatibility endpoints are processed according to migration agreements.
+   * If this field is not passed during an update, the original value is retained. Explicitly set this field to true or false. The system does not automatically append false. The new contract rejects null and invalid types. Existing compatibility endpoints are processed according to migration agreements.
    * 
    * @example
    * true
@@ -1053,6 +1169,7 @@ export class UpdateCustomAgentRequestBody extends $dara.Model {
     return {
       agenticFsMounts: 'agenticFsMounts',
       artifact: 'artifact',
+      customImage: 'customImage',
       description: 'description',
       environment: 'environment',
       healthCheck: 'healthCheck',
@@ -1072,6 +1189,7 @@ export class UpdateCustomAgentRequestBody extends $dara.Model {
     return {
       agenticFsMounts: { 'type': 'array', 'itemType': UpdateCustomAgentRequestBodyAgenticFsMounts },
       artifact: UpdateCustomAgentRequestBodyArtifact,
+      customImage: UpdateCustomAgentRequestBodyCustomImage,
       description: 'string',
       environment: UpdateCustomAgentRequestBodyEnvironment,
       healthCheck: UpdateCustomAgentRequestBodyHealthCheck,
@@ -1094,6 +1212,9 @@ export class UpdateCustomAgentRequestBody extends $dara.Model {
     if(this.artifact && typeof (this.artifact as any).validate === 'function') {
       (this.artifact as any).validate();
     }
+    if(this.customImage && typeof (this.customImage as any).validate === 'function') {
+      (this.customImage as any).validate();
+    }
     if(this.environment && typeof (this.environment as any).validate === 'function') {
       (this.environment as any).validate();
     }
@@ -1129,7 +1250,7 @@ export class UpdateCustomAgentRequestBody extends $dara.Model {
 export class UpdateCustomAgentRequest extends $dara.Model {
   /**
    * @remarks
-   * The update configuration for the custom agent. Provide at least one top-level field. Omitted top-level fields retain their original values. When providing a configuration object, specify its required subfields and include any optional configurations that you want to retain. Arrays are replaced as a whole.
+   * The update configuration for the custom agent. Specify at least one top-level field. Omitted top-level fields retain their original values. When you provide a configuration object, you must specify its required subfields and include any optional configurations that you want to retain. Arrays are replaced as a whole.
    */
   body?: UpdateCustomAgentRequestBody;
   /**