@alicloud/agentcore20260804 2.5.0 → 2.6.0

package/src/models/ListMemorySessionMessagesRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListMemorySessionMessagesRequest extends $dara.Model {
   /**
    * @remarks
-   * The agent ID. At least one of UserId and AgentId must be provided. The length must be 1 to 128 UTF-8 bytes. The value cannot contain forward slashes (/) or asterisks (*).
+   * The agent ID. You must specify at least one of AgentId and UserId. The length is limited to 1 to 128 UTF-8 bytes. The forward slash (/) and asterisk (*) are not allowed.
    * 
    * @example
    * agent-001
@@ -29,7 +29,7 @@ export class ListMemorySessionMessagesRequest extends $dara.Model {
   nextToken?: string;
   /**
    * @remarks
-   * The session ID. The length must be 1 to 128 UTF-8 bytes. The value cannot contain forward slashes (/) or asterisks (*).
+   * The session ID. The length is limited to 1 to 128 UTF-8 bytes. The forward slash (/) and asterisk (*) are not allowed.
    * 
    * This parameter is required.
    * 
@@ -39,7 +39,7 @@ export class ListMemorySessionMessagesRequest extends $dara.Model {
   sessionId?: string;
   /**
    * @remarks
-   * The user ID. At least one of UserId and AgentId must be provided. The length must be 1 to 128 UTF-8 bytes. The value cannot contain forward slashes (/) or asterisks (*).
+   * The user ID. You must specify at least one of UserId and AgentId. The length is limited to 1 to 128 UTF-8 bytes. The forward slash (/) and asterisk (*) are not allowed.
    * 
    * @example
    * user-001

package/src/models/ListMemorySessionsRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListMemorySessionsRequest extends $dara.Model {
   /**
    * @remarks
-   * The agent ID. If this parameter is not specified, all agents are matched. The length is limited to 1 to 128 UTF-8 bytes, and the value cannot contain / or *.
+   * The agent ID. If you do not specify this parameter, all agents are matched. The value must be 1 to 128 bytes in length and cannot contain forward slashes (/) or asterisks (*).
    * 
    * @example
    * agent-001
@@ -29,7 +29,7 @@ export class ListMemorySessionsRequest extends $dara.Model {
   nextToken?: string;
   /**
    * @remarks
-   * The user ID. If this parameter is not specified, all users are matched. The length is limited to 1 to 128 UTF-8 bytes, and the value cannot contain / or *.
+   * The user ID. If you do not specify this parameter, all users are matched. The value must be 1 to 128 bytes in length and cannot contain forward slashes (/) or asterisks (*).
    * 
    * @example
    * user-001

package/src/models/ListMemorySessionsResponseBody.ts

@@ -71,7 +71,7 @@ export class ListMemorySessionsResponseBody extends $dara.Model {
   httpStatusCode?: number;
   /**
    * @remarks
-   * The session list.
+   * The list of sessions.
    */
   items?: ListMemorySessionsResponseBodyItems[];
   /**

package/src/models/ListMemoryStoresResponseBody.ts

@@ -13,7 +13,7 @@ export class ListMemoryStoresResponseBodyItems extends $dara.Model {
   createdAt?: string;
   /**
    * @remarks
-   * The description of the MemoryStore.
+   * The MemoryStore description.
    * 
    * @example
    * Used to store long-term user preferences
@@ -37,7 +37,7 @@ export class ListMemoryStoresResponseBodyItems extends $dara.Model {
   memoryStoreId?: string;
   /**
    * @remarks
-   * The name of the MemoryStore. It cannot be modified after creation.
+   * The MemoryStore name. It cannot be modified after creation.
    * 
    * @example
    * customer-memory

package/src/models/SearchMemoriesRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class SearchMemoriesRequestBodyScope extends $dara.Model {
   /**
    * @remarks
-   * The agent ID. The ID must be 1 to 128 bytes in length and encoded in UTF-8. The ID cannot contain forward slashes (/) or asterisks (*). If the memory is not associated with an agent ID, this field is not returned.
+   * The agent ID. The ID must be 1 to 128 bytes in length and encoded in UTF-8. The ID cannot contain a forward slash (/) or an asterisk (*). If the memory is not associated with an agent ID, this field is not returned.
    * 
    * @example
    * agent-001
@@ -13,7 +13,7 @@ export class SearchMemoriesRequestBodyScope extends $dara.Model {
   agentId?: string;
   /**
    * @remarks
-   * The session ID. The ID must be 1 to 128 bytes in length and encoded in UTF-8. The ID cannot contain forward slashes (/) or asterisks (*). If the memory is not associated with a session ID, this field is not returned.
+   * The session ID. The ID must be 1 to 128 bytes in length and encoded in UTF-8. The ID cannot contain a forward slash (/) or an asterisk (*). If the memory is not associated with a session ID, this field is not returned.
    * 
    * @example
    * session-001
@@ -21,7 +21,7 @@ export class SearchMemoriesRequestBodyScope extends $dara.Model {
   sessionId?: string;
   /**
    * @remarks
-   * The user ID. The ID must be 1 to 128 bytes in length and encoded in UTF-8. The ID cannot contain forward slashes (/) or asterisks (*). If the memory is not associated with a user ID, this field is not returned.
+   * The user ID. The ID must be 1 to 128 bytes in length and encoded in UTF-8. The ID cannot contain a forward slash (/) or an asterisk (*). If the memory is not associated with a user ID, this field is not returned.
    * 
    * @example
    * user-001

package/src/models/SearchMemoriesResponseBody.ts

@@ -35,7 +35,7 @@ export class SearchMemoriesResponseBodyDataMemoriesMemoryContent extends $dara.M
 export class SearchMemoriesResponseBodyDataMemoriesMemoryScope extends $dara.Model {
   /**
    * @remarks
-   * The agent ID. The ID must be 1 to 128 bytes in length and encoded in UTF-8. The ID cannot contain forward slashes (/) or asterisks (*). If the memory is not associated with an agent ID, this field is not returned.
+   * The agent ID. The ID must be 1 to 128 bytes in length and encoded in UTF-8. The ID cannot contain a forward slash (/) or an asterisk (*). If the memory is not associated with an agent ID, this field is not returned.
    * 
    * @example
    * agent-001
@@ -43,7 +43,7 @@ export class SearchMemoriesResponseBodyDataMemoriesMemoryScope extends $dara.Mod
   agentId?: string;
   /**
    * @remarks
-   * The session ID. The ID must be 1 to 128 bytes in length and encoded in UTF-8. The ID cannot contain forward slashes (/) or asterisks (*). If the memory is not associated with a session ID, this field is not returned.
+   * The session ID. The ID must be 1 to 128 bytes in length and encoded in UTF-8. The ID cannot contain a forward slash (/) or an asterisk (*). If the memory is not associated with a session ID, this field is not returned.
    * 
    * @example
    * session-001
@@ -51,7 +51,7 @@ export class SearchMemoriesResponseBodyDataMemoriesMemoryScope extends $dara.Mod
   sessionId?: string;
   /**
    * @remarks
-   * The user ID. The ID must be 1 to 128 bytes in length and encoded in UTF-8. The ID cannot contain forward slashes (/) or asterisks (*). If the memory is not associated with a user ID, this field is not returned.
+   * The user ID. The ID must be 1 to 128 bytes in length and encoded in UTF-8. The ID cannot contain a forward slash (/) or an asterisk (*). If the memory is not associated with a user ID, this field is not returned.
    * 
    * @example
    * user-001

package/src/models/UpdateCustomAgentRequest.ts

@@ -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 false indicates read and write. If 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 this field is omitted, the default value is false.
    * 
    * @example
    * false
@@ -65,32 +65,32 @@ export class UpdateCustomAgentRequestBodyAgenticFsMounts extends $dara.Model {
 export class UpdateCustomAgentRequestBodyArtifactCode extends $dara.Model {
   /**
    * @remarks
-   * The startup entry point for the code package. Code package deployment is currently not supported. Omit this field.
+   * 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.
    * 
    * @example
-   * python app.py
+   * python main.py
    */
   entrypoint?: string;
   /**
    * @remarks
-   * The language runtime identifier for the code package. Code package deployment is currently not supported. Omit this field.
+   * 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.
    * 
    * @example
-   * python
+   * python3.12
    */
   languageRuntime?: string;
   /**
    * @remarks
-   * The source URI of the code package. Code package deployment is currently not supported. Omit this field.
+   * 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.
    * 
    * @example
-   * oss://my-agent-bucket/packages/agent.zip
+   * oss://my-agent-bucket/packages/main.zip
    */
   sourceUri?: string;
   static names(): { [key: string]: string } {
@@ -121,7 +121,7 @@ export class UpdateCustomAgentRequestBodyArtifactCode extends $dara.Model {
 export class UpdateCustomAgentRequestBodyArtifactContainer extends $dara.Model {
   /**
    * @remarks
-   * The optional executable program and startup parameters. If specified, this 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 as well.
+   * 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.
    * 
    * @example
    * python app.py
@@ -169,7 +169,7 @@ export class UpdateCustomAgentRequestBodyArtifactContainer extends $dara.Model {
   tag?: string;
   /**
    * @remarks
-   * The source type of the image. Currently, only acr is supported, which indicates Alibaba Cloud Container Registry (ACR).
+   * The image source type. Currently, only acr is supported, which indicates Alibaba Cloud Container Registry (ACR).
    * 
    * This parameter is required.
    * 
@@ -211,7 +211,7 @@ export class UpdateCustomAgentRequestBodyArtifactContainer extends $dara.Model {
 export class UpdateCustomAgentRequestBodyArtifact extends $dara.Model {
   /**
    * @remarks
-   * The code package deployment configuration. This is currently not supported. Omit this field and use artifact.container instead.
+   * The code package deployment configuration. This field is mutually exclusive with the container field. Code packages use the ZIP or TAR.GZ format. Dependencies must be packaged by the user. The platform does not install dependencies or perform online builds.
    */
   code?: UpdateCustomAgentRequestBodyArtifactCode;
   /**
@@ -263,7 +263,7 @@ export class UpdateCustomAgentRequestBodyArtifact extends $dara.Model {
 export class UpdateCustomAgentRequestBodyEnvironmentVariables extends $dara.Model {
   /**
    * @remarks
-   * The name of the environment variable. This field cannot be empty and must be unique within the current environment variable list.
+   * The name of the environment variable. This field cannot be empty and must be unique in the current environment variable list.
    * 
    * This parameter is required.
    * 
@@ -273,7 +273,7 @@ export class UpdateCustomAgentRequestBodyEnvironmentVariables extends $dara.Mode
   name?: string;
   /**
    * @remarks
-   * The value of the environment variable. This must be a string. Empty strings are allowed.
+   * The value of the environment variable. This field must be a string. Empty strings are allowed.
    * 
    * This parameter is required.
    * 
@@ -345,7 +345,7 @@ export class UpdateCustomAgentRequestBodyHealthCheck extends $dara.Model {
   healthyThreshold?: number;
   /**
    * @remarks
-   * The interval between two health checks, in seconds. This must be a positive integer. If omitted, the default value is 10.
+   * 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.
    * 
    * @example
    * 10
@@ -353,7 +353,7 @@ export class UpdateCustomAgentRequestBodyHealthCheck extends $dara.Model {
   intervalSeconds?: number;
   /**
    * @remarks
-   * The HTTP health check path. This must start with a forward slash (/). If omitted, the default value is /healthz.
+   * The HTTP health check path. This field must start with a forward slash (/). If this field is omitted, the default value is /healthz.
    * 
    * @example
    * /healthz
@@ -361,7 +361,7 @@ export class UpdateCustomAgentRequestBodyHealthCheck extends $dara.Model {
   path?: string;
   /**
    * @remarks
-   * The port accessed for health checks. This field is required when configuring a health check. Valid values: 1 to 65535.
+   * The port accessed by the health check. This field is required when configuring a health check. Valid values: 1 to 65535.
    * 
    * @example
    * 8080
@@ -369,7 +369,7 @@ export class UpdateCustomAgentRequestBodyHealthCheck extends $dara.Model {
   port?: number;
   /**
    * @remarks
-   * The timeout period for a single health check, in seconds. This must be a positive integer and less than intervalSeconds. If omitted, the default value is 2.
+   * 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.
    * 
    * @example
    * 2
@@ -377,7 +377,7 @@ export class UpdateCustomAgentRequestBodyHealthCheck extends $dara.Model {
   timeoutSeconds?: number;
   /**
    * @remarks
-   * The number of consecutive health check failures before the instance is considered unhealthy. This must be a positive integer. If omitted, the default value is 3.
+   * 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.
    * 
    * @example
    * 3
@@ -417,7 +417,7 @@ export class UpdateCustomAgentRequestBodyHealthCheck extends $dara.Model {
 export class UpdateCustomAgentRequestBodyLoggingSls extends $dara.Model {
   /**
    * @remarks
-   * The name of the Simple Log Service logstore that receives agent logs.
+   * The name of the SLS logstore that receives agent logs.
    * 
    * @example
    * agent-runtime
@@ -425,7 +425,7 @@ export class UpdateCustomAgentRequestBodyLoggingSls extends $dara.Model {
   logstore?: string;
   /**
    * @remarks
-   * The name of the Simple Log Service project that receives agent logs.
+   * The name of the SLS project that receives agent logs.
    * 
    * @example
    * my-agent-logs
@@ -457,7 +457,7 @@ export class UpdateCustomAgentRequestBodyLoggingSls extends $dara.Model {
 export class UpdateCustomAgentRequestBodyLogging extends $dara.Model {
   /**
    * @remarks
-   * The Simple Log Service log delivery destination. When updating this object, you must provide both project and logstore, and neither can be empty.
+   * The SLS log delivery destination. When updating 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 +487,7 @@ export class UpdateCustomAgentRequestBodyLogging extends $dara.Model {
 export class UpdateCustomAgentRequestBodyNetworkAccessInternet extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to allow the agent to access the Internet. A Boolean value is required when configuring accessInternet. For this to take effect, the workspace must also allow Internet access.
+   * 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.
    */
   enabled?: boolean;
   static names(): { [key: string]: string } {
@@ -514,7 +514,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 for the workspace. A Boolean value is required when configuring accessVpc. For this to take effect, the workspace must also allow VPC access.
+   * 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.
    */
   enabled?: boolean;
   static names(): { [key: string]: string } {
@@ -541,12 +541,12 @@ export class UpdateCustomAgentRequestBodyNetworkAccessVpc extends $dara.Model {
 export class UpdateCustomAgentRequestBodyNetwork extends $dara.Model {
   /**
    * @remarks
-   * The Internet access configuration. If this access item is omitted, Internet access is not restricted on the agent side. However, the workspace must still allow Internet access.
+   * 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.
    */
   accessInternet?: UpdateCustomAgentRequestBodyNetworkAccessInternet;
   /**
    * @remarks
-   * The user VPC access configuration. If this access item is omitted, VPC access is not restricted on the agent side. However, the workspace must still be configured to allow access to the user VPC.
+   * 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.
    */
   accessVpc?: UpdateCustomAgentRequestBodyNetworkAccessVpc;
   static names(): { [key: string]: string } {
@@ -581,7 +581,7 @@ export class UpdateCustomAgentRequestBodyNetwork extends $dara.Model {
 export class UpdateCustomAgentRequestBodyObservability extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to enable agent observability. Default value: true. If set to false, the platform Python probe is not loaded at runtime, and you must collect observability data yourself.
+   * Specifies whether to enable agent observability.
    */
   enabled?: boolean;
   static names(): { [key: string]: string } {
@@ -624,7 +624,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 traversal.
+   * 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.
    * 
    * @example
    * datasets/train
@@ -632,7 +632,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 false indicates read and write. If 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 this field is omitted, the default value is false.
    */
   readOnly?: boolean;
   static names(): { [key: string]: string } {
@@ -800,14 +800,14 @@ export class UpdateCustomAgentRequestBodyRuntimeHpa extends $dara.Model {
    * Specifies whether to enable elastic scaling. Valid values:
    * - true: Enabled.
    * - false: Disabled.
-   * When runtime is provided, if this field is omitted, the default value is false.
+   * Default value: false. This default value applies when runtime is provided and this field is omitted.
    * 
    * This parameter is required.
    */
   enabled?: boolean;
   /**
    * @remarks
-   * The maximum number of concurrent sessions for a single runtime instance. Valid values: 1 to 100. When runtime is provided, if this field is omitted, the default value is 100.
+   * The maximum number of concurrent sessions for a single runtime instance. Valid values: 1 to 100. When runtime is provided, omitting this field uses the default value of 100.
    * 
    * @example
    * 100
@@ -815,7 +815,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, if this field is omitted, the default value is 10.
+   * 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.
    * 
    * @example
    * 10
@@ -823,7 +823,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, if this field is omitted, the default value is 1.
+   * 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.
    * 
    * @example
    * 1
@@ -831,7 +831,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, if this field is omitted, the default value is 600.
+   * The session idle timeout in seconds. Valid values: 60 to 86400. When runtime is provided, omitting this field uses the default value of 600.
    * 
    * @example
    * 600
@@ -869,7 +869,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 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 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.
    * 
    * @example
    * X-Session-Id
@@ -879,8 +879,8 @@ 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 in headerName.
-   * - ISOLATED_COOKIE: Cookie-based session option. Not recommended.
+   * - 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.
    * 
    * This parameter is required.
@@ -922,7 +922,7 @@ export class UpdateCustomAgentRequestBodyRuntime extends $dara.Model {
   compute?: UpdateCustomAgentRequestBodyRuntimeCompute;
   /**
    * @remarks
-   * The optional elastic policy. When runtime is provided, if hpa or its fields are omitted, default values are used: 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 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;
   /**
@@ -969,17 +969,17 @@ export class UpdateCustomAgentRequestBodyRuntime extends $dara.Model {
 export class UpdateCustomAgentRequestBody extends $dara.Model {
   /**
    * @remarks
-   * The list of additional AgenticFS mounts. The total number of AgenticFS and OSS mounts 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 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.
    */
   agenticFsMounts?: UpdateCustomAgentRequestBodyAgenticFsMounts[];
   /**
    * @remarks
-   * The deployment artifact configuration. Currently, only ACR container images are supported. Specify the container field and the service listening port field. Omit the code field. During an update, you must specify the port field and all required fields of the container object.
+   * 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.
    */
   artifact?: UpdateCustomAgentRequestBodyArtifact;
   /**
    * @remarks
-   * The description of the agent purpose. The maximum length is 1,024 characters after leading and trailing whitespaces are removed. If omitted, the original value is retained. Pass null to clear the description.
+   * 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.
    * 
    * @example
    * Custom agent that provides conversation services
@@ -997,12 +997,12 @@ export class UpdateCustomAgentRequestBody extends $dara.Model {
   healthCheck?: UpdateCustomAgentRequestBodyHealthCheck;
   /**
    * @remarks
-   * The log delivery configuration for the agent. You can specify the Simple Log Service 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 whether logs are delivered properly.
    */
   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. If omitted, the original value is retained. You cannot pass null or an empty name.
+   * 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.
    * 
    * @example
    * my-custom-agent
@@ -1010,27 +1010,27 @@ 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 scope is still subject to 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 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.
    */
   network?: UpdateCustomAgentRequestBodyNetwork;
   /**
    * @remarks
-   * The observability configuration for high-code agents.
+   * The high-code agent observability configuration.
    */
   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. During an update, this list is replaced entirely. Pass an empty array to clear all mounts.
+   * 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.
    */
   ossMounts?: UpdateCustomAgentRequestBodyOssMounts[];
   /**
    * @remarks
-   * 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.
+   * 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.
    */
   protocol?: UpdateCustomAgentRequestBodyProtocol[];
   /**
    * @remarks
-   * The ARN of the RAM role used by the agent to access user cloud resources. The role must have permissions to access the cloud resources.
+   * The ARN of the RAM role used when the agent accesses user cloud resources. The role must have permissions to access the cloud resources.
    * 
    * @example
    * acs:ram::1234567890123456:role/agentcore-runtime-role
@@ -1038,12 +1038,12 @@ export class UpdateCustomAgentRequestBody extends $dara.Model {
   roleArn?: string;
   /**
    * @remarks
-   * The runtime configuration. When this object is provided, compute and sessionPolicy must be provided together. 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, 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.
    */
   runtime?: UpdateCustomAgentRequestBodyRuntime;
   /**
    * @remarks
-   * If not specified during an update, the original value is retained. Explicitly set to true or false. The system does not automatically default to false. New API contracts reject null and invalid types. Existing compatibility endpoints are processed according to migration conventions.
+   * 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.
    * 
    * @example
    * true
@@ -1129,7 +1129,7 @@ export class UpdateCustomAgentRequestBody extends $dara.Model {
 export class UpdateCustomAgentRequest extends $dara.Model {
   /**
    * @remarks
-   * The update configuration for the custom agent. Specify 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. 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.
    */
   body?: UpdateCustomAgentRequestBody;
   /**