@alicloud/agentloop20260520 2.3.2 → 2.3.3

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);
+  }
+}
+

package/src/models/GetEvaluationTaskResponseBody.ts

@@ -23,7 +23,7 @@ export class GetEvaluationTaskResponseBody extends $dara.Model {
   channel?: string;
   /**
    * @remarks
-   * The data source and execution configuration. Tasks with `dataType=trace` typically include `project`, `storeName`, and `dataScope` fields populated by the backend.
+   * The data source and execution configuration. Tasks with `dataType=trace` typically contain `project`, `storeName`, and `dataScope` fields that are populated by the backend.
    * 
    * @example
    * {"project":"agentspace-project","storeName":"logstore-tracing","dataScope":"trace"}
@@ -39,7 +39,7 @@ export class GetEvaluationTaskResponseBody extends $dara.Model {
   createdAt?: number;
   /**
    * @remarks
-   * The filter conditions for evaluation data, returned by the backend as a JSON string.
+   * The evaluation data filter condition, returned by the backend as a JSON string.
    * 
    * @example
    * {"query":"serviceName=\\"checkout-service\\"","maxRecords":10,"samplingRate":100}
@@ -58,7 +58,7 @@ export class GetEvaluationTaskResponseBody extends $dara.Model {
    * The evaluation task description.
    * 
    * @example
-   * 评估线上 Agent 链路任务完成度
+   * Evaluate the task completion rate of the online Agent pipeline
    */
   description?: string;
   /**

package/src/models/GetExperimentPlanResponseBody.ts

@@ -7,7 +7,7 @@ import { ExperimentConfig } from "./ExperimentConfig";
 export class GetExperimentPlanResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The creation time. This value is a millisecond-level UNIX timestamp.
+   * The creation time, in millisecond-level UNIX timestamp.
    * 
    * @example
    * 1782816000000
@@ -26,7 +26,7 @@ export class GetExperimentPlanResponseBody extends $dara.Model {
    * The description.
    * 
    * @example
-   * Compare the checkout Agent baseline with the optimized version.
+   * Compare the checkout Agent baseline with the optimized version
    */
   description?: string;
   /**
@@ -61,6 +61,10 @@ export class GetExperimentPlanResponseBody extends $dara.Model {
    * {"question": "How do I request a refund?"}
    */
   input?: { [key: string]: any };
+  /**
+   * @remarks
+   * The name of the associated data processing pipeline. This value is empty if no pipeline is associated.
+   */
   pipelineName?: string;
   /**
    * @remarks
@@ -96,7 +100,7 @@ export class GetExperimentPlanResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The list of selected data item IDs in partial dataset mode.
+   * The list of data item IDs selected in partial dataset mode.
    * 
    * @example
    * ["019ef4d5-a0f0-7114-832d-5542d771cd8c"]
@@ -112,7 +116,7 @@ export class GetExperimentPlanResponseBody extends $dara.Model {
   status?: string;
   /**
    * @remarks
-   * The update time. This value is a millisecond-level UNIX timestamp.
+   * The update time, in millisecond-level UNIX timestamp.
    * 
    * @example
    * 1782816600000