@alicloud/agentloop20260520 2.3.1 → 2.3.3

package/src/models/CreateExperimentPlanRequest.ts

@@ -18,12 +18,12 @@ export class CreateExperimentPlanRequest extends $dara.Model {
    * The description of the experiment plan.
    * 
    * @example
-   * rca_benchmark_eval_experiment offline experiment.
+   * rca_benchmark_eval_experiment offline experiment
    */
   description?: string;
   /**
    * @remarks
-   * The list of evaluators. After configuration, evaluation can be automatically triggered when the experiment completes.
+   * The list of evaluators. When configured, evaluation can be automatically triggered upon experiment completion.
    * 
    * @example
    * [{"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": ""}}]
@@ -41,7 +41,7 @@ export class CreateExperimentPlanRequest extends $dara.Model {
   experimentType?: string;
   /**
    * @remarks
-   * The list of experiment configurations. A maximum of 5 configurations are supported. For offline experiments, this parameter can be omitted or set to an empty array. For online experiments, at least one configuration is required.
+   * The list of experiment configurations. A maximum of five configurations are supported. For offline experiments, this parameter can be omitted or set to an empty array. For online experiments, at least one configuration is required.
    * 
    * This parameter is required.
    * 
@@ -54,13 +54,17 @@ export class CreateExperimentPlanRequest 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 (optional). After association, when the experiment execution under this plan writes 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.
+   */
   pipelineName?: string;
   /**
    * @remarks
-   * The experiment plan name. The name must be unique within the same AgentSpace and account.
+   * The experiment plan name. The name must be unique within the same AgentSpace under the same account.
    * 
    * This parameter is required.
    * 
@@ -78,7 +82,7 @@ export class CreateExperimentPlanRequest extends $dara.Model {
   querySql?: string;
   /**
    * @remarks
-   * The list of selected data item IDs in partial dataset mode. This parameter must be used together with `datasetId`.
+   * The list of selected data item IDs in partial dataset mode. Use this parameter together with `datasetId`.
    * 
    * @example
    * ["019ef4d5-a0f0-7114-832d-5542d771cd8c", "019f1729-be9b-7769-a006-8e98023ad7ad"]

package/src/models/CreateExperimentPlanResponseBody.ts

@@ -8,7 +8,7 @@ export class CreateExperimentPlanResponseBody extends $dara.Model {
    * The message.
    * 
    * @example
-   * Experiment plan created successfully.
+   * Experiment plan created successfully
    */
   message?: string;
   /**
@@ -29,7 +29,7 @@ export class CreateExperimentPlanResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The creation result. The value is `created` upon success.
+   * The creation result. A value of `created` indicates success.
    * 
    * @example
    * created

package/src/models/CreatePipelineRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CreatePipelineRequestExecutePolicyRunOnce extends $dara.Model {
   /**
    * @remarks
-   * The start time of the data processing window, in Unix seconds. The value must be less than toTime.
+   * The start time of the data processing window, in UNIX seconds. The value must be less than toTime.
    * 
    * @example
    * 1735660800
@@ -13,7 +13,7 @@ export class CreatePipelineRequestExecutePolicyRunOnce extends $dara.Model {
   fromTime?: number;
   /**
    * @remarks
-   * The end time of the data processing window, in Unix seconds. The value must be greater than fromTime.
+   * The end time of the data processing window, in UNIX seconds. The value must be greater than fromTime.
    * 
    * @example
    * 1735747200
@@ -45,7 +45,7 @@ export class CreatePipelineRequestExecutePolicyRunOnce extends $dara.Model {
 export class CreatePipelineRequestExecutePolicyScheduled extends $dara.Model {
   /**
    * @remarks
-   * The scheduling start time, in Unix milliseconds.
+   * The scheduling start time, in UNIX milliseconds.
    * 
    * @example
    * 1735660800000
@@ -85,7 +85,9 @@ export class CreatePipelineRequestExecutePolicyScheduled extends $dara.Model {
 export class CreatePipelineRequestExecutePolicy extends $dara.Model {
   /**
    * @remarks
-   * The scheduling mode. Valid values: RunOnce (one-time execution) and Scheduled (periodic scheduling).
+   * The scheduling mode. Valid values:
+   * - RunOnce: one-time execution.
+   * - Scheduled: periodic scheduling.
    * 
    * @example
    * RunOnce
@@ -143,7 +145,7 @@ export class CreatePipelineRequestPipelineNodes extends $dara.Model {
   id?: string;
   /**
    * @remarks
-   * The node parameters in key-value format. 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 };
   /**
@@ -212,6 +214,266 @@ export class CreatePipelineRequestPipeline extends $dara.Model {
   }
 }
 
+export class CreatePipelineRequestSinkConditionDefaultSinkDataset extends $dara.Model {
+  /**
+   * @remarks
+   * The name of the AgentSpace to which the default destination dataset belongs.
+   * 
+   * @example
+   * my-agent-space
+   */
+  agentSpace?: string;
+  /**
+   * @remarks
+   * The name of the default destination dataset.
+   * 
+   * @example
+   * other-result
+   */
+  dataset?: string;
+  static names(): { [key: string]: string } {
+    return {
+      agentSpace: 'agentSpace',
+      dataset: 'dataset',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      agentSpace: 'string',
+      dataset: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class CreatePipelineRequestSinkConditionDefaultSink extends $dara.Model {
+  /**
+   * @remarks
+   * The default destination dataset.
+   */
+  dataset?: CreatePipelineRequestSinkConditionDefaultSinkDataset;
+  /**
+   * @remarks
+   * The default destination type. Currently, only dataset is supported.
+   * 
+   * @example
+   * dataset
+   */
+  type?: string;
+  static names(): { [key: string]: string } {
+    return {
+      dataset: 'dataset',
+      type: 'type',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      dataset: CreatePipelineRequestSinkConditionDefaultSinkDataset,
+      type: 'string',
+    };
+  }
+
+  validate() {
+    if(this.dataset && typeof (this.dataset as any).validate === 'function') {
+      (this.dataset as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class CreatePipelineRequestSinkConditionRoutesSinkDataset extends $dara.Model {
+  /**
+   * @remarks
+   * The name of the AgentSpace to which the destination dataset belongs.
+   * 
+   * @example
+   * my-agent-space
+   */
+  agentSpace?: string;
+  /**
+   * @remarks
+   * The name of the destination dataset.
+   * 
+   * @example
+   * refund-result
+   */
+  dataset?: string;
+  static names(): { [key: string]: string } {
+    return {
+      agentSpace: 'agentSpace',
+      dataset: 'dataset',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      agentSpace: 'string',
+      dataset: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class CreatePipelineRequestSinkConditionRoutesSink extends $dara.Model {
+  /**
+   * @remarks
+   * The route destination dataset.
+   */
+  dataset?: CreatePipelineRequestSinkConditionRoutesSinkDataset;
+  /**
+   * @remarks
+   * The route destination type. Currently, only dataset is supported.
+   * 
+   * @example
+   * dataset
+   */
+  type?: string;
+  static names(): { [key: string]: string } {
+    return {
+      dataset: 'dataset',
+      type: 'type',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      dataset: CreatePipelineRequestSinkConditionRoutesSinkDataset,
+      type: 'string',
+    };
+  }
+
+  validate() {
+    if(this.dataset && typeof (this.dataset as any).validate === 'function') {
+      (this.dataset as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class CreatePipelineRequestSinkConditionRoutes extends $dara.Model {
+  /**
+   * @remarks
+   * The route expression in SPL. Only where, project, and extend are supported.
+   * 
+   * @example
+   * * | where intent = \\"refund\\"
+   */
+  expression?: string;
+  /**
+   * @remarks
+   * The route ID.
+   * 
+   * @example
+   * refund
+   */
+  id?: string;
+  /**
+   * @remarks
+   * The route write destination.
+   */
+  sink?: CreatePipelineRequestSinkConditionRoutesSink;
+  static names(): { [key: string]: string } {
+    return {
+      expression: 'expression',
+      id: 'id',
+      sink: 'sink',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      expression: 'string',
+      id: 'string',
+      sink: CreatePipelineRequestSinkConditionRoutesSink,
+    };
+  }
+
+  validate() {
+    if(this.sink && typeof (this.sink as any).validate === 'function') {
+      (this.sink as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class CreatePipelineRequestSinkCondition extends $dara.Model {
+  /**
+   * @remarks
+   * The default write destination used when no conditional route is matched.
+   */
+  defaultSink?: CreatePipelineRequestSinkConditionDefaultSink;
+  /**
+   * @remarks
+   * The route matching mode. Currently, only all is supported.
+   * 
+   * @example
+   * all
+   */
+  matchMode?: string;
+  /**
+   * @remarks
+   * The list of conditional routes.
+   */
+  routes?: CreatePipelineRequestSinkConditionRoutes[];
+  static names(): { [key: string]: string } {
+    return {
+      defaultSink: 'defaultSink',
+      matchMode: 'matchMode',
+      routes: 'routes',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      defaultSink: CreatePipelineRequestSinkConditionDefaultSink,
+      matchMode: 'string',
+      routes: { 'type': 'array', 'itemType': CreatePipelineRequestSinkConditionRoutes },
+    };
+  }
+
+  validate() {
+    if(this.defaultSink && typeof (this.defaultSink as any).validate === 'function') {
+      (this.defaultSink as any).validate();
+    }
+    if(Array.isArray(this.routes)) {
+      $dara.Model.validateArray(this.routes);
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class CreatePipelineRequestSinkDataset extends $dara.Model {
   /**
    * @remarks
@@ -253,6 +515,11 @@ export class CreatePipelineRequestSinkDataset extends $dara.Model {
 }
 
 export class CreatePipelineRequestSink extends $dara.Model {
+  /**
+   * @remarks
+   * The conditional routing configuration. This parameter is used only when sink.type is set to condition.
+   */
+  condition?: CreatePipelineRequestSinkCondition;
   /**
    * @remarks
    * The destination dataset configuration.
@@ -260,7 +527,7 @@ export class CreatePipelineRequestSink extends $dara.Model {
   dataset?: CreatePipelineRequestSinkDataset;
   /**
    * @remarks
-   * The sink type. Currently, Dataset is supported.
+   * The sink type. Currently, only Dataset is supported.
    * 
    * @example
    * Dataset
@@ -268,6 +535,7 @@ export class CreatePipelineRequestSink extends $dara.Model {
   type?: string;
   static names(): { [key: string]: string } {
     return {
+      condition: 'condition',
       dataset: 'dataset',
       type: 'type',
     };
@@ -275,12 +543,16 @@ export class CreatePipelineRequestSink extends $dara.Model {
 
   static types(): { [key: string]: any } {
     return {
+      condition: CreatePipelineRequestSinkCondition,
       dataset: CreatePipelineRequestSinkDataset,
       type: 'string',
     };
   }
 
   validate() {
+    if(this.condition && typeof (this.condition as any).validate === 'function') {
+      (this.condition as any).validate();
+    }
     if(this.dataset && typeof (this.dataset as any).validate === 'function') {
       (this.dataset as any).validate();
     }
@@ -292,6 +564,86 @@ export class CreatePipelineRequestSink extends $dara.Model {
   }
 }
 
+export class CreatePipelineRequestSourceDataset extends $dara.Model {
+  /**
+   * @remarks
+   * The name of the source dataset.
+   * 
+   * @example
+   * my-dataset
+   */
+  dataset?: string;
+  /**
+   * @remarks
+   * The filter condition for the 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 CreatePipelineRequestSourceInputFields 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 CreatePipelineRequestSourceLogstore extends $dara.Model {
   /**
    * @remarks
@@ -343,6 +695,16 @@ export class CreatePipelineRequestSourceLogstore extends $dara.Model {
 }
 
 export class CreatePipelineRequestSource extends $dara.Model {
+  /**
+   * @remarks
+   * The dataset datasource config under the current AgentSpace.
+   */
+  dataset?: CreatePipelineRequestSourceDataset;
+  /**
+   * @remarks
+   * The input fields and field types. This parameter applies to all data source types.
+   */
+  inputFields?: CreatePipelineRequestSourceInputFields[];
   /**
    * @remarks
    * The SLS Logstore datasource config.
@@ -358,6 +720,8 @@ export class CreatePipelineRequestSource extends $dara.Model {
   type?: string;
   static names(): { [key: string]: string } {
     return {
+      dataset: 'dataset',
+      inputFields: 'inputFields',
       logstore: 'logstore',
       type: 'type',
     };
@@ -365,12 +729,20 @@ export class CreatePipelineRequestSource extends $dara.Model {
 
   static types(): { [key: string]: any } {
     return {
+      dataset: CreatePipelineRequestSourceDataset,
+      inputFields: { 'type': 'array', 'itemType': CreatePipelineRequestSourceInputFields },
       logstore: CreatePipelineRequestSourceLogstore,
       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();
     }
@@ -388,7 +760,7 @@ export class CreatePipelineRequest extends $dara.Model {
    * The pipeline description. The description can be up to 256 characters in length.
    * 
    * @example
-   * 从 SLS 采集 Trace 数据清洗入 Dataset
+   * Collect trace data from SLS, perform data cleaning, and ingest it into a dataset
    */
   description?: string;
   /**
@@ -403,7 +775,7 @@ export class CreatePipelineRequest extends $dara.Model {
   pipeline?: CreatePipelineRequestPipeline;
   /**
    * @remarks
-   * The pipeline name. The name must be 3 to 63 characters in length and can contain only lowercase letters, digits, and hyphens.
+   * The pipeline name. The name must be 3 to 63 characters in length and can contain only lowercase letters, digits, and hyphens (-).
    * 
    * @example
    * my-pipeline
@@ -421,7 +793,7 @@ export class CreatePipelineRequest extends $dara.Model {
   source?: CreatePipelineRequestSource;
   /**
    * @remarks
-   * The idempotency token. A unique string generated by the client to ensure the idempotence of the create operation.
+   * The idempotency token. A unique string generated by the client to ensure the idempotency of the create operation.
    * 
    * @example
    * a1b2c3d4-1234-5678-90ab-cdef12345678

package/src/models/Evaluator.ts

@@ -1,11 +1,12 @@
 // This file is auto-generated, don't edit it
 import * as $dara from '@darabonba/typescript';
+import { EvaluatorVariableExtractorMappingValue } from "./EvaluatorVariableExtractorMappingValue";
 
 
 export class Evaluator extends $dara.Model {
   /**
    * @remarks
-   * The evaluator runtime configuration. For inline LLM evaluators, this must include configurations such as prompt. When referencing an existing evaluator, this parameter is typically not required and is only specified when runtime parameters such as version need to be set.
+   * The runtime configuration of the evaluator. For inline LLM evaluators, this must include configurations such as prompt. When referencing an existing evaluator, this parameter is typically not required and should only be specified when runtime parameters such as version need to be set.
    * 
    * @example
    * {"version":"1.0.0"}
@@ -45,7 +46,7 @@ export class Evaluator extends $dara.Model {
   resultName?: string;
   /**
    * @remarks
-   * The evaluation result type. Required for inline evaluators. Defaults to score when referencing an existing evaluator and this parameter is not specified.
+   * The evaluation result type. Required for inline evaluators. When referencing an existing evaluator, defaults to score if not specified.
    * 
    * @example
    * score
@@ -53,12 +54,17 @@ export class Evaluator extends $dara.Model {
   resultType?: string;
   /**
    * @remarks
-   * The evaluator type. Defaults to LLM if not specified. Inline CODE evaluators are currently not supported. For CODE type evaluators, reference a previously created evaluator by using evaluatorRef.
+   * The evaluator type. Defaults to LLM if not specified. Inline CODE evaluators are not currently supported. For the CODE type, reference a previously created evaluator by using evaluatorRef.
    * 
    * @example
    * AGENT
    */
   type?: string;
+  /**
+   * @remarks
+   * The variable extraction rule mapping that maps evaluator variables to a portion of the content within an evaluation data field. This is applicable when the variable value is not the entire field but a subset of the field content. This parameter shares the same variable name key space as variableMapping. Each variable can use only one of the two. Duplicate configurations cause an error. When referencing an existing evaluator, the variable names must exist in the evaluator definition. Call ListTraceFieldExtractionsPreview to perform a trial run for validation before saving.
+   */
+  variableExtractorMapping?: { [key: string]: EvaluatorVariableExtractorMappingValue };
   /**
    * @remarks
    * The variable mapping that maps evaluator variables to evaluation data fields. Required for LLM/AGENT inline evaluators. When referencing an existing evaluator, the variable names must exist in the evaluator definition.
@@ -76,6 +82,7 @@ export class Evaluator extends $dara.Model {
       resultName: 'resultName',
       resultType: 'resultType',
       type: 'type',
+      variableExtractorMapping: 'variableExtractorMapping',
       variableMapping: 'variableMapping',
     };
   }
@@ -89,6 +96,7 @@ export class Evaluator extends $dara.Model {
       resultName: 'string',
       resultType: 'string',
       type: 'string',
+      variableExtractorMapping: { 'type': 'map', 'keyType': 'string', 'valueType': EvaluatorVariableExtractorMappingValue },
       variableMapping: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
     };
   }
@@ -100,6 +108,9 @@ export class Evaluator extends $dara.Model {
     if(this.filters) {
       $dara.Model.validateMap(this.filters);
     }
+    if(this.variableExtractorMapping) {
+      $dara.Model.validateMap(this.variableExtractorMapping);
+    }
     if(this.variableMapping) {
       $dara.Model.validateMap(this.variableMapping);
     }

package/src/models/EvaluatorVariableExtractorMappingValue.ts

@@ -0,0 +1,54 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class EvaluatorVariableExtractorMappingValue extends $dara.Model {
+  /**
+   * @remarks
+   * The evaluation data field from which content is extracted. The extraction expression is applied to the content of this field. Required when saving with the evaluation task. For the trial run API, this parameter can be omitted and the backend derives it from the expression. Multiple variables can share the same source field.
+   * 
+   * @example
+   * trace.output
+   */
+  originField?: string;
+  /**
+   * @remarks
+   * The extraction method. jsonpath extracts values from the JSON content of the field by using JSONPath. regex performs regular expression matching on the full text of the field. When capturing groups are present, the first capturing group is returned. When no capturing group is present, the entire match is returned.
+   * 
+   * @example
+   * jsonpath
+   */
+  type?: string;
+  /**
+   * @remarks
+   * The extraction expression. Its meaning is determined by type. When type is jsonpath, specify a JSONPath expression. You can use either a relative path relative to originField (such as $.order.expected) or an absolute path from the root (such as $trace.output.order.expected). When type is regex, specify a regular expression. Note that backslashes must be escaped in JSON. The expression syntax is validated upon saving. For regular expressions, RE2 compatibility is additionally validated. Patterns such as lookahead assertions, lookbehind assertions, backreferences, named groups, atomic groups, and possessive quantifiers are rejected.
+   * 
+   * @example
+   * $.order.expected
+   */
+  expression?: string;
+  static names(): { [key: string]: string } {
+    return {
+      originField: 'originField',
+      type: 'type',
+      expression: 'expression',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      originField: 'string',
+      type: 'string',
+      expression: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+