@alicloud/agentloop20260520 2.4.5 → 2.5.0

package/src/client.ts

@@ -367,6 +367,61 @@ export default class Client extends OpenApi {
     return await this.createDatasetWithOptions(agentSpace, request, headers, runtime);
   }
 
+  /**
+   * Creates a named historical version for a dataset in a specified agent workspace to preserve the historical state of the dataset. You can call ListDatasetVersions to query version information. If a version is no longer needed, you can call DeleteDatasetVersion to delete the version.
+   * 
+   * @param request - CreateDatasetVersionRequest
+   * @param headers - map
+   * @param runtime - runtime options for this request RuntimeOptions
+   * @returns CreateDatasetVersionResponse
+   */
+  async createDatasetVersionWithOptions(agentSpace: string, datasetName: string, request: $_model.CreateDatasetVersionRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.CreateDatasetVersionResponse> {
+    request.validate();
+    let query : {[key: string ]: any} = { };
+    if (!$dara.isNull(request.clientToken)) {
+      query["clientToken"] = request.clientToken;
+    }
+
+    let body : {[key: string ]: any} = { };
+    if (!$dara.isNull(request.description)) {
+      body["description"] = request.description;
+    }
+
+    if (!$dara.isNull(request.version)) {
+      body["version"] = request.version;
+    }
+
+    let req = new $OpenApiUtil.OpenApiRequest({
+      headers: headers,
+      query: OpenApiUtil.query(query),
+      body: OpenApiUtil.parseToMap(body),
+    });
+    let params = new $OpenApiUtil.Params({
+      action: "CreateDatasetVersion",
+      version: "2026-05-20",
+      protocol: "HTTPS",
+      pathname: `/agentspace/${$dara.URL.percentEncode(agentSpace)}/dataset/${$dara.URL.percentEncode(datasetName)}/version`,
+      method: "POST",
+      authType: "AK",
+      style: "ROA",
+      reqBodyType: "json",
+      bodyType: "json",
+    });
+    return $dara.cast<$_model.CreateDatasetVersionResponse>(await this.callApi(params, req, runtime), new $_model.CreateDatasetVersionResponse({}));
+  }
+
+  /**
+   * Creates a named historical version for a dataset in a specified agent workspace to preserve the historical state of the dataset. You can call ListDatasetVersions to query version information. If a version is no longer needed, you can call DeleteDatasetVersion to delete the version.
+   * 
+   * @param request - CreateDatasetVersionRequest
+   * @returns CreateDatasetVersionResponse
+   */
+  async createDatasetVersion(agentSpace: string, datasetName: string, request: $_model.CreateDatasetVersionRequest): Promise<$_model.CreateDatasetVersionResponse> {
+    let runtime = new $dara.RuntimeOptions({ });
+    let headers : {[key: string ]: string} = { };
+    return await this.createDatasetVersionWithOptions(agentSpace, datasetName, request, headers, runtime);
+  }
+
   /**
    * Creates an evaluation task.
    * 
@@ -1161,6 +1216,45 @@ export default class Client extends OpenApi {
     return await this.deleteDatasetWithOptions(agentSpace, datasetName, request, headers, runtime);
   }
 
+  /**
+   * Deletes a historical version of a dataset in a specified agent workspace. After deletion, the version no longer appears in the list returned by ListDatasetVersions. This operation does not delete the dataset itself, the current data, or other historical versions.
+   * 
+   * @param request - DeleteDatasetVersionRequest
+   * @param headers - map
+   * @param runtime - runtime options for this request RuntimeOptions
+   * @returns DeleteDatasetVersionResponse
+   */
+  async deleteDatasetVersionWithOptions(agentSpace: string, datasetName: string, version: string, request: $_model.DeleteDatasetVersionRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.DeleteDatasetVersionResponse> {
+    request.validate();
+    let req = new $OpenApiUtil.OpenApiRequest({
+      headers: headers,
+    });
+    let params = new $OpenApiUtil.Params({
+      action: "DeleteDatasetVersion",
+      version: "2026-05-20",
+      protocol: "HTTPS",
+      pathname: `/agentspace/${$dara.URL.percentEncode(agentSpace)}/dataset/${$dara.URL.percentEncode(datasetName)}/version/${$dara.URL.percentEncode(version)}`,
+      method: "DELETE",
+      authType: "AK",
+      style: "ROA",
+      reqBodyType: "json",
+      bodyType: "json",
+    });
+    return $dara.cast<$_model.DeleteDatasetVersionResponse>(await this.callApi(params, req, runtime), new $_model.DeleteDatasetVersionResponse({}));
+  }
+
+  /**
+   * Deletes a historical version of a dataset in a specified agent workspace. After deletion, the version no longer appears in the list returned by ListDatasetVersions. This operation does not delete the dataset itself, the current data, or other historical versions.
+   * 
+   * @param request - DeleteDatasetVersionRequest
+   * @returns DeleteDatasetVersionResponse
+   */
+  async deleteDatasetVersion(agentSpace: string, datasetName: string, version: string, request: $_model.DeleteDatasetVersionRequest): Promise<$_model.DeleteDatasetVersionResponse> {
+    let runtime = new $dara.RuntimeOptions({ });
+    let headers : {[key: string ]: string} = { };
+    return await this.deleteDatasetVersionWithOptions(agentSpace, datasetName, version, request, headers, runtime);
+  }
+
   /**
    * Deletes an evaluation run.
    * 
@@ -2280,13 +2374,19 @@ export default class Client extends OpenApi {
    * @remarks
    * Supports filtering by region.
    * 
-   * @param request - ListAgentSpacesRequest
+   * @param tmpReq - ListAgentSpacesRequest
    * @param headers - map
    * @param runtime - runtime options for this request RuntimeOptions
    * @returns ListAgentSpacesResponse
    */
-  async listAgentSpacesWithOptions(request: $_model.ListAgentSpacesRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.ListAgentSpacesResponse> {
-    request.validate();
+  async listAgentSpacesWithOptions(tmpReq: $_model.ListAgentSpacesRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.ListAgentSpacesResponse> {
+    tmpReq.validate();
+    let request = new $_model.ListAgentSpacesShrinkRequest({ });
+    OpenApiUtil.convert(tmpReq, request);
+    if (!$dara.isNull(tmpReq.tag)) {
+      request.tagShrink = OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.tag, "tag", "json");
+    }
+
     let query : {[key: string ]: any} = { };
     if (!$dara.isNull(request.agentSpace)) {
       query["agentSpace"] = request.agentSpace;
@@ -2304,6 +2404,10 @@ export default class Client extends OpenApi {
       query["regionId"] = request.regionId;
     }
 
+    if (!$dara.isNull(request.tagShrink)) {
+      query["tag"] = request.tagShrink;
+    }
+
     let req = new $OpenApiUtil.OpenApiRequest({
       headers: headers,
       query: OpenApiUtil.query(query),
@@ -2447,6 +2551,55 @@ export default class Client extends OpenApi {
     return await this.listContextStoresWithOptions(agentSpace, request, headers, runtime);
   }
 
+  /**
+   * Performs a paged query to retrieve the historical versions of a dataset in a specified agent workspace and returns the version names, descriptions, and creation time. Deleted versions are not included in the list. Do not specify nextToken in the first request. For subsequent requests, use the nextToken value from the previous response for paging to retrieve the next page.
+   * 
+   * @param request - ListDatasetVersionsRequest
+   * @param headers - map
+   * @param runtime - runtime options for this request RuntimeOptions
+   * @returns ListDatasetVersionsResponse
+   */
+  async listDatasetVersionsWithOptions(agentSpace: string, datasetName: string, request: $_model.ListDatasetVersionsRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.ListDatasetVersionsResponse> {
+    request.validate();
+    let query : {[key: string ]: any} = { };
+    if (!$dara.isNull(request.maxResults)) {
+      query["maxResults"] = request.maxResults;
+    }
+
+    if (!$dara.isNull(request.nextToken)) {
+      query["nextToken"] = request.nextToken;
+    }
+
+    let req = new $OpenApiUtil.OpenApiRequest({
+      headers: headers,
+      query: OpenApiUtil.query(query),
+    });
+    let params = new $OpenApiUtil.Params({
+      action: "ListDatasetVersions",
+      version: "2026-05-20",
+      protocol: "HTTPS",
+      pathname: `/agentspace/${$dara.URL.percentEncode(agentSpace)}/dataset/${$dara.URL.percentEncode(datasetName)}/version`,
+      method: "GET",
+      authType: "AK",
+      style: "ROA",
+      reqBodyType: "json",
+      bodyType: "json",
+    });
+    return $dara.cast<$_model.ListDatasetVersionsResponse>(await this.callApi(params, req, runtime), new $_model.ListDatasetVersionsResponse({}));
+  }
+
+  /**
+   * Performs a paged query to retrieve the historical versions of a dataset in a specified agent workspace and returns the version names, descriptions, and creation time. Deleted versions are not included in the list. Do not specify nextToken in the first request. For subsequent requests, use the nextToken value from the previous response for paging to retrieve the next page.
+   * 
+   * @param request - ListDatasetVersionsRequest
+   * @returns ListDatasetVersionsResponse
+   */
+  async listDatasetVersions(agentSpace: string, datasetName: string, request: $_model.ListDatasetVersionsRequest): Promise<$_model.ListDatasetVersionsResponse> {
+    let runtime = new $dara.RuntimeOptions({ });
+    let headers : {[key: string ]: string} = { };
+    return await this.listDatasetVersionsWithOptions(agentSpace, datasetName, request, headers, runtime);
+  }
+
   /**
    * Queries a list of datasets.
    * 

package/src/models/CreateDatasetVersionRequest.ts

@@ -0,0 +1,56 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class CreateDatasetVersionRequest extends $dara.Model {
+  /**
+   * @remarks
+   * The description of the version. This parameter is optional. If this parameter is not specified, an empty string is used.
+   * 
+   * @example
+   * Dataset version used for the first evaluation
+   */
+  description?: string;
+  /**
+   * @remarks
+   * The name of the version to be created, which is used to identify the version within the current dataset. The name cannot be empty after leading and trailing whitespaces are removed. The length of the UTF-8 encoded name cannot exceed 128 bytes, and the name cannot contain forward slashes (/).
+   * 
+   * This parameter is required.
+   * 
+   * @example
+   * v1
+   */
+  version?: string;
+  /**
+   * @remarks
+   * The optional client token that is generated and passed by the client. Do not use this token to determine whether the version is created. You can call ListDatasetVersions to query the version.
+   * 
+   * @example
+   * a1b2c3d4-1234-5678-90ab-cdef12345678
+   */
+  clientToken?: string;
+  static names(): { [key: string]: string } {
+    return {
+      description: 'description',
+      version: 'version',
+      clientToken: 'clientToken',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      description: 'string',
+      version: 'string',
+      clientToken: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/CreateDatasetVersionResponse.ts

@@ -0,0 +1,40 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+import { CreateDatasetVersionResponseBody } from "./CreateDatasetVersionResponseBody";
+
+
+export class CreateDatasetVersionResponse extends $dara.Model {
+  headers?: { [key: string]: string };
+  statusCode?: number;
+  body?: CreateDatasetVersionResponseBody;
+  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: CreateDatasetVersionResponseBody,
+    };
+  }
+
+  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/CreateDatasetVersionResponseBody.ts

@@ -0,0 +1,34 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class CreateDatasetVersionResponseBody extends $dara.Model {
+  /**
+   * @remarks
+   * The unique identifier of the request, which is used to locate and troubleshoot issues.
+   * 
+   * @example
+   * D17DE39E-6C62-50E3-9EB7-FDE41BB0D43D
+   */
+  requestId?: string;
+  static names(): { [key: string]: string } {
+    return {
+      requestId: 'requestId',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      requestId: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/DeleteDatasetVersionRequest.ts

@@ -0,0 +1,24 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class DeleteDatasetVersionRequest extends $dara.Model {
+  static names(): { [key: string]: string } {
+    return {
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/DeleteDatasetVersionResponse.ts

@@ -0,0 +1,40 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+import { DeleteDatasetVersionResponseBody } from "./DeleteDatasetVersionResponseBody";
+
+
+export class DeleteDatasetVersionResponse extends $dara.Model {
+  headers?: { [key: string]: string };
+  statusCode?: number;
+  body?: DeleteDatasetVersionResponseBody;
+  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: DeleteDatasetVersionResponseBody,
+    };
+  }
+
+  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/DeleteDatasetVersionResponseBody.ts

@@ -0,0 +1,34 @@
+// This file is auto-generated, don't edit it
+import * as $dara from '@darabonba/typescript';
+
+
+export class DeleteDatasetVersionResponseBody extends $dara.Model {
+  /**
+   * @remarks
+   * The unique identifier of the request, which is used to locate and troubleshoot issues.
+   * 
+   * @example
+   * D17DE39E-6C62-50E3-9EB7-FDE41BB0D43D
+   */
+  requestId?: string;
+  static names(): { [key: string]: string } {
+    return {
+      requestId: 'requestId',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      requestId: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+

package/src/models/GetAgentSpaceResponseBody.ts

@@ -52,6 +52,40 @@ export class GetAgentSpaceResponseBodyMseNamespace extends $dara.Model {
   }
 }
 
+export class GetAgentSpaceResponseBodyTags extends $dara.Model {
+  /**
+   * @example
+   * env
+   */
+  key?: string;
+  /**
+   * @example
+   * test
+   */
+  value?: string;
+  static names(): { [key: string]: string } {
+    return {
+      key: 'key',
+      value: 'value',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      key: 'string',
+      value: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class GetAgentSpaceResponseBody extends $dara.Model {
   /**
    * @remarks
@@ -124,6 +158,11 @@ export class GetAgentSpaceResponseBody extends $dara.Model {
    * default-cms-1837787111545040-cn-beijing
    */
   slsProject?: string;
+  /**
+   * @example
+   * [{\\"key\\": \\"env\\", \\"value\\": \\"test\\"}]
+   */
+  tags?: GetAgentSpaceResponseBodyTags[];
   /**
    * @remarks
    * The update time.
@@ -145,6 +184,7 @@ export class GetAgentSpaceResponseBody extends $dara.Model {
       regionId: 'regionId',
       requestId: 'requestId',
       slsProject: 'slsProject',
+      tags: 'tags',
       updateTime: 'updateTime',
     };
   }
@@ -160,6 +200,7 @@ export class GetAgentSpaceResponseBody extends $dara.Model {
       regionId: 'string',
       requestId: 'string',
       slsProject: 'string',
+      tags: { 'type': 'array', 'itemType': GetAgentSpaceResponseBodyTags },
       updateTime: 'string',
     };
   }
@@ -168,6 +209,9 @@ export class GetAgentSpaceResponseBody extends $dara.Model {
     if(this.mseNamespace && typeof (this.mseNamespace as any).validate === 'function') {
       (this.mseNamespace as any).validate();
     }
+    if(Array.isArray(this.tags)) {
+      $dara.Model.validateArray(this.tags);
+    }
     super.validate();
   }
 

package/src/models/ListAgentSpacesRequest.ts

@@ -2,6 +2,46 @@
 import * as $dara from '@darabonba/typescript';
 
 
+export class ListAgentSpacesRequestTag extends $dara.Model {
+  /**
+   * @remarks
+   * The tag key.
+   * 
+   * @example
+   * env
+   */
+  key?: string;
+  /**
+   * @remarks
+   * The tag value.
+   * 
+   * @example
+   * test
+   */
+  value?: string;
+  static names(): { [key: string]: string } {
+    return {
+      key: 'key',
+      value: 'value',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      key: 'string',
+      value: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class ListAgentSpacesRequest extends $dara.Model {
   /**
    * @remarks
@@ -35,12 +75,21 @@ export class ListAgentSpacesRequest extends $dara.Model {
    * cn-hangzhou
    */
   regionId?: string;
+  /**
+   * @remarks
+   * Filters only active AgentSpaces in the current region. Multiple conditions use the AND operator, and keys must be unique. Omitting the value matches the existence of the key, and an empty character string is an exact match for an empty value. An empty array is equivalent to not using label filtering and retains the original cross-region resources.
+   * 
+   * @example
+   * [{\\"key\\": \\"env\\", \\"value\\": \\"test\\"}]
+   */
+  tag?: ListAgentSpacesRequestTag[];
   static names(): { [key: string]: string } {
     return {
       agentSpace: 'agentSpace',
       maxResults: 'maxResults',
       nextToken: 'nextToken',
       regionId: 'regionId',
+      tag: 'tag',
     };
   }
 
@@ -50,10 +99,14 @@ export class ListAgentSpacesRequest extends $dara.Model {
       maxResults: 'number',
       nextToken: 'string',
       regionId: 'string',
+      tag: { 'type': 'array', 'itemType': ListAgentSpacesRequestTag },
     };
   }
 
   validate() {
+    if(Array.isArray(this.tag)) {
+      $dara.Model.validateArray(this.tag);
+    }
     super.validate();
   }