@alicloud/agentloop20260520 2.4.3 → 2.4.5

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 (64) hide show
  1. package/dist/client.d.ts +14 -14
  2. package/dist/client.js +26 -14
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/CreateAgentSpaceRequest.d.ts +11 -3
  5. package/dist/models/CreateAgentSpaceRequest.js +2 -0
  6. package/dist/models/CreateAgentSpaceRequest.js.map +1 -1
  7. package/dist/models/CreateContextStoreRequest.d.ts +69 -61
  8. package/dist/models/CreateContextStoreRequest.js +2 -0
  9. package/dist/models/CreateContextStoreRequest.js.map +1 -1
  10. package/dist/models/CreateContextStoreResponseBody.d.ts +2 -2
  11. package/dist/models/CreateExperimentPlanRequest.d.ts +9 -9
  12. package/dist/models/CreateExperimentPlanResponseBody.d.ts +3 -3
  13. package/dist/models/CreatePipelineRequest.d.ts +36 -36
  14. package/dist/models/CreatePipelineResponseBody.d.ts +1 -1
  15. package/dist/models/GetContextStoreResponseBody.d.ts +84 -78
  16. package/dist/models/GetContextStoreResponseBody.js +2 -0
  17. package/dist/models/GetContextStoreResponseBody.js.map +1 -1
  18. package/dist/models/GetDatasetRequest.d.ts +8 -0
  19. package/dist/models/GetDatasetRequest.js +6 -2
  20. package/dist/models/GetDatasetRequest.js.map +1 -1
  21. package/dist/models/GetDatasetResponseBody.d.ts +1 -1
  22. package/dist/models/GetExperimentPlanResponseBody.d.ts +10 -10
  23. package/dist/models/GetExperimentRunResponseBody.d.ts +1 -1
  24. package/dist/models/ListAgentSpacesRequest.d.ts +2 -2
  25. package/dist/models/ListAgentSpacesResponseBody.d.ts +15 -8
  26. package/dist/models/ListAgentSpacesResponseBody.js.map +1 -1
  27. package/dist/models/ListExperimentRunsRequest.d.ts +6 -6
  28. package/dist/models/ListExperimentRunsResponseBody.d.ts +2 -2
  29. package/dist/models/ModelParameters.d.ts +142 -6
  30. package/dist/models/ModelParameters.js +69 -1
  31. package/dist/models/ModelParameters.js.map +1 -1
  32. package/dist/models/UpdateContextStoreRequest.d.ts +58 -59
  33. package/dist/models/UpdateContextStoreRequest.js +2 -0
  34. package/dist/models/UpdateContextStoreRequest.js.map +1 -1
  35. package/dist/models/UpdateContextStoreResponseBody.d.ts +2 -2
  36. package/dist/models/UpdateExperimentPlanRequest.d.ts +5 -5
  37. package/dist/models/UpdateExperimentPlanResponseBody.d.ts +1 -1
  38. package/dist/models/model.d.ts +2 -0
  39. package/dist/models/model.js +15 -11
  40. package/dist/models/model.js.map +1 -1
  41. package/package.json +2 -1
  42. package/src/client.ts +28 -14
  43. package/src/models/CreateAgentSpaceRequest.ts +13 -3
  44. package/src/models/CreateContextStoreRequest.ts +71 -61
  45. package/src/models/CreateContextStoreResponseBody.ts +2 -2
  46. package/src/models/CreateExperimentPlanRequest.ts +9 -9
  47. package/src/models/CreateExperimentPlanResponseBody.ts +3 -3
  48. package/src/models/CreatePipelineRequest.ts +36 -36
  49. package/src/models/CreatePipelineResponseBody.ts +1 -1
  50. package/src/models/GetContextStoreResponseBody.ts +86 -78
  51. package/src/models/GetDatasetRequest.ts +10 -0
  52. package/src/models/GetDatasetResponseBody.ts +1 -1
  53. package/src/models/GetExperimentPlanResponseBody.ts +10 -10
  54. package/src/models/GetExperimentRunResponseBody.ts +1 -1
  55. package/src/models/ListAgentSpacesRequest.ts +2 -2
  56. package/src/models/ListAgentSpacesResponseBody.ts +15 -8
  57. package/src/models/ListExperimentRunsRequest.ts +6 -6
  58. package/src/models/ListExperimentRunsResponseBody.ts +2 -2
  59. package/src/models/ModelParameters.ts +192 -6
  60. package/src/models/UpdateContextStoreRequest.ts +60 -59
  61. package/src/models/UpdateContextStoreResponseBody.ts +2 -2
  62. package/src/models/UpdateExperimentPlanRequest.ts +5 -5
  63. package/src/models/UpdateExperimentPlanResponseBody.ts +1 -1
  64. package/src/models/model.ts +2 -0
@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
5
5
  export class CreateContextStoreRequestConfigAudit extends $dara.Model {
6
6
  /**
7
7
  * @remarks
8
- * Specifies whether to write item events for dropped recall candidates. Default value: false.
8
+ * Specifies whether to write item events for dropped retrieval candidates. Default value: false.
9
9
  *
10
10
  * @example
11
11
  * false
@@ -13,7 +13,7 @@ export class CreateContextStoreRequestConfigAudit extends $dara.Model {
13
13
  droppedCandidates?: boolean;
14
14
  /**
15
15
  * @remarks
16
- * The recording mode for recall queries. Valid values: raw (plaintext) and hash (HMAC only). Default value: raw.
16
+ * The recording mode for retrieval queries. Valid values: raw (plaintext) and hash (HMAC only). Default value: raw.
17
17
  *
18
18
  * @example
19
19
  * raw
@@ -55,7 +55,7 @@ export class CreateContextStoreRequestConfigAudit extends $dara.Model {
55
55
  export class CreateContextStoreRequestConfigExtractionPoliciesModel extends $dara.Model {
56
56
  /**
57
57
  * @remarks
58
- * The name of the extraction model. Currently, only qwen3.8-flash is supported. Platform internal credentials are used.
58
+ * The name of the extraction model. Currently, only qwen3.8-flash is supported, which uses internal platform credentials.
59
59
  *
60
60
  * @example
61
61
  * qwen3.8-flash
@@ -85,7 +85,7 @@ export class CreateContextStoreRequestConfigExtractionPoliciesModel extends $dar
85
85
  export class CreateContextStoreRequestConfigExtractionPoliciesStoragePolicy extends $dara.Model {
86
86
  /**
87
87
  * @remarks
88
- * The allowed storage actions. Default value: all actions (ADD, UPDATE, MERGE, and DELETE).
88
+ * The allowed storage actions. Default value: all. Valid values: ADD, UPDATE, MERGE, and DELETE.
89
89
  *
90
90
  * @example
91
91
  * ["ADD","UPDATE","MERGE","DELETE"]
@@ -101,7 +101,7 @@ export class CreateContextStoreRequestConfigExtractionPoliciesStoragePolicy exte
101
101
  dedupe?: boolean;
102
102
  /**
103
103
  * @remarks
104
- * Specifies whether to enable human edit protection. Default value: true. When enabled, automatic extraction does not overwrite manually modified memories.
104
+ * Specifies whether to enable human edit protection. Default value: true. If enabled, automatic extraction does not overwrite manually modified memories.
105
105
  *
106
106
  * @example
107
107
  * true
@@ -109,7 +109,7 @@ export class CreateContextStoreRequestConfigExtractionPoliciesStoragePolicy exte
109
109
  humanEditProtection?: boolean;
110
110
  /**
111
111
  * @remarks
112
- * The merge key for upsert operations. Valid values: factKey, semantic, and both. Default value: semantic.
112
+ * The upsert merge key. Valid values: factKey, semantic, and both. Default value: semantic.
113
113
  *
114
114
  * @example
115
115
  * semantic
@@ -117,7 +117,7 @@ export class CreateContextStoreRequestConfigExtractionPoliciesStoragePolicy exte
117
117
  mergeKey?: string;
118
118
  /**
119
119
  * @remarks
120
- * The storage mode. Valid values: event (event append) and upsert (merge update). Default value: upsert.
120
+ * The storage mode. Valid values: event (event append) and upsert (merge and update). Default value: upsert.
121
121
  *
122
122
  * @example
123
123
  * upsert
@@ -125,7 +125,7 @@ export class CreateContextStoreRequestConfigExtractionPoliciesStoragePolicy exte
125
125
  mode?: string;
126
126
  /**
127
127
  * @remarks
128
- * The similarity threshold for semantic merging. Valid values: 0 to 1. Default value: 0.4.
128
+ * The semantic merge similarity threshold. Valid values: 0 to 1. Default value: 0.4.
129
129
  *
130
130
  * @example
131
131
  * 0.4
@@ -133,7 +133,7 @@ export class CreateContextStoreRequestConfigExtractionPoliciesStoragePolicy exte
133
133
  similarityThreshold?: number;
134
134
  /**
135
135
  * @remarks
136
- * The number of days before memories expire. A value of 0 indicates that memories do not expire.
136
+ * The number of days before a memory expires. A value of 0 indicates that the memory does not expire.
137
137
  *
138
138
  * @example
139
139
  * 0
@@ -186,7 +186,7 @@ export class CreateContextStoreRequestConfigExtractionPolicies extends $dara.Mod
186
186
  categories?: string[];
187
187
  /**
188
188
  * @remarks
189
- * The custom extraction instructions. This parameter is required when preset is set to custom. Length: 1 to 8,000 characters.
189
+ * The custom extraction instructions. This parameter is required when preset is set to custom. The length must be 1 to 8,000 characters.
190
190
  *
191
191
  * @example
192
192
  * Extract only user product preferences
@@ -194,7 +194,7 @@ export class CreateContextStoreRequestConfigExtractionPolicies extends $dara.Mod
194
194
  customInstructions?: string;
195
195
  /**
196
196
  * @remarks
197
- * Specifies whether to apply this policy to new inputs. Default value: true. Disabling the policy does not delete historical memories.
197
+ * Specifies whether to execute this policy for new input. Default value: true. Disabling the policy does not delete historical memories.
198
198
  *
199
199
  * @example
200
200
  * true
@@ -202,7 +202,7 @@ export class CreateContextStoreRequestConfigExtractionPolicies extends $dara.Mod
202
202
  enabled?: boolean;
203
203
  /**
204
204
  * @remarks
205
- * The list of exclusion rules. Content that matches these rules is not extracted.
205
+ * The list of exclusion rules. Content that matches the rules is not extracted.
206
206
  *
207
207
  * @example
208
208
  * ["Password","ID number"]
@@ -210,7 +210,7 @@ export class CreateContextStoreRequestConfigExtractionPolicies extends $dara.Mod
210
210
  excludeRules?: string[];
211
211
  /**
212
212
  * @remarks
213
- * The extraction model configuration.
213
+ * The configuration of the extraction model.
214
214
  */
215
215
  model?: CreateContextStoreRequestConfigExtractionPoliciesModel;
216
216
  /**
@@ -231,12 +231,12 @@ export class CreateContextStoreRequestConfigExtractionPolicies extends $dara.Mod
231
231
  preset?: string;
232
232
  /**
233
233
  * @remarks
234
- * The independent storage rules for this policy. If omitted, the original values are retained. New policies use default values. Repeatedly confirmed memories refresh the validity period by default.
234
+ * The independent storage rule for this policy. If omitted, the original value is retained. New policies use the default value. Repeatedly confirmed memories refresh the validity period by default.
235
235
  */
236
236
  storagePolicy?: CreateContextStoreRequestConfigExtractionPoliciesStoragePolicy;
237
237
  /**
238
238
  * @remarks
239
- * The ID of the extraction policy. This parameter is optional. If omitted, the default value is used. The ID must start with a letter and can contain only letters, digits, underscores, and hyphens. Maximum length: 64 characters. After default processing, the ID must be unique within the same library. Modifying the name or instructions does not change this ID.
239
+ * The ID of the extraction policy. This parameter is optional. If omitted, the default value is default. The ID must start with a letter and can contain only letters, digits, underscores, and hyphens. It can be up to 64 characters in length. After default value processing, the ID must be unique within the same database. Modifying the name or instructions does not change this ID.
240
240
  *
241
241
  * @example
242
242
  * preferences
@@ -294,7 +294,7 @@ export class CreateContextStoreRequestConfigExtractionPolicies extends $dara.Mod
294
294
  export class CreateContextStoreRequestConfigExtractionPolicyModel extends $dara.Model {
295
295
  /**
296
296
  * @remarks
297
- * The name of the extraction model. Currently, only qwen3.8-flash is supported. Platform internal credentials are used.
297
+ * The name of the extraction model. Currently, only qwen3.8-flash is supported, which uses internal platform credentials.
298
298
  *
299
299
  * @example
300
300
  * qwen3.8-flash
@@ -332,7 +332,7 @@ export class CreateContextStoreRequestConfigExtractionPolicy extends $dara.Model
332
332
  categories?: string[];
333
333
  /**
334
334
  * @remarks
335
- * The custom extraction instructions. This parameter is required when preset is set to custom. Length: 1 to 8,000 characters.
335
+ * The custom extraction instructions. This parameter is required when preset is set to custom. The length must be 1 to 8,000 characters.
336
336
  *
337
337
  * @example
338
338
  * Extract only user product preferences
@@ -340,7 +340,7 @@ export class CreateContextStoreRequestConfigExtractionPolicy extends $dara.Model
340
340
  customInstructions?: string;
341
341
  /**
342
342
  * @remarks
343
- * The list of exclusion rules. Content that matches these rules is not extracted.
343
+ * The list of exclusion rules. Content that matches the rules is not extracted.
344
344
  *
345
345
  * @example
346
346
  * ["Password","ID number"]
@@ -348,7 +348,7 @@ export class CreateContextStoreRequestConfigExtractionPolicy extends $dara.Model
348
348
  excludeRules?: string[];
349
349
  /**
350
350
  * @remarks
351
- * The extraction model configuration.
351
+ * The configuration of the extraction model.
352
352
  */
353
353
  model?: CreateContextStoreRequestConfigExtractionPolicyModel;
354
354
  /**
@@ -400,7 +400,7 @@ export class CreateContextStoreRequestConfigExtractionPolicy extends $dara.Model
400
400
  export class CreateContextStoreRequestConfigScopePolicy extends $dara.Model {
401
401
  /**
402
402
  * @remarks
403
- * Specifies that at least one of the specified scope fields must be non-empty. Valid values for elements: userId, agentId, appId, and runId.
403
+ * The list of scope fields where at least one must be non-empty. Valid values for elements: userId, agentId, appId, and runId.
404
404
  *
405
405
  * @example
406
406
  * ["userId"]
@@ -533,7 +533,7 @@ export class CreateContextStoreRequestConfigSourceDatasetFilter extends $dara.Mo
533
533
  export class CreateContextStoreRequestConfigSourceDatasetVersionPolicy extends $dara.Model {
534
534
  /**
535
535
  * @remarks
536
- * The consumption mode. Valid values: follow (incremental consumption based on __dataset_seq) and fixed (full consumption of the specified ACTIVE version once).
536
+ * The version consumption mode. Valid values: follow, which consumes data incrementally by __dataset_seq, and fixed, which consumes the specified ACTIVE version in full at once.
537
537
  *
538
538
  * @example
539
539
  * follow
@@ -541,7 +541,7 @@ export class CreateContextStoreRequestConfigSourceDatasetVersionPolicy extends $
541
541
  mode?: string;
542
542
  /**
543
543
  * @remarks
544
- * The starting __dataset_seq for the follow mode.
544
+ * The start __dataset_seq for the follow mode.
545
545
  *
546
546
  * @example
547
547
  * 0
@@ -549,7 +549,7 @@ export class CreateContextStoreRequestConfigSourceDatasetVersionPolicy extends $
549
549
  startSeq?: number;
550
550
  /**
551
551
  * @remarks
552
- * The Dataset version specified for the fixed mode.
552
+ * The dataset version specified for the fixed mode.
553
553
  *
554
554
  * @example
555
555
  * v3
@@ -588,7 +588,7 @@ export class CreateContextStoreRequestConfigSourceDataset extends $dara.Model {
588
588
  customFields?: CreateContextStoreRequestConfigSourceDatasetCustomFields[];
589
589
  /**
590
590
  * @remarks
591
- * The name of the Dataset in the same AgentSpace. This parameter cannot be modified after creation.
591
+ * The name of the dataset in the same AgentSpace. This parameter cannot be modified after creation.
592
592
  *
593
593
  * @example
594
594
  * trajectory-with-crm-profile
@@ -609,7 +609,7 @@ export class CreateContextStoreRequestConfigSourceDataset extends $dara.Model {
609
609
  pollIntervalSeconds?: number;
610
610
  /**
611
611
  * @remarks
612
- * The row schema contract of the Dataset. In the current version, this parameter is fixed to MemorySourceV1.
612
+ * The row schema contract for the dataset. In the current phase, the value is fixed to MemorySourceV1.
613
613
  *
614
614
  * @example
615
615
  * MemorySourceV1
@@ -617,7 +617,7 @@ export class CreateContextStoreRequestConfigSourceDataset extends $dara.Model {
617
617
  schemaContract?: string;
618
618
  /**
619
619
  * @remarks
620
- * The version consumption policy of the Dataset.
620
+ * The version consumption policy for the dataset.
621
621
  */
622
622
  versionPolicy?: CreateContextStoreRequestConfigSourceDatasetVersionPolicy;
623
623
  static names(): { [key: string]: string } {
@@ -671,7 +671,7 @@ export class CreateContextStoreRequestConfigSourceTrajectoryFilter extends $dara
671
671
  agentNames?: string[];
672
672
  /**
673
673
  * @remarks
674
- * Specifies whether to exclude degraded trajectories. Default value: false (degraded trajectories are included).
674
+ * Specifies whether to exclude degraded trajectories. Default value: false, which means degraded trajectories are included.
675
675
  *
676
676
  * @example
677
677
  * false
@@ -679,7 +679,7 @@ export class CreateContextStoreRequestConfigSourceTrajectoryFilter extends $dara
679
679
  excludeDegraded?: boolean;
680
680
  /**
681
681
  * @remarks
682
- * The minimum number of steps, which must be greater than or equal to 0.
682
+ * The minimum number of steps. The value must be greater than or equal to 0.
683
683
  *
684
684
  * @example
685
685
  * 2
@@ -687,7 +687,7 @@ export class CreateContextStoreRequestConfigSourceTrajectoryFilter extends $dara
687
687
  minStepCount?: number;
688
688
  /**
689
689
  * @remarks
690
- * The native Simple Log Service (SLS) query statement, which is combined with the preceding conditions using AND.
690
+ * The native Simple Log Service (SLS) query statement. It is combined with the preceding conditions using AND.
691
691
  *
692
692
  * @example
693
693
  * tool_names:"search_order"
@@ -739,7 +739,7 @@ export class CreateContextStoreRequestConfigSourceTrajectoryFilter extends $dara
739
739
  export class CreateContextStoreRequestConfigSourceTrajectoryScopeMapping extends $dara.Model {
740
740
  /**
741
741
  * @remarks
742
- * The JSONPath expression for agentId. Default value: $.agent_name.
742
+ * The JSONPath for agentId. Default value: $.agent_name.
743
743
  *
744
744
  * @example
745
745
  * $.agent_name
@@ -747,7 +747,7 @@ export class CreateContextStoreRequestConfigSourceTrajectoryScopeMapping extends
747
747
  agentId?: string;
748
748
  /**
749
749
  * @remarks
750
- * The JSONPath expression for appId. Default value: $.service_names[0].
750
+ * The JSONPath for appId. Default value: $.service_names[0].
751
751
  *
752
752
  * @example
753
753
  * $.service_names[0]
@@ -755,7 +755,7 @@ export class CreateContextStoreRequestConfigSourceTrajectoryScopeMapping extends
755
755
  appId?: string;
756
756
  /**
757
757
  * @remarks
758
- * The JSONPath expression for runId. Default value: $.trajectory_id.
758
+ * The JSONPath for runId. Default value: $.trajectory_id.
759
759
  *
760
760
  * @example
761
761
  * $.trajectory_id
@@ -763,7 +763,7 @@ export class CreateContextStoreRequestConfigSourceTrajectoryScopeMapping extends
763
763
  runId?: string;
764
764
  /**
765
765
  * @remarks
766
- * The JSONPath expression for userId. By default, this field is not mapped.
766
+ * The JSONPath for userId. By default, no mapping is applied.
767
767
  *
768
768
  * @example
769
769
  * $.trajectory_extensions.user_id
@@ -799,7 +799,7 @@ export class CreateContextStoreRequestConfigSourceTrajectoryScopeMapping extends
799
799
  export class CreateContextStoreRequestConfigSourceTrajectory extends $dara.Model {
800
800
  /**
801
801
  * @remarks
802
- * The trajectory filter conditions. Conditions are combined with AND, and elements within a list are combined with OR.
802
+ * The trajectory filter conditions. Conditions are combined with AND, and items within a list are combined with OR.
803
803
  */
804
804
  filter?: CreateContextStoreRequestConfigSourceTrajectoryFilter;
805
805
  /**
@@ -820,12 +820,20 @@ export class CreateContextStoreRequestConfigSourceTrajectory extends $dara.Model
820
820
  pollIntervalSeconds?: number;
821
821
  /**
822
822
  * @remarks
823
- * The scope field mapping. The value must be a JSONPath expression. Only the $.a.b and $.a[0] formats are supported.
823
+ * The scope field mapping. The value is a JSONPath expression, and only the $.a.b and $.a[0] formats are supported.
824
824
  */
825
825
  scopeMapping?: CreateContextStoreRequestConfigSourceTrajectoryScopeMapping;
826
826
  /**
827
827
  * @remarks
828
- * The start time for trajectory consumption in ISO 8601 UTC format. If you do not specify this parameter, the creation time is used by default.
828
+ * The default mapping version for the trajectory identity. Version 1 retains the legacy rules. Version 2 reads user.id and enduser.id from agent attributes. The version is frozen upon creation.
829
+ *
830
+ * @example
831
+ * 2
832
+ */
833
+ scopeMappingVersion?: number;
834
+ /**
835
+ * @remarks
836
+ * The start time for trajectory consumption in ISO 8601 UTC format. If this parameter is not specified, the default value is the creation time.
829
837
  *
830
838
  * Use the UTC time format: yyyy-MM-ddTHH:mm:ssZ
831
839
  *
@@ -839,6 +847,7 @@ export class CreateContextStoreRequestConfigSourceTrajectory extends $dara.Model
839
847
  logstore: 'logstore',
840
848
  pollIntervalSeconds: 'pollIntervalSeconds',
841
849
  scopeMapping: 'scopeMapping',
850
+ scopeMappingVersion: 'scopeMappingVersion',
842
851
  startTime: 'startTime',
843
852
  };
844
853
  }
@@ -849,6 +858,7 @@ export class CreateContextStoreRequestConfigSourceTrajectory extends $dara.Model
849
858
  logstore: 'string',
850
859
  pollIntervalSeconds: 'number',
851
860
  scopeMapping: CreateContextStoreRequestConfigSourceTrajectoryScopeMapping,
861
+ scopeMappingVersion: 'number',
852
862
  startTime: 'string',
853
863
  };
854
864
  }
@@ -871,7 +881,7 @@ export class CreateContextStoreRequestConfigSourceTrajectory extends $dara.Model
871
881
  export class CreateContextStoreRequestConfigSourceVersionPolicy extends $dara.Model {
872
882
  /**
873
883
  * @remarks
874
- * The continuous consumption mode. Set the value to follow.
884
+ * The continuous consumption mode. The value is fixed to follow.
875
885
  *
876
886
  * @example
877
887
  * follow
@@ -879,7 +889,7 @@ export class CreateContextStoreRequestConfigSourceVersionPolicy extends $dara.Mo
879
889
  mode?: string;
880
890
  /**
881
891
  * @remarks
882
- * The initial consumed append sequence number. The value must be a decimal string of a non-negative 64-bit integer. Default value: 0. The __dataset_seq field is used, and the business timestamp is not used as the consumption checkpoint.
892
+ * The initial consumed append sequence number. It is a decimal string of a non-negative int64 value. Default value: 0. The __dataset_seq field is used, and the business timestamp is not used as the consumption checkpoint.
883
893
  *
884
894
  * @example
885
895
  * 0
@@ -911,7 +921,7 @@ export class CreateContextStoreRequestConfigSourceVersionPolicy extends $dara.Mo
911
921
  export class CreateContextStoreRequestConfigSource extends $dara.Model {
912
922
  /**
913
923
  * @remarks
914
- * The AgentSpace where the trace data source is located. If not specified, the default value is the AgentSpace in the current path. Cross-AgentSpace operations are not supported in the current version. If specified, the value must be the same as the AgentSpace in the path. Otherwise, a 400 parameter error is returned. This parameter cannot be modified after creation.
924
+ * The AgentSpace where the trace data source resides. If this parameter is not specified, the default value is the AgentSpace in the current path. Cross-AgentSpace is not supported in the current phase. If specified, the value must be the same as the path AgentSpace. Otherwise, a 400 parameter error is returned. This parameter cannot be modified after creation.
915
925
  *
916
926
  * @example
917
927
  * my-agent-space
@@ -919,7 +929,7 @@ export class CreateContextStoreRequestConfigSource extends $dara.Model {
919
929
  agentSpace?: string;
920
930
  /**
921
931
  * @remarks
922
- * The DatasetBinding v1 shared with optimization tasks, which includes version, selection (all/window and structured filters), and customFields. This parameter is validated by the server and does not accept SQL or column mappings.
932
+ * The DatasetBinding v1 shared with optimization tasks. It includes version, selection (all/window and structured filters), and customFields. It is validated by the server and does not accept SQL or column mappings.
923
933
  *
924
934
  * @example
925
935
  * {"version":1,"selection":{"mode":"all"}}
@@ -927,12 +937,12 @@ export class CreateContextStoreRequestConfigSource extends $dara.Model {
927
937
  binding?: { [key: string]: any };
928
938
  /**
929
939
  * @remarks
930
- * The Dataset datasource config. This parameter is required when source.type is set to dataset.
940
+ * The dataset datasource config. This parameter is required when the source type is dataset.
931
941
  */
932
942
  dataset?: CreateContextStoreRequestConfigSourceDataset;
933
943
  /**
934
944
  * @remarks
935
- * The name of the experience Dataset source, which must be located in the current AgentSpace. This parameter is provided only when the type is experience and source.type is set to dataset.
945
+ * The name of the dataset source for the experience. The dataset must reside in the current AgentSpace. This parameter is provided only when the source type is dataset for an experience.
936
946
  *
937
947
  * @example
938
948
  * reviewed_trajectories
@@ -940,7 +950,7 @@ export class CreateContextStoreRequestConfigSource extends $dara.Model {
940
950
  datasetName?: string;
941
951
  /**
942
952
  * @remarks
943
- * The input format of the Dataset. For experience library Dataset sources, only atif is supported, and the fixed columns are the same as those for optimization tasks.
953
+ * The input format of the dataset. For dataset sources in the experience library, only atif is supported, and the fixed columns are the same as those in optimization tasks.
944
954
  *
945
955
  * @example
946
956
  * atif
@@ -948,7 +958,7 @@ export class CreateContextStoreRequestConfigSource extends $dara.Model {
948
958
  format?: string;
949
959
  /**
950
960
  * @remarks
951
- * The maximum number of records to read per batch. Valid values: 1 to 1000. Default value: 1000. In manual mode, exceeding the limit causes a failure. In follow mode, bounded pagination is used to continue consumption.
961
+ * The maximum number of records to read per batch from the dataset. Valid values: 1 to 1000. Default value: 1000. In manual mode, exceeding the limit causes a failure. In follow mode, bounded pagination is used to continue consumption.
952
962
  *
953
963
  * @example
954
964
  * 1000
@@ -956,7 +966,7 @@ export class CreateContextStoreRequestConfigSource extends $dara.Model {
956
966
  maxRecords?: number;
957
967
  /**
958
968
  * @remarks
959
- * The start time for data backfill in ISO 8601 UTC format. If not specified, the backfill starts from the current time.
969
+ * The start time for data backfill in ISO 8601 UTC format. If this parameter is not specified, the backfill starts from the current time.
960
970
  *
961
971
  * Use the UTC time format: yyyy-MM-ddTHH:mm:ssZ
962
972
  *
@@ -966,12 +976,12 @@ export class CreateContextStoreRequestConfigSource extends $dara.Model {
966
976
  startTime?: string;
967
977
  /**
968
978
  * @remarks
969
- * The trajectory datasource config. This parameter is required when source.type is set to trajectory.
979
+ * The trajectory datasource config. This parameter is required when the source type is trajectory.
970
980
  */
971
981
  trajectory?: CreateContextStoreRequestConfigSourceTrajectory;
972
982
  /**
973
983
  * @remarks
974
- * The data source type for the memory type. Valid values: trajectory and dataset. If this parameter is not specified, manual is used, which means only AddContexts can write data. This parameter cannot be modified after creation.
984
+ * The data source type for the memory type. Valid values: trajectory and dataset. If this parameter is not specified, the value is manual, which means data is written only through AddContexts. This parameter cannot be modified after creation.
975
985
  *
976
986
  * @example
977
987
  * trajectory
@@ -979,7 +989,7 @@ export class CreateContextStoreRequestConfigSource extends $dara.Model {
979
989
  type?: string;
980
990
  /**
981
991
  * @remarks
982
- * The continuous consumption configuration for the Dataset of the native experience library. Default value: manual. If the value is follow, only binding.selection.mode=all is allowed, and data is consumed based on the append sequence number. This parameter cannot be modified after creation.
992
+ * The continuous consumption configuration for datasets in the native experience library. The default mode is manual. The follow mode only allows binding.selection.mode=all and consumes data by append sequence number. This configuration cannot be modified after creation.
983
993
  */
984
994
  versionPolicy?: CreateContextStoreRequestConfigSourceVersionPolicy;
985
995
  static names(): { [key: string]: string } {
@@ -1036,7 +1046,7 @@ export class CreateContextStoreRequestConfigSource extends $dara.Model {
1036
1046
  export class CreateContextStoreRequestConfigStoragePolicy extends $dara.Model {
1037
1047
  /**
1038
1048
  * @remarks
1039
- * The allowed storage actions. Default value: all actions (ADD, UPDATE, MERGE, and DELETE).
1049
+ * The allowed storage actions. Default value: all. Valid values: ADD, UPDATE, MERGE, and DELETE.
1040
1050
  *
1041
1051
  * @example
1042
1052
  * ["ADD","UPDATE","MERGE","DELETE"]
@@ -1052,7 +1062,7 @@ export class CreateContextStoreRequestConfigStoragePolicy extends $dara.Model {
1052
1062
  dedupe?: boolean;
1053
1063
  /**
1054
1064
  * @remarks
1055
- * Specifies whether to enable human edit protection. Default value: true. When enabled, automatic extraction does not overwrite manually modified memories.
1065
+ * Specifies whether to enable human edit protection. Default value: true. If enabled, automatic extraction does not overwrite manually modified memories.
1056
1066
  *
1057
1067
  * @example
1058
1068
  * true
@@ -1060,7 +1070,7 @@ export class CreateContextStoreRequestConfigStoragePolicy extends $dara.Model {
1060
1070
  humanEditProtection?: boolean;
1061
1071
  /**
1062
1072
  * @remarks
1063
- * The merge key for upsert operations. Valid values: factKey, semantic, and both. Default value: semantic.
1073
+ * The upsert merge key. Valid values: factKey, semantic, and both. Default value: semantic.
1064
1074
  *
1065
1075
  * @example
1066
1076
  * semantic
@@ -1068,7 +1078,7 @@ export class CreateContextStoreRequestConfigStoragePolicy extends $dara.Model {
1068
1078
  mergeKey?: string;
1069
1079
  /**
1070
1080
  * @remarks
1071
- * The storage mode. Valid values: event (event append) and upsert (merge update). Default value: upsert.
1081
+ * The storage mode. Valid values: event (event append) and upsert (merge and update). Default value: upsert.
1072
1082
  *
1073
1083
  * @example
1074
1084
  * upsert
@@ -1076,7 +1086,7 @@ export class CreateContextStoreRequestConfigStoragePolicy extends $dara.Model {
1076
1086
  mode?: string;
1077
1087
  /**
1078
1088
  * @remarks
1079
- * The similarity threshold for semantic merging. Valid values: 0 to 1. Default value: 0.4.
1089
+ * The semantic merge similarity threshold. Valid values: 0 to 1. Default value: 0.4.
1080
1090
  *
1081
1091
  * @example
1082
1092
  * 0.4
@@ -1084,7 +1094,7 @@ export class CreateContextStoreRequestConfigStoragePolicy extends $dara.Model {
1084
1094
  similarityThreshold?: number;
1085
1095
  /**
1086
1096
  * @remarks
1087
- * The number of days before memories expire. A value of 0 indicates that memories do not expire.
1097
+ * The number of days before a memory expires. A value of 0 indicates that the memory does not expire.
1088
1098
  *
1089
1099
  * @example
1090
1100
  * 0
@@ -1134,7 +1144,7 @@ export class CreateContextStoreRequestConfig extends $dara.Model {
1134
1144
  audit?: CreateContextStoreRequestConfigAudit;
1135
1145
  /**
1136
1146
  * @remarks
1137
- * The extraction policies. You can configure 1 to 10 policies. Compatible fields passed back as-is during updates are ignored. strategyVersion indicates the snapshot version of the entire library configuration.
1147
+ * The list of extraction policies. You can specify 1 to 10 policies. Compatible fields returned as-is during updates are ignored. strategyVersion indicates the snapshot version of the entire database configuration.
1138
1148
  */
1139
1149
  extractionPolicies?: CreateContextStoreRequestConfigExtractionPolicies[];
1140
1150
  /**
@@ -1144,7 +1154,7 @@ export class CreateContextStoreRequestConfig extends $dara.Model {
1144
1154
  extractionPolicy?: CreateContextStoreRequestConfigExtractionPolicy;
1145
1155
  /**
1146
1156
  * @remarks
1147
- * The metadata field mapping, where the key is the business field and the value is the storage field.
1157
+ * The metadata field mapping. The key is the business field and the value is the storage field.
1148
1158
  *
1149
1159
  * @example
1150
1160
  * {"userId":"user_id","sessionId":"session_id"}
@@ -1165,7 +1175,7 @@ export class CreateContextStoreRequestConfig extends $dara.Model {
1165
1175
  scopePolicy?: CreateContextStoreRequestConfigScopePolicy;
1166
1176
  /**
1167
1177
  * @remarks
1168
- * The list of service names. This parameter is required and cannot be empty. It works with source.agentSpace to locate the trace data source. The trajectory extraction service uses the agentSpace to find the bound CMS workspace and project or logstore, and then filters by serviceName. This parameter cannot be modified after creation.
1178
+ * The list of service names. This parameter is required and cannot be empty. It works with source.agentSpace to locate the trace data source. The trajectory extraction service uses agentSpace to query the bound CMS workspace and project/logstore, and then filters the data by serviceName. This parameter cannot be modified after creation (no modification entry is available in the current release).
1169
1179
  *
1170
1180
  * @example
1171
1181
  * ["order-service","payment-service"]
@@ -1173,7 +1183,7 @@ export class CreateContextStoreRequestConfig extends $dara.Model {
1173
1183
  serviceNames?: string[];
1174
1184
  /**
1175
1185
  * @remarks
1176
- * The datasource config, which serves only as the root identity for the data source. This block is optional.
1186
+ * The datasource config, which serves only as the root identity for the data source. This is an optional block.
1177
1187
  */
1178
1188
  source?: CreateContextStoreRequestConfigSource;
1179
1189
  /**
@@ -1250,7 +1260,7 @@ export class CreateContextStoreRequest extends $dara.Model {
1250
1260
  config?: CreateContextStoreRequestConfig;
1251
1261
  /**
1252
1262
  * @remarks
1253
- * The name of the context store. The name must be globally unique within AgentSpace and 2 to 64 characters in length.
1263
+ * The name of the context store. The name must be globally unique within the AgentSpace and 2 to 64 characters in length.
1254
1264
  *
1255
1265
  * This parameter is required.
1256
1266
  *
@@ -1260,7 +1270,7 @@ export class CreateContextStoreRequest extends $dara.Model {
1260
1270
  contextStoreName?: string;
1261
1271
  /**
1262
1272
  * @remarks
1263
- * The type of the context store. Valid values include experience and memory.
1273
+ * The type of the context store. Example values include experience (experience store) and memory (memory store).
1264
1274
  *
1265
1275
  * This parameter is required.
1266
1276
  *
@@ -1278,7 +1288,7 @@ export class CreateContextStoreRequest extends $dara.Model {
1278
1288
  description?: string;
1279
1289
  /**
1280
1290
  * @remarks
1281
- * The client token. It is a unique string generated by the client to ensure the idempotency of the create operation.
1291
+ * The idempotency token, a unique string generated by the client to ensure the idempotency of the creation operation.
1282
1292
  *
1283
1293
  * @example
1284
1294
  * a1b2c3d4-1234-5678-90ab-cdef12345678
@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
5
5
  export class CreateContextStoreResponseBody extends $dara.Model {
6
6
  /**
7
7
  * @remarks
8
- * The request ID, which is used to locate the request during troubleshooting.
8
+ * The request ID, used to locate the request during troubleshooting.
9
9
  *
10
10
  * @example
11
11
  * 9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M
@@ -13,7 +13,7 @@ export class CreateContextStoreResponseBody extends $dara.Model {
13
13
  requestId?: string;
14
14
  /**
15
15
  * @remarks
16
- * The version number of the effective strategy for the memory type.
16
+ * The version number of the currently effective policy (memory type).
17
17
  *
18
18
  * @example
19
19
  * 1
@@ -7,7 +7,7 @@ import { ExperimentConfig } from "./ExperimentConfig";
7
7
  export class CreateExperimentPlanRequest extends $dara.Model {
8
8
  /**
9
9
  * @remarks
10
- * The ID of the associated dataset. If not specified, the execution phase processes in simple mode.
10
+ * The ID of the associated dataset. If you do not specify this parameter, the execution phase is processed in simple mode.
11
11
  *
12
12
  * @example
13
13
  * rca_benckmark_eval
@@ -23,7 +23,7 @@ export class CreateExperimentPlanRequest extends $dara.Model {
23
23
  description?: string;
24
24
  /**
25
25
  * @remarks
26
- * The list of evaluators. When configured, evaluation can be automatically triggered upon experiment completion.
26
+ * The list of evaluators. After you configure this parameter, an evaluation is automatically triggered when the experiment is completed.
27
27
  *
28
28
  * @example
29
29
  * [{"evaluatorRef": "Builtin.agent_correctness", "name": "Builtin.agent_correctness", "type": "AGENT", "resultName": "Builtin.agent_correctness", "resultType": "score", "variableMapping": {"input": "experiment_input", "output": "experiment_output", "expected_output": "dataset.ground_truth_json"}, "filters": {"query": "", "sample": "100"}, "config": {"variables": [], "prompt": ""}}, {"evaluatorRef": "rca-toxicity-safety-accuracy", "name": "rca-toxicity-safety-accuracy", "type": "AGENT", "resultName": "rca-toxicity-safety-accuracy", "resultType": "score", "variableMapping": {"input": "experiment_input", "output": "experiment_output", "question": "dataset.question", "expected_output": "dataset.ground_truth_json", "payload_json": "dataset.payload_json"}, "filters": {"query": "", "sample": "100"}, "config": {"variables": [], "prompt": ""}}]
@@ -31,7 +31,7 @@ export class CreateExperimentPlanRequest extends $dara.Model {
31
31
  evaluators?: Evaluator[];
32
32
  /**
33
33
  * @remarks
34
- * The experiment type. Set this parameter to `OFFLINE` or `ONLINE`.
34
+ * The type of the experiment. Valid values: OFFLINE and ONLINE.
35
35
  *
36
36
  * This parameter is required.
37
37
  *
@@ -41,12 +41,12 @@ export class CreateExperimentPlanRequest extends $dara.Model {
41
41
  experimentType?: string;
42
42
  /**
43
43
  * @remarks
44
- * The list of experiment configurations. A maximum of 5 entries are supported. For offline experiments, this parameter can be omitted or set to an empty array. For online experiments, at least one entry is required.
44
+ * The list of experiment configurations. You can specify up to 5 configurations. This parameter is optional or can be left empty for offline experiments. For online experiments, you must specify at least one configuration.
45
45
  *
46
46
  * This parameter is required.
47
47
  *
48
48
  * @example
49
- * [{"label": "A", "name": "experimentA", "modelName": "qwen3.7-plus", "modelProvider": "dashscope", "modelParameters": {"temperature": 0.7, "topP": 0.8, "presencePenalty": 0.0, "frequencyPenalty": 0.0}, "promptTemplate": [{"role": "system", "content": "You are an Alibaba Cloud ARMS product Q&A bot"}, {"role": "user", "content": "{{input}}"}]}, {"label": "B", "name": "experimentB", "modelName": "qwen3.7-max", "modelProvider": "dashscope", "modelParameters": {"temperature": 0.7, "topP": 0.8, "presencePenalty": 0.0, "frequencyPenalty": 0.0}, "promptTemplate": [{"role": "system", "content": "You are an Alibaba Cloud ARMS product Q&A bot"}, {"role": "user", "content": "{{input}}"}]}]
49
+ * [{"label": "A", "name": "experimentA", "modelName": "qwen3.7-plus", "modelProvider": "dashscope", "modelParameters": {"temperature": 0.7, "topP": 0.8, "presencePenalty": 0.0, "frequencyPenalty": 0.0}, "promptTemplate": [{"role": "system", "content": "You are the Alibaba Cloud ARMS product Q&A bot."}, {"role": "user", "content": "{{input}}"}]}, {"label": "B", "name": "experimentB", "modelName": "qwen3.7-max", "modelProvider": "dashscope", "modelParameters": {"temperature": 0.7, "topP": 0.8, "presencePenalty": 0.0, "frequencyPenalty": 0.0}, "promptTemplate": [{"role": "system", "content": "You are the Alibaba Cloud ARMS product Q&A bot."}, {"role": "user", "content": "{{input}}"}]}]
50
50
  */
51
51
  experiments?: ExperimentConfig[];
52
52
  /**
@@ -59,12 +59,12 @@ export class CreateExperimentPlanRequest extends $dara.Model {
59
59
  input?: { [key: string]: any };
60
60
  /**
61
61
  * @remarks
62
- * The name of the associated data processing pipeline (optional). After association, when experiment runs under this plan finish writing results to the experiment result Logstore, the system filters by the traceId of the experiment trace, calls PreviewPipeline, and writes the pipeline-processed results together.
62
+ * The name of the associated data processing pipeline. This parameter is optional. After you associate a pipeline, when the experiment execution under this plan is completed and the experiment results are written to the Logstore, the system filters the data by the traceId of the current experiment trace and calls PreviewPipeline to write the results processed by the pipeline.
63
63
  */
64
64
  pipelineName?: string;
65
65
  /**
66
66
  * @remarks
67
- * The name of the experiment plan. The name must be unique within the same AgentSpace and account.
67
+ * The name of the experiment plan. The name must be unique within the same account in an AgentSpace.
68
68
  *
69
69
  * This parameter is required.
70
70
  *
@@ -74,7 +74,7 @@ export class CreateExperimentPlanRequest extends $dara.Model {
74
74
  planName?: string;
75
75
  /**
76
76
  * @remarks
77
- * The custom query SQL clause for partial dataset mode. This parameter can be used when `selectedItemIds` is empty.
77
+ * The custom query SQL clause in partial dataset mode. You can use this parameter when selectedItemIds is empty.
78
78
  *
79
79
  * @example
80
80
  * status=\\"OK\\"
@@ -82,7 +82,7 @@ export class CreateExperimentPlanRequest extends $dara.Model {
82
82
  querySql?: string;
83
83
  /**
84
84
  * @remarks
85
- * The list of selected data item IDs for partial dataset mode. This parameter must be used together with `datasetId`.
85
+ * The list of selected data item IDs in partial dataset mode. This parameter must be used together with the datasetId parameter.
86
86
  *
87
87
  * @example
88
88
  * ["019ef4d5-a0f0-7114-832d-5542d771cd8c", "019f1729-be9b-7769-a006-8e98023ad7ad"]