@alicloud/agentloop20260520 2.4.5 → 2.5.0

package/dist/client.d.ts

@@ -116,6 +116,24 @@ export default class Client extends OpenApi {
      * @returns CreateDatasetResponse
      */
     createDataset(agentSpace: string, request: $_model.CreateDatasetRequest): Promise<$_model.CreateDatasetResponse>;
+    /**
+     * 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
+     */
+    createDatasetVersionWithOptions(agentSpace: string, datasetName: string, request: $_model.CreateDatasetVersionRequest, headers: {
+        [key: string]: string;
+    }, runtime: $dara.RuntimeOptions): Promise<$_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
+     */
+    createDatasetVersion(agentSpace: string, datasetName: string, request: $_model.CreateDatasetVersionRequest): Promise<$_model.CreateDatasetVersionResponse>;
     /**
      * Creates an evaluation task.
      *
@@ -352,6 +370,24 @@ export default class Client extends OpenApi {
      * @returns DeleteDatasetResponse
      */
     deleteDataset(agentSpace: string, datasetName: string, request: $_model.DeleteDatasetRequest): Promise<$_model.DeleteDatasetResponse>;
+    /**
+     * 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
+     */
+    deleteDatasetVersionWithOptions(agentSpace: string, datasetName: string, version: string, request: $_model.DeleteDatasetVersionRequest, headers: {
+        [key: string]: string;
+    }, runtime: $dara.RuntimeOptions): Promise<$_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
+     */
+    deleteDatasetVersion(agentSpace: string, datasetName: string, version: string, request: $_model.DeleteDatasetVersionRequest): Promise<$_model.DeleteDatasetVersionResponse>;
     /**
      * Deletes an evaluation run.
      *
@@ -840,12 +876,12 @@ 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
      */
-    listAgentSpacesWithOptions(request: $_model.ListAgentSpacesRequest, headers: {
+    listAgentSpacesWithOptions(tmpReq: $_model.ListAgentSpacesRequest, headers: {
         [key: string]: string;
     }, runtime: $dara.RuntimeOptions): Promise<$_model.ListAgentSpacesResponse>;
     /**
@@ -894,6 +930,24 @@ export default class Client extends OpenApi {
      * @returns ListContextStoresResponse
      */
     listContextStores(agentSpace: string, request: $_model.ListContextStoresRequest): Promise<$_model.ListContextStoresResponse>;
+    /**
+     * 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
+     */
+    listDatasetVersionsWithOptions(agentSpace: string, datasetName: string, request: $_model.ListDatasetVersionsRequest, headers: {
+        [key: string]: string;
+    }, runtime: $dara.RuntimeOptions): Promise<$_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
+     */
+    listDatasetVersions(agentSpace: string, datasetName: string, request: $_model.ListDatasetVersionsRequest): Promise<$_model.ListDatasetVersionsResponse>;
     /**
      * Queries a list of datasets.
      *

package/dist/client.js

@@ -367,6 +367,56 @@ class Client extends openapi_core_1.default {
         let headers = {};
         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, datasetName, request, headers, runtime) {
+        request.validate();
+        let query = {};
+        if (!$dara.isNull(request.clientToken)) {
+            query["clientToken"] = request.clientToken;
+        }
+        let body = {};
+        if (!$dara.isNull(request.description)) {
+            body["description"] = request.description;
+        }
+        if (!$dara.isNull(request.version)) {
+            body["version"] = request.version;
+        }
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+            query: openapi_core_2.OpenApiUtil.query(query),
+            body: openapi_core_2.OpenApiUtil.parseToMap(body),
+        });
+        let params = new openapi_core_2.$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(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, datasetName, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.createDatasetVersionWithOptions(agentSpace, datasetName, request, headers, runtime);
+    }
     /**
      * Creates an evaluation task.
      *
@@ -1069,6 +1119,43 @@ class Client extends openapi_core_1.default {
         let headers = {};
         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, datasetName, version, request, headers, runtime) {
+        request.validate();
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+        });
+        let params = new openapi_core_2.$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(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, datasetName, version, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.deleteDatasetVersionWithOptions(agentSpace, datasetName, version, request, headers, runtime);
+    }
     /**
      * Deletes an evaluation run.
      *
@@ -2116,13 +2203,18 @@ class Client extends openapi_core_1.default {
      * @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, headers, runtime) {
-        request.validate();
+    async listAgentSpacesWithOptions(tmpReq, headers, runtime) {
+        tmpReq.validate();
+        let request = new $_model.ListAgentSpacesShrinkRequest({});
+        openapi_core_2.OpenApiUtil.convert(tmpReq, request);
+        if (!$dara.isNull(tmpReq.tag)) {
+            request.tagShrink = openapi_core_2.OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.tag, "tag", "json");
+        }
         let query = {};
         if (!$dara.isNull(request.agentSpace)) {
             query["agentSpace"] = request.agentSpace;
@@ -2136,6 +2228,9 @@ class Client extends openapi_core_1.default {
         if (!$dara.isNull(request.regionId)) {
             query["regionId"] = request.regionId;
         }
+        if (!$dara.isNull(request.tagShrink)) {
+            query["tag"] = request.tagShrink;
+        }
         let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
             headers: headers,
             query: openapi_core_2.OpenApiUtil.query(query),
@@ -2266,6 +2361,51 @@ class Client extends openapi_core_1.default {
         let headers = {};
         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, datasetName, request, headers, runtime) {
+        request.validate();
+        let query = {};
+        if (!$dara.isNull(request.maxResults)) {
+            query["maxResults"] = request.maxResults;
+        }
+        if (!$dara.isNull(request.nextToken)) {
+            query["nextToken"] = request.nextToken;
+        }
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+            query: openapi_core_2.OpenApiUtil.query(query),
+        });
+        let params = new openapi_core_2.$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(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, datasetName, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.listDatasetVersionsWithOptions(agentSpace, datasetName, request, headers, runtime);
+    }
     /**
      * Queries a list of datasets.
      *