@alicloud/agentcore20260804 2.3.1 → 2.4.0

package/src/models/GetCustomAgentResponseBody.ts

@@ -4,21 +4,33 @@ import * as $dara from '@darabonba/typescript';
 
 export class GetCustomAgentResponseBodyDataAgenticFsMounts extends $dara.Model {
   /**
+   * @remarks
+   * The AgenticFS mount directory in the container, located under /mnt/agenticfs/.
+   * 
    * @example
    * /mnt/agenticfs/data
    */
   mountPath?: string;
   /**
+   * @remarks
+   * The relative directory within the mounted access point.
+   * 
    * @example
    * workspace/data
    */
   path?: string;
   /**
+   * @remarks
+   * 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
    */
   readOnly?: boolean;
   /**
+   * @remarks
+   * The AgenticFS access point domain name used for the mount.
+   * 
    * @example
    * ap-0123456789abcdef0.0123456789-vlm36.cn-hangzhou.nas.aliyuncs.com
    */
@@ -53,6 +65,8 @@ export class GetCustomAgentResponseBodyDataAgenticFsMounts extends $dara.Model {
 export class GetCustomAgentResponseBodyDataArtifactCode extends $dara.Model {
   /**
    * @remarks
+   * The startup entry point of the code package. Code package deployment is not supported.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -61,6 +75,8 @@ export class GetCustomAgentResponseBodyDataArtifactCode extends $dara.Model {
   entrypoint?: string;
   /**
    * @remarks
+   * The language runtime identifier of the code package. Code package deployment is not supported.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -69,6 +85,8 @@ export class GetCustomAgentResponseBodyDataArtifactCode extends $dara.Model {
   languageRuntime?: string;
   /**
    * @remarks
+   * The source URI of the code package. Code package deployment is not supported.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -102,12 +120,17 @@ export class GetCustomAgentResponseBodyDataArtifactCode extends $dara.Model {
 
 export class GetCustomAgentResponseBodyDataArtifactContainer extends $dara.Model {
   /**
+   * @remarks
+   * The custom executable program and startup parameters. If not configured, the default startup method of the image is used.
+   * 
    * @example
    * python app.py
    */
   entrypoint?: string;
   /**
    * @remarks
+   * The ID of the ACR instance to which the image repository belongs.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -116,6 +139,8 @@ export class GetCustomAgentResponseBodyDataArtifactContainer extends $dara.Model
   instanceId?: string;
   /**
    * @remarks
+   * The namespace to which the ACR image repository belongs.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -124,6 +149,8 @@ export class GetCustomAgentResponseBodyDataArtifactContainer extends $dara.Model
   namespace?: string;
   /**
    * @remarks
+   * The name of the image repository in the ACR namespace.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -132,6 +159,8 @@ export class GetCustomAgentResponseBodyDataArtifactContainer extends $dara.Model
   repo?: string;
   /**
    * @remarks
+   * The latest submitted image tag.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -140,6 +169,8 @@ export class GetCustomAgentResponseBodyDataArtifactContainer extends $dara.Model
   tag?: string;
   /**
    * @remarks
+   * The image source type. A value of acr indicates Alibaba Cloud Container Registry.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -178,10 +209,20 @@ export class GetCustomAgentResponseBodyDataArtifactContainer extends $dara.Model
 }
 
 export class GetCustomAgentResponseBodyDataArtifact extends $dara.Model {
+  /**
+   * @remarks
+   * The code package configuration field. Code package deployment is not supported.
+   */
   code?: GetCustomAgentResponseBodyDataArtifactCode;
+  /**
+   * @remarks
+   * The latest submitted ACR container image configuration.
+   */
   container?: GetCustomAgentResponseBodyDataArtifactContainer;
   /**
    * @remarks
+   * The TCP port listened on by the agent service.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -222,6 +263,8 @@ export class GetCustomAgentResponseBodyDataArtifact extends $dara.Model {
 export class GetCustomAgentResponseBodyDataEnvironmentVariables extends $dara.Model {
   /**
    * @remarks
+   * The name of the environment variable.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -230,6 +273,8 @@ export class GetCustomAgentResponseBodyDataEnvironmentVariables extends $dara.Mo
   name?: string;
   /**
    * @remarks
+   * The string value of the environment variable. Empty strings are allowed.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -260,6 +305,10 @@ export class GetCustomAgentResponseBodyDataEnvironmentVariables extends $dara.Mo
 }
 
 export class GetCustomAgentResponseBodyDataEnvironment extends $dara.Model {
+  /**
+   * @remarks
+   * The latest submitted list of environment variables.
+   */
   variables?: GetCustomAgentResponseBodyDataEnvironmentVariables[];
   static names(): { [key: string]: string } {
     return {
@@ -287,31 +336,49 @@ export class GetCustomAgentResponseBodyDataEnvironment extends $dara.Model {
 
 export class GetCustomAgentResponseBodyDataHealthCheck extends $dara.Model {
   /**
+   * @remarks
+   * This parameter does not take effect.
+   * 
    * @example
    * 1
    */
   healthyThreshold?: number;
   /**
+   * @remarks
+   * The interval between two consecutive health checks, in seconds.
+   * 
    * @example
    * 10
    */
   intervalSeconds?: number;
   /**
+   * @remarks
+   * The HTTP health check path.
+   * 
    * @example
    * /healthz
    */
   path?: string;
   /**
+   * @remarks
+   * The port accessed for the HTTP health check.
+   * 
    * @example
    * 8080
    */
   port?: number;
   /**
+   * @remarks
+   * The timeout period for a single health check, in seconds.
+   * 
    * @example
    * 2
    */
   timeoutSeconds?: number;
   /**
+   * @remarks
+   * The number of consecutive health check failures required to mark the agent as unhealthy.
+   * 
    * @example
    * 3
    */
@@ -349,15 +416,25 @@ export class GetCustomAgentResponseBodyDataHealthCheck extends $dara.Model {
 
 export class GetCustomAgentResponseBodyDataLatestExecutionError extends $dara.Model {
   /**
+   * @remarks
+   * The cause code for the waiting or execution failure of the latest configuration. This code is used to determine the subsequent handling method.
+   * 
    * @example
    * AgentExecutionFailed
    */
   code?: string;
   /**
+   * @remarks
+   * The reason why the latest configuration is pending or failed to execute. Determine what to do next based on the code and retryable fields.
+   * 
    * @example
-   * Agent 执行失败，请检查配置后重新提交。
+   * Agent execution failed. Check the configuration and resubmit
    */
   message?: string;
+  /**
+   * @remarks
+   * Specifies whether automatic retries are 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.
+   */
   retryable?: boolean;
   static names(): { [key: string]: string } {
     return {
@@ -386,11 +463,17 @@ export class GetCustomAgentResponseBodyDataLatestExecutionError extends $dara.Mo
 
 export class GetCustomAgentResponseBodyDataLoggingSls extends $dara.Model {
   /**
+   * @remarks
+   * The name of the SLS Logstore that receives agent logs.
+   * 
    * @example
    * agent-runtime
    */
   logstore?: string;
   /**
+   * @remarks
+   * The name of the SLS project that receives agent logs.
+   * 
    * @example
    * my-agent-logs
    */
@@ -419,6 +502,10 @@ export class GetCustomAgentResponseBodyDataLoggingSls extends $dara.Model {
 }
 
 export class GetCustomAgentResponseBodyDataLogging extends $dara.Model {
+  /**
+   * @remarks
+   * The Simple Log Service (SLS) log delivery destination.
+   */
   sls?: GetCustomAgentResponseBodyDataLoggingSls;
   static names(): { [key: string]: string } {
     return {
@@ -445,6 +532,10 @@ export class GetCustomAgentResponseBodyDataLogging extends $dara.Model {
 }
 
 export class GetCustomAgentResponseBodyDataNetworkAccessInternet extends $dara.Model {
+  /**
+   * @remarks
+   * Specifies whether Internet access is allowed on the agent side. The actual access is still restricted by the workspace.
+   */
   enabled?: boolean;
   static names(): { [key: string]: string } {
     return {
@@ -468,6 +559,10 @@ export class GetCustomAgentResponseBodyDataNetworkAccessInternet extends $dara.M
 }
 
 export class GetCustomAgentResponseBodyDataNetworkAccessVpc 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.
+   */
   enabled?: boolean;
   static names(): { [key: string]: string } {
     return {
@@ -491,7 +586,15 @@ export class GetCustomAgentResponseBodyDataNetworkAccessVpc extends $dara.Model
 }
 
 export class GetCustomAgentResponseBodyDataNetwork 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 is still restricted by the workspace.
+   */
   accessInternet?: GetCustomAgentResponseBodyDataNetworkAccessInternet;
+  /**
+   * @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 is still restricted by the workspace.
+   */
   accessVpc?: GetCustomAgentResponseBodyDataNetworkAccessVpc;
   static names(): { [key: string]: string } {
     return {
@@ -524,20 +627,33 @@ export class GetCustomAgentResponseBodyDataNetwork extends $dara.Model {
 
 export class GetCustomAgentResponseBodyDataOssMounts extends $dara.Model {
   /**
+   * @remarks
+   * The name of the mounted OSS bucket.
+   * 
    * @example
    * my-agent-data
    */
   bucketName?: string;
   /**
+   * @remarks
+   * The OSS mount directory in the container, located under /mnt/oss/.
+   * 
    * @example
    * /mnt/oss/train
    */
   mountPath?: string;
   /**
+   * @remarks
+   * The object directory prefix in the mounted bucket.
+   * 
    * @example
    * datasets/train
    */
   path?: string;
+  /**
+   * @remarks
+   * 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(): { [key: string]: string } {
     return {
@@ -568,12 +684,17 @@ export class GetCustomAgentResponseBodyDataOssMounts extends $dara.Model {
 
 export class GetCustomAgentResponseBodyDataProtocolPaths extends $dara.Model {
   /**
+   * @remarks
+   * The usage description of the current API path.
+   * 
    * @example
-   * AG-UI 对话接口
+   * AG-UI conversation API
    */
   description?: string;
   /**
    * @remarks
+   * The API path corresponding to the current protocol.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -604,10 +725,23 @@ export class GetCustomAgentResponseBodyDataProtocolPaths extends $dara.Model {
 }
 
 export class GetCustomAgentResponseBodyDataProtocol extends $dara.Model {
+  /**
+   * @remarks
+   * The request header configurations for the current protocol, where the key is the name and the value is a string.
+   */
   headers?: { [key: string]: string };
+  /**
+   * @remarks
+   * The list of API paths corresponding to the current protocol.
+   */
   paths?: GetCustomAgentResponseBodyDataProtocolPaths[];
   /**
    * @remarks
+   * The invocation protocol type. Valid values:
+   * - agui: AG-UI protocol.
+   * - openai-chat-completion: OpenAI Chat Completions compatible protocol.
+   * - custom: Custom protocol.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -648,6 +782,11 @@ export class GetCustomAgentResponseBodyDataProtocol extends $dara.Model {
 export class GetCustomAgentResponseBodyDataRuntimeCompute extends $dara.Model {
   /**
    * @remarks
+   * The compute 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.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -678,12 +817,16 @@ export class GetCustomAgentResponseBodyDataRuntimeCompute extends $dara.Model {
 export class GetCustomAgentResponseBodyDataRuntimeHpa extends $dara.Model {
   /**
    * @remarks
+   * Specifies whether to enable elastic scaling. Valid values:
+   * - true: Enabled.
+   * - false: Disabled.
+   * 
    * This parameter is required.
    */
   enabled?: boolean;
   /**
    * @remarks
-   * 正整数，必须与 sessionTtlSeconds 同时配置。
+   * The configured maximum number of concurrent sessions per runtime instance.
    * 
    * @example
    * 100
@@ -691,7 +834,7 @@ export class GetCustomAgentResponseBodyDataRuntimeHpa extends $dara.Model {
   maxConcurrentSessionsPerSandbox?: number;
   /**
    * @remarks
-   * 开启时为正整数，关闭时为非负整数；不得小于 minSandboxCount。
+   * The configured maximum number of runtime instances.
    * 
    * @example
    * 10
@@ -699,7 +842,7 @@ export class GetCustomAgentResponseBodyDataRuntimeHpa extends $dara.Model {
   maxSandboxCount?: number;
   /**
    * @remarks
-   * 非负整数。开启弹性时必填；关闭时如提供上下限，必须成对提供。
+   * The configured minimum number of runtime instances.
    * 
    * @example
    * 1
@@ -707,7 +850,7 @@ export class GetCustomAgentResponseBodyDataRuntimeHpa extends $dara.Model {
   minSandboxCount?: number;
   /**
    * @remarks
-   * 正整数，必须与 maxConcurrentSessionsPerSandbox 同时配置。
+   * The configured session idle timeout limit, in seconds.
    * 
    * @example
    * 600
@@ -744,12 +887,21 @@ export class GetCustomAgentResponseBodyDataRuntimeHpa extends $dara.Model {
 
 export class GetCustomAgentResponseBodyDataRuntimeSessionPolicy extends $dara.Model {
   /**
+   * @remarks
+   * The name of the HTTP request header used by the session policy, applicable to ISOLATED_HEADER_FIELD.
+   * 
    * @example
    * X-Session-Id
    */
   headerName?: string;
   /**
    * @remarks
+   * The session policy type. Valid values:
+   * - AFFINITY: Session affinity.
+   * - ISOLATED_HEADER_FIELD: Uses the request header specified by headerName to associate sessions.
+   * - ISOLATED_COOKIE: Cookie-based session isolation. Not recommended.
+   * Note: The compatible value DISABLED in a request is returned as AFFINITY.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -782,16 +934,20 @@ export class GetCustomAgentResponseBodyDataRuntimeSessionPolicy extends $dara.Mo
 export class GetCustomAgentResponseBodyDataRuntime extends $dara.Model {
   /**
    * @remarks
+   * The compute resource configuration for the agent runtime instance.
+   * 
    * This parameter is required.
    */
   compute?: GetCustomAgentResponseBodyDataRuntimeCompute;
   /**
    * @remarks
-   * Agent 当前 spec 版本的 HPA 配置，与 Managed Agent 一致。开启时必须提供最小和最大 Sandbox 数；并发会话上限与会话空闲超时必须一起配置。
+   * The elastic policy configuration for the agent.
    */
   hpa?: GetCustomAgentResponseBodyDataRuntimeHpa;
   /**
    * @remarks
+   * The session policy configuration for the agent.
+   * 
    * This parameter is required.
    */
   sessionPolicy?: GetCustomAgentResponseBodyDataRuntimeSessionPolicy;
@@ -831,81 +987,173 @@ export class GetCustomAgentResponseBodyDataRuntime extends $dara.Model {
 
 export class GetCustomAgentResponseBodyData extends $dara.Model {
   /**
+   * @remarks
+   * The unique identifier of the custom agent. You can obtain this value from the response of CreateCustomAgent or ListCustomAgents.
+   * 
    * @example
    * agent-550e8400e29b41d4a716446655440000
    */
   agentId?: string;
+  /**
+   * @remarks
+   * The latest submitted list of additional AgenticFS mounts.
+   */
   agenticFsMounts?: GetCustomAgentResponseBodyDataAgenticFsMounts[];
+  /**
+   * @remarks
+   * The latest submitted deployment artifact configuration, including the service listening port and ACR container image. To determine whether the configuration has taken effect, check the latestVersionStatus field.
+   */
   artifact?: GetCustomAgentResponseBodyDataArtifact;
   /**
+   * @remarks
+   * The creation method of the agent. The value is CUSTOM for custom agents.
+   * 
    * @example
    * CUSTOM
    */
   createMode?: string;
   /**
+   * @remarks
+   * The creation time of the agent. The time is in ISO 8601 format. The trailing Z indicates the UTC time zone. Fractional seconds may be included.
+   * 
    * @example
    * 2026-10-10T06:00:00Z
    */
   createdAt?: string;
   /**
+   * @remarks
+   * The deployment method of the agent. Custom agents are deployed and managed by the platform, and the value is MANAGED.
+   * 
    * @example
    * MANAGED
    */
   deployType?: string;
   /**
+   * @remarks
+   * The description of the agent.
+   * 
    * @example
-   * 提供对话服务的自定义智能体
+   * Custom agent that provides conversation services
    */
   description?: string;
+  /**
+   * @remarks
+   * The environment variable configuration for the agent process.
+   */
   environment?: GetCustomAgentResponseBodyDataEnvironment;
+  /**
+   * @remarks
+   * The HTTP health check configuration of the agent. This field is empty if not configured.
+   */
   healthCheck?: GetCustomAgentResponseBodyDataHealthCheck;
   /**
    * @remarks
-   * 可选。仅解释同一响应 latestSpecVersion/latestVersionStatus 的等待或失败；正常待处理、执行中或成功时省略。消息由 Console 白名单映射，不返回原始运行时诊断、Checkpoint 或凭证。
+   * 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.
    */
   latestExecutionError?: GetCustomAgentResponseBodyDataLatestExecutionError;
   /**
+   * @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.
+   * 
    * @example
    * 1
    */
   latestSpecVersion?: number;
   /**
+   * @remarks
+   * The execution status corresponding to latestSpecVersion. Valid values:
+   * - pending: Waiting for execution.
+   * - processing: Executing.
+   * - waiting_retry: Waiting for a retry.
+   * - succeeded: Executed successfully.
+   * - failed: Execution failed.
+   * - superseded: Superseded by a subsequent version.
+   * 
    * @example
    * succeeded
    */
   latestVersionStatus?: string;
+  /**
+   * @remarks
+   * The latest submitted log delivery configuration.
+   */
   logging?: GetCustomAgentResponseBodyDataLogging;
   /**
+   * @remarks
+   * The name of the custom agent.
+   * 
    * @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.
+   */
   network?: GetCustomAgentResponseBodyDataNetwork;
+  /**
+   * @remarks
+   * The latest submitted list of OSS directory mounts.
+   */
   ossMounts?: GetCustomAgentResponseBodyDataOssMounts[];
+  /**
+   * @remarks
+   * The list of invocation protocol configurations for the agent.
+   */
   protocol?: GetCustomAgentResponseBodyDataProtocol[];
   /**
+   * @remarks
+   * The region ID of the workspace to which the agent belongs.
+   * 
    * @example
    * cn-hangzhou
    */
   regionId?: string;
   /**
+   * @remarks
+   * The ARN of the RAM role used by the agent to access user cloud resources.
+   * 
    * @example
    * acs:ram::1234567890123456:role/agentcore-runtime-role
    */
   roleArn?: string;
+  /**
+   * @remarks
+   * The latest committed runtime configuration, including compute specifications, session policy, and elastic policy.
+   */
   runtime?: GetCustomAgentResponseBodyDataRuntime;
+  /**
+   * @remarks
+   * The counts by runtime 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: The agent is being created.
+   * - Running: The agent is running.
+   * - Failed: The agent failed.
+   * - Updating: The agent is being updated.
+   * - Deleting: The agent is being deleted.
+   * - Deleted: The agent is deleted.
+   * To check the execution progress of the latest configuration, query latestVersionStatus.
+   * 
    * @example
    * Running
    */
   status?: string;
   /**
+   * @remarks
+   * The time when the agent was last updated. The time is in ISO 8601 format. A trailing Z indicates the UTC time zone. Fractional seconds may be included.
+   * 
    * @example
    * 2026-10-10T06:05:00Z
    */
   updatedAt?: string;
   /**
+   * @remarks
+   * The ID of the workspace to which the custom agent belongs.
+   * 
    * @example
    * ws-a1b2c3d4e5f6
    */
@@ -1012,26 +1260,46 @@ export class GetCustomAgentResponseBodyData extends $dara.Model {
 
 export class GetCustomAgentResponseBody extends $dara.Model {
   /**
+   * @remarks
+   * The request result code. The value is SUCCESS when the request is successful.
+   * 
    * @example
    * SUCCESS
    */
   code?: string;
+  /**
+   * @remarks
+   * The latest submitted configuration and status of the custom agent. To determine whether the configuration has taken effect, check the latestVersionStatus field.
+   */
   data?: GetCustomAgentResponseBodyData;
   /**
+   * @remarks
+   * The HTTP status code of the request. A value of 200 indicates success.
+   * 
    * @example
    * 200
    */
   httpStatusCode?: number;
   /**
+   * @remarks
+   * The result message of the request. The value is success when the request is successful.
+   * 
    * @example
    * success
    */
   message?: string;
   /**
+   * @remarks
+   * The unique identifier of the request, which is used to locate and troubleshoot issues.
+   * 
    * @example
    * 550E8400-E29B-41D4-A716-446655440000
    */
   requestId?: string;
+  /**
+   * @remarks
+   * Indicates whether the request was processed successfully. A value of true indicates success. Note that a successful creation, update, or deletion response does not mean that the background operation is complete.
+   */
   success?: boolean;
   static names(): { [key: string]: string } {
     return {