@alicloud/agentcore20260804 2.3.2 → 2.5.0

package/dist/models/UpdateCustomAgentResponseBody.d.ts

@@ -10,7 +10,7 @@ export declare class UpdateCustomAgentResponseBodyDataAgenticFsMounts extends $d
     mountPath?: string;
     /**
      * @remarks
-     * The relative directory within the mounted AccessPoint.
+     * The relative directory within the mounted access point.
      *
      * @example
      * workspace/data
@@ -18,7 +18,7 @@ export declare class UpdateCustomAgentResponseBodyDataAgenticFsMounts extends $d
     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.
+     * Specifies whether the mount is read-only. A value of true indicates a read-only mount, and a value of false indicates a read-write mount.
      *
      * @example
      * false
@@ -26,7 +26,7 @@ export declare class UpdateCustomAgentResponseBodyDataAgenticFsMounts extends $d
     readOnly?: boolean;
     /**
      * @remarks
-     * The domain name of the AgenticFS AccessPoint used for the mount.
+     * The domain name of the AgenticFS access point used for the mount.
      *
      * @example
      * ap-0123456789abcdef0.0123456789-vlm36.cn-hangzhou.nas.aliyuncs.com
@@ -168,7 +168,7 @@ export declare class UpdateCustomAgentResponseBodyDataArtifact extends $dara.Mod
     container?: UpdateCustomAgentResponseBodyDataArtifactContainer;
     /**
      * @remarks
-     * The TCP port listened on by the agent service.
+     * The TCP port on which the agent service listens.
      *
      * This parameter is required.
      *
@@ -247,7 +247,7 @@ export declare class UpdateCustomAgentResponseBodyDataHealthCheck extends $dara.
     healthyThreshold?: number;
     /**
      * @remarks
-     * The interval between two consecutive health checks, in seconds.
+     * The interval between two health checks, in seconds.
      *
      * @example
      * 10
@@ -255,7 +255,7 @@ export declare class UpdateCustomAgentResponseBodyDataHealthCheck extends $dara.
     intervalSeconds?: number;
     /**
      * @remarks
-     * The health check path.
+     * The HTTP health check path.
      *
      * @example
      * /healthz
@@ -263,7 +263,7 @@ export declare class UpdateCustomAgentResponseBodyDataHealthCheck extends $dara.
     path?: string;
     /**
      * @remarks
-     * The port accessed for the HTTP health check.
+     * The port accessed for HTTP health checks.
      *
      * @example
      * 8080
@@ -279,7 +279,7 @@ export declare class UpdateCustomAgentResponseBodyDataHealthCheck extends $dara.
     timeoutSeconds?: number;
     /**
      * @remarks
-     * The number of consecutive health check failures required to mark the agent as unhealthy.
+     * The number of consecutive health check failures after which the agent is considered unhealthy.
      *
      * @example
      * 3
@@ -296,10 +296,54 @@ export declare class UpdateCustomAgentResponseBodyDataHealthCheck extends $dara.
         [key: string]: any;
     });
 }
+export declare class UpdateCustomAgentResponseBodyDataImageCachePreparation extends $dara.Model {
+    /**
+     * @remarks
+     * The value is equal to the imageCacheId in the same response and belongs to the current workspace.
+     *
+     * This parameter is required.
+     *
+     * @example
+     * img-example
+     */
+    imageId?: string;
+    /**
+     * @remarks
+     * The acceptance snapshot of the current request, which can be PENDING, READY, or FAILED. This value does not represent the real-time status. You can query the real-time status by calling GetImageCache.
+     *
+     * This parameter is required.
+     *
+     * @example
+     * PENDING
+     */
+    statusAtAcceptance?: string;
+    /**
+     * @remarks
+     * The value is fixed as ACCEPTED, indicating that the logical association and preparation intent are confirmed.
+     *
+     * This parameter is required.
+     *
+     * @example
+     * ACCEPTED
+     */
+    submissionStatus?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
 export declare class UpdateCustomAgentResponseBodyDataLatestExecutionError extends $dara.Model {
     /**
      * @remarks
-     * The reason code for the waiting or execution failure of the latest configuration. This code is used to determine the subsequent processing method.
+     * The cause code for the wait or execution failure of the latest configuration. You can use this code to determine the subsequent processing method.
+     *
+     * This parameter is required.
      *
      * @example
      * AgentExecutionFailed
@@ -307,7 +351,9 @@ export declare class UpdateCustomAgentResponseBodyDataLatestExecutionError exten
     code?: string;
     /**
      * @remarks
-     * The description of the reason why the latest configuration is waiting or failed to execute. Refer to code and retryable to determine what to do next.
+     * The description of the cause for the wait or when the latest configuration failed to execute. Check the code and retryable fields to determine What to do next.
+     *
+     * This parameter is required.
      *
      * @example
      * Agent execution failed. Check the configuration and resubmit
@@ -315,7 +361,9 @@ export declare class UpdateCustomAgentResponseBodyDataLatestExecutionError exten
     message?: string;
     /**
      * @remarks
-     * Specifies whether automatic retry is performed. If the value is true, you can query again later. If the value is false, check and fix the configuration based on the reason, and then resubmit.
+     * Specifies whether automatic retry is performed. If the value is true, you can query again later. If the value is false, check and fix the configuration based on the cause and then resubmit the agent.
+     *
+     * This parameter is required.
      */
     retryable?: boolean;
     static names(): {
@@ -377,7 +425,7 @@ export declare class UpdateCustomAgentResponseBodyDataLogging extends $dara.Mode
 export declare class UpdateCustomAgentResponseBodyDataNetworkAccessInternet extends $dara.Model {
     /**
      * @remarks
-     * Specifies whether Internet access is allowed on the agent side. The actual access is still restricted by the workspace.
+     * Specifies whether Internet access is allowed on the agent side. The actual access remains restricted by the workspace.
      */
     enabled?: boolean;
     static names(): {
@@ -394,7 +442,7 @@ export declare class UpdateCustomAgentResponseBodyDataNetworkAccessInternet exte
 export declare class UpdateCustomAgentResponseBodyDataNetworkAccessVpc extends $dara.Model {
     /**
      * @remarks
-     * Specifies whether access to the user VPC configured for the workspace is allowed on the agent side. The actual access is still restricted by the workspace.
+     * Specifies whether access to the user VPC configured for the workspace is allowed on the agent side. The actual access remains restricted by the workspace.
      */
     enabled?: boolean;
     static names(): {
@@ -411,12 +459,12 @@ export declare class UpdateCustomAgentResponseBodyDataNetworkAccessVpc extends $
 export declare class UpdateCustomAgentResponseBodyDataNetwork extends $dara.Model {
     /**
      * @remarks
-     * The Internet access configuration of the agent. If this field is not configured, Internet access is allowed on the agent side, but it is still restricted by the workspace.
+     * The Internet access configuration of the agent. If this parameter is not configured, Internet access is allowed on the agent side but remains restricted by the workspace.
      */
     accessInternet?: UpdateCustomAgentResponseBodyDataNetworkAccessInternet;
     /**
      * @remarks
-     * The user VPC access configuration of the agent. If this field is not configured, user VPC access is allowed on the agent side, but it is still restricted by the workspace.
+     * The user VPC access configuration of the agent. If this parameter is not configured, user VPC access is allowed on the agent side but remains restricted by the workspace.
      */
     accessVpc?: UpdateCustomAgentResponseBodyDataNetworkAccessVpc;
     static names(): {
@@ -430,6 +478,23 @@ export declare class UpdateCustomAgentResponseBodyDataNetwork extends $dara.Mode
         [key: string]: any;
     });
 }
+export declare class UpdateCustomAgentResponseBodyDataObservability 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.
+     */
+    enabled?: boolean;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
 export declare class UpdateCustomAgentResponseBodyDataOssMounts extends $dara.Model {
     /**
      * @remarks
@@ -457,7 +522,7 @@ export declare class UpdateCustomAgentResponseBodyDataOssMounts extends $dara.Mo
     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.
+     * Specifies whether the mount is read-only. A value of true indicates a read-only mount, and a value of false indicates a read-write mount.
      */
     readOnly?: boolean;
     static names(): {
@@ -474,7 +539,7 @@ export declare class UpdateCustomAgentResponseBodyDataOssMounts extends $dara.Mo
 export declare class UpdateCustomAgentResponseBodyDataProtocolPaths extends $dara.Model {
     /**
      * @remarks
-     * The description of the current API path.
+     * The usage description of the current API path.
      *
      * @example
      * AG-UI conversation API
@@ -504,14 +569,14 @@ export declare class UpdateCustomAgentResponseBodyDataProtocolPaths extends $dar
 export declare class UpdateCustomAgentResponseBodyDataProtocol extends $dara.Model {
     /**
      * @remarks
-     * The request header configurations for the current protocol, where the key is the name and the value is a string.
+     * The request header configuration for the current protocol. The key is the header name and the value is a string.
      */
     headers?: {
         [key: string]: string;
     };
     /**
      * @remarks
-     * The list of API paths corresponding to the current protocol.
+     * The list of API paths for the current protocol.
      */
     paths?: UpdateCustomAgentResponseBodyDataProtocolPaths[];
     /**
@@ -566,7 +631,9 @@ export declare class UpdateCustomAgentResponseBodyDataRuntimeCompute extends $da
 export declare class UpdateCustomAgentResponseBodyDataRuntimeHpa extends $dara.Model {
     /**
      * @remarks
-     * Specifies whether elastic scaling is enabled. A value of true indicates that elastic scaling is enabled, and a value of false indicates that elastic scaling is disabled.
+     * Specifies whether to enable elastic scaling. Valid values:
+     * - true: Enabled.
+     * - false: Disabled.
      *
      * This parameter is required.
      */
@@ -617,7 +684,7 @@ export declare class UpdateCustomAgentResponseBodyDataRuntimeHpa extends $dara.M
 export declare class UpdateCustomAgentResponseBodyDataRuntimeSessionPolicy extends $dara.Model {
     /**
      * @remarks
-     * The name of the HTTP request header used by the session policy. This parameter is applicable to ISOLATED_HEADER_FIELD.
+     * The name of the HTTP request header used by the session policy. This applies to ISOLATED_HEADER_FIELD.
      *
      * @example
      * X-Session-Id
@@ -625,7 +692,10 @@ export declare class UpdateCustomAgentResponseBodyDataRuntimeSessionPolicy exten
     headerName?: string;
     /**
      * @remarks
-     * The type of the session policy. Valid values: AFFINITY (session affinity), ISOLATED_HEADER_FIELD (associates sessions by using the request header specified by headerName), and ISOLATED_COOKIE (not recommended). The compatible value DISABLED in requests is returned as AFFINITY.
+     * The type of the session policy. Valid values:
+     * - AFFINITY: Session affinity.
+     * - ISOLATED_HEADER_FIELD: Uses the request header specified by headerName to associate sessions.
+     * ISOLATED_COOKIE is not recommended. The compatible value DISABLED in a request is returned as AFFINITY.
      *
      * This parameter is required.
      *
@@ -654,12 +724,12 @@ export declare class UpdateCustomAgentResponseBodyDataRuntime extends $dara.Mode
     compute?: UpdateCustomAgentResponseBodyDataRuntimeCompute;
     /**
      * @remarks
-     * The elastic policy configurations for the agent.
+     * The elastic policy configuration of the agent.
      */
     hpa?: UpdateCustomAgentResponseBodyDataRuntimeHpa;
     /**
      * @remarks
-     * The session policy configurations for the agent.
+     * The session policy configuration of the agent.
      *
      * This parameter is required.
      */
@@ -680,6 +750,8 @@ export declare class UpdateCustomAgentResponseBodyData extends $dara.Model {
      * @remarks
      * The unique identifier of the custom agent. You can obtain this ID from the response of the CreateCustomAgent or ListCustomAgents operation.
      *
+     * This parameter is required.
+     *
      * @example
      * agent-550e8400e29b41d4a716446655440000
      */
@@ -691,12 +763,12 @@ export declare class UpdateCustomAgentResponseBodyData extends $dara.Model {
     agenticFsMounts?: UpdateCustomAgentResponseBodyDataAgenticFsMounts[];
     /**
      * @remarks
-     * The latest submitted deployment artifact configuration, including the service listening port and ACR container image. Check latestVersionStatus to determine whether the configuration has taken effect.
+     * The latest submitted deployment artifact configuration, including the service listening port and the ACR container image. Check the latestVersionStatus field to determine whether the configuration has taken effect.
      */
     artifact?: UpdateCustomAgentResponseBodyDataArtifact;
     /**
      * @remarks
-     * The creation method of the agent. The value is CUSTOM for custom agents.
+     * The creation method of the agent. A value of CUSTOM is returned for custom agents.
      *
      * @example
      * CUSTOM
@@ -712,7 +784,7 @@ export declare class UpdateCustomAgentResponseBodyData extends $dara.Model {
     createdAt?: string;
     /**
      * @remarks
-     * The deployment method of the agent. Custom agents are deployed and managed by the platform, and the value is MANAGED.
+     * The deployment method of the agent. Custom agents are deployed and managed by the platform, and a value of MANAGED is returned.
      *
      * @example
      * MANAGED
@@ -720,7 +792,7 @@ export declare class UpdateCustomAgentResponseBodyData extends $dara.Model {
     deployType?: string;
     /**
      * @remarks
-     * The description of the agent\\"s purpose.
+     * The purpose description of the agent.
      *
      * @example
      * Custom agent that provides conversation services
@@ -728,22 +800,55 @@ export declare class UpdateCustomAgentResponseBodyData extends $dara.Model {
     description?: string;
     /**
      * @remarks
-     * The environment variable configuration for the agent process.
+     * The value is null if no effective version exists. Do not use latestSpecVersion as a substitute. You cannot use this field to release the occupation protection of old cache instances.
+     *
+     * This parameter is required.
+     *
+     * @example
+     * 1
+     *
+     * **if can be null:**
+     * true
+     */
+    effectiveSpecVersion?: number;
+    /**
+     * @remarks
+     * The environment variable configuration of the agent process.
      */
     environment?: UpdateCustomAgentResponseBodyDataEnvironment;
     /**
      * @remarks
-     * The HTTP health check configuration of the agent. This field is empty if no configuration is specified.
+     * The HTTP health check configuration of the agent. The value is empty if not configured.
      */
     healthCheck?: UpdateCustomAgentResponseBodyDataHealthCheck;
     /**
      * @remarks
-     * The waiting or execution error of the latest configuration version. This field is returned only when the version is waiting for a retry or fails to execute.
+     * This field is always returned. If useImageCache is set to true, the value is the non-empty logical ID of the current workspace. If useImageCache is set to false, the value is null. The occupation of old instances after the feature is disabled is independently protected by the backend and is not backfilled as the current configuration association.
+     *
+     * This parameter is required.
+     *
+     * @example
+     * img-example
+     *
+     * **if can be null:**
+     * true
+     */
+    imageCacheId?: string;
+    /**
+     * @remarks
+     * This field is always returned when caching is enabled in the final configuration for a create or update operation, including the reuse of existing registrations. This field is omitted when the final switch is disabled or during a get operation. Old summaries are not returned.
+     */
+    imageCachePreparation?: UpdateCustomAgentResponseBodyDataImageCachePreparation;
+    /**
+     * @remarks
+     * The wait or execution error of the latest configuration version. This field is returned only when the version is waiting for a retry or fails to execute.
      */
     latestExecutionError?: UpdateCustomAgentResponseBodyDataLatestExecutionError;
     /**
      * @remarks
-     * The current latest configuration version number. Updates with the same configuration may retain the original version number. This field does not indicate that the configuration has taken effect.
+     * The latest configuration version number. Updates with the same configuration may retain the original version number. This field does not indicate that the configuration has taken effect.
+     *
+     * This parameter is required.
      *
      * @example
      * 1
@@ -752,7 +857,7 @@ export declare class UpdateCustomAgentResponseBodyData extends $dara.Model {
     /**
      * @remarks
      * The execution status corresponding to latestSpecVersion. Valid values:
-     * - pending: Waiting for execution.
+     * - pending: Pending execution.
      * - processing: Executing.
      * - waiting_retry: Waiting for retry.
      * - succeeded: Execution succeeded.
@@ -761,6 +866,9 @@ export declare class UpdateCustomAgentResponseBodyData extends $dara.Model {
      *
      * @example
      * succeeded
+     *
+     * **if can be null:**
+     * true
      */
     latestVersionStatus?: string;
     /**
@@ -772,15 +880,22 @@ export declare class UpdateCustomAgentResponseBodyData extends $dara.Model {
      * @remarks
      * The name of the custom agent.
      *
+     * This parameter is required.
+     *
      * @example
      * my-custom-agent
      */
     name?: string;
     /**
      * @remarks
-     * The network access configuration of the agent. The actual access scope is also restricted by the workspace network configuration.
+     * The network access configuration of the agent. The actual access scope is also restricted by the network configuration of the workspace.
      */
     network?: UpdateCustomAgentResponseBodyDataNetwork;
+    /**
+     * @remarks
+     * The observability configuration for high-code agents.
+     */
+    observability?: UpdateCustomAgentResponseBodyDataObservability;
     /**
      * @remarks
      * The latest submitted list of OSS directory mounts.
@@ -809,19 +924,28 @@ export declare class UpdateCustomAgentResponseBodyData extends $dara.Model {
     roleArn?: string;
     /**
      * @remarks
-     * The latest committed runtime configurations, including compute specifications, session policy, and elastic policy.
+     * The latest committed runtime configuration, including compute specifications, session policy, and elastic policy.
      */
     runtime?: UpdateCustomAgentResponseBodyDataRuntime;
     /**
      * @remarks
-     * The counts of running instances by phase. Keys include PENDING (creating or initializing), RUNNING (running), HIBERNATING (hibernating), HIBERNATED (hibernated), RESUMING (resuming), TERMINATING (terminating), and FAILED (failed). Only phases that actually occur are returned. Missing keys are treated as 0.
+     * The instance counts grouped by running instance phase. Keys include PENDING (creating or initializing), RUNNING (running), HIBERNATING (hibernating), HIBERNATED (hibernated), RESUMING (resuming), TERMINATING (terminating), and FAILED (failed). Only phases that actually occur are returned. Missing keys are treated as 0.
      */
     sandboxPhaseCounts?: {
         [key: string]: number;
     };
     /**
      * @remarks
-     * The overall status of the agent. Valid values: Creating (creating), Running (running), Failed (failed), Updating (updating), Deleting (deleting), and Deleted (deleted). To check the execution progress of the latest configuration, query latestVersionStatus.
+     * The overall status of the agent. Valid values:
+     * - Creating: Creating.
+     * - Running: Running.
+     * - Failed: Failed.
+     * - Updating: Updating.
+     * - Deleting: Deleting.
+     * - Deleted: Deleted.
+     * To check the execution progress of the latest configuration, query latestVersionStatus.
+     *
+     * This parameter is required.
      *
      * @example
      * Running
@@ -829,16 +953,28 @@ export declare class UpdateCustomAgentResponseBodyData extends $dara.Model {
     status?: string;
     /**
      * @remarks
-     * The time when the agent was last updated. The time follows the ISO 8601 standard. A trailing Z indicates the UTC time zone. Fractional seconds may be included.
+     * The time when the agent was last updated, in ISO 8601 format. The trailing Z indicates the UTC time zone, and fractional seconds may be included.
      *
      * @example
      * 2026-10-10T06:05:00Z
      */
     updatedAt?: string;
+    /**
+     * @remarks
+     * Required. Reflects the final accepted configuration. If this field is missing in historical data, false is returned. Do not infer the value based on the cache status.
+     *
+     * This parameter is required.
+     *
+     * @example
+     * true
+     */
+    useImageCache?: boolean;
     /**
      * @remarks
      * The ID of the workspace to which the custom agent belongs.
      *
+     * This parameter is required.
+     *
      * @example
      * ws-a1b2c3d4e5f6
      */
@@ -857,7 +993,9 @@ export declare class UpdateCustomAgentResponseBodyData extends $dara.Model {
 export declare class UpdateCustomAgentResponseBody extends $dara.Model {
     /**
      * @remarks
-     * The request result code. The value is SUCCESS when the request is successful.
+     * The request result code. The value is SUCCESS when the request succeeds.
+     *
+     * This parameter is required.
      *
      * @example
      * SUCCESS
@@ -865,12 +1003,16 @@ export declare class UpdateCustomAgentResponseBody extends $dara.Model {
     code?: string;
     /**
      * @remarks
-     * The latest submitted configuration and status of the custom agent. A successful response indicates that the request is accepted, but the configuration may not have taken effect yet.
+     * The latest submitted configuration and status of the custom agent. A successful response indicates that the request is accepted, but the configuration may not have taken effect.
+     *
+     * This parameter is required.
      */
     data?: UpdateCustomAgentResponseBodyData;
     /**
      * @remarks
-     * The HTTP status code of the request. A value of 200 indicates success.
+     * The HTTP status code of the request. The value is 200 if the request is successful.
+     *
+     * This parameter is required.
      *
      * @example
      * 200
@@ -878,7 +1020,9 @@ export declare class UpdateCustomAgentResponseBody extends $dara.Model {
     httpStatusCode?: number;
     /**
      * @remarks
-     * The processing result message of the request. The value is success if the request is successful.
+     * The result message of the request. The value is success if the request is successful.
+     *
+     * This parameter is required.
      *
      * @example
      * success
@@ -886,7 +1030,9 @@ export declare class UpdateCustomAgentResponseBody extends $dara.Model {
     message?: string;
     /**
      * @remarks
-     * The unique identifier of the request, which is used to locate and troubleshoot issues.
+     * The unique identifier of the request, used to locate and troubleshoot issues.
+     *
+     * This parameter is required.
      *
      * @example
      * 550E8400-E29B-41D4-A716-446655440000
@@ -895,6 +1041,8 @@ export declare class UpdateCustomAgentResponseBody extends $dara.Model {
     /**
      * @remarks
      * Indicates whether the request was processed successfully. A value of true indicates that the request was processed successfully. A successful creation, update, or deletion does not mean that the background operation is complete.
+     *
+     * This parameter is required.
      */
     success?: boolean;
     static names(): {