@alicloud/agentloop20260520 2.4.4 → 2.5.0

package/src/client.ts

@@ -155,6 +155,10 @@ export default class Client extends OpenApi {
       body["mseNamespaceId"] = request.mseNamespaceId;
     }
 
+    if (!$dara.isNull(request.trajectoryEmbeddingEnabled)) {
+      body["trajectoryEmbeddingEnabled"] = request.trajectoryEmbeddingEnabled;
+    }
+
     if (!$dara.isNull(request.trajectoryStoreEnabled)) {
       body["trajectoryStoreEnabled"] = request.trajectoryStoreEnabled;
     }
@@ -191,7 +195,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Creates a context library.
+   * Creates a context store.
    * 
    * @param request - CreateContextStoreRequest
    * @param headers - map
@@ -242,7 +246,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Creates a context library.
+   * Creates a context store.
    * 
    * @param request - CreateContextStoreRequest
    * @returns CreateContextStoreResponse
@@ -363,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.
    * 
@@ -620,7 +679,7 @@ export default class Client extends OpenApi {
    * Creates an experiment plan.
    * 
    * @remarks
-   * Calls CreateExperimentPlan to create an experiment plan under a specified AgentSpace. This operation defines the configuration for an offline or online experiment, including the data source, optional evaluators, and experiment groups required for online experiments. After the plan is created, call CreateExperimentRun to start the execution.
+   * Creates an experiment plan in a specified AgentSpace. You can use this operation to define the configuration for an offline or online experiment, including the data source, optional evaluators, and experiment groups required for online experiments. After the plan is created, call CreateExperimentRun to initiate the execution.
    * 
    * @param request - CreateExperimentPlanRequest
    * @param headers - map
@@ -692,7 +751,7 @@ export default class Client extends OpenApi {
    * Creates an experiment plan.
    * 
    * @remarks
-   * Calls CreateExperimentPlan to create an experiment plan under a specified AgentSpace. This operation defines the configuration for an offline or online experiment, including the data source, optional evaluators, and experiment groups required for online experiments. After the plan is created, call CreateExperimentRun to start the execution.
+   * Creates an experiment plan in a specified AgentSpace. You can use this operation to define the configuration for an offline or online experiment, including the data source, optional evaluators, and experiment groups required for online experiments. After the plan is created, call CreateExperimentRun to initiate the execution.
    * 
    * @param request - CreateExperimentPlanRequest
    * @returns CreateExperimentPlanResponse
@@ -1157,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.
    * 
@@ -2017,10 +2115,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the details of an experiment run record.
+   * Queries the details of an experiment run.
    * 
    * @remarks
-   * Calls GetExperimentRun to query the details of a specific experiment run record, including the status, progress, configuration snapshot, and associated evaluation task ID.
+   * Calls the GetExperimentRun operation to query the details of an experiment run, including the status, progress, configuration snapshot, and associated evaluation task ID.
    * 
    * @param request - GetExperimentRunRequest
    * @param headers - map
@@ -2047,10 +2145,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the details of an experiment run record.
+   * Queries the details of an experiment run.
    * 
    * @remarks
-   * Calls GetExperimentRun to query the details of a specific experiment run record, including the status, progress, configuration snapshot, and associated evaluation task ID.
+   * Calls the GetExperimentRun operation to query the details of an experiment run, including the status, progress, configuration snapshot, and associated evaluation task ID.
    * 
    * @param request - GetExperimentRunRequest
    * @returns GetExperimentRunResponse
@@ -2276,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;
@@ -2300,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),
@@ -2443,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.
    * 
@@ -2826,10 +2983,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries a list of experiment run records.
+   * Queries a list of experiment runs.
    * 
    * @remarks
-   * Calls ListExperimentRuns to query experiment run records under a specified AgentSpace for the current account. You can filter results by status, dataset, plan name, or experiment name, and use `page`/`pageSize` for pagination.
+   * Calls the ListExperimentRuns operation to query the experiment execution records of the current account in a specified AgentSpace. You can filter records by status, dataset, plan name, and experiment name, and paginate results by using page and pageSize.
    * 
    * @param request - ListExperimentRunsRequest
    * @param headers - map
@@ -2890,10 +3047,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries a list of experiment run records.
+   * Queries a list of experiment runs.
    * 
    * @remarks
-   * Calls ListExperimentRuns to query experiment run records under a specified AgentSpace for the current account. You can filter results by status, dataset, plan name, or experiment name, and use `page`/`pageSize` for pagination.
+   * Calls the ListExperimentRuns operation to query the experiment execution records of the current account in a specified AgentSpace. You can filter records by status, dataset, plan name, and experiment name, and paginate results by using page and pageSize.
    * 
    * @param request - ListExperimentRunsRequest
    * @returns ListExperimentRunsResponse
@@ -3939,7 +4096,7 @@ export default class Client extends OpenApi {
    * Updates an experiment plan.
    * 
    * @remarks
-   * Updates a specified experiment plan. Fields that are not specified remain unchanged. You can only update plans created by the current account.
+   * Updates a specified experiment plan. Unspecified fields remain unchanged. Only plans created by the current account can be updated.
    * 
    * @param request - UpdateExperimentPlanRequest
    * @param headers - map
@@ -4015,7 +4172,7 @@ export default class Client extends OpenApi {
    * Updates an experiment plan.
    * 
    * @remarks
-   * Updates a specified experiment plan. Fields that are not specified remain unchanged. You can only update plans created by the current account.
+   * Updates a specified experiment plan. Unspecified fields remain unchanged. Only plans created by the current account can be updated.
    * 
    * @param request - UpdateExperimentPlanRequest
    * @returns UpdateExperimentPlanResponse

package/src/models/CreateAgentSpaceRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CreateAgentSpaceRequest extends $dara.Model {
   /**
    * @remarks
-   * The AgentSpace name.
+   * The name of the AgentSpace.
    * 
    * This parameter is required.
    * 
@@ -39,12 +39,20 @@ export class CreateAgentSpaceRequest extends $dara.Model {
   mseNamespaceId?: string;
   /**
    * @remarks
-   * Specifies whether to enable trajectory cleaning.
+   * Specifies whether vector indexing is enabled.
+   * 
+   * @example
+   * true
+   */
+  trajectoryEmbeddingEnabled?: boolean;
+  /**
+   * @remarks
+   * Specifies whether trajectory cleaning is enabled.
    */
   trajectoryStoreEnabled?: boolean;
   /**
    * @remarks
-   * The idempotency token. A unique string generated by the client to ensure the idempotence of the create operation.
+   * The client token that is used to ensure the idempotence of the create operation. It is a unique string generated by the client.
    * 
    * @example
    * a1b2c3d4-1234-5678-90ab-cdef12345678
@@ -56,6 +64,7 @@ export class CreateAgentSpaceRequest extends $dara.Model {
       cmsWorkspace: 'cmsWorkspace',
       description: 'description',
       mseNamespaceId: 'mseNamespaceId',
+      trajectoryEmbeddingEnabled: 'trajectoryEmbeddingEnabled',
       trajectoryStoreEnabled: 'trajectoryStoreEnabled',
       clientToken: 'clientToken',
     };
@@ -67,6 +76,7 @@ export class CreateAgentSpaceRequest extends $dara.Model {
       cmsWorkspace: 'string',
       description: 'string',
       mseNamespaceId: 'string',
+      trajectoryEmbeddingEnabled: 'boolean',
       trajectoryStoreEnabled: 'boolean',
       clientToken: 'string',
     };