@alicloud/agentloop20260520 2.3.2 → 2.3.4

package/src/models/PreviewPipelineRequest.ts

@@ -13,7 +13,7 @@ export class PreviewPipelineRequestPipelineNodes extends $dara.Model {
   id?: string;
   /**
    * @remarks
-   * The node parameters in key-value structure. The parameters vary depending on the node type.
+   * The node parameters in key-value format. The parameters vary based on the node type.
    */
   parameters?: { [key: string]: any };
   /**
@@ -82,6 +82,86 @@ export class PreviewPipelineRequestPipeline extends $dara.Model {
   }
 }
 
+export class PreviewPipelineRequestSourceDataset extends $dara.Model {
+  /**
+   * @remarks
+   * The name of the source dataset.
+   * 
+   * @example
+   * my-dataset
+   */
+  dataset?: string;
+  /**
+   * @remarks
+   * The filter condition for dataset data.
+   * 
+   * @example
+   * status = \\"pending\\"
+   */
+  filter?: string;
+  static names(): { [key: string]: string } {
+    return {
+      dataset: 'dataset',
+      filter: 'filter',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      dataset: 'string',
+      filter: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class PreviewPipelineRequestSourceInputFields extends $dara.Model {
+  /**
+   * @remarks
+   * The field name.
+   * 
+   * @example
+   * question
+   */
+  name?: string;
+  /**
+   * @remarks
+   * The field type. Valid values: text, long, double, and json.
+   * 
+   * @example
+   * text
+   */
+  type?: string;
+  static names(): { [key: string]: string } {
+    return {
+      name: 'name',
+      type: 'type',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      name: 'string',
+      type: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class PreviewPipelineRequestSourceLogstore extends $dara.Model {
   /**
    * @remarks
@@ -133,6 +213,16 @@ export class PreviewPipelineRequestSourceLogstore extends $dara.Model {
 }
 
 export class PreviewPipelineRequestSource extends $dara.Model {
+  /**
+   * @remarks
+   * The Dataset datasource config under the current AgentSpace.
+   */
+  dataset?: PreviewPipelineRequestSourceDataset;
+  /**
+   * @remarks
+   * The input fields and field types. This parameter applies to all data source types.
+   */
+  inputFields?: PreviewPipelineRequestSourceInputFields[];
   /**
    * @remarks
    * The SLS Logstore datasource config.
@@ -140,7 +230,7 @@ export class PreviewPipelineRequestSource extends $dara.Model {
   logstore?: PreviewPipelineRequestSourceLogstore;
   /**
    * @remarks
-   * The data source type. Currently, only Simple Log Service (SLS) is supported.
+   * The data source type. Currently, Simple Log Service (SLS) is supported.
    * 
    * @example
    * SLS
@@ -148,6 +238,8 @@ export class PreviewPipelineRequestSource extends $dara.Model {
   type?: string;
   static names(): { [key: string]: string } {
     return {
+      dataset: 'dataset',
+      inputFields: 'inputFields',
       logstore: 'logstore',
       type: 'type',
     };
@@ -155,12 +247,20 @@ export class PreviewPipelineRequestSource extends $dara.Model {
 
   static types(): { [key: string]: any } {
     return {
+      dataset: PreviewPipelineRequestSourceDataset,
+      inputFields: { 'type': 'array', 'itemType': PreviewPipelineRequestSourceInputFields },
       logstore: PreviewPipelineRequestSourceLogstore,
       type: 'string',
     };
   }
 
   validate() {
+    if(this.dataset && typeof (this.dataset as any).validate === 'function') {
+      (this.dataset as any).validate();
+    }
+    if(Array.isArray(this.inputFields)) {
+      $dara.Model.validateArray(this.inputFields);
+    }
     if(this.logstore && typeof (this.logstore as any).validate === 'function') {
       (this.logstore as any).validate();
     }

package/src/models/PreviewPipelineResponseBody.ts

@@ -13,7 +13,7 @@ export class PreviewPipelineResponseBodyMeta extends $dara.Model {
   aggQuery?: string;
   /**
    * @remarks
-   * The `meta.columnTypes` field provides a mapping from column names to data types (string / long / double / json).
+   * `meta.columnTypes` provides the mapping from column names to data types (string / long / double / json).
    */
   columnTypes?: string[];
   /**
@@ -65,7 +65,7 @@ export class PreviewPipelineResponseBodyMeta extends $dara.Model {
   keys?: string[];
   /**
    * @remarks
-   * The maximum number of result rows returned.
+   * The maximum number of rows that can be returned.
    * 
    * @example
    * 5
@@ -81,7 +81,7 @@ export class PreviewPipelineResponseBodyMeta extends $dara.Model {
   mode?: number;
   /**
    * @remarks
-   * The number of processed data bytes.
+   * The number of data bytes processed.
    * 
    * @example
    * 524288
@@ -97,7 +97,7 @@ export class PreviewPipelineResponseBodyMeta extends $dara.Model {
   processedRows?: number;
   /**
    * @remarks
-   * The SLS query progress. A value of Complete indicates that the query is complete.
+   * The Simple Log Service (SLS) query progress. A value of Complete indicates that the query is complete.
    * 
    * @example
    * Complete
@@ -113,7 +113,7 @@ export class PreviewPipelineResponseBodyMeta extends $dara.Model {
   scanBytes?: number;
   /**
    * @remarks
-   * The column type and aggregation information.
+   * The type and aggregation information of columns.
    */
   terms?: { [key: string]: any }[];
   /**
@@ -189,7 +189,7 @@ export class PreviewPipelineResponseBodyMeta extends $dara.Model {
 export class PreviewPipelineResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The `data` field is a collection of sample rows (an array of maps) that contains only the first N rows (up to 5 by default) and does not reflect the complete write plan.
+   * `data` is a collection of sample rows (maps within an array) that contains only the first N rows (up to 5 by default) and does not reflect the complete write plan.
    */
   data?: { [key: string]: string }[];
   /**

package/src/models/RunPipelineRequest.ts

@@ -4,11 +4,17 @@ import * as $dara from '@darabonba/typescript';
 
 export class RunPipelineRequestOutput extends $dara.Model {
   /**
+   * @remarks
+   * Specifies whether to write to the target Dataset. Default value: true.
+   * 
    * @example
    * true
    */
   dataset?: boolean;
   /**
+   * @remarks
+   * Specifies whether to return inline results in the response. Default value: false.
+   * 
    * @example
    * false
    */
@@ -38,12 +44,22 @@ export class RunPipelineRequestOutput extends $dara.Model {
 
 export class RunPipelineRequest extends $dara.Model {
   /**
+   * @remarks
+   * The start of the data processing window, in UNIX seconds. This parameter is required for SQL Pipeline and time window-based WorkItem Source. This parameter is optional for checkpoint-based WorkItem Source types such as Dataset and Logstore Pull.
+   * 
    * @example
    * 1735660800
    */
   fromTime?: number;
+  /**
+   * @remarks
+   * The output control settings. SQL Pipeline supports overriding. WorkItem Pipeline uses the saved Sink configuration and must keep the default value.
+   */
   output?: RunPipelineRequestOutput;
   /**
+   * @remarks
+   * The end of the data processing window, in UNIX seconds. This parameter must be provided together with fromTime and must be greater than fromTime. This parameter is optional for checkpoint-based WorkItem Source types.
+   * 
    * @example
    * 1735747200
    */

package/src/models/RunPipelineResponseBody.ts

@@ -4,26 +4,41 @@ import * as $dara from '@darabonba/typescript';
 
 export class RunPipelineResponseBody extends $dara.Model {
   /**
+   * @remarks
+   * The name of the AgentSpace.
+   * 
    * @example
    * my-agent-space
    */
   agentSpaceName?: string;
   /**
+   * @remarks
+   * The pipeline name.
+   * 
    * @example
    * my-pipeline
    */
   pipelineName?: string;
   /**
+   * @remarks
+   * The request ID, which is used to locate and troubleshoot issues.
+   * 
    * @example
    * 9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M
    */
   requestId?: string;
   /**
+   * @remarks
+   * The run ID created by this trigger.
+   * 
    * @example
    * run-20260101-0001
    */
   runId?: string;
   /**
+   * @remarks
+   * The current status of the run. The status is typically Pending after the run is queued.
+   * 
    * @example
    * Pending
    */

package/src/models/UpdateEvaluationTaskRequest.ts

@@ -15,7 +15,7 @@ export class UpdateEvaluationTaskRequest extends $dara.Model {
   config?: { [key: string]: string };
   /**
    * @remarks
-   * The filter condition for evaluation data. A JSON object or JSON string is supported.
+   * The filter conditions for evaluation data. JSON objects and JSON strings are supported.
    * 
    * @example
    * {"query":"serviceName=\\"checkout-service\\" AND status=\\"OK\\"","maxRecords":10,"samplingRate":50}
@@ -26,7 +26,7 @@ export class UpdateEvaluationTaskRequest extends $dara.Model {
    * The description of the evaluation task.
    * 
    * @example
-   * 更新后的链路 Trace 任务完成度评估
+   * Updated trace link task completion evaluation
    */
   description?: string;
   /**
@@ -39,12 +39,12 @@ export class UpdateEvaluationTaskRequest extends $dara.Model {
   evaluators?: Evaluator[];
   /**
    * @remarks
-   * The new task execution strategies. A JSON object or JSON string is supported. If the task is in `Completed`, `Terminated`, or `Failed` status and the new strategy enables backfill or continuous mode, the backend resets the task to `Pending` and triggers orchestration.
+   * The new task execution strategies. JSON objects and JSON strings are supported. If the task is in the `Completed`, `Terminated`, or `Failed` state and the new strategy enables backfill or continuous mode, the backend restores the task to the `Pending` state and triggers orchestration.
    */
   runStrategies?: RunStrategies;
   /**
    * @remarks
-   * The task status. Currently the backend only allows users to explicitly set this to `Terminated`. Other statuses are managed by the system.
+   * The task status. Currently, the backend only allows users to manually set this to `Terminated`. Other statuses are managed by the system.
    * 
    * @example
    * Terminated
@@ -60,7 +60,7 @@ export class UpdateEvaluationTaskRequest extends $dara.Model {
   tags?: { [key: string]: string };
   /**
    * @remarks
-   * The idempotency token. CloudSpec declares this query parameter, but the backend does not currently perform idempotency comparison.
+   * The idempotency token. CloudSpec declares this query parameter, but the backend does not currently perform idempotency checks.
    * 
    * @example
    * a1b2c3d4-1234-5678-90ab-cdef12345678

package/src/models/UpdateExperimentPlanRequest.ts

@@ -7,7 +7,7 @@ import { ExperimentConfig } from "./ExperimentConfig";
 export class UpdateExperimentPlanRequest extends $dara.Model {
   /**
    * @remarks
-   * The associated dataset ID.
+   * The ID of the associated dataset.
    * 
    * @example
    * rca_benckmark_eval
@@ -26,12 +26,12 @@ export class UpdateExperimentPlanRequest extends $dara.Model {
    * The description.
    * 
    * @example
-   * rca_benchmark_eval_experiment offline experiment.
+   * rca_benchmark_eval_experiment offline experiment
    */
   description?: string;
   /**
    * @remarks
-   * The evaluator list. Omitting this field indicates no modification. Passing an empty array clears the list.
+   * The list of evaluators. Omitting this field indicates no modification. Passing an empty array clears the list.
    * 
    * @example
    * [{"evaluatorRef": "Builtin.agent_task_completion"}]
@@ -47,7 +47,7 @@ export class UpdateExperimentPlanRequest extends $dara.Model {
   experimentType?: string;
   /**
    * @remarks
-   * The experiment configuration list. When specified, the entire list is replaced. The number of items must be 1 to 5.
+   * The list of experiment configurations. When specified, the entire list is replaced. The number of configurations must be 1 to 5.
    * 
    * @example
    * [{"label": "A", "name": "baseline", "modelName": "qwen-max"}]
@@ -58,13 +58,17 @@ export class UpdateExperimentPlanRequest extends $dara.Model {
    * Optional.
    * 
    * @example
-   * {"question": "How do I get a refund?"}
+   * {"question": "How do I request a refund?"}
    */
   input?: { [key: string]: any };
+  /**
+   * @remarks
+   * The name of the associated data processing pipeline. This parameter is optional. If not specified, the value is not updated. If an empty character string is specified, the association is dissociated. After association, when an experiment under this plan finishes execution and writes results to the experiment result Logstore, the system filters by the traceId of the experiment trace and calls PreviewPipeline. The pipeline-processed results are then written together.
+   */
   pipelineName?: string;
   /**
    * @remarks
-   * The experiment plan name.
+   * The name of the experiment plan.
    * 
    * @example
    * rca_benchmark_eval_experiment

package/src/models/UpdateExperimentPlanResponseBody.ts

@@ -8,12 +8,12 @@ export class UpdateExperimentPlanResponseBody extends $dara.Model {
    * The prompt message.
    * 
    * @example
-   * Experiment plan updated successfully.
+   * Experiment plan updated successfully
    */
   message?: string;
   /**
    * @remarks
-   * The experiment plan ID.
+   * The ID of the experiment plan.
    * 
    * @example
    * exp-plan-e95bff54685a4ae29ff3a834c1008a71
@@ -29,7 +29,7 @@ export class UpdateExperimentPlanResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The update result. The value is updated if the operation is successful.
+   * The update result. A value of updated indicates success.
    * 
    * @example
    * updated