@alicloud/agentcore20260804 2.2.1 → 2.3.1

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 (105) hide show
  1. package/dist/client.d.ts +148 -2
  2. package/dist/client.js +284 -2
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/CreateCustomAgentRequest.d.ts +765 -0
  5. package/dist/models/CreateCustomAgentRequest.js +591 -0
  6. package/dist/models/CreateCustomAgentRequest.js.map +1 -0
  7. package/dist/models/CreateCustomAgentResponse.d.ts +19 -0
  8. package/dist/models/CreateCustomAgentResponse.js +69 -0
  9. package/dist/models/CreateCustomAgentResponse.js.map +1 -0
  10. package/dist/models/CreateCustomAgentResponseBody.d.ts +923 -0
  11. package/dist/models/CreateCustomAgentResponseBody.js +652 -0
  12. package/dist/models/CreateCustomAgentResponseBody.js.map +1 -0
  13. package/dist/models/CreateCustomAgentShrinkRequest.d.ts +26 -0
  14. package/dist/models/CreateCustomAgentShrinkRequest.js +60 -0
  15. package/dist/models/CreateCustomAgentShrinkRequest.js.map +1 -0
  16. package/dist/models/CreateExternalAgentRequest.d.ts +61 -14
  17. package/dist/models/CreateExternalAgentRequest.js +29 -1
  18. package/dist/models/CreateExternalAgentRequest.js.map +1 -1
  19. package/dist/models/CreateExternalAgentResponseBody.d.ts +171 -39
  20. package/dist/models/CreateExternalAgentResponseBody.js +89 -1
  21. package/dist/models/CreateExternalAgentResponseBody.js.map +1 -1
  22. package/dist/models/CreateExternalAgentShrinkRequest.d.ts +1 -1
  23. package/dist/models/DeleteCustomAgentRequest.d.ts +13 -0
  24. package/dist/models/DeleteCustomAgentRequest.js +54 -0
  25. package/dist/models/DeleteCustomAgentRequest.js.map +1 -0
  26. package/dist/models/DeleteCustomAgentResponse.d.ts +19 -0
  27. package/dist/models/DeleteCustomAgentResponse.js +69 -0
  28. package/dist/models/DeleteCustomAgentResponse.js.map +1 -0
  29. package/dist/models/DeleteCustomAgentResponseBody.d.ts +155 -0
  30. package/dist/models/DeleteCustomAgentResponseBody.js +110 -0
  31. package/dist/models/DeleteCustomAgentResponseBody.js.map +1 -0
  32. package/dist/models/GetCustomAgentRequest.d.ts +13 -0
  33. package/dist/models/GetCustomAgentRequest.js +54 -0
  34. package/dist/models/GetCustomAgentRequest.js.map +1 -0
  35. package/dist/models/GetCustomAgentResponse.d.ts +19 -0
  36. package/dist/models/GetCustomAgentResponse.js +69 -0
  37. package/dist/models/GetCustomAgentResponse.js.map +1 -0
  38. package/dist/models/GetCustomAgentResponseBody.d.ts +655 -0
  39. package/dist/models/GetCustomAgentResponseBody.js +652 -0
  40. package/dist/models/GetCustomAgentResponseBody.js.map +1 -0
  41. package/dist/models/GetExternalAgentResponseBody.d.ts +164 -43
  42. package/dist/models/GetExternalAgentResponseBody.js +89 -1
  43. package/dist/models/GetExternalAgentResponseBody.js.map +1 -1
  44. package/dist/models/ListCustomAgentsRequest.d.ts +29 -0
  45. package/dist/models/ListCustomAgentsRequest.js +60 -0
  46. package/dist/models/ListCustomAgentsRequest.js.map +1 -0
  47. package/dist/models/ListCustomAgentsResponse.d.ts +19 -0
  48. package/dist/models/ListCustomAgentsResponse.js +69 -0
  49. package/dist/models/ListCustomAgentsResponse.js.map +1 -0
  50. package/dist/models/ListCustomAgentsResponseBody.d.ts +248 -0
  51. package/dist/models/ListCustomAgentsResponseBody.js +171 -0
  52. package/dist/models/ListCustomAgentsResponseBody.js.map +1 -0
  53. package/dist/models/ListUsersRequest.d.ts +12 -4
  54. package/dist/models/ListUsersRequest.js +2 -0
  55. package/dist/models/ListUsersRequest.js.map +1 -1
  56. package/dist/models/ListUsersResponseBody.d.ts +14 -14
  57. package/dist/models/UpdateCustomAgentRequest.d.ts +757 -0
  58. package/dist/models/UpdateCustomAgentRequest.js +591 -0
  59. package/dist/models/UpdateCustomAgentRequest.js.map +1 -0
  60. package/dist/models/UpdateCustomAgentResponse.d.ts +19 -0
  61. package/dist/models/UpdateCustomAgentResponse.js +69 -0
  62. package/dist/models/UpdateCustomAgentResponse.js.map +1 -0
  63. package/dist/models/UpdateCustomAgentResponseBody.d.ts +910 -0
  64. package/dist/models/UpdateCustomAgentResponseBody.js +652 -0
  65. package/dist/models/UpdateCustomAgentResponseBody.js.map +1 -0
  66. package/dist/models/UpdateCustomAgentShrinkRequest.d.ts +26 -0
  67. package/dist/models/UpdateCustomAgentShrinkRequest.js +60 -0
  68. package/dist/models/UpdateCustomAgentShrinkRequest.js.map +1 -0
  69. package/dist/models/UpdateExternalAgentRequest.d.ts +59 -12
  70. package/dist/models/UpdateExternalAgentRequest.js +29 -1
  71. package/dist/models/UpdateExternalAgentRequest.js.map +1 -1
  72. package/dist/models/UpdateExternalAgentResponseBody.d.ts +175 -34
  73. package/dist/models/UpdateExternalAgentResponseBody.js +89 -1
  74. package/dist/models/UpdateExternalAgentResponseBody.js.map +1 -1
  75. package/dist/models/model.d.ts +135 -0
  76. package/dist/models/model.js +337 -65
  77. package/dist/models/model.js.map +1 -1
  78. package/package.json +1 -1
  79. package/src/client.ts +303 -2
  80. package/src/models/CreateCustomAgentRequest.ts +1129 -0
  81. package/src/models/CreateCustomAgentResponse.ts +40 -0
  82. package/src/models/CreateCustomAgentResponseBody.ts +1337 -0
  83. package/src/models/CreateCustomAgentShrinkRequest.ts +41 -0
  84. package/src/models/CreateExternalAgentRequest.ts +80 -14
  85. package/src/models/CreateExternalAgentResponseBody.ts +232 -39
  86. package/src/models/CreateExternalAgentShrinkRequest.ts +1 -1
  87. package/src/models/DeleteCustomAgentRequest.ts +24 -0
  88. package/src/models/DeleteCustomAgentResponse.ts +40 -0
  89. package/src/models/DeleteCustomAgentResponseBody.ts +211 -0
  90. package/src/models/GetCustomAgentRequest.ts +24 -0
  91. package/src/models/GetCustomAgentResponse.ts +40 -0
  92. package/src/models/GetCustomAgentResponseBody.ts +1069 -0
  93. package/src/models/GetExternalAgentResponseBody.ts +225 -43
  94. package/src/models/ListCustomAgentsRequest.ts +44 -0
  95. package/src/models/ListCustomAgentsResponse.ts +40 -0
  96. package/src/models/ListCustomAgentsResponseBody.ts +345 -0
  97. package/src/models/ListUsersRequest.ts +14 -4
  98. package/src/models/ListUsersResponseBody.ts +14 -14
  99. package/src/models/UpdateCustomAgentRequest.ts +1121 -0
  100. package/src/models/UpdateCustomAgentResponse.ts +40 -0
  101. package/src/models/UpdateCustomAgentResponseBody.ts +1324 -0
  102. package/src/models/UpdateCustomAgentShrinkRequest.ts +41 -0
  103. package/src/models/UpdateExternalAgentRequest.ts +78 -12
  104. package/src/models/UpdateExternalAgentResponseBody.ts +236 -34
  105. package/src/models/model.ts +135 -0
@@ -0,0 +1,1121 @@
1
+ // This file is auto-generated, don't edit it
2
+ import * as $dara from '@darabonba/typescript';
3
+
4
+
5
+ export class UpdateCustomAgentRequestBodyAgenticFsMounts extends $dara.Model {
6
+ /**
7
+ * @remarks
8
+ * The subdirectory under /mnt/agenticfs/ in the container. This field is required for each mount item. Mount targets must not be duplicated or form parent-child overrides.
9
+ *
10
+ * @example
11
+ * /mnt/agenticfs/data
12
+ */
13
+ mountPath?: string;
14
+ /**
15
+ * @remarks
16
+ * The existing non-empty relative directory under the access point. This field is required for each mount item. Root directories, absolute paths, and parent directory traversals are not allowed.
17
+ *
18
+ * @example
19
+ * workspace/data
20
+ */
21
+ path?: string;
22
+ /**
23
+ * @remarks
24
+ * 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.
25
+ *
26
+ * @example
27
+ * false
28
+ */
29
+ readOnly?: boolean;
30
+ /**
31
+ * @remarks
32
+ * The domain name of the access point. This field is required for each mount item. Use the DomainName value from the NAS ListAccessPoints response. Do not include the protocol, port, or path.
33
+ *
34
+ * @example
35
+ * ap-0123456789abcdef0.0123456789-vlm36.cn-hangzhou.nas.aliyuncs.com
36
+ */
37
+ server?: string;
38
+ static names(): { [key: string]: string } {
39
+ return {
40
+ mountPath: 'mountPath',
41
+ path: 'path',
42
+ readOnly: 'readOnly',
43
+ server: 'server',
44
+ };
45
+ }
46
+
47
+ static types(): { [key: string]: any } {
48
+ return {
49
+ mountPath: 'string',
50
+ path: 'string',
51
+ readOnly: 'boolean',
52
+ server: 'string',
53
+ };
54
+ }
55
+
56
+ validate() {
57
+ super.validate();
58
+ }
59
+
60
+ constructor(map?: { [key: string]: any }) {
61
+ super(map);
62
+ }
63
+ }
64
+
65
+ export class UpdateCustomAgentRequestBodyArtifactCode extends $dara.Model {
66
+ /**
67
+ * @remarks
68
+ * The startup entry point for the code package. Code package deployment is currently not supported. Omit this field.
69
+ *
70
+ * This parameter is required.
71
+ *
72
+ * @example
73
+ * python app.py
74
+ */
75
+ entrypoint?: string;
76
+ /**
77
+ * @remarks
78
+ * The language runtime identifier for the code package. Code package deployment is currently not supported. Omit this field.
79
+ *
80
+ * This parameter is required.
81
+ *
82
+ * @example
83
+ * python
84
+ */
85
+ languageRuntime?: string;
86
+ /**
87
+ * @remarks
88
+ * The source URI of the code package. Code package deployment is currently not supported. Omit this field.
89
+ *
90
+ * This parameter is required.
91
+ *
92
+ * @example
93
+ * oss://my-agent-bucket/packages/agent.zip
94
+ */
95
+ sourceUri?: string;
96
+ static names(): { [key: string]: string } {
97
+ return {
98
+ entrypoint: 'entrypoint',
99
+ languageRuntime: 'languageRuntime',
100
+ sourceUri: 'sourceUri',
101
+ };
102
+ }
103
+
104
+ static types(): { [key: string]: any } {
105
+ return {
106
+ entrypoint: 'string',
107
+ languageRuntime: 'string',
108
+ sourceUri: 'string',
109
+ };
110
+ }
111
+
112
+ validate() {
113
+ super.validate();
114
+ }
115
+
116
+ constructor(map?: { [key: string]: any }) {
117
+ super(map);
118
+ }
119
+ }
120
+
121
+ export class UpdateCustomAgentRequestBodyArtifactContainer extends $dara.Model {
122
+ /**
123
+ * @remarks
124
+ * 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 together.
125
+ *
126
+ * @example
127
+ * python app.py
128
+ */
129
+ entrypoint?: string;
130
+ /**
131
+ * @remarks
132
+ * The ID of the ACR instance to which the image repository belongs. This field cannot be empty.
133
+ *
134
+ * This parameter is required.
135
+ *
136
+ * @example
137
+ * cri-a1b2c3d4e5f6
138
+ */
139
+ instanceId?: string;
140
+ /**
141
+ * @remarks
142
+ * The namespace to which the ACR image repository belongs. This field cannot be empty.
143
+ *
144
+ * This parameter is required.
145
+ *
146
+ * @example
147
+ * my-agent
148
+ */
149
+ namespace?: string;
150
+ /**
151
+ * @remarks
152
+ * The name of the image repository in the ACR namespace. This field cannot be empty.
153
+ *
154
+ * This parameter is required.
155
+ *
156
+ * @example
157
+ * chat-agent
158
+ */
159
+ repo?: string;
160
+ /**
161
+ * @remarks
162
+ * The image tag used for deployment. This field cannot be empty. When updating the tag, you must also provide artifact.port and other required image fields.
163
+ *
164
+ * This parameter is required.
165
+ *
166
+ * @example
167
+ * v1.0.0
168
+ */
169
+ tag?: string;
170
+ /**
171
+ * @remarks
172
+ * The image source type. Currently, only acr is supported, which indicates Alibaba Cloud Container Registry (ACR).
173
+ *
174
+ * This parameter is required.
175
+ *
176
+ * @example
177
+ * acr
178
+ */
179
+ type?: string;
180
+ static names(): { [key: string]: string } {
181
+ return {
182
+ entrypoint: 'entrypoint',
183
+ instanceId: 'instanceId',
184
+ namespace: 'namespace',
185
+ repo: 'repo',
186
+ tag: 'tag',
187
+ type: 'type',
188
+ };
189
+ }
190
+
191
+ static types(): { [key: string]: any } {
192
+ return {
193
+ entrypoint: 'string',
194
+ instanceId: 'string',
195
+ namespace: 'string',
196
+ repo: 'string',
197
+ tag: 'string',
198
+ type: 'string',
199
+ };
200
+ }
201
+
202
+ validate() {
203
+ super.validate();
204
+ }
205
+
206
+ constructor(map?: { [key: string]: any }) {
207
+ super(map);
208
+ }
209
+ }
210
+
211
+ export class UpdateCustomAgentRequestBodyArtifact extends $dara.Model {
212
+ /**
213
+ * @remarks
214
+ * The code package deployment configuration. This is currently not supported. Omit this field and use artifact.container instead.
215
+ */
216
+ code?: UpdateCustomAgentRequestBodyArtifactCode;
217
+ /**
218
+ * @remarks
219
+ * The ACR container image configuration. You must specify the type, instanceId, namespace, repo, and tag fields. Do not configure the code field at the same time.
220
+ */
221
+ container?: UpdateCustomAgentRequestBodyArtifactContainer;
222
+ /**
223
+ * @remarks
224
+ * The TCP port listened to by the agent service. Valid values: 1 to 65535.
225
+ *
226
+ * This parameter is required.
227
+ *
228
+ * @example
229
+ * 8080
230
+ */
231
+ port?: number;
232
+ static names(): { [key: string]: string } {
233
+ return {
234
+ code: 'code',
235
+ container: 'container',
236
+ port: 'port',
237
+ };
238
+ }
239
+
240
+ static types(): { [key: string]: any } {
241
+ return {
242
+ code: UpdateCustomAgentRequestBodyArtifactCode,
243
+ container: UpdateCustomAgentRequestBodyArtifactContainer,
244
+ port: 'number',
245
+ };
246
+ }
247
+
248
+ validate() {
249
+ if(this.code && typeof (this.code as any).validate === 'function') {
250
+ (this.code as any).validate();
251
+ }
252
+ if(this.container && typeof (this.container as any).validate === 'function') {
253
+ (this.container as any).validate();
254
+ }
255
+ super.validate();
256
+ }
257
+
258
+ constructor(map?: { [key: string]: any }) {
259
+ super(map);
260
+ }
261
+ }
262
+
263
+ export class UpdateCustomAgentRequestBodyEnvironmentVariables extends $dara.Model {
264
+ /**
265
+ * @remarks
266
+ * The name of the environment variable. This field cannot be empty and must be unique within the current environment variable list.
267
+ *
268
+ * This parameter is required.
269
+ *
270
+ * @example
271
+ * LOG_LEVEL
272
+ */
273
+ name?: string;
274
+ /**
275
+ * @remarks
276
+ * The value of the environment variable. This must be a string. Empty strings are allowed.
277
+ *
278
+ * This parameter is required.
279
+ *
280
+ * @example
281
+ * info
282
+ */
283
+ value?: string;
284
+ static names(): { [key: string]: string } {
285
+ return {
286
+ name: 'name',
287
+ value: 'value',
288
+ };
289
+ }
290
+
291
+ static types(): { [key: string]: any } {
292
+ return {
293
+ name: 'string',
294
+ value: 'string',
295
+ };
296
+ }
297
+
298
+ validate() {
299
+ super.validate();
300
+ }
301
+
302
+ constructor(map?: { [key: string]: any }) {
303
+ super(map);
304
+ }
305
+ }
306
+
307
+ export class UpdateCustomAgentRequestBodyEnvironment extends $dara.Model {
308
+ /**
309
+ * @remarks
310
+ * The list of environment variables. Each item includes a name and a value. This list is replaced in its entirety during an update.
311
+ */
312
+ variables?: UpdateCustomAgentRequestBodyEnvironmentVariables[];
313
+ static names(): { [key: string]: string } {
314
+ return {
315
+ variables: 'variables',
316
+ };
317
+ }
318
+
319
+ static types(): { [key: string]: any } {
320
+ return {
321
+ variables: { 'type': 'array', 'itemType': UpdateCustomAgentRequestBodyEnvironmentVariables },
322
+ };
323
+ }
324
+
325
+ validate() {
326
+ if(Array.isArray(this.variables)) {
327
+ $dara.Model.validateArray(this.variables);
328
+ }
329
+ super.validate();
330
+ }
331
+
332
+ constructor(map?: { [key: string]: any }) {
333
+ super(map);
334
+ }
335
+ }
336
+
337
+ export class UpdateCustomAgentRequestBodyHealthCheck extends $dara.Model {
338
+ /**
339
+ * @remarks
340
+ * This parameter currently does not take effect. Omit this field.
341
+ *
342
+ * @example
343
+ * 1
344
+ */
345
+ healthyThreshold?: number;
346
+ /**
347
+ * @remarks
348
+ * The interval between two health checks, in seconds. This must be a positive integer. If omitted, the default value is 10.
349
+ *
350
+ * @example
351
+ * 10
352
+ */
353
+ intervalSeconds?: number;
354
+ /**
355
+ * @remarks
356
+ * The HTTP health check path. This must start with a forward slash (/). If omitted, the default value is /healthz.
357
+ *
358
+ * @example
359
+ * /healthz
360
+ */
361
+ path?: string;
362
+ /**
363
+ * @remarks
364
+ * The port accessed for health checks. This field is required when configuring a health check. Valid values: 1 to 65535.
365
+ *
366
+ * @example
367
+ * 8080
368
+ */
369
+ port?: number;
370
+ /**
371
+ * @remarks
372
+ * 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.
373
+ *
374
+ * @example
375
+ * 2
376
+ */
377
+ timeoutSeconds?: number;
378
+ /**
379
+ * @remarks
380
+ * The number of consecutive health check failures required to mark the agent as unhealthy. This must be a positive integer. If omitted, the default value is 3.
381
+ *
382
+ * @example
383
+ * 3
384
+ */
385
+ unhealthyThreshold?: number;
386
+ static names(): { [key: string]: string } {
387
+ return {
388
+ healthyThreshold: 'healthyThreshold',
389
+ intervalSeconds: 'intervalSeconds',
390
+ path: 'path',
391
+ port: 'port',
392
+ timeoutSeconds: 'timeoutSeconds',
393
+ unhealthyThreshold: 'unhealthyThreshold',
394
+ };
395
+ }
396
+
397
+ static types(): { [key: string]: any } {
398
+ return {
399
+ healthyThreshold: 'number',
400
+ intervalSeconds: 'number',
401
+ path: 'string',
402
+ port: 'number',
403
+ timeoutSeconds: 'number',
404
+ unhealthyThreshold: 'number',
405
+ };
406
+ }
407
+
408
+ validate() {
409
+ super.validate();
410
+ }
411
+
412
+ constructor(map?: { [key: string]: any }) {
413
+ super(map);
414
+ }
415
+ }
416
+
417
+ export class UpdateCustomAgentRequestBodyLoggingSls extends $dara.Model {
418
+ /**
419
+ * @remarks
420
+ * The name of the Simple Log Service logstore that receives agent logs.
421
+ *
422
+ * @example
423
+ * agent-runtime
424
+ */
425
+ logstore?: string;
426
+ /**
427
+ * @remarks
428
+ * The name of the Simple Log Service project that receives agent logs.
429
+ *
430
+ * @example
431
+ * my-agent-logs
432
+ */
433
+ project?: string;
434
+ static names(): { [key: string]: string } {
435
+ return {
436
+ logstore: 'logstore',
437
+ project: 'project',
438
+ };
439
+ }
440
+
441
+ static types(): { [key: string]: any } {
442
+ return {
443
+ logstore: 'string',
444
+ project: 'string',
445
+ };
446
+ }
447
+
448
+ validate() {
449
+ super.validate();
450
+ }
451
+
452
+ constructor(map?: { [key: string]: any }) {
453
+ super(map);
454
+ }
455
+ }
456
+
457
+ export class UpdateCustomAgentRequestBodyLogging extends $dara.Model {
458
+ /**
459
+ * @remarks
460
+ * The Simple Log Service log delivery destination. When updating this object, you must provide both the project and logstore fields, and they cannot be empty.
461
+ */
462
+ sls?: UpdateCustomAgentRequestBodyLoggingSls;
463
+ static names(): { [key: string]: string } {
464
+ return {
465
+ sls: 'sls',
466
+ };
467
+ }
468
+
469
+ static types(): { [key: string]: any } {
470
+ return {
471
+ sls: UpdateCustomAgentRequestBodyLoggingSls,
472
+ };
473
+ }
474
+
475
+ validate() {
476
+ if(this.sls && typeof (this.sls as any).validate === 'function') {
477
+ (this.sls as any).validate();
478
+ }
479
+ super.validate();
480
+ }
481
+
482
+ constructor(map?: { [key: string]: any }) {
483
+ super(map);
484
+ }
485
+ }
486
+
487
+ export class UpdateCustomAgentRequestBodyNetworkAccessInternet extends $dara.Model {
488
+ /**
489
+ * @remarks
490
+ * 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.
491
+ */
492
+ enabled?: boolean;
493
+ static names(): { [key: string]: string } {
494
+ return {
495
+ enabled: 'enabled',
496
+ };
497
+ }
498
+
499
+ static types(): { [key: string]: any } {
500
+ return {
501
+ enabled: 'boolean',
502
+ };
503
+ }
504
+
505
+ validate() {
506
+ super.validate();
507
+ }
508
+
509
+ constructor(map?: { [key: string]: any }) {
510
+ super(map);
511
+ }
512
+ }
513
+
514
+ export class UpdateCustomAgentRequestBodyNetworkAccessVpc extends $dara.Model {
515
+ /**
516
+ * @remarks
517
+ * 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.
518
+ */
519
+ enabled?: boolean;
520
+ static names(): { [key: string]: string } {
521
+ return {
522
+ enabled: 'enabled',
523
+ };
524
+ }
525
+
526
+ static types(): { [key: string]: any } {
527
+ return {
528
+ enabled: 'boolean',
529
+ };
530
+ }
531
+
532
+ validate() {
533
+ super.validate();
534
+ }
535
+
536
+ constructor(map?: { [key: string]: any }) {
537
+ super(map);
538
+ }
539
+ }
540
+
541
+ export class UpdateCustomAgentRequestBodyNetwork extends $dara.Model {
542
+ /**
543
+ * @remarks
544
+ * 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.
545
+ */
546
+ accessInternet?: UpdateCustomAgentRequestBodyNetworkAccessInternet;
547
+ /**
548
+ * @remarks
549
+ * 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.
550
+ */
551
+ accessVpc?: UpdateCustomAgentRequestBodyNetworkAccessVpc;
552
+ static names(): { [key: string]: string } {
553
+ return {
554
+ accessInternet: 'accessInternet',
555
+ accessVpc: 'accessVpc',
556
+ };
557
+ }
558
+
559
+ static types(): { [key: string]: any } {
560
+ return {
561
+ accessInternet: UpdateCustomAgentRequestBodyNetworkAccessInternet,
562
+ accessVpc: UpdateCustomAgentRequestBodyNetworkAccessVpc,
563
+ };
564
+ }
565
+
566
+ validate() {
567
+ if(this.accessInternet && typeof (this.accessInternet as any).validate === 'function') {
568
+ (this.accessInternet as any).validate();
569
+ }
570
+ if(this.accessVpc && typeof (this.accessVpc as any).validate === 'function') {
571
+ (this.accessVpc as any).validate();
572
+ }
573
+ super.validate();
574
+ }
575
+
576
+ constructor(map?: { [key: string]: any }) {
577
+ super(map);
578
+ }
579
+ }
580
+
581
+ export class UpdateCustomAgentRequestBodyOssMounts extends $dara.Model {
582
+ /**
583
+ * @remarks
584
+ * The name of the OSS bucket. This field is required for each mount item. The name must be 3 to 63 characters in length and can contain only lowercase letters, digits, and hyphens. It cannot start or end with a hyphen.
585
+ *
586
+ * @example
587
+ * my-agent-data
588
+ */
589
+ bucketName?: string;
590
+ /**
591
+ * @remarks
592
+ * The subdirectory under /mnt/oss/ in the container. This field is required for each mount item. Mount targets must not be duplicated or form parent-child overrides.
593
+ *
594
+ * @example
595
+ * /mnt/oss/train
596
+ */
597
+ mountPath?: string;
598
+ /**
599
+ * @remarks
600
+ * The non-empty object directory prefix in the bucket, such as datasets/train. Leading and trailing forward slashes (/) are removed. Root directories are not supported. Do not use parent directory traversals.
601
+ *
602
+ * @example
603
+ * datasets/train
604
+ */
605
+ path?: string;
606
+ /**
607
+ * @remarks
608
+ * 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.
609
+ */
610
+ readOnly?: boolean;
611
+ static names(): { [key: string]: string } {
612
+ return {
613
+ bucketName: 'bucketName',
614
+ mountPath: 'mountPath',
615
+ path: 'path',
616
+ readOnly: 'readOnly',
617
+ };
618
+ }
619
+
620
+ static types(): { [key: string]: any } {
621
+ return {
622
+ bucketName: 'string',
623
+ mountPath: 'string',
624
+ path: 'string',
625
+ readOnly: 'boolean',
626
+ };
627
+ }
628
+
629
+ validate() {
630
+ super.validate();
631
+ }
632
+
633
+ constructor(map?: { [key: string]: any }) {
634
+ super(map);
635
+ }
636
+ }
637
+
638
+ export class UpdateCustomAgentRequestBodyProtocolPaths extends $dara.Model {
639
+ /**
640
+ * @remarks
641
+ * The description of the current API path.
642
+ *
643
+ * @example
644
+ * AG-UI conversation API
645
+ */
646
+ description?: string;
647
+ /**
648
+ * @remarks
649
+ * The non-empty API path corresponding to the current protocol.
650
+ *
651
+ * This parameter is required.
652
+ *
653
+ * @example
654
+ * /agui
655
+ */
656
+ name?: string;
657
+ static names(): { [key: string]: string } {
658
+ return {
659
+ description: 'description',
660
+ name: 'name',
661
+ };
662
+ }
663
+
664
+ static types(): { [key: string]: any } {
665
+ return {
666
+ description: 'string',
667
+ name: 'string',
668
+ };
669
+ }
670
+
671
+ validate() {
672
+ super.validate();
673
+ }
674
+
675
+ constructor(map?: { [key: string]: any }) {
676
+ super(map);
677
+ }
678
+ }
679
+
680
+ export class UpdateCustomAgentRequestBodyProtocol extends $dara.Model {
681
+ /**
682
+ * @remarks
683
+ * The request header configuration for the current protocol. The key is a non-empty request header name, and the value must be a string.
684
+ */
685
+ headers?: { [key: string]: string };
686
+ /**
687
+ * @remarks
688
+ * The list of API paths corresponding to the current protocol.
689
+ */
690
+ paths?: UpdateCustomAgentRequestBodyProtocolPaths[];
691
+ /**
692
+ * @remarks
693
+ * The invocation protocol type. Valid values:
694
+ * - agui: AG-UI protocol.
695
+ * - openai-chat-completion: OpenAI Chat Completions compatible protocol.
696
+ * - custom: Custom protocol.
697
+ *
698
+ * This parameter is required.
699
+ *
700
+ * @example
701
+ * agui
702
+ */
703
+ type?: string;
704
+ static names(): { [key: string]: string } {
705
+ return {
706
+ headers: 'headers',
707
+ paths: 'paths',
708
+ type: 'type',
709
+ };
710
+ }
711
+
712
+ static types(): { [key: string]: any } {
713
+ return {
714
+ headers: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
715
+ paths: { 'type': 'array', 'itemType': UpdateCustomAgentRequestBodyProtocolPaths },
716
+ type: 'string',
717
+ };
718
+ }
719
+
720
+ validate() {
721
+ if(this.headers) {
722
+ $dara.Model.validateMap(this.headers);
723
+ }
724
+ if(Array.isArray(this.paths)) {
725
+ $dara.Model.validateArray(this.paths);
726
+ }
727
+ super.validate();
728
+ }
729
+
730
+ constructor(map?: { [key: string]: any }) {
731
+ super(map);
732
+ }
733
+ }
734
+
735
+ export class UpdateCustomAgentRequestBodyRuntimeCompute extends $dara.Model {
736
+ /**
737
+ * @remarks
738
+ * The compute specification. Valid values:
739
+ * - INTERACTIVE: 1 vCPU and 2 GiB of memory.
740
+ * - STANDARD: 2 vCPUs and 4 GiB of memory.
741
+ * - HEAVY: 4 vCPUs and 8 GiB of memory.
742
+ *
743
+ * This parameter is required.
744
+ *
745
+ * @example
746
+ * STANDARD
747
+ */
748
+ computeClass?: string;
749
+ static names(): { [key: string]: string } {
750
+ return {
751
+ computeClass: 'computeClass',
752
+ };
753
+ }
754
+
755
+ static types(): { [key: string]: any } {
756
+ return {
757
+ computeClass: 'string',
758
+ };
759
+ }
760
+
761
+ validate() {
762
+ super.validate();
763
+ }
764
+
765
+ constructor(map?: { [key: string]: any }) {
766
+ super(map);
767
+ }
768
+ }
769
+
770
+ export class UpdateCustomAgentRequestBodyRuntimeHpa extends $dara.Model {
771
+ /**
772
+ * @remarks
773
+ * Specifies whether to enable elastic scaling. Valid values:
774
+ * - true: Enabled.
775
+ * - false: Disabled.
776
+ * When runtime is provided, omitting this field defaults to false.
777
+ *
778
+ * This parameter is required.
779
+ */
780
+ enabled?: boolean;
781
+ /**
782
+ * @remarks
783
+ * 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.
784
+ *
785
+ * @example
786
+ * 100
787
+ */
788
+ maxConcurrentSessionsPerSandbox?: number;
789
+ /**
790
+ * @remarks
791
+ * 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.
792
+ *
793
+ * @example
794
+ * 10
795
+ */
796
+ maxSandboxCount?: number;
797
+ /**
798
+ * @remarks
799
+ * 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.
800
+ *
801
+ * @example
802
+ * 1
803
+ */
804
+ minSandboxCount?: number;
805
+ /**
806
+ * @remarks
807
+ * The session idle timeout in seconds. Valid values: 60 to 86400. When runtime is provided, omitting this field uses the default value of 600.
808
+ *
809
+ * @example
810
+ * 600
811
+ */
812
+ sessionTtlSeconds?: number;
813
+ static names(): { [key: string]: string } {
814
+ return {
815
+ enabled: 'enabled',
816
+ maxConcurrentSessionsPerSandbox: 'maxConcurrentSessionsPerSandbox',
817
+ maxSandboxCount: 'maxSandboxCount',
818
+ minSandboxCount: 'minSandboxCount',
819
+ sessionTtlSeconds: 'sessionTtlSeconds',
820
+ };
821
+ }
822
+
823
+ static types(): { [key: string]: any } {
824
+ return {
825
+ enabled: 'boolean',
826
+ maxConcurrentSessionsPerSandbox: 'number',
827
+ maxSandboxCount: 'number',
828
+ minSandboxCount: 'number',
829
+ sessionTtlSeconds: 'number',
830
+ };
831
+ }
832
+
833
+ validate() {
834
+ super.validate();
835
+ }
836
+
837
+ constructor(map?: { [key: string]: any }) {
838
+ super(map);
839
+ }
840
+ }
841
+
842
+ export class UpdateCustomAgentRequestBodyRuntimeSessionPolicy extends $dara.Model {
843
+ /**
844
+ * @remarks
845
+ * 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.
846
+ *
847
+ * @example
848
+ * X-Session-Id
849
+ */
850
+ headerName?: string;
851
+ /**
852
+ * @remarks
853
+ * The session policy type. Valid values:
854
+ * - AFFINITY: Session affinity.
855
+ * - ISOLATED_HEADER_FIELD: Associates sessions by using the request header specified by headerName.
856
+ * - ISOLATED_COOKIE: Not recommended.
857
+ * - DISABLED: A compatibility option. The response returns AFFINITY.
858
+ *
859
+ * This parameter is required.
860
+ *
861
+ * @example
862
+ * AFFINITY
863
+ */
864
+ type?: string;
865
+ static names(): { [key: string]: string } {
866
+ return {
867
+ headerName: 'headerName',
868
+ type: 'type',
869
+ };
870
+ }
871
+
872
+ static types(): { [key: string]: any } {
873
+ return {
874
+ headerName: 'string',
875
+ type: 'string',
876
+ };
877
+ }
878
+
879
+ validate() {
880
+ super.validate();
881
+ }
882
+
883
+ constructor(map?: { [key: string]: any }) {
884
+ super(map);
885
+ }
886
+ }
887
+
888
+ export class UpdateCustomAgentRequestBodyRuntime extends $dara.Model {
889
+ /**
890
+ * @remarks
891
+ * The compute resource configuration for the agent runtime instance.
892
+ *
893
+ * This parameter is required.
894
+ */
895
+ compute?: UpdateCustomAgentRequestBodyRuntimeCompute;
896
+ /**
897
+ * @remarks
898
+ * 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.
899
+ */
900
+ hpa?: UpdateCustomAgentRequestBodyRuntimeHpa;
901
+ /**
902
+ * @remarks
903
+ * The session policy configuration, which is used to set the session association method for requests.
904
+ *
905
+ * This parameter is required.
906
+ */
907
+ sessionPolicy?: UpdateCustomAgentRequestBodyRuntimeSessionPolicy;
908
+ static names(): { [key: string]: string } {
909
+ return {
910
+ compute: 'compute',
911
+ hpa: 'hpa',
912
+ sessionPolicy: 'sessionPolicy',
913
+ };
914
+ }
915
+
916
+ static types(): { [key: string]: any } {
917
+ return {
918
+ compute: UpdateCustomAgentRequestBodyRuntimeCompute,
919
+ hpa: UpdateCustomAgentRequestBodyRuntimeHpa,
920
+ sessionPolicy: UpdateCustomAgentRequestBodyRuntimeSessionPolicy,
921
+ };
922
+ }
923
+
924
+ validate() {
925
+ if(this.compute && typeof (this.compute as any).validate === 'function') {
926
+ (this.compute as any).validate();
927
+ }
928
+ if(this.hpa && typeof (this.hpa as any).validate === 'function') {
929
+ (this.hpa as any).validate();
930
+ }
931
+ if(this.sessionPolicy && typeof (this.sessionPolicy as any).validate === 'function') {
932
+ (this.sessionPolicy as any).validate();
933
+ }
934
+ super.validate();
935
+ }
936
+
937
+ constructor(map?: { [key: string]: any }) {
938
+ super(map);
939
+ }
940
+ }
941
+
942
+ export class UpdateCustomAgentRequestBody extends $dara.Model {
943
+ /**
944
+ * @remarks
945
+ * 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.
946
+ */
947
+ agenticFsMounts?: UpdateCustomAgentRequestBodyAgenticFsMounts[];
948
+ /**
949
+ * @remarks
950
+ * The deployment artifact configuration. Currently, only ACR container images are supported. Specify the container field and the service listening port field, and omit the code field. During an update, you must specify the port field and all required fields of the container object.
951
+ */
952
+ artifact?: UpdateCustomAgentRequestBodyArtifact;
953
+ /**
954
+ * @remarks
955
+ * The description of the agent\\"s 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.
956
+ *
957
+ * @example
958
+ * Custom agent that provides conversation services
959
+ */
960
+ description?: string;
961
+ /**
962
+ * @remarks
963
+ * The environment variable configuration for the agent process. Omitting this top-level field retains the original value. Providing this object but omitting the variables field clears the custom environment variables. To retain the variables, provide the complete list.
964
+ */
965
+ environment?: UpdateCustomAgentRequestBodyEnvironment;
966
+ /**
967
+ * @remarks
968
+ * The optional HTTP health check configuration. When providing this object, you must specify the port field. Other unspecified items use default values. Omitting this field during creation indicates no configuration. During an update, omitting this top-level field retains the original configuration, and passing null removes the health check.
969
+ */
970
+ healthCheck?: UpdateCustomAgentRequestBodyHealthCheck;
971
+ /**
972
+ * @remarks
973
+ * The log delivery configuration for the agent. You can specify the Simple Log Service project and logstore. After a successful creation or update, verify that logs are delivered properly.
974
+ */
975
+ logging?: UpdateCustomAgentRequestBodyLogging;
976
+ /**
977
+ * @remarks
978
+ * The name of the custom agent. The length must be 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 a blank name.
979
+ *
980
+ * @example
981
+ * my-custom-agent
982
+ */
983
+ name?: string;
984
+ /**
985
+ * @remarks
986
+ * 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.
987
+ */
988
+ network?: UpdateCustomAgentRequestBodyNetwork;
989
+ /**
990
+ * @remarks
991
+ * The list of OSS mounts. The total number of OSS and AgenticFS mounts cannot exceed 10. For each item, you must specify the bucketName, path, and mountPath fields. Mount targets must not be duplicated or overlap with each other. This list is replaced in its entirety during an update. Pass an empty array [] to clear the list.
992
+ */
993
+ ossMounts?: UpdateCustomAgentRequestBodyOssMounts[];
994
+ /**
995
+ * @remarks
996
+ * The list of invocation protocols supported by the agent. Each item includes the protocol type, along with optional paths and request headers. The entire list is replaced during an update.
997
+ */
998
+ protocol?: UpdateCustomAgentRequestBodyProtocol[];
999
+ /**
1000
+ * @remarks
1001
+ * 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.
1002
+ *
1003
+ * @example
1004
+ * acs:ram::1234567890123456:role/agentcore-runtime-role
1005
+ */
1006
+ roleArn?: string;
1007
+ /**
1008
+ * @remarks
1009
+ * The runtime configuration. When this object is provided, both compute and sessionPolicy must be present. To retain the original elastic policy, provide the complete hpa configuration. Omitting the top-level runtime field retains the original configuration.
1010
+ */
1011
+ runtime?: UpdateCustomAgentRequestBodyRuntime;
1012
+ static names(): { [key: string]: string } {
1013
+ return {
1014
+ agenticFsMounts: 'agenticFsMounts',
1015
+ artifact: 'artifact',
1016
+ description: 'description',
1017
+ environment: 'environment',
1018
+ healthCheck: 'healthCheck',
1019
+ logging: 'logging',
1020
+ name: 'name',
1021
+ network: 'network',
1022
+ ossMounts: 'ossMounts',
1023
+ protocol: 'protocol',
1024
+ roleArn: 'roleArn',
1025
+ runtime: 'runtime',
1026
+ };
1027
+ }
1028
+
1029
+ static types(): { [key: string]: any } {
1030
+ return {
1031
+ agenticFsMounts: { 'type': 'array', 'itemType': UpdateCustomAgentRequestBodyAgenticFsMounts },
1032
+ artifact: UpdateCustomAgentRequestBodyArtifact,
1033
+ description: 'string',
1034
+ environment: UpdateCustomAgentRequestBodyEnvironment,
1035
+ healthCheck: UpdateCustomAgentRequestBodyHealthCheck,
1036
+ logging: UpdateCustomAgentRequestBodyLogging,
1037
+ name: 'string',
1038
+ network: UpdateCustomAgentRequestBodyNetwork,
1039
+ ossMounts: { 'type': 'array', 'itemType': UpdateCustomAgentRequestBodyOssMounts },
1040
+ protocol: { 'type': 'array', 'itemType': UpdateCustomAgentRequestBodyProtocol },
1041
+ roleArn: 'string',
1042
+ runtime: UpdateCustomAgentRequestBodyRuntime,
1043
+ };
1044
+ }
1045
+
1046
+ validate() {
1047
+ if(Array.isArray(this.agenticFsMounts)) {
1048
+ $dara.Model.validateArray(this.agenticFsMounts);
1049
+ }
1050
+ if(this.artifact && typeof (this.artifact as any).validate === 'function') {
1051
+ (this.artifact as any).validate();
1052
+ }
1053
+ if(this.environment && typeof (this.environment as any).validate === 'function') {
1054
+ (this.environment as any).validate();
1055
+ }
1056
+ if(this.healthCheck && typeof (this.healthCheck as any).validate === 'function') {
1057
+ (this.healthCheck as any).validate();
1058
+ }
1059
+ if(this.logging && typeof (this.logging as any).validate === 'function') {
1060
+ (this.logging as any).validate();
1061
+ }
1062
+ if(this.network && typeof (this.network as any).validate === 'function') {
1063
+ (this.network as any).validate();
1064
+ }
1065
+ if(Array.isArray(this.ossMounts)) {
1066
+ $dara.Model.validateArray(this.ossMounts);
1067
+ }
1068
+ if(Array.isArray(this.protocol)) {
1069
+ $dara.Model.validateArray(this.protocol);
1070
+ }
1071
+ if(this.runtime && typeof (this.runtime as any).validate === 'function') {
1072
+ (this.runtime as any).validate();
1073
+ }
1074
+ super.validate();
1075
+ }
1076
+
1077
+ constructor(map?: { [key: string]: any }) {
1078
+ super(map);
1079
+ }
1080
+ }
1081
+
1082
+ export class UpdateCustomAgentRequest extends $dara.Model {
1083
+ /**
1084
+ * @remarks
1085
+ * 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 in their entirety.
1086
+ */
1087
+ body?: UpdateCustomAgentRequestBody;
1088
+ /**
1089
+ * @remarks
1090
+ * Idempotency is not currently guaranteed. Do not rely on this parameter to prevent duplicate requests.
1091
+ *
1092
+ * @example
1093
+ * custom-agent-request-20261010-001
1094
+ */
1095
+ clientToken?: string;
1096
+ static names(): { [key: string]: string } {
1097
+ return {
1098
+ body: 'body',
1099
+ clientToken: 'clientToken',
1100
+ };
1101
+ }
1102
+
1103
+ static types(): { [key: string]: any } {
1104
+ return {
1105
+ body: UpdateCustomAgentRequestBody,
1106
+ clientToken: 'string',
1107
+ };
1108
+ }
1109
+
1110
+ validate() {
1111
+ if(this.body && typeof (this.body as any).validate === 'function') {
1112
+ (this.body as any).validate();
1113
+ }
1114
+ super.validate();
1115
+ }
1116
+
1117
+ constructor(map?: { [key: string]: any }) {
1118
+ super(map);
1119
+ }
1120
+ }
1121
+