@alicloud/agentcore20260804 2.4.0 → 2.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (109) hide show
  1. package/dist/client.d.ts +144 -24
  2. package/dist/client.js +335 -24
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/CreateCustomAgentRequest.d.ts +63 -33
  5. package/dist/models/CreateCustomAgentRequest.js +27 -1
  6. package/dist/models/CreateCustomAgentRequest.js.map +1 -1
  7. package/dist/models/CreateCustomAgentResponseBody.d.ts +193 -41
  8. package/dist/models/CreateCustomAgentResponseBody.js +59 -1
  9. package/dist/models/CreateCustomAgentResponseBody.js.map +1 -1
  10. package/dist/models/CreateCustomAgentShrinkRequest.d.ts +1 -1
  11. package/dist/models/CreateImageCacheRequest.d.ts +122 -0
  12. package/dist/models/CreateImageCacheRequest.js +96 -0
  13. package/dist/models/CreateImageCacheRequest.js.map +1 -0
  14. package/dist/models/CreateImageCacheResponse.d.ts +19 -0
  15. package/dist/models/CreateImageCacheResponse.js +69 -0
  16. package/dist/models/CreateImageCacheResponse.js.map +1 -0
  17. package/dist/models/CreateImageCacheResponseBody.d.ts +260 -0
  18. package/dist/models/CreateImageCacheResponseBody.js +140 -0
  19. package/dist/models/CreateImageCacheResponseBody.js.map +1 -0
  20. package/dist/models/CreateImageCacheShrinkRequest.d.ts +50 -0
  21. package/dist/models/CreateImageCacheShrinkRequest.js +64 -0
  22. package/dist/models/CreateImageCacheShrinkRequest.js.map +1 -0
  23. package/dist/models/DeleteImageCacheRequest.d.ts +33 -0
  24. package/dist/models/DeleteImageCacheRequest.js +60 -0
  25. package/dist/models/DeleteImageCacheRequest.js.map +1 -0
  26. package/dist/models/DeleteImageCacheResponse.d.ts +19 -0
  27. package/dist/models/DeleteImageCacheResponse.js +69 -0
  28. package/dist/models/DeleteImageCacheResponse.js.map +1 -0
  29. package/dist/models/DeleteImageCacheResponseBody.d.ts +102 -0
  30. package/dist/models/DeleteImageCacheResponseBody.js +92 -0
  31. package/dist/models/DeleteImageCacheResponseBody.js.map +1 -0
  32. package/dist/models/GetCustomAgentResponseBody.d.ts +130 -66
  33. package/dist/models/GetCustomAgentResponseBody.js +31 -1
  34. package/dist/models/GetCustomAgentResponseBody.js.map +1 -1
  35. package/dist/models/GetImageCacheRequest.d.ts +33 -0
  36. package/dist/models/GetImageCacheRequest.js +60 -0
  37. package/dist/models/GetImageCacheRequest.js.map +1 -0
  38. package/dist/models/GetImageCacheResponse.d.ts +19 -0
  39. package/dist/models/GetImageCacheResponse.js +69 -0
  40. package/dist/models/GetImageCacheResponse.js.map +1 -0
  41. package/dist/models/GetImageCacheResponseBody.d.ts +264 -0
  42. package/dist/models/GetImageCacheResponseBody.js +140 -0
  43. package/dist/models/GetImageCacheResponseBody.js.map +1 -0
  44. package/dist/models/GetWorkspaceAcrRamAuthorizeUrlRequest.d.ts +2 -2
  45. package/dist/models/GetWorkspaceAcrRamAuthorizeUrlResponseBody.d.ts +23 -1
  46. package/dist/models/GetWorkspaceAcrRamAuthorizeUrlResponseBody.js.map +1 -1
  47. package/dist/models/ListImageCachesRequest.d.ts +113 -0
  48. package/dist/models/ListImageCachesRequest.js +80 -0
  49. package/dist/models/ListImageCachesRequest.js.map +1 -0
  50. package/dist/models/ListImageCachesResponse.d.ts +19 -0
  51. package/dist/models/ListImageCachesResponse.js +69 -0
  52. package/dist/models/ListImageCachesResponse.js.map +1 -0
  53. package/dist/models/ListImageCachesResponseBody.d.ts +290 -0
  54. package/dist/models/ListImageCachesResponseBody.js +146 -0
  55. package/dist/models/ListImageCachesResponseBody.js.map +1 -0
  56. package/dist/models/RetryImageCacheRequest.d.ts +60 -0
  57. package/dist/models/RetryImageCacheRequest.js +82 -0
  58. package/dist/models/RetryImageCacheRequest.js.map +1 -0
  59. package/dist/models/RetryImageCacheResponse.d.ts +19 -0
  60. package/dist/models/RetryImageCacheResponse.js +69 -0
  61. package/dist/models/RetryImageCacheResponse.js.map +1 -0
  62. package/dist/models/RetryImageCacheResponseBody.d.ts +264 -0
  63. package/dist/models/RetryImageCacheResponseBody.js +140 -0
  64. package/dist/models/RetryImageCacheResponseBody.js.map +1 -0
  65. package/dist/models/RetryImageCacheShrinkRequest.d.ts +48 -0
  66. package/dist/models/RetryImageCacheShrinkRequest.js +64 -0
  67. package/dist/models/RetryImageCacheShrinkRequest.js.map +1 -0
  68. package/dist/models/UpdateCustomAgentRequest.d.ts +68 -35
  69. package/dist/models/UpdateCustomAgentRequest.js +27 -1
  70. package/dist/models/UpdateCustomAgentRequest.js.map +1 -1
  71. package/dist/models/UpdateCustomAgentResponseBody.d.ts +184 -49
  72. package/dist/models/UpdateCustomAgentResponseBody.js +59 -1
  73. package/dist/models/UpdateCustomAgentResponseBody.js.map +1 -1
  74. package/dist/models/UpdateCustomAgentShrinkRequest.d.ts +2 -2
  75. package/dist/models/VerifyWorkspaceAcrRamAuthorizationResponseBody.d.ts +33 -3
  76. package/dist/models/VerifyWorkspaceAcrRamAuthorizationResponseBody.js.map +1 -1
  77. package/dist/models/model.d.ts +35 -0
  78. package/dist/models/model.js +157 -86
  79. package/dist/models/model.js.map +1 -1
  80. package/package.json +1 -1
  81. package/src/client.ts +371 -24
  82. package/src/models/CreateCustomAgentRequest.ts +80 -33
  83. package/src/models/CreateCustomAgentResponseBody.ts +233 -41
  84. package/src/models/CreateCustomAgentShrinkRequest.ts +1 -1
  85. package/src/models/CreateImageCacheRequest.ts +164 -0
  86. package/src/models/CreateImageCacheResponse.ts +40 -0
  87. package/src/models/CreateImageCacheResponseBody.ts +337 -0
  88. package/src/models/CreateImageCacheShrinkRequest.ts +69 -0
  89. package/src/models/DeleteImageCacheRequest.ts +48 -0
  90. package/src/models/DeleteImageCacheResponse.ts +40 -0
  91. package/src/models/DeleteImageCacheResponseBody.ts +140 -0
  92. package/src/models/GetCustomAgentResponseBody.ts +151 -66
  93. package/src/models/GetImageCacheRequest.ts +48 -0
  94. package/src/models/GetImageCacheResponse.ts +40 -0
  95. package/src/models/GetImageCacheResponseBody.ts +341 -0
  96. package/src/models/GetWorkspaceAcrRamAuthorizeUrlRequest.ts +2 -2
  97. package/src/models/GetWorkspaceAcrRamAuthorizeUrlResponseBody.ts +23 -1
  98. package/src/models/ListImageCachesRequest.ts +148 -0
  99. package/src/models/ListImageCachesResponse.ts +40 -0
  100. package/src/models/ListImageCachesResponseBody.ts +373 -0
  101. package/src/models/RetryImageCacheRequest.ts +90 -0
  102. package/src/models/RetryImageCacheResponse.ts +40 -0
  103. package/src/models/RetryImageCacheResponseBody.ts +341 -0
  104. package/src/models/RetryImageCacheShrinkRequest.ts +67 -0
  105. package/src/models/UpdateCustomAgentRequest.ts +85 -35
  106. package/src/models/UpdateCustomAgentResponseBody.ts +224 -49
  107. package/src/models/UpdateCustomAgentShrinkRequest.ts +2 -2
  108. package/src/models/VerifyWorkspaceAcrRamAuthorizationResponseBody.ts +33 -3
  109. package/src/models/model.ts +35 -0
@@ -13,7 +13,7 @@ export class CreateCustomAgentResponseBodyDataAgenticFsMounts extends $dara.Mode
13
13
  mountPath?: string;
14
14
  /**
15
15
  * @remarks
16
- * The relative directory within the mounted access point.
16
+ * The relative directory within the mounted AccessPoint.
17
17
  *
18
18
  * @example
19
19
  * workspace/data
@@ -21,7 +21,9 @@ export class CreateCustomAgentResponseBodyDataAgenticFsMounts extends $dara.Mode
21
21
  path?: string;
22
22
  /**
23
23
  * @remarks
24
- * Specifies whether the mount is read-only.
24
+ * Specifies whether the mount is read-only. Valid values:
25
+ * - true: The mount is read-only.
26
+ * - false: The mount is readable and writable.
25
27
  *
26
28
  * @example
27
29
  * false
@@ -29,7 +31,7 @@ export class CreateCustomAgentResponseBodyDataAgenticFsMounts extends $dara.Mode
29
31
  readOnly?: boolean;
30
32
  /**
31
33
  * @remarks
32
- * The domain name of the AgenticFS access point used for the mount.
34
+ * The domain name of the AgenticFS AccessPoint used for the mount.
33
35
  *
34
36
  * @example
35
37
  * ap-0123456789abcdef0.0123456789-vlm36.cn-hangzhou.nas.aliyuncs.com
@@ -169,7 +171,7 @@ export class CreateCustomAgentResponseBodyDataArtifactContainer extends $dara.Mo
169
171
  tag?: string;
170
172
  /**
171
173
  * @remarks
172
- * The image source type. A value of acr indicates Alibaba Cloud Container Registry.
174
+ * The source type of the image. A value of acr indicates Alibaba Cloud Container Registry (ACR).
173
175
  *
174
176
  * This parameter is required.
175
177
  *
@@ -221,7 +223,7 @@ export class CreateCustomAgentResponseBodyDataArtifact extends $dara.Model {
221
223
  container?: CreateCustomAgentResponseBodyDataArtifactContainer;
222
224
  /**
223
225
  * @remarks
224
- * The TCP port listened on by the agent service.
226
+ * The TCP port that the agent service listens on.
225
227
  *
226
228
  * This parameter is required.
227
229
  *
@@ -353,7 +355,7 @@ export class CreateCustomAgentResponseBodyDataHealthCheck extends $dara.Model {
353
355
  intervalSeconds?: number;
354
356
  /**
355
357
  * @remarks
356
- * The health check path.
358
+ * The HTTP health check path.
357
359
  *
358
360
  * @example
359
361
  * /healthz
@@ -414,18 +416,78 @@ export class CreateCustomAgentResponseBodyDataHealthCheck extends $dara.Model {
414
416
  }
415
417
  }
416
418
 
419
+ export class CreateCustomAgentResponseBodyDataImageCachePreparation extends $dara.Model {
420
+ /**
421
+ * @remarks
422
+ * The value is the same as imageCacheId in the same response and belongs to the current workspace.
423
+ *
424
+ * This parameter is required.
425
+ *
426
+ * @example
427
+ * img-example
428
+ */
429
+ imageId?: string;
430
+ /**
431
+ * @remarks
432
+ * The acceptance snapshot of the current request, which can be PENDING, READY, or FAILED. This does not represent the real-time status. You can query the real-time status later by calling GetImageCache.
433
+ *
434
+ * This parameter is required.
435
+ *
436
+ * @example
437
+ * PENDING
438
+ */
439
+ statusAtAcceptance?: string;
440
+ /**
441
+ * @remarks
442
+ * The value is fixed as ACCEPTED, indicating that the logical association and preparation intent are confirmed.
443
+ *
444
+ * This parameter is required.
445
+ *
446
+ * @example
447
+ * ACCEPTED
448
+ */
449
+ submissionStatus?: string;
450
+ static names(): { [key: string]: string } {
451
+ return {
452
+ imageId: 'imageId',
453
+ statusAtAcceptance: 'statusAtAcceptance',
454
+ submissionStatus: 'submissionStatus',
455
+ };
456
+ }
457
+
458
+ static types(): { [key: string]: any } {
459
+ return {
460
+ imageId: 'string',
461
+ statusAtAcceptance: 'string',
462
+ submissionStatus: 'string',
463
+ };
464
+ }
465
+
466
+ validate() {
467
+ super.validate();
468
+ }
469
+
470
+ constructor(map?: { [key: string]: any }) {
471
+ super(map);
472
+ }
473
+ }
474
+
417
475
  export class CreateCustomAgentResponseBodyDataLatestExecutionError extends $dara.Model {
418
476
  /**
419
477
  * @remarks
420
478
  * The reason code for the waiting or execution failure of the latest configuration. This code is used to determine the subsequent handling method.
421
479
  *
480
+ * This parameter is required.
481
+ *
422
482
  * @example
423
483
  * AgentExecutionFailed
424
484
  */
425
485
  code?: string;
426
486
  /**
427
487
  * @remarks
428
- * The description of the reason why the latest configuration is waiting or failed to execute. Refer to the code and retryable fields to determine what to do next.
488
+ * 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.
489
+ *
490
+ * This parameter is required.
429
491
  *
430
492
  * @example
431
493
  * Agent execution failed. Check the configuration and resubmit
@@ -433,7 +495,9 @@ export class CreateCustomAgentResponseBodyDataLatestExecutionError extends $dara
433
495
  message?: string;
434
496
  /**
435
497
  * @remarks
436
- * 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 the request.
498
+ * 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 reason, and then resubmit the request.
499
+ *
500
+ * This parameter is required.
437
501
  */
438
502
  retryable?: boolean;
439
503
  static names(): { [key: string]: string } {
@@ -464,7 +528,7 @@ export class CreateCustomAgentResponseBodyDataLatestExecutionError extends $dara
464
528
  export class CreateCustomAgentResponseBodyDataLoggingSls extends $dara.Model {
465
529
  /**
466
530
  * @remarks
467
- * The name of the Simple Log Service Logstore that receives the agent logs.
531
+ * The name of the Simple Log Service Logstore that receives agent logs.
468
532
  *
469
533
  * @example
470
534
  * agent-runtime
@@ -472,7 +536,7 @@ export class CreateCustomAgentResponseBodyDataLoggingSls extends $dara.Model {
472
536
  logstore?: string;
473
537
  /**
474
538
  * @remarks
475
- * The name of the Simple Log Service project that receives the agent logs.
539
+ * The name of the Simple Log Service project that receives agent logs.
476
540
  *
477
541
  * @example
478
542
  * my-agent-logs
@@ -588,12 +652,12 @@ export class CreateCustomAgentResponseBodyDataNetworkAccessVpc extends $dara.Mod
588
652
  export class CreateCustomAgentResponseBodyDataNetwork extends $dara.Model {
589
653
  /**
590
654
  * @remarks
591
- * 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.
655
+ * The Internet access configuration of the agent. If this parameter is not configured, Internet access is allowed on the agent side but is still restricted by the workspace.
592
656
  */
593
657
  accessInternet?: CreateCustomAgentResponseBodyDataNetworkAccessInternet;
594
658
  /**
595
659
  * @remarks
596
- * 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.
660
+ * The user VPC access configuration of the agent. If this parameter is not configured, user VPC access is allowed on the agent side but is still restricted by the workspace.
597
661
  */
598
662
  accessVpc?: CreateCustomAgentResponseBodyDataNetworkAccessVpc;
599
663
  static names(): { [key: string]: string } {
@@ -625,6 +689,33 @@ export class CreateCustomAgentResponseBodyDataNetwork extends $dara.Model {
625
689
  }
626
690
  }
627
691
 
692
+ export class CreateCustomAgentResponseBodyDataObservability extends $dara.Model {
693
+ /**
694
+ * @remarks
695
+ * Default value: true. If set to false, the platform Python probe is not loaded at runtime, and you must collect observability data yourself.
696
+ */
697
+ enabled?: boolean;
698
+ static names(): { [key: string]: string } {
699
+ return {
700
+ enabled: 'enabled',
701
+ };
702
+ }
703
+
704
+ static types(): { [key: string]: any } {
705
+ return {
706
+ enabled: 'boolean',
707
+ };
708
+ }
709
+
710
+ validate() {
711
+ super.validate();
712
+ }
713
+
714
+ constructor(map?: { [key: string]: any }) {
715
+ super(map);
716
+ }
717
+ }
718
+
628
719
  export class CreateCustomAgentResponseBodyDataOssMounts extends $dara.Model {
629
720
  /**
630
721
  * @remarks
@@ -636,7 +727,7 @@ export class CreateCustomAgentResponseBodyDataOssMounts extends $dara.Model {
636
727
  bucketName?: string;
637
728
  /**
638
729
  * @remarks
639
- * The OSS mount directory in the container, located under /mnt/oss/.
730
+ * The OSS mount directory in the container, which is located under /mnt/oss/.
640
731
  *
641
732
  * @example
642
733
  * /mnt/oss/train
@@ -652,7 +743,9 @@ export class CreateCustomAgentResponseBodyDataOssMounts extends $dara.Model {
652
743
  path?: string;
653
744
  /**
654
745
  * @remarks
655
- * Specifies whether the mount is read-only.
746
+ * Specifies whether the mount is read-only. Valid values:
747
+ * - true: The mount is read-only.
748
+ * - false: The mount is readable and writable.
656
749
  */
657
750
  readOnly?: boolean;
658
751
  static names(): { [key: string]: string } {
@@ -685,7 +778,7 @@ export class CreateCustomAgentResponseBodyDataOssMounts extends $dara.Model {
685
778
  export class CreateCustomAgentResponseBodyDataProtocolPaths extends $dara.Model {
686
779
  /**
687
780
  * @remarks
688
- * The usage description of the current API path.
781
+ * The purpose description of the current API path.
689
782
  *
690
783
  * @example
691
784
  * AG-UI conversation API
@@ -693,7 +786,7 @@ export class CreateCustomAgentResponseBodyDataProtocolPaths extends $dara.Model
693
786
  description?: string;
694
787
  /**
695
788
  * @remarks
696
- * The API path that corresponds to the current protocol.
789
+ * The API path corresponding to the current protocol.
697
790
  *
698
791
  * This parameter is required.
699
792
  *
@@ -727,7 +820,7 @@ export class CreateCustomAgentResponseBodyDataProtocolPaths extends $dara.Model
727
820
  export class CreateCustomAgentResponseBodyDataProtocol extends $dara.Model {
728
821
  /**
729
822
  * @remarks
730
- * The request header configuration for the current protocol. The key is the header name and the value is a string.
823
+ * The request header configuration for the current protocol. The key is the name and the value is a string.
731
824
  */
732
825
  headers?: { [key: string]: string };
733
826
  /**
@@ -811,7 +904,9 @@ export class CreateCustomAgentResponseBodyDataRuntimeCompute extends $dara.Model
811
904
  export class CreateCustomAgentResponseBodyDataRuntimeHpa extends $dara.Model {
812
905
  /**
813
906
  * @remarks
814
- * 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.
907
+ * Specifies whether to enable elastic scaling. Valid values:
908
+ * - true: Enabled.
909
+ * - false: Disabled.
815
910
  *
816
911
  * This parameter is required.
817
912
  */
@@ -842,7 +937,7 @@ export class CreateCustomAgentResponseBodyDataRuntimeHpa extends $dara.Model {
842
937
  minSandboxCount?: number;
843
938
  /**
844
939
  * @remarks
845
- * The maximum idle time for a session, in seconds.
940
+ * The maximum idle time configured for a session, in seconds.
846
941
  *
847
942
  * @example
848
943
  * 600
@@ -880,7 +975,7 @@ export class CreateCustomAgentResponseBodyDataRuntimeHpa extends $dara.Model {
880
975
  export class CreateCustomAgentResponseBodyDataRuntimeSessionPolicy extends $dara.Model {
881
976
  /**
882
977
  * @remarks
883
- * The name of the HTTP request header used by the session policy. This parameter applies to ISOLATED_HEADER_FIELD.
978
+ * The name of the HTTP request header used by the session policy. This parameter is applicable to ISOLATED_HEADER_FIELD.
884
979
  *
885
980
  * @example
886
981
  * X-Session-Id
@@ -888,7 +983,10 @@ export class CreateCustomAgentResponseBodyDataRuntimeSessionPolicy extends $dara
888
983
  headerName?: string;
889
984
  /**
890
985
  * @remarks
891
- * 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.
986
+ * The type of the session policy. Valid values:
987
+ * - AFFINITY: Session affinity.
988
+ * - ISOLATED_HEADER_FIELD: Uses the request header specified by headerName to associate sessions.
989
+ * ISOLATED_COOKIE is not recommended. The compatible value DISABLED in a request is returned as AFFINITY.
892
990
  *
893
991
  * This parameter is required.
894
992
  *
@@ -929,12 +1027,12 @@ export class CreateCustomAgentResponseBodyDataRuntime extends $dara.Model {
929
1027
  compute?: CreateCustomAgentResponseBodyDataRuntimeCompute;
930
1028
  /**
931
1029
  * @remarks
932
- * The elastic policy configuration for the agent.
1030
+ * The elastic policy configuration of the agent.
933
1031
  */
934
1032
  hpa?: CreateCustomAgentResponseBodyDataRuntimeHpa;
935
1033
  /**
936
1034
  * @remarks
937
- * The session policy configuration for the agent.
1035
+ * The session policy configuration of the agent.
938
1036
  *
939
1037
  * This parameter is required.
940
1038
  */
@@ -976,7 +1074,9 @@ export class CreateCustomAgentResponseBodyDataRuntime extends $dara.Model {
976
1074
  export class CreateCustomAgentResponseBodyData extends $dara.Model {
977
1075
  /**
978
1076
  * @remarks
979
- * The unique identifier of the custom agent. You can obtain this ID from the response of the CreateCustomAgent or ListCustomAgents operation.
1077
+ * The unique identifier of the custom agent. You can obtain this ID from the response of CreateCustomAgent or ListCustomAgents.
1078
+ *
1079
+ * This parameter is required.
980
1080
  *
981
1081
  * @example
982
1082
  * agent-550e8400e29b41d4a716446655440000
@@ -989,7 +1089,7 @@ export class CreateCustomAgentResponseBodyData extends $dara.Model {
989
1089
  agenticFsMounts?: CreateCustomAgentResponseBodyDataAgenticFsMounts[];
990
1090
  /**
991
1091
  * @remarks
992
- * 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.
1092
+ * The latest submitted deployment artifact configuration, including the service listening port and the ACR container image. To check whether the configuration has taken effect, refer to latestVersionStatus.
993
1093
  */
994
1094
  artifact?: CreateCustomAgentResponseBodyDataArtifact;
995
1095
  /**
@@ -1010,7 +1110,7 @@ export class CreateCustomAgentResponseBodyData extends $dara.Model {
1010
1110
  createdAt?: string;
1011
1111
  /**
1012
1112
  * @remarks
1013
- * The deployment method of the agent. Custom agents are deployed and managed by the platform, and the value is MANAGED.
1113
+ * The deployment method of the agent. Custom agents are deployed and managed by the platform. The value is MANAGED.
1014
1114
  *
1015
1115
  * @example
1016
1116
  * MANAGED
@@ -1018,12 +1118,25 @@ export class CreateCustomAgentResponseBodyData extends $dara.Model {
1018
1118
  deployType?: string;
1019
1119
  /**
1020
1120
  * @remarks
1021
- * The description of the agent.
1121
+ * The description of the agent\\"s purpose.
1022
1122
  *
1023
1123
  * @example
1024
- * Custom agent that provides conversation services
1124
+ * Custom agent that provides conversational services
1025
1125
  */
1026
1126
  description?: string;
1127
+ /**
1128
+ * @remarks
1129
+ * The value is null if no effective version exists. Do not use latestSpecVersion as a substitute. This field cannot be used to release the occupation protection of old cache instances.
1130
+ *
1131
+ * This parameter is required.
1132
+ *
1133
+ * @example
1134
+ * 1
1135
+ *
1136
+ * **if can be null:**
1137
+ * true
1138
+ */
1139
+ effectiveSpecVersion?: number;
1027
1140
  /**
1028
1141
  * @remarks
1029
1142
  * The environment variable configuration for the agent process.
@@ -1034,6 +1147,24 @@ export class CreateCustomAgentResponseBodyData extends $dara.Model {
1034
1147
  * The HTTP health check configuration of the agent. This field is empty if no health check is configured.
1035
1148
  */
1036
1149
  healthCheck?: CreateCustomAgentResponseBodyDataHealthCheck;
1150
+ /**
1151
+ * @remarks
1152
+ * This field is always returned. If useImageCache is true, the value is the non-empty logical ID of the current workspace. If useImageCache is 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.
1153
+ *
1154
+ * This parameter is required.
1155
+ *
1156
+ * @example
1157
+ * img-example
1158
+ *
1159
+ * **if can be null:**
1160
+ * true
1161
+ */
1162
+ imageCacheId?: string;
1163
+ /**
1164
+ * @remarks
1165
+ * This field is always returned when caching is enabled in the final configuration for creation or update, 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.
1166
+ */
1167
+ imageCachePreparation?: CreateCustomAgentResponseBodyDataImageCachePreparation;
1037
1168
  /**
1038
1169
  * @remarks
1039
1170
  * 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.
@@ -1041,7 +1172,9 @@ export class CreateCustomAgentResponseBodyData extends $dara.Model {
1041
1172
  latestExecutionError?: CreateCustomAgentResponseBodyDataLatestExecutionError;
1042
1173
  /**
1043
1174
  * @remarks
1044
- * 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.
1175
+ * 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.
1176
+ *
1177
+ * This parameter is required.
1045
1178
  *
1046
1179
  * @example
1047
1180
  * 1
@@ -1049,16 +1182,19 @@ export class CreateCustomAgentResponseBodyData extends $dara.Model {
1049
1182
  latestSpecVersion?: number;
1050
1183
  /**
1051
1184
  * @remarks
1052
- * The execution status corresponding to the latestSpecVersion. Valid values:
1053
- * - pending: Waiting for execution.
1185
+ * The execution status corresponding to latestSpecVersion. Valid values:
1186
+ * - pending: Pending execution.
1054
1187
  * - processing: Executing.
1055
1188
  * - waiting_retry: Waiting for retry.
1056
1189
  * - succeeded: Execution succeeded.
1057
1190
  * - failed: Execution failed.
1058
- * - superseded: Superseded by a later version.
1191
+ * - superseded: Superseded by a subsequent version.
1059
1192
  *
1060
1193
  * @example
1061
1194
  * succeeded
1195
+ *
1196
+ * **if can be null:**
1197
+ * true
1062
1198
  */
1063
1199
  latestVersionStatus?: string;
1064
1200
  /**
@@ -1070,15 +1206,22 @@ export class CreateCustomAgentResponseBodyData extends $dara.Model {
1070
1206
  * @remarks
1071
1207
  * The name of the custom agent.
1072
1208
  *
1209
+ * This parameter is required.
1210
+ *
1073
1211
  * @example
1074
1212
  * my-custom-agent
1075
1213
  */
1076
1214
  name?: string;
1077
1215
  /**
1078
1216
  * @remarks
1079
- * The network access configuration of the agent. The actual access scope is also restricted by the workspace network configuration.
1217
+ * The network access configuration of the agent. The actual access scope is also restricted by the network configuration of the workspace.
1080
1218
  */
1081
1219
  network?: CreateCustomAgentResponseBodyDataNetwork;
1220
+ /**
1221
+ * @remarks
1222
+ * The high-code agent observability configuration.
1223
+ */
1224
+ observability?: CreateCustomAgentResponseBodyDataObservability;
1082
1225
  /**
1083
1226
  * @remarks
1084
1227
  * The latest submitted list of OSS directory mounts.
@@ -1112,12 +1255,21 @@ export class CreateCustomAgentResponseBodyData extends $dara.Model {
1112
1255
  runtime?: CreateCustomAgentResponseBodyDataRuntime;
1113
1256
  /**
1114
1257
  * @remarks
1115
- * The statistics of instance counts 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.
1258
+ * 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.
1116
1259
  */
1117
1260
  sandboxPhaseCounts?: { [key: string]: number };
1118
1261
  /**
1119
1262
  * @remarks
1120
- * The overall status of the agent. Valid values: Creating, Running, Failed, Updating, Deleting, and Deleted. To query the execution progress of the latest configuration, check latestVersionStatus.
1263
+ * The overall status of the agent. Valid values:
1264
+ * - Creating: Creating.
1265
+ * - Running: Running.
1266
+ * - Failed: Failed.
1267
+ * - Updating: Updating.
1268
+ * - Deleting: Deleting.
1269
+ * - Deleted: Deleted.
1270
+ * To check the execution progress of the latest configuration, query latestVersionStatus.
1271
+ *
1272
+ * This parameter is required.
1121
1273
  *
1122
1274
  * @example
1123
1275
  * Running
@@ -1125,16 +1277,28 @@ export class CreateCustomAgentResponseBodyData extends $dara.Model {
1125
1277
  status?: string;
1126
1278
  /**
1127
1279
  * @remarks
1128
- * 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.
1280
+ * The time when the agent was last updated. The time follows the ISO 8601 standard and is displayed in UTC. Fractional seconds are supported.
1129
1281
  *
1130
1282
  * @example
1131
1283
  * 2026-10-10T06:05:00Z
1132
1284
  */
1133
1285
  updatedAt?: string;
1286
+ /**
1287
+ * @remarks
1288
+ * The image cache switch. This field is always returned and reflects the final accepted configuration. If this field is missing in historical data, false is returned. Do not infer the status based on the cache status.
1289
+ *
1290
+ * This parameter is required.
1291
+ *
1292
+ * @example
1293
+ * true
1294
+ */
1295
+ useImageCache?: boolean;
1134
1296
  /**
1135
1297
  * @remarks
1136
1298
  * The ID of the workspace to which the custom agent belongs.
1137
1299
  *
1300
+ * This parameter is required.
1301
+ *
1138
1302
  * @example
1139
1303
  * ws-a1b2c3d4e5f6
1140
1304
  */
@@ -1148,14 +1312,18 @@ export class CreateCustomAgentResponseBodyData extends $dara.Model {
1148
1312
  createdAt: 'createdAt',
1149
1313
  deployType: 'deployType',
1150
1314
  description: 'description',
1315
+ effectiveSpecVersion: 'effectiveSpecVersion',
1151
1316
  environment: 'environment',
1152
1317
  healthCheck: 'healthCheck',
1318
+ imageCacheId: 'imageCacheId',
1319
+ imageCachePreparation: 'imageCachePreparation',
1153
1320
  latestExecutionError: 'latestExecutionError',
1154
1321
  latestSpecVersion: 'latestSpecVersion',
1155
1322
  latestVersionStatus: 'latestVersionStatus',
1156
1323
  logging: 'logging',
1157
1324
  name: 'name',
1158
1325
  network: 'network',
1326
+ observability: 'observability',
1159
1327
  ossMounts: 'ossMounts',
1160
1328
  protocol: 'protocol',
1161
1329
  regionId: 'regionId',
@@ -1164,6 +1332,7 @@ export class CreateCustomAgentResponseBodyData extends $dara.Model {
1164
1332
  sandboxPhaseCounts: 'sandboxPhaseCounts',
1165
1333
  status: 'status',
1166
1334
  updatedAt: 'updatedAt',
1335
+ useImageCache: 'useImageCache',
1167
1336
  workspaceId: 'workspaceId',
1168
1337
  };
1169
1338
  }
@@ -1177,14 +1346,18 @@ export class CreateCustomAgentResponseBodyData extends $dara.Model {
1177
1346
  createdAt: 'string',
1178
1347
  deployType: 'string',
1179
1348
  description: 'string',
1349
+ effectiveSpecVersion: 'number',
1180
1350
  environment: CreateCustomAgentResponseBodyDataEnvironment,
1181
1351
  healthCheck: CreateCustomAgentResponseBodyDataHealthCheck,
1352
+ imageCacheId: 'string',
1353
+ imageCachePreparation: CreateCustomAgentResponseBodyDataImageCachePreparation,
1182
1354
  latestExecutionError: CreateCustomAgentResponseBodyDataLatestExecutionError,
1183
1355
  latestSpecVersion: 'number',
1184
1356
  latestVersionStatus: 'string',
1185
1357
  logging: CreateCustomAgentResponseBodyDataLogging,
1186
1358
  name: 'string',
1187
1359
  network: CreateCustomAgentResponseBodyDataNetwork,
1360
+ observability: CreateCustomAgentResponseBodyDataObservability,
1188
1361
  ossMounts: { 'type': 'array', 'itemType': CreateCustomAgentResponseBodyDataOssMounts },
1189
1362
  protocol: { 'type': 'array', 'itemType': CreateCustomAgentResponseBodyDataProtocol },
1190
1363
  regionId: 'string',
@@ -1193,6 +1366,7 @@ export class CreateCustomAgentResponseBodyData extends $dara.Model {
1193
1366
  sandboxPhaseCounts: { 'type': 'map', 'keyType': 'string', 'valueType': 'number' },
1194
1367
  status: 'string',
1195
1368
  updatedAt: 'string',
1369
+ useImageCache: 'boolean',
1196
1370
  workspaceId: 'string',
1197
1371
  };
1198
1372
  }
@@ -1210,6 +1384,9 @@ export class CreateCustomAgentResponseBodyData extends $dara.Model {
1210
1384
  if(this.healthCheck && typeof (this.healthCheck as any).validate === 'function') {
1211
1385
  (this.healthCheck as any).validate();
1212
1386
  }
1387
+ if(this.imageCachePreparation && typeof (this.imageCachePreparation as any).validate === 'function') {
1388
+ (this.imageCachePreparation as any).validate();
1389
+ }
1213
1390
  if(this.latestExecutionError && typeof (this.latestExecutionError as any).validate === 'function') {
1214
1391
  (this.latestExecutionError as any).validate();
1215
1392
  }
@@ -1219,6 +1396,9 @@ export class CreateCustomAgentResponseBodyData extends $dara.Model {
1219
1396
  if(this.network && typeof (this.network as any).validate === 'function') {
1220
1397
  (this.network as any).validate();
1221
1398
  }
1399
+ if(this.observability && typeof (this.observability as any).validate === 'function') {
1400
+ (this.observability as any).validate();
1401
+ }
1222
1402
  if(Array.isArray(this.ossMounts)) {
1223
1403
  $dara.Model.validateArray(this.ossMounts);
1224
1404
  }
@@ -1242,7 +1422,9 @@ export class CreateCustomAgentResponseBodyData extends $dara.Model {
1242
1422
  export class CreateCustomAgentResponseBody extends $dara.Model {
1243
1423
  /**
1244
1424
  * @remarks
1245
- * The request result code. The value is SUCCESS when the request is successful.
1425
+ * The request result code. The value is SUCCESS if the request is successful.
1426
+ *
1427
+ * This parameter is required.
1246
1428
  *
1247
1429
  * @example
1248
1430
  * SUCCESS
@@ -1251,11 +1433,15 @@ export class CreateCustomAgentResponseBody extends $dara.Model {
1251
1433
  /**
1252
1434
  * @remarks
1253
1435
  * 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.
1436
+ *
1437
+ * This parameter is required.
1254
1438
  */
1255
1439
  data?: CreateCustomAgentResponseBodyData;
1256
1440
  /**
1257
1441
  * @remarks
1258
- * The HTTP status code of the request. A value of 200 indicates success.
1442
+ * The HTTP status code returned. A value of 200 indicates that the request was successful.
1443
+ *
1444
+ * This parameter is required.
1259
1445
  *
1260
1446
  * @example
1261
1447
  * 200
@@ -1263,7 +1449,9 @@ export class CreateCustomAgentResponseBody extends $dara.Model {
1263
1449
  httpStatusCode?: number;
1264
1450
  /**
1265
1451
  * @remarks
1266
- * The processing result message of the request. The value is success when the request is successful.
1452
+ * The result message of the request. A value of success indicates that the request was successful.
1453
+ *
1454
+ * This parameter is required.
1267
1455
  *
1268
1456
  * @example
1269
1457
  * success
@@ -1271,7 +1459,9 @@ export class CreateCustomAgentResponseBody extends $dara.Model {
1271
1459
  message?: string;
1272
1460
  /**
1273
1461
  * @remarks
1274
- * The unique identifier of the request, which is used to locate and troubleshoot issues.
1462
+ * The ID of the request. You can use this ID to locate and troubleshoot issues.
1463
+ *
1464
+ * This parameter is required.
1275
1465
  *
1276
1466
  * @example
1277
1467
  * 550E8400-E29B-41D4-A716-446655440000
@@ -1279,7 +1469,9 @@ export class CreateCustomAgentResponseBody extends $dara.Model {
1279
1469
  requestId?: string;
1280
1470
  /**
1281
1471
  * @remarks
1282
- * Specifies 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.
1472
+ * Indicates whether the request was successful. A value of true indicates that the request was successful. A successful creation, update, or deletion response does not mean that the backend operation is complete.
1473
+ *
1474
+ * This parameter is required.
1283
1475
  */
1284
1476
  success?: boolean;
1285
1477
  static names(): { [key: string]: string } {
@@ -10,7 +10,7 @@ export class CreateCustomAgentShrinkRequest extends $dara.Model {
10
10
  bodyShrink?: string;
11
11
  /**
12
12
  * @remarks
13
- * Idempotency is not currently guaranteed. Do not rely on this parameter to prevent duplicate requests.
13
+ * Idempotence is not currently guaranteed. Do not rely on this parameter to prevent duplicate requests.
14
14
  *
15
15
  * @example
16
16
  * custom-agent-request-20261010-001