@alicloud/agentloop20260520 2.3.4 → 2.3.6

package/src/models/CreateExperimentRunRequest.ts

@@ -6,7 +6,7 @@ import { OfflineExperimentConfig } from "./OfflineExperimentConfig";
 export class CreateExperimentRunRequest extends $dara.Model {
   /**
    * @remarks
-   * The completion time, in millisecond-level UNIX timestamp.
+   * The completion time. The value is a millisecond-level UNIX timestamp.
    * 
    * @example
    * 1784721811392
@@ -14,7 +14,7 @@ export class CreateExperimentRunRequest extends $dara.Model {
   completedAt?: number;
   /**
    * @remarks
-   * The number of completed tasks. If not specified, the default value is 0.
+   * The number of completed tasks. Default value: 0.
    * 
    * @example
    * 0
@@ -22,7 +22,7 @@ export class CreateExperimentRunRequest extends $dara.Model {
   completedTasks?: number;
   /**
    * @remarks
-   * The execution time, in millisecond-level UNIX timestamp.
+   * The execution time. The value is a millisecond-level UNIX timestamp.
    * 
    * @example
    * 1784721775379
@@ -40,7 +40,7 @@ export class CreateExperimentRunRequest extends $dara.Model {
   experimentPlanId?: string;
   /**
    * @remarks
-   * The number of failed tasks. If not specified, the default value is 0.
+   * The number of failed tasks. Default value: 0.
    * 
    * @example
    * 0
@@ -48,7 +48,7 @@ export class CreateExperimentRunRequest extends $dara.Model {
   failedTasks?: number;
   /**
    * @remarks
-   * The list of offline experiment configurations. Required when the plan type is offline. The number of items ranges from 1 to 5.
+   * The list of offline experiment configurations. This parameter is required when the plan type is offline. You can specify 1 to 5 configurations.
    * 
    * @example
    * [{"label": "experimentA", "name": "experimentA"}]
@@ -56,7 +56,7 @@ export class CreateExperimentRunRequest extends $dara.Model {
   offlineExperiments?: OfflineExperimentConfig[];
   /**
    * @remarks
-   * The experiment record name. If not specified, the default value is the plan name plus a timestamp.
+   * The experiment record name. If not specified, the default value is the plan name followed by a timestamp.
    * 
    * @example
    * arms_agent_experiment 2026/07/22 20:02:55
@@ -64,7 +64,7 @@ export class CreateExperimentRunRequest extends $dara.Model {
   recordName?: string;
   /**
    * @remarks
-   * The initial status. If not specified, the default value is `pending`.
+   * The initial status. Default value: `pending`.
    * 
    * @example
    * pending

package/src/models/CreateExperimentRunResponseBody.ts

@@ -8,12 +8,12 @@ export class CreateExperimentRunResponseBody extends $dara.Model {
    * The message.
    * 
    * @example
-   * Experiment created, execution started.
+   * Experiment created, execution started
    */
   message?: string;
   /**
    * @remarks
-   * The experiment record ID. For online experiments, the format is typically exp-run-{uuid32}. For offline experiments, the format may also be a standard UUID.
+   * The experiment record ID. For online experiments, the ID is typically in the format exp-run-{uuid32}. For offline experiments, the ID may also be a standard UUID.
    * 
    * @example
    * exp-run-f6d419b0ed3d43a7b585948a55efc07b
@@ -29,7 +29,7 @@ export class CreateExperimentRunResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The experiment record status. After creation, the status is typically pending.
+   * The experiment record status. The value is typically pending after creation.
    * 
    * @example
    * pending

package/src/models/DeleteExperimentPlanResponseBody.ts

@@ -21,7 +21,7 @@ export class DeleteExperimentPlanResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The deletion result. The value is deleted if the operation is successful.
+   * The deletion result. The value is deleted if the operation succeeds.
    * 
    * @example
    * deleted

package/src/models/ExperimentConfig.ts

@@ -5,14 +5,58 @@ import { PromptTemplateItem } from "./PromptTemplateItem";
 
 
 export class ExperimentConfig extends $dara.Model {
+  /**
+   * @remarks
+   * The endpoint connector ID. This parameter is required in user/agent mode.
+   */
   endpointConnectorId?: string;
+  /**
+   * @remarks
+   * The experiment label (A/B/C/D/E).
+   */
   label?: string;
+  /**
+   * @remarks
+   * The model name. You can set this parameter to agent in agent scenarios.
+   */
   modelName?: string;
+  /**
+   * @remarks
+   * The model parameters.
+   */
   modelParameters?: ModelParameters;
+  /**
+   * @remarks
+   * The model provider. Valid values: dashscope (default), user, and agent.
+   */
   modelProvider?: string;
+  /**
+   * @remarks
+   * The experiment name.
+   */
   name?: string;
+  /**
+   * @remarks
+   * The prompt message template. Supports {{variable name}} placeholders.
+   */
   promptTemplate?: PromptTemplateItem[];
+  /**
+   * @remarks
+   * The agent request body template. This parameter is required in agent mode. Supports {{variable name}} placeholders.
+   */
   requestBodyTemplate?: string;
+  /**
+   * @remarks
+   * The agent request header template. This parameter is optional in agent mode. Supports {{variable name}} placeholders.
+   * 
+   * @example
+   * {"Content-Type: application/json" }
+   */
+  requestHeaderTemplate?: string;
+  /**
+   * @remarks
+   * The agent request method. Valid values: POST (default) and GET.
+   */
   requestMethod?: string;
   static names(): { [key: string]: string } {
     return {
@@ -24,6 +68,7 @@ export class ExperimentConfig extends $dara.Model {
       name: 'name',
       promptTemplate: 'promptTemplate',
       requestBodyTemplate: 'requestBodyTemplate',
+      requestHeaderTemplate: 'requestHeaderTemplate',
       requestMethod: 'requestMethod',
     };
   }
@@ -38,6 +83,7 @@ export class ExperimentConfig extends $dara.Model {
       name: 'string',
       promptTemplate: { 'type': 'array', 'itemType': PromptTemplateItem },
       requestBodyTemplate: 'string',
+      requestHeaderTemplate: 'string',
       requestMethod: 'string',
     };
   }

package/src/models/GetEvaluationRunResponseBody.ts

@@ -13,7 +13,7 @@ export class GetEvaluationRunResponseBodyEvaluatorProgress extends $dara.Model {
   evaluatorName?: string;
   /**
    * @remarks
-   * The number of failed entries for this evaluator.
+   * The number of failed items for this evaluator.
    * 
    * @example
    * 4
@@ -21,7 +21,7 @@ export class GetEvaluationRunResponseBodyEvaluatorProgress extends $dara.Model {
   failedCount?: number;
   /**
    * @remarks
-   * The number of successful entries for this evaluator.
+   * The number of successful items for this evaluator.
    * 
    * @example
    * 96
@@ -29,7 +29,7 @@ export class GetEvaluationRunResponseBodyEvaluatorProgress extends $dara.Model {
   successCount?: number;
   /**
    * @remarks
-   * The total number of entries for this evaluator.
+   * The total number of items for this evaluator.
    * 
    * @example
    * 100
@@ -73,7 +73,7 @@ export class GetEvaluationRunResponseBody extends $dara.Model {
   createdAt?: number;
   /**
    * @remarks
-   * The end time of the data window for the run, in seconds-level UNIX timestamp.
+   * The end time of the run data window, in seconds-level UNIX timestamp.
    * 
    * @example
    * 1782902400
@@ -81,7 +81,7 @@ export class GetEvaluationRunResponseBody extends $dara.Model {
   dataEndTime?: number;
   /**
    * @remarks
-   * The start time of the data window for the run, in seconds-level UNIX timestamp.
+   * The start time of the run data window, in seconds-level UNIX timestamp.
    * 
    * @example
    * 1782816000
@@ -89,7 +89,7 @@ export class GetEvaluationRunResponseBody extends $dara.Model {
   dataStartTime?: number;
   /**
    * @remarks
-   * The list of progress details by evaluator.
+   * The list of progress entries by evaluator.
    * 
    * @example
    * [{"evaluatorName":"Builtin.agent_task_completion","totalCount":100,"successCount":96,"failedCount":4}]
@@ -97,7 +97,7 @@ export class GetEvaluationRunResponseBody extends $dara.Model {
   evaluatorProgress?: GetEvaluationRunResponseBodyEvaluatorProgress[];
   /**
    * @remarks
-   * The evaluator configuration snapshot at the time the run was created, in JSON string format.
+   * The snapshot of the evaluator configuration at the time the run was created, in JSON string format.
    * 
    * @example
    * [{"evaluatorRef":"Builtin.agent_task_completion"}]
@@ -105,7 +105,7 @@ export class GetEvaluationRunResponseBody extends $dara.Model {
   evaluators?: string;
   /**
    * @remarks
-   * The number of failed entries.
+   * The number of failed items.
    * 
    * @example
    * 4
@@ -153,7 +153,7 @@ export class GetEvaluationRunResponseBody extends $dara.Model {
   status?: string;
   /**
    * @remarks
-   * The number of successful entries.
+   * The number of successful items.
    * 
    * @example
    * 96
@@ -169,7 +169,7 @@ export class GetEvaluationRunResponseBody extends $dara.Model {
   taskId?: string;
   /**
    * @remarks
-   * The total number of evaluation entries.
+   * The total number of evaluation items.
    * 
    * @example
    * 100

package/src/models/GetEvaluationTaskResponseBody.ts

@@ -15,7 +15,7 @@ export class GetEvaluationTaskResponseBody extends $dara.Model {
   agentSpace?: string;
   /**
    * @remarks
-   * The task source.
+   * The source of the task.
    * 
    * @example
    * default
@@ -23,7 +23,7 @@ export class GetEvaluationTaskResponseBody extends $dara.Model {
   channel?: string;
   /**
    * @remarks
-   * The data source and execution configuration. Tasks with `dataType=trace` typically contain `project`, `storeName`, and `dataScope` fields that are populated by the backend.
+   * The data source and execution configuration. Tasks with `dataType=trace` typically contain backend-populated `project`, `storeName`, and `dataScope` fields.
    * 
    * @example
    * {"project":"agentspace-project","storeName":"logstore-tracing","dataScope":"trace"}
@@ -31,7 +31,7 @@ export class GetEvaluationTaskResponseBody extends $dara.Model {
   config?: { [key: string]: string };
   /**
    * @remarks
-   * The creation time, in seconds-level UNIX timestamp.
+   * The creation time, in seconds as a UNIX timestamp.
    * 
    * @example
    * 1782816000
@@ -39,7 +39,7 @@ export class GetEvaluationTaskResponseBody extends $dara.Model {
   createdAt?: number;
   /**
    * @remarks
-   * The evaluation data filter condition, returned by the backend as a JSON string.
+   * The evaluation data filter conditions, returned by the backend as a JSON string.
    * 
    * @example
    * {"query":"serviceName=\\"checkout-service\\"","maxRecords":10,"samplingRate":100}
@@ -55,10 +55,10 @@ export class GetEvaluationTaskResponseBody extends $dara.Model {
   dataType?: string;
   /**
    * @remarks
-   * The evaluation task description.
+   * The description of the evaluation task.
    * 
    * @example
-   * Evaluate the task completion rate of the online Agent pipeline
+   * Evaluate the task completion of the online Agent pipeline
    */
   description?: string;
   /**
@@ -87,7 +87,7 @@ export class GetEvaluationTaskResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The structured configuration of the run strategy, including the parsed backfill strategy and continuous evaluation strategy.
+   * The structured run strategy configuration, including the parsed backfill strategy and continuous evaluation strategy.
    * 
    * @example
    * {"backfill":{"enabled":true,"startTime":1782816000000,"endTime":1782902400000},"continuous":{"enabled":true,"intervalUnit":"HOUR","intervalValue":1,"dataDelayMinutes":5}}
@@ -135,7 +135,7 @@ export class GetEvaluationTaskResponseBody extends $dara.Model {
   taskName?: string;
   /**
    * @remarks
-   * The last update time, in seconds-level UNIX timestamp.
+   * The last update time, in seconds as a UNIX timestamp.
    * 
    * @example
    * 1782816600

package/src/models/GetEvaluatorResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class GetEvaluatorResponseBodyEvaluatorVersions extends $dara.Model {
   /**
    * @remarks
-   * The time when the version was created. The value is a UNIX timestamp in seconds.
+   * The version creation time, in seconds-level UNIX timestamp.
    * 
    * @example
    * 1782816000
@@ -24,7 +24,7 @@ export class GetEvaluatorResponseBodyEvaluatorVersions extends $dara.Model {
    * The version description.
    * 
    * @example
-   * 初始版本
+   * Initial version
    */
   versionDescription?: string;
   static names(): { [key: string]: string } {
@@ -74,12 +74,12 @@ export class GetEvaluatorResponseBodyEvaluator extends $dara.Model {
    * The configuration of the current version.
    * 
    * @example
-   * {"prompt":"请评估任务完成度"}
+   * {"prompt":"Please evaluate the task completion"}
    */
   config?: { [key: string]: any };
   /**
    * @remarks
-   * The time when the evaluator was created. The value is a UNIX timestamp in seconds.
+   * The creation time, in seconds-level UNIX timestamp.
    * 
    * @example
    * 1782816000
@@ -98,7 +98,7 @@ export class GetEvaluatorResponseBodyEvaluator extends $dara.Model {
    * The evaluator description.
    * 
    * @example
-   * 判断 Agent 是否完成用户任务
+   * Determines whether the Agent has completed the user task
    */
   description?: string;
   /**
@@ -106,7 +106,7 @@ export class GetEvaluatorResponseBodyEvaluator extends $dara.Model {
    * The display name.
    * 
    * @example
-   * 链路任务完成度
+   * Trace task completion
    */
   displayName?: string;
   /**
@@ -151,7 +151,7 @@ export class GetEvaluatorResponseBodyEvaluator extends $dara.Model {
   type?: string;
   /**
    * @remarks
-   * The time when the evaluator was last updated. The value is a UNIX timestamp in seconds.
+   * The update time, in seconds-level UNIX timestamp.
    * 
    * @example
    * 1782816600

package/src/models/GetEvaluatorSkillResponseBody.ts

@@ -21,10 +21,10 @@ export class GetEvaluatorSkillResponseBodySkillFiles extends $dara.Model {
   name?: string;
   /**
    * @remarks
-   * The file remarks.
+   * The file remark.
    * 
    * @example
-   * 主技能说明
+   * Main skill description
    */
   remark?: string;
   static names(): { [key: string]: string } {
@@ -55,7 +55,7 @@ export class GetEvaluatorSkillResponseBodySkillFiles extends $dara.Model {
 export class GetEvaluatorSkillResponseBodySkillVersions extends $dara.Model {
   /**
    * @remarks
-   * The time when the version was created. This value is a UNIX timestamp in seconds.
+   * The version creation time, in seconds-level UNIX timestamp.
    * 
    * @example
    * 1782816000
@@ -74,7 +74,7 @@ export class GetEvaluatorSkillResponseBodySkillVersions extends $dara.Model {
    * The version description.
    * 
    * @example
-   * 首次发布版本
+   * Initial release version
    */
   versionDescription?: string;
   static names(): { [key: string]: string } {
@@ -105,7 +105,7 @@ export class GetEvaluatorSkillResponseBodySkillVersions extends $dara.Model {
 export class GetEvaluatorSkillResponseBodySkill extends $dara.Model {
   /**
    * @remarks
-   * The time when the skill was created. This value is a UNIX timestamp in seconds.
+   * The creation time, in seconds-level UNIX timestamp.
    * 
    * @example
    * 1782816000
@@ -124,7 +124,7 @@ export class GetEvaluatorSkillResponseBodySkill extends $dara.Model {
    * The skill description.
    * 
    * @example
-   * 读取链路上下文辅助评估
+   * Read trace context to assist evaluation
    */
   description?: string;
   /**
@@ -132,7 +132,7 @@ export class GetEvaluatorSkillResponseBodySkill extends $dara.Model {
    * The display name.
    * 
    * @example
-   * Trace 上下文读取
+   * Trace Context Loader
    */
   displayName?: string;
   /**
@@ -148,7 +148,7 @@ export class GetEvaluatorSkillResponseBodySkill extends $dara.Model {
    * The list of skill files.
    * 
    * @example
-   * [{"name":"SKILL.md","content":"# Trace Context Loader","remark":"主技能说明"}]
+   * [{"name":"SKILL.md","content":"# Trace Context Loader","remark":"Main skill description"}]
    */
   files?: GetEvaluatorSkillResponseBodySkillFiles[];
   /**
@@ -169,7 +169,7 @@ export class GetEvaluatorSkillResponseBodySkill extends $dara.Model {
   skillName?: string;
   /**
    * @remarks
-   * The time when the skill was last updated. This value is a UNIX timestamp in seconds.
+   * The update time, in seconds-level UNIX timestamp.
    * 
    * @example
    * 1782816600
@@ -180,7 +180,7 @@ export class GetEvaluatorSkillResponseBodySkill extends $dara.Model {
    * The list of skill versions.
    * 
    * @example
-   * [{"version":"1782816000000","versionDescription":"首次发布版本"}]
+   * [{"version":"1782816000000","versionDescription":"Initial release version"}]
    */
   versions?: GetEvaluatorSkillResponseBodySkillVersions[];
   static names(): { [key: string]: string } {

package/src/models/GetExperimentPlanResponseBody.ts

@@ -7,7 +7,7 @@ import { ExperimentConfig } from "./ExperimentConfig";
 export class GetExperimentPlanResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The creation time, in millisecond-level UNIX timestamp.
+   * The creation time. The value is a 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 checkout Agent baseline with optimized version
    */
   description?: string;
   /**
@@ -100,7 +100,7 @@ export class GetExperimentPlanResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The list of data item IDs selected in partial dataset mode.
+   * The list of selected data item IDs in partial dataset mode.
    * 
    * @example
    * ["019ef4d5-a0f0-7114-832d-5542d771cd8c"]
@@ -116,7 +116,7 @@ export class GetExperimentPlanResponseBody extends $dara.Model {
   status?: string;
   /**
    * @remarks
-   * The update time, in millisecond-level UNIX timestamp.
+   * The update time. The value is a millisecond-level UNIX timestamp.
    * 
    * @example
    * 1782816600000

package/src/models/IndexJsonKey.ts

@@ -3,7 +3,23 @@ import * as $dara from '@darabonba/typescript';
 
 
 export class IndexJsonKey extends $dara.Model {
+  /**
+   * @remarks
+   * Specifies whether the field contains Chinese characters. This parameter is required only when the **type** parameter is set to **text**. Valid values:
+   *   - true: The field contains Chinese characters.
+   *   - false: The field does not contain Chinese characters.
+   * 
+   * @example
+   * false
+   */
   chn?: boolean;
+  /**
+   * @remarks
+   * The type.
+   * 
+   * @example
+   * text
+   */
   type?: string;
   static names(): { [key: string]: string } {
     return {

package/src/models/IndexKey.ts

@@ -4,13 +4,49 @@ import { IndexJsonKey } from "./IndexJsonKey";
 
 
 export class IndexKey extends $dara.Model {
+  /**
+   * @remarks
+   * Specifies whether Chinese is included. This parameter is required only when the **type** parameter is set to **text**. Valid values:
+   *   - true: Chinese is included.
+   *   - false: Chinese is not included.
+   * 
+   * @example
+   * true
+   */
   chn?: boolean;
+  /**
+   * @remarks
+   * The description.
+   * 
+   * @example
+   * test
+   */
+  description?: string;
+  /**
+   * @remarks
+   * The field embedding type.
+   * 
+   * @example
+   * agentloop-embedding-v4
+   */
   embedding?: string;
+  /**
+   * @remarks
+   * The JSON subfields. This parameter takes effect only when type is set to json.
+   */
   jsonKeys?: { [key: string]: IndexJsonKey };
+  /**
+   * @remarks
+   * The type.
+   * 
+   * @example
+   * text
+   */
   type?: string;
   static names(): { [key: string]: string } {
     return {
       chn: 'chn',
+      description: 'description',
       embedding: 'embedding',
       jsonKeys: 'jsonKeys',
       type: 'type',
@@ -20,6 +56,7 @@ export class IndexKey extends $dara.Model {
   static types(): { [key: string]: any } {
     return {
       chn: 'boolean',
+      description: 'string',
       embedding: 'string',
       jsonKeys: { 'type': 'map', 'keyType': 'string', 'valueType': IndexJsonKey },
       type: 'string',

package/src/models/ListAgentSpacesRequest.ts

@@ -27,6 +27,13 @@ export class ListAgentSpacesRequest extends $dara.Model {
    * pEL20OGYeZQez8NdW7ve
    */
   nextToken?: string;
+  /**
+   * @remarks
+   * The region ID.
+   * 
+   * @example
+   * cn-hangzhou
+   */
   regionId?: string;
   static names(): { [key: string]: string } {
     return {

package/src/models/ListEvaluationRunsResponseBody.ts

@@ -161,7 +161,7 @@ export class ListEvaluationRunsResponseBody extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The pagination token for the next page. An empty value indicates that no more pages exist.
+   * The pagination token for the next page. An empty value indicates that no more pages are available.
    * 
    * @example
    * eyJsYXN0SWQiOjEyMH0=

package/src/models/ListEvaluationTasksResponseBody.ts

@@ -30,10 +30,10 @@ export class ListEvaluationTasksResponseBodyEvaluationTasks extends $dara.Model
   dataType?: string;
   /**
    * @remarks
-   * The evaluation task description.
+   * The description of the evaluation task.
    * 
    * @example
-   * 评估线上 Agent 链路任务完成度
+   * Evaluate the task completion of the online Agent trace
    */
   description?: string;
   /**
@@ -187,7 +187,7 @@ export class ListEvaluationTasksResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The total number of records. The total count is returned only on the first page. This value may be empty on subsequent pages.
+   * The total number of records. The total count is calculated only on the first page. This value may be empty on subsequent pages.
    * 
    * @example
    * 126

package/src/models/ListEvaluatorSkillsResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListEvaluatorSkillsResponseBodySkills extends $dara.Model {
   /**
    * @remarks
-   * The creation time. This field is declared as int64 in CloudSpec, but the backend currently returns the StarOps `createTime` string field.
+   * The creation time. Declared as int64 in CloudSpec. The backend currently returns the StarOps `createTime` string field.
    * 
    * @example
    * 1782816000
@@ -16,7 +16,7 @@ export class ListEvaluatorSkillsResponseBodySkills extends $dara.Model {
    * The skill description.
    * 
    * @example
-   * 读取链路上下文辅助评估
+   * Reads trace context to assist evaluation
    */
   description?: string;
   /**
@@ -24,7 +24,7 @@ export class ListEvaluatorSkillsResponseBodySkills extends $dara.Model {
    * The display name.
    * 
    * @example
-   * Trace 上下文读取
+   * Trace Context Loader
    */
   displayName?: string;
   /**
@@ -53,7 +53,7 @@ export class ListEvaluatorSkillsResponseBodySkills extends $dara.Model {
   skillName?: string;
   /**
    * @remarks
-   * The update time. This field is declared as int64 in CloudSpec, but the backend currently returns the StarOps `updateTime` string field.
+   * The update time. Declared as int64 in CloudSpec. The backend currently returns the StarOps `updateTime` string field.
    * 
    * @example
    * 1782816600
@@ -122,7 +122,7 @@ export class ListEvaluatorSkillsResponseBody extends $dara.Model {
    * The list of skill summaries.
    * 
    * @example
-   * [{"skillName":"trace_context_loader","displayName":"Trace 上下文读取","enable":true}]
+   * [{"skillName":"trace_context_loader","displayName":"Trace Context Loader","enable":true}]
    */
   skills?: ListEvaluatorSkillsResponseBodySkills[];
   /**