@alicloud/agentloop20260520 2.4.3 → 2.4.5

package/src/models/GetDatasetRequest.ts

@@ -3,13 +3,23 @@ import * as $dara from '@darabonba/typescript';
 
 
 export class GetDatasetRequest extends $dara.Model {
+  /**
+   * @remarks
+   * The version number.
+   * 
+   * @example
+   * 1.0.0
+   */
+  version?: string;
   static names(): { [key: string]: string } {
     return {
+      version: 'version',
     };
   }
 
   static types(): { [key: string]: any } {
     return {
+      version: 'string',
     };
   }
 

package/src/models/GetDatasetResponseBody.ts

@@ -6,7 +6,7 @@ import { IndexKey } from "./IndexKey";
 export class GetDatasetResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The name of the agent space.
+   * The name of the agent workspace.
    * 
    * @example
    * sop-agent

package/src/models/GetExperimentPlanResponseBody.ts

@@ -7,7 +7,7 @@ import { ExperimentConfig } from "./ExperimentConfig";
 export class GetExperimentPlanResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The creation time. The value is a millisecond-level UNIX timestamp.
+   * The creation time. The value is a UNIX timestamp in milliseconds.
    * 
    * @example
    * 1782816000000
@@ -15,7 +15,7 @@ export class GetExperimentPlanResponseBody extends $dara.Model {
   createdAt?: number;
   /**
    * @remarks
-   * The associated dataset ID.
+   * The ID of the associated dataset.
    * 
    * @example
    * arms_customer_agent_level1
@@ -26,7 +26,7 @@ export class GetExperimentPlanResponseBody extends $dara.Model {
    * The description.
    * 
    * @example
-   * Compare checkout Agent baseline with optimized version
+   * Compare the checkout agent baseline with the optimized version
    */
   description?: string;
   /**
@@ -39,7 +39,7 @@ export class GetExperimentPlanResponseBody extends $dara.Model {
   evaluators?: Evaluator[];
   /**
    * @remarks
-   * The experiment type.
+   * The type of the experiment.
    * 
    * @example
    * online
@@ -58,17 +58,17 @@ export class GetExperimentPlanResponseBody extends $dara.Model {
    * Optional.
    * 
    * @example
-   * {"question": "How do I request a refund?"}
+   * {"question": "How do I get a refund?"}
    */
   input?: { [key: string]: any };
   /**
    * @remarks
-   * The name of the associated data processing pipeline. This value is empty if no pipeline is associated.
+   * The name of the associated data processing pipeline. This field is empty if no pipeline is associated.
    */
   pipelineName?: string;
   /**
    * @remarks
-   * The experiment plan ID.
+   * The ID of the experiment plan.
    * 
    * @example
    * exp-plan-0242d983f5d340fd8479cf2c19eb279e
@@ -76,7 +76,7 @@ export class GetExperimentPlanResponseBody extends $dara.Model {
   planId?: string;
   /**
    * @remarks
-   * The experiment plan name.
+   * The name of the experiment plan.
    * 
    * @example
    * arms_agent_experiment
@@ -108,7 +108,7 @@ export class GetExperimentPlanResponseBody extends $dara.Model {
   selectedItemIds?: string[];
   /**
    * @remarks
-   * The plan status.
+   * The status of the plan.
    * 
    * @example
    * stopped
@@ -116,7 +116,7 @@ export class GetExperimentPlanResponseBody extends $dara.Model {
   status?: string;
   /**
    * @remarks
-   * The update time. The value is a millisecond-level UNIX timestamp.
+   * The update time. The value is a UNIX timestamp in milliseconds.
    * 
    * @example
    * 1782816600000

package/src/models/GetExperimentRunResponseBody.ts

@@ -6,7 +6,7 @@ import { ExperimentRecord } from "./ExperimentRecord";
 export class GetExperimentRunResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The experiment run record details. Fields with null values are not returned.
+   * The details of the experiment run. Fields with null values are not returned.
    * 
    * @example
    * {"recordId": "exp-run-f6d419b0ed3d43a7b585948a55efc07b", "experimentPlanId": "exp-plan-0242d983f5d340fd8479cf2c19eb279e", "recordName": "arms_agent_experiment 2026/07/22 20:02:55", "planName": "arms_agent_experiment", "status": "evaluating", "totalTasks": 40, "completedTasks": 40, "failedTasks": 0, "progress": 100.0, "executedAt": 1784721775379, "completedAt": 1784721811392, "dataSourceType": "dataset-full", "datasetId": "arms_customer_agent_level1", "modelNames": ["qwen3.7-plus", "qwen3.7-max"], "evaluationTaskId": "eval-task-6bec93bfa03740dd86ce2bf1496e65fb"}

package/src/models/ListAgentSpacesRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListAgentSpacesRequest extends $dara.Model {
   /**
    * @remarks
-   * The AgentSpace name.
+   * The name of the AgentSpace.
    * 
    * @example
    * test-agent-space
@@ -13,7 +13,7 @@ export class ListAgentSpacesRequest extends $dara.Model {
   agentSpace?: string;
   /**
    * @remarks
-   * The maximum number of results to return.
+   * The maximum number of results.
    * 
    * @example
    * 50

package/src/models/ListAgentSpacesResponseBody.ts

@@ -3,10 +3,17 @@ import * as $dara from '@darabonba/typescript';
 
 
 export class ListAgentSpacesResponseBodyAgentSpacesMseNamespace extends $dara.Model {
+  /**
+   * @remarks
+   * The attach method of the MSE namespace. AutoCreated indicates automatic creation by AgentLoop. UserSelected indicates that an existing namespace is selected and attached when the AgentSpace is created.
+   * 
+   * @example
+   * AutoCreated
+   */
   bindType?: string;
   /**
    * @remarks
-   * The MSE namespace ID.
+   * The ID of the MSE namespace.
    * 
    * @example
    * phoenixcloud-raw-logs
@@ -14,7 +21,7 @@ export class ListAgentSpacesResponseBodyAgentSpacesMseNamespace extends $dara.Mo
   namespaceId?: string;
   /**
    * @remarks
-   * The MSE namespace name.
+   * The name of the MSE namespace.
    * 
    * @example
    * terraform-alicloud-modules
@@ -48,7 +55,7 @@ export class ListAgentSpacesResponseBodyAgentSpacesMseNamespace extends $dara.Mo
 export class ListAgentSpacesResponseBodyAgentSpaces extends $dara.Model {
   /**
    * @remarks
-   * The AgentSpace name.
+   * The name of the AgentSpace.
    * 
    * @example
    * test-agent-space
@@ -95,7 +102,7 @@ export class ListAgentSpacesResponseBodyAgentSpaces extends $dara.Model {
   regionId?: string;
   /**
    * @remarks
-   * The Simple Log Service project name.
+   * The name of the Simple Log Service project.
    * 
    * @example
    * default-cms-1152309027070167-cn-beijing
@@ -152,12 +159,12 @@ export class ListAgentSpacesResponseBodyAgentSpaces extends $dara.Model {
 export class ListAgentSpacesResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The AgentSpaces information.
+   * The information about the AgentSpaces.
    */
   agentSpaces?: ListAgentSpacesResponseBodyAgentSpaces[];
   /**
    * @remarks
-   * The maximum number of results returned.
+   * The maximum number of returned results.
    * 
    * @example
    * 100
@@ -165,7 +172,7 @@ export class ListAgentSpacesResponseBody extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The pagination token. This parameter is empty if no more pages are available.
+   * The pagination token. This parameter is empty if no next page is available.
    * 
    * @example
    * b5754ef15c784abc8696d82790d2985c
@@ -181,7 +188,7 @@ export class ListAgentSpacesResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * The total number of entries.
+   * The total count.
    * 
    * @example
    * 13

package/src/models/ListExperimentRunsRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListExperimentRunsRequest extends $dara.Model {
   /**
    * @remarks
-   * Filters results by exact dataset ID.
+   * Filters the results by exact dataset ID.
    * 
    * @example
    * arms_customer_agent_level1
@@ -13,7 +13,7 @@ export class ListExperimentRunsRequest extends $dara.Model {
   datasetId?: string;
   /**
    * @remarks
-   * Filters results by fuzzy match on the experiment configuration name.
+   * Filters the results by using a fuzzy match on the name in the experiment configuration.
    * 
    * @example
    * experimentA
@@ -21,7 +21,7 @@ export class ListExperimentRunsRequest extends $dara.Model {
   experimentName?: string;
   /**
    * @remarks
-   * Optional. Use `page` and `pageSize` for pagination instead.
+   * Optional. For pagination, use page and pageSize.
    * 
    * @example
    * 20
@@ -29,7 +29,7 @@ export class ListExperimentRunsRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * Optional. Use `page` and `pageSize` for pagination instead.
+   * Optional. For pagination, use page and pageSize.
    * 
    * @example
    * eyJwYWdlIjoxfQ==
@@ -53,7 +53,7 @@ export class ListExperimentRunsRequest extends $dara.Model {
   pageSize?: number;
   /**
    * @remarks
-   * Filters results by fuzzy match on the experiment plan name.
+   * Filters the results by using a fuzzy match on the experiment plan name.
    * 
    * @example
    * arms_agent_experiment
@@ -61,7 +61,7 @@ export class ListExperimentRunsRequest extends $dara.Model {
   planName?: string;
   /**
    * @remarks
-   * Filters results by status.
+   * Filters the results by status.
    * 
    * @example
    * evaluating

package/src/models/ListExperimentRunsResponseBody.ts

@@ -6,7 +6,7 @@ import { ExperimentRecord } from "./ExperimentRecord";
 export class ListExperimentRunsResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The maximum number of entries returned.
+   * The maximum number of returned entries.
    * 
    * @example
    * 20
@@ -38,7 +38,7 @@ export class ListExperimentRunsResponseBody extends $dara.Model {
   pageSize?: number;
   /**
    * @remarks
-   * The list of experiment run records.
+   * The list of experiment runs.
    * 
    * @example
    * [{"recordId": "exp-run-f6d419b0ed3d43a7b585948a55efc07b", "experimentPlanId": "exp-plan-0242d983f5d340fd8479cf2c19eb279e", "recordName": "arms_agent_experiment 2026/07/22 20:02:55", "planName": "arms_agent_experiment", "status": "evaluating", "progress": 100.0, "totalTasks": 40, "completedTasks": 40, "failedTasks": 0, "dataSourceType": "dataset-full", "datasetId": "arms_customer_agent_level1", "modelNames": ["qwen3.7-plus", "qwen3.7-max"], "evaluationTaskId": "eval-task-6bec93bfa03740dd86ce2bf1496e65fb", "executedAt": 1784721775379, "completedAt": 1784721811392}, {"recordId": "a5397261-6e6d-4e45-bf52-feb8686f7524", "experimentPlanId": "exp-plan-e95bff54685a4ae29ff3a834c1008a71", "recordName": "rca_benchmark_eval_experiment 2026/07/22 19:23:59", "planName": "rca_benchmark_eval_experiment", "status": "completed", "progress": 100.0, "totalTasks": 20, "completedTasks": 20, "failedTasks": 0, "dataSourceType": "dataset-full", "datasetId": "rca_benckmark_eval", "modelNames": [], "evaluationTaskId": "eval-task-b1395b3bdf3e4dc994d7dcde7a66da45", "executedAt": 1784719439255, "completedAt": 1784719989371}]

package/src/models/ModelParameters.ts

@@ -2,15 +2,140 @@
 import * as $dara from '@darabonba/typescript';
 
 
+export class ModelParametersResponseFormatJsonSchema extends $dara.Model {
+  /**
+   * @remarks
+   * The schema name.
+   * 
+   * @example
+   * answer
+   */
+  name?: string;
+  /**
+   * @remarks
+   * The JSON Schema definition, which is a serialized string of a JSON object.
+   * 
+   * @example
+   * {"type":"object","properties":{"answer":{"type":"string"}},"required":["answer"]}
+   */
+  schema?: string;
+  /**
+   * @remarks
+   * Specifies whether to strictly adhere to the schema structure. Set this to true.
+   * 
+   * @example
+   * true
+   */
+  strict?: boolean;
+  static names(): { [key: string]: string } {
+    return {
+      name: 'name',
+      schema: 'schema',
+      strict: 'strict',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      name: 'string',
+      schema: 'string',
+      strict: 'boolean',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class ModelParametersResponseFormat extends $dara.Model {
+  /**
+   * @remarks
+   * The JSON Schema constraint, which is required when the type is json_schema.
+   * 
+   * @example
+   * {"name":"answer","strict":true,"schema":"{\\"type\\":\\"object\\",\\"properties\\":{\\"answer\\":{\\"type\\":\\"string\\"}},\\"required\\":[\\"answer\\"]}"}
+   */
+  jsonSchema?: ModelParametersResponseFormatJsonSchema;
+  /**
+   * @remarks
+   * The format type. Valid values: text, json_object, and json_schema. When using json_object, the prompt must explicitly request JSON output.
+   * 
+   * @example
+   * json_object
+   */
+  type?: string;
+  static names(): { [key: string]: string } {
+    return {
+      jsonSchema: 'jsonSchema',
+      type: 'type',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      jsonSchema: ModelParametersResponseFormatJsonSchema,
+      type: 'string',
+    };
+  }
+
+  validate() {
+    if(this.jsonSchema && typeof (this.jsonSchema as any).validate === 'function') {
+      (this.jsonSchema as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class ModelParameters extends $dara.Model {
   /**
    * @remarks
-   * The frequency penalty. Positive values reduce repetition. Valid values: -2.0 to 2.0.
+   * Specifies whether to enable explicit caching for system messages.
+   * 
+   * @example
+   * true
+   */
+  enableCacheControl?: boolean;
+  /**
+   * @remarks
+   * Specifies whether to enable thinking mode. This takes effect only for hybrid thinking models and defaults to false if not specified.
+   * 
+   * @example
+   * true
+   */
+  enableThinking?: boolean;
+  /**
+   * @remarks
+   * The extended parameters, which are a serialized string of a JSON object. These are merged into the top level of the model request body to pass through other Model Studio parameters.
+   * 
+   * @example
+   * {"enable_search":false}
+   */
+  extraBody?: string;
+  /**
+   * @remarks
+   * The frequency penalty where positive values reduce repetition, with a range of -2.0 to 2.0.
    * 
    * @example
    * 0.2
    */
   frequencyPenalty?: number;
+  /**
+   * @remarks
+   * The maximum number of output tokens, including the chain-of-thought and the response. This is recommended for thinking models.
+   * 
+   * @example
+   * 4096
+   */
+  maxCompletionTokens?: number;
   /**
    * @remarks
    * The maximum number of output tokens.
@@ -21,7 +146,7 @@ export class ModelParameters extends $dara.Model {
   maxTokens?: number;
   /**
    * @remarks
-   * The presence penalty. Positive values encourage new topics. Valid values: -2.0 to 2.0.
+   * The presence penalty where positive values encourage new topics, with a range of -2.0 to 2.0.
    * 
    * @example
    * 0.1
@@ -29,7 +154,39 @@ export class ModelParameters extends $dara.Model {
   presencePenalty?: number;
   /**
    * @remarks
-   * The stop sequences. Generation stops immediately when any of these sequences is encountered.
+   * The reasoning effort level. This takes effect only when thinking mode is enabled. For the Qwen3.8 series, valid values are low, medium, and xhigh. This cannot be set simultaneously with thinkingBudget.
+   * 
+   * @example
+   * low
+   */
+  reasoningEffort?: string;
+  /**
+   * @remarks
+   * The repetition penalty that controls the repetition of consecutive sequences. The value must be greater than 0. A value of 1.0 indicates no penalty, and a larger value results in less repetition.
+   * 
+   * @example
+   * 1.05
+   */
+  repetitionPenalty?: number;
+  /**
+   * @remarks
+   * The response content format, which defaults to text if not specified.
+   * 
+   * @example
+   * {"type":"json_schema","jsonSchema":{"name":"answer","strict":true,"schema":"{\\"type\\":\\"object\\",\\"properties\\":{\\"answer\\":{\\"type\\":\\"string\\"}},\\"required\\":[\\"answer\\"]}"}}
+   */
+  responseFormat?: ModelParametersResponseFormat;
+  /**
+   * @remarks
+   * The random seed, with a range of 0 to 2147483647, which attempts to return the same result for the same input and parameters.
+   * 
+   * @example
+   * 1234
+   */
+  seed?: number;
+  /**
+   * @remarks
+   * The stop sequences that immediately halt generation when encountered.
    * 
    * @example
    * ["END"]
@@ -37,7 +194,7 @@ export class ModelParameters extends $dara.Model {
   stopSequences?: string[];
   /**
    * @remarks
-   * The temperature parameter that controls the randomness of the output. Valid values: 0 to 2.
+   * The temperature parameter that controls the randomness of the output, with a range of 0 to 2.
    * 
    * @example
    * 0.7
@@ -45,7 +202,15 @@ export class ModelParameters extends $dara.Model {
   temperature?: number;
   /**
    * @remarks
-   * The top-k sampling parameter. Valid values: 1 to 100.
+   * The maximum number of tokens for the thinking process. This takes effect only when thinking mode is enabled and cannot be set simultaneously with reasoningEffort.
+   * 
+   * @example
+   * 2048
+   */
+  thinkingBudget?: number;
+  /**
+   * @remarks
+   * The Top K sampling parameter, with a range of 1 to 100.
    * 
    * @example
    * 50
@@ -53,7 +218,7 @@ export class ModelParameters extends $dara.Model {
   topK?: number;
   /**
    * @remarks
-   * The top-p sampling parameter. Valid values: 0 to 1.
+   * The Top P sampling parameter, with a range of 0 to 1.
    * 
    * @example
    * 0.9
@@ -61,11 +226,20 @@ export class ModelParameters extends $dara.Model {
   topP?: number;
   static names(): { [key: string]: string } {
     return {
+      enableCacheControl: 'enableCacheControl',
+      enableThinking: 'enableThinking',
+      extraBody: 'extraBody',
       frequencyPenalty: 'frequencyPenalty',
+      maxCompletionTokens: 'maxCompletionTokens',
       maxTokens: 'maxTokens',
       presencePenalty: 'presencePenalty',
+      reasoningEffort: 'reasoningEffort',
+      repetitionPenalty: 'repetitionPenalty',
+      responseFormat: 'responseFormat',
+      seed: 'seed',
       stopSequences: 'stopSequences',
       temperature: 'temperature',
+      thinkingBudget: 'thinkingBudget',
       topK: 'topK',
       topP: 'topP',
     };
@@ -73,17 +247,29 @@ export class ModelParameters extends $dara.Model {
 
   static types(): { [key: string]: any } {
     return {
+      enableCacheControl: 'boolean',
+      enableThinking: 'boolean',
+      extraBody: 'string',
       frequencyPenalty: 'number',
+      maxCompletionTokens: 'number',
       maxTokens: 'number',
       presencePenalty: 'number',
+      reasoningEffort: 'string',
+      repetitionPenalty: 'number',
+      responseFormat: ModelParametersResponseFormat,
+      seed: 'number',
       stopSequences: { 'type': 'array', 'itemType': 'string' },
       temperature: 'number',
+      thinkingBudget: 'number',
       topK: 'number',
       topP: 'number',
     };
   }
 
   validate() {
+    if(this.responseFormat && typeof (this.responseFormat as any).validate === 'function') {
+      (this.responseFormat as any).validate();
+    }
     if(Array.isArray(this.stopSequences)) {
       $dara.Model.validateArray(this.stopSequences);
     }