@alicloud/agentloop20260520 2.0.0 → 2.2.0

package/src/models/CreateEvaluationTaskRequest.ts

@@ -0,0 +1,145 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+import { Evaluator } from "./Evaluator";
+import { RunStrategies } from "./RunStrategies";
+
+
+export class CreateEvaluationTaskRequest extends $dara.Model {
+  /**
+   * @remarks
+   * The task source. If this parameter is not specified, the backend uses `default`.
+   * 
+   * @example
+   * default
+   */
+  channel?: string;
+  /**
+   * @remarks
+   * The data source and execution configuration. When `dataType` is set to `trace`, the backend automatically populates the SLS Project and sets `storeName` to `logstore-tracing`. For trace-level evaluation, set `dataScope` to `trace`.
+   * 
+   * @example
+   * {"dataScope":"trace"}
+   */
+  config?: { [key: string]: string };
+  /**
+   * @remarks
+   * The filter conditions for evaluation data. This parameter supports a JSON object or a JSON string. Common fields include `query`, `provided`, `maxRecords`, and `samplingRate`.
+   * 
+   * @example
+   * {"query":"serviceName=\\"checkout-service\\"","maxRecords":10,"samplingRate":100}
+   */
+  dataFilter?: string;
+  /**
+   * @remarks
+   * The data source type of the evaluation object. Set this parameter to `trace` for trace-based evaluation.
+   * 
+   * @example
+   * trace
+   */
+  dataType?: string;
+  /**
+   * @remarks
+   * The description of the evaluation task.
+   * 
+   * @example
+   * 评估线上 Agent 链路任务完成度
+   */
+  description?: string;
+  /**
+   * @remarks
+   * The list of evaluator configurations. This parameter cannot be empty. Within the same task, `evaluatorRef` takes precedence as the unique identifier. Otherwise, `name` is used.
+   * 
+   * @example
+   * [{"evaluatorRef":"Builtin.agent_task_completion","resultName":"agent_task_completion","resultType":"score","variableMapping":{"input":"trace.input","output":"trace.output","agent_trajectory":"trace.agent_trajectory"}}]
+   */
+  evaluators?: Evaluator[];
+  /**
+   * @remarks
+   * The task execution strategy. This parameter supports a JSON object or a JSON string. Set this parameter to `backfill` for historical data backfill or `continuous` for continuous evaluation of new data.
+   */
+  runStrategies?: RunStrategies;
+  /**
+   * @remarks
+   * The key-value pairs of task tags. You do not need to specify this parameter by default. Specify this parameter only when you want to associate or filter tasks by business tags.
+   * 
+   * @example
+   * {"env":"prod","serviceId":"checkout-service","planId":"plan-20260703"}
+   */
+  tags?: { [key: string]: string };
+  /**
+   * @remarks
+   * The evaluation task mode. Set this parameter to `batch` to create a persistent evaluation task.
+   * 
+   * @example
+   * batch
+   */
+  taskMode?: string;
+  /**
+   * @remarks
+   * The task name. The name must be unique among non-deleted tasks within the same user and AgentSpace. The name can be up to 256 characters in length.
+   * 
+   * @example
+   * trace_task_completion_eval
+   */
+  taskName?: string;
+  /**
+   * @remarks
+   * The idempotency token. This query parameter is declared in CloudSpec, but the backend does not currently perform idempotency comparison.
+   * 
+   * @example
+   * a1b2c3d4-1234-5678-90ab-cdef12345678
+   */
+  clientToken?: string;
+  static names(): { [key: string]: string } {
+    return {
+      channel: 'channel',
+      config: 'config',
+      dataFilter: 'dataFilter',
+      dataType: 'dataType',
+      description: 'description',
+      evaluators: 'evaluators',
+      runStrategies: 'runStrategies',
+      tags: 'tags',
+      taskMode: 'taskMode',
+      taskName: 'taskName',
+      clientToken: 'clientToken',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      channel: 'string',
+      config: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
+      dataFilter: 'string',
+      dataType: 'string',
+      description: 'string',
+      evaluators: { 'type': 'array', 'itemType': Evaluator },
+      runStrategies: RunStrategies,
+      tags: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
+      taskMode: 'string',
+      taskName: 'string',
+      clientToken: 'string',
+    };
+  }
+
+  validate() {
+    if(this.config) {
+      $dara.Model.validateMap(this.config);
+    }
+    if(Array.isArray(this.evaluators)) {
+      $dara.Model.validateArray(this.evaluators);
+    }
+    if(this.runStrategies && typeof (this.runStrategies as any).validate === 'function') {
+      (this.runStrategies as any).validate();
+    }
+    if(this.tags) {
+      $dara.Model.validateMap(this.tags);
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/CreateEvaluationTaskResponse.ts

@@ -0,0 +1,40 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+import { CreateEvaluationTaskResponseBody } from "./CreateEvaluationTaskResponseBody";
+
+
+export class CreateEvaluationTaskResponse extends $dara.Model {
+  headers?: { [key: string]: string };
+  statusCode?: number;
+  body?: CreateEvaluationTaskResponseBody;
+  static names(): { [key: string]: string } {
+    return {
+      headers: 'headers',
+      statusCode: 'statusCode',
+      body: 'body',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      headers: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
+      statusCode: 'number',
+      body: CreateEvaluationTaskResponseBody,
+    };
+  }
+
+  validate() {
+    if(this.headers) {
+      $dara.Model.validateMap(this.headers);
+    }
+    if(this.body && typeof (this.body as any).validate === 'function') {
+      (this.body as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/CreateEvaluationTaskResponseBody.ts

@@ -0,0 +1,54 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class CreateEvaluationTaskResponseBody extends $dara.Model {
+  /**
+   * @remarks
+   * The request ID.
+   * 
+   * @example
+   * 3FE4CD1E-FF41-56BE-B590-7A021D9C1524
+   */
+  requestId?: string;
+  /**
+   * @remarks
+   * The evaluation task status. After creation, the status is typically `Pending`. After asynchronous orchestration, the status may change to `Running` or `Scheduling`.
+   * 
+   * @example
+   * Pending
+   */
+  status?: string;
+  /**
+   * @remarks
+   * The evaluation task ID.
+   * 
+   * @example
+   * eval-task-8b36f2e2b1f94f9c91ce7a4b0f6d9c25
+   */
+  taskId?: string;
+  static names(): { [key: string]: string } {
+    return {
+      requestId: 'requestId',
+      status: 'status',
+      taskId: 'taskId',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      requestId: 'string',
+      status: 'string',
+      taskId: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/CreateEvaluatorRequest.ts

@@ -0,0 +1,155 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class CreateEvaluatorRequest extends $dara.Model {
+  /**
+   * @remarks
+   * The list of annotation tags.
+   * 
+   * @example
+   * ["__en"]
+   */
+  annotations?: string[];
+  /**
+   * @remarks
+   * The evaluator configuration. For LLM/AGENT evaluators, this typically contains prompt, variables, and outputSchema. For CODE evaluators, this typically contains codeType, faasConfig, variables, and parameters.
+   * 
+   * @example
+   * {"prompt":"请评估任务完成度","variables":[{"name":"input"}]}
+   */
+  config?: { [key: string]: any };
+  /**
+   * @remarks
+   * The evaluator description. The description can be up to 256 characters in length.
+   * 
+   * @example
+   * 判断 Agent 是否完成用户任务
+   */
+  description?: string;
+  /**
+   * @remarks
+   * The display name. The name can be up to 128 characters in length.
+   * 
+   * @example
+   * 链路任务完成度
+   */
+  displayName?: string;
+  /**
+   * @remarks
+   * The evaluation metric name.
+   * 
+   * This parameter is required.
+   * 
+   * @example
+   * agent_task_completion
+   */
+  metricName?: string;
+  /**
+   * @remarks
+   * The evaluator name. The name cannot start with a system-reserved prefix and can be up to 128 characters in length.
+   * 
+   * This parameter is required.
+   * 
+   * @example
+   * trace_task_completion
+   */
+  name?: string;
+  /**
+   * @remarks
+   * The evaluator properties.
+   * 
+   * @example
+   * {"agentEvaluatorMode":"raw_prompt"}
+   */
+  properties?: { [key: string]: any };
+  /**
+   * @remarks
+   * The evaluator type. Valid values:
+   * 
+   * - LLM: an inner join large language model evaluation evaluator.
+   * - AGENT: a StarOps digital human evaluator.
+   * - CODE: a code evaluator.
+   * 
+   * This parameter is required.
+   * 
+   * @example
+   * AGENT
+   */
+  type?: string;
+  /**
+   * @remarks
+   * The initial version number.
+   * 
+   * This parameter is required.
+   * 
+   * @example
+   * 1.0.0
+   */
+  version?: string;
+  /**
+   * @remarks
+   * The version description.
+   * 
+   * @example
+   * 初始版本
+   */
+  versionDescription?: string;
+  /**
+   * @remarks
+   * The idempotency token. A unique string generated by the client to ensure idempotent creation. This query parameter is declared in CloudSpec, but the backend does not currently perform idempotency checks.
+   * 
+   * @example
+   * a1b2c3d4-1234-5678-90ab-cdef12345678
+   */
+  clientToken?: string;
+  static names(): { [key: string]: string } {
+    return {
+      annotations: 'annotations',
+      config: 'config',
+      description: 'description',
+      displayName: 'displayName',
+      metricName: 'metricName',
+      name: 'name',
+      properties: 'properties',
+      type: 'type',
+      version: 'version',
+      versionDescription: 'versionDescription',
+      clientToken: 'clientToken',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      annotations: { 'type': 'array', 'itemType': 'string' },
+      config: { 'type': 'map', 'keyType': 'string', 'valueType': 'any' },
+      description: 'string',
+      displayName: 'string',
+      metricName: 'string',
+      name: 'string',
+      properties: { 'type': 'map', 'keyType': 'string', 'valueType': 'any' },
+      type: 'string',
+      version: 'string',
+      versionDescription: 'string',
+      clientToken: 'string',
+    };
+  }
+
+  validate() {
+    if(Array.isArray(this.annotations)) {
+      $dara.Model.validateArray(this.annotations);
+    }
+    if(this.config) {
+      $dara.Model.validateMap(this.config);
+    }
+    if(this.properties) {
+      $dara.Model.validateMap(this.properties);
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/CreateEvaluatorResponse.ts

@@ -0,0 +1,40 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+import { CreateEvaluatorResponseBody } from "./CreateEvaluatorResponseBody";
+
+
+export class CreateEvaluatorResponse extends $dara.Model {
+  headers?: { [key: string]: string };
+  statusCode?: number;
+  body?: CreateEvaluatorResponseBody;
+  static names(): { [key: string]: string } {
+    return {
+      headers: 'headers',
+      statusCode: 'statusCode',
+      body: 'body',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      headers: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
+      statusCode: 'number',
+      body: CreateEvaluatorResponseBody,
+    };
+  }
+
+  validate() {
+    if(this.headers) {
+      $dara.Model.validateMap(this.headers);
+    }
+    if(this.body && typeof (this.body as any).validate === 'function') {
+      (this.body as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/CreateEvaluatorResponseBody.ts

@@ -0,0 +1,54 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class CreateEvaluatorResponseBody extends $dara.Model {
+  /**
+   * @remarks
+   * The evaluator name.
+   * 
+   * @example
+   * trace_task_completion
+   */
+  name?: string;
+  /**
+   * @remarks
+   * The request ID.
+   * 
+   * @example
+   * 3FE4CD1E-FF41-56BE-B590-7A021D9C1524
+   */
+  requestId?: string;
+  /**
+   * @remarks
+   * The version number that is created.
+   * 
+   * @example
+   * 1.0.0
+   */
+  version?: string;
+  static names(): { [key: string]: string } {
+    return {
+      name: 'name',
+      requestId: 'requestId',
+      version: 'version',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      name: 'string',
+      requestId: 'string',
+      version: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/CreateEvaluatorSkillRequest.ts

@@ -0,0 +1,157 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class CreateEvaluatorSkillRequestFiles extends $dara.Model {
+  /**
+   * @remarks
+   * The skill file content.
+   * 
+   * This parameter is required.
+   * 
+   * @example
+   * # Trace Context Loader
+   */
+  content?: string;
+  /**
+   * @remarks
+   * The skill file name.
+   * 
+   * This parameter is required.
+   * 
+   * @example
+   * SKILL.md
+   */
+  name?: string;
+  /**
+   * @remarks
+   * The file remarks.
+   * 
+   * @example
+   * 主技能说明
+   */
+  remark?: string;
+  static names(): { [key: string]: string } {
+    return {
+      content: 'content',
+      name: 'name',
+      remark: 'remark',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      content: 'string',
+      name: 'string',
+      remark: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class CreateEvaluatorSkillRequest extends $dara.Model {
+  /**
+   * @remarks
+   * The AgentSpace name.
+   * 
+   * This parameter is required.
+   * 
+   * @example
+   * prod-agentspace
+   */
+  agentSpace?: string;
+  /**
+   * @remarks
+   * The description of the skill.
+   * 
+   * @example
+   * 读取链路上下文辅助评估
+   */
+  description?: string;
+  /**
+   * @remarks
+   * The display name of the skill.
+   * 
+   * @example
+   * Trace 上下文读取
+   */
+  displayName?: string;
+  /**
+   * @remarks
+   * Specifies whether to enable the skill.
+   * 
+   * @example
+   * true
+   */
+  enable?: boolean;
+  /**
+   * @remarks
+   * The list of skill files.
+   * 
+   * This parameter is required.
+   * 
+   * @example
+   * [{"name":"SKILL.md","content":"# Trace Context Loader","remark":"主技能说明"}]
+   */
+  files?: CreateEvaluatorSkillRequestFiles[];
+  /**
+   * @remarks
+   * The skill name.
+   * 
+   * This parameter is required.
+   * 
+   * @example
+   * trace_context_loader
+   */
+  skillName?: string;
+  /**
+   * @remarks
+   * The idempotency token. This is a unique string generated by the client to ensure idempotence of the create operation. CloudSpec declares this query parameter, but the backend does not currently perform idempotency comparison.
+   * 
+   * @example
+   * a1b2c3d4-1234-5678-90ab-cdef12345678
+   */
+  clientToken?: string;
+  static names(): { [key: string]: string } {
+    return {
+      agentSpace: 'agentSpace',
+      description: 'description',
+      displayName: 'displayName',
+      enable: 'enable',
+      files: 'files',
+      skillName: 'skillName',
+      clientToken: 'clientToken',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      agentSpace: 'string',
+      description: 'string',
+      displayName: 'string',
+      enable: 'boolean',
+      files: { 'type': 'array', 'itemType': CreateEvaluatorSkillRequestFiles },
+      skillName: 'string',
+      clientToken: 'string',
+    };
+  }
+
+  validate() {
+    if(Array.isArray(this.files)) {
+      $dara.Model.validateArray(this.files);
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/CreateEvaluatorSkillResponse.ts

@@ -0,0 +1,40 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+import { CreateEvaluatorSkillResponseBody } from "./CreateEvaluatorSkillResponseBody";
+
+
+export class CreateEvaluatorSkillResponse extends $dara.Model {
+  headers?: { [key: string]: string };
+  statusCode?: number;
+  body?: CreateEvaluatorSkillResponseBody;
+  static names(): { [key: string]: string } {
+    return {
+      headers: 'headers',
+      statusCode: 'statusCode',
+      body: 'body',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      headers: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
+      statusCode: 'number',
+      body: CreateEvaluatorSkillResponseBody,
+    };
+  }
+
+  validate() {
+    if(this.headers) {
+      $dara.Model.validateMap(this.headers);
+    }
+    if(this.body && typeof (this.body as any).validate === 'function') {
+      (this.body as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+