@alicloud/agentloop20260520 2.2.1 → 2.3.1

package/dist/client.js

@@ -586,6 +586,158 @@ class Client extends openapi_core_1.default {
         let headers = {};
         return await this.createEvaluatorSkillWithOptions(name, request, headers, runtime);
     }
+    /**
+     * Creates an experiment plan.
+     *
+     * @remarks
+     * Calls CreateExperimentPlan to create an experiment plan under a specified AgentSpace. Use this operation to define the configuration of 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.
+     *
+     * @param request - CreateExperimentPlanRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns CreateExperimentPlanResponse
+     */
+    async createExperimentPlanWithOptions(agentSpace, request, headers, runtime) {
+        request.validate();
+        let body = {};
+        if (!$dara.isNull(request.datasetId)) {
+            body["datasetId"] = request.datasetId;
+        }
+        if (!$dara.isNull(request.description)) {
+            body["description"] = request.description;
+        }
+        if (!$dara.isNull(request.evaluators)) {
+            body["evaluators"] = request.evaluators;
+        }
+        if (!$dara.isNull(request.experimentType)) {
+            body["experimentType"] = request.experimentType;
+        }
+        if (!$dara.isNull(request.experiments)) {
+            body["experiments"] = request.experiments;
+        }
+        if (!$dara.isNull(request.input)) {
+            body["input"] = request.input;
+        }
+        if (!$dara.isNull(request.pipelineName)) {
+            body["pipelineName"] = request.pipelineName;
+        }
+        if (!$dara.isNull(request.planName)) {
+            body["planName"] = request.planName;
+        }
+        if (!$dara.isNull(request.querySql)) {
+            body["querySql"] = request.querySql;
+        }
+        if (!$dara.isNull(request.selectedItemIds)) {
+            body["selectedItemIds"] = request.selectedItemIds;
+        }
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+            body: openapi_core_2.OpenApiUtil.parseToMap(body),
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "CreateExperimentPlan",
+            version: "2026-05-20",
+            protocol: "HTTPS",
+            pathname: `/api/v1/experiments/${$dara.URL.percentEncode(agentSpace)}/plans`,
+            method: "POST",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateExperimentPlanResponse({}));
+    }
+    /**
+     * Creates an experiment plan.
+     *
+     * @remarks
+     * Calls CreateExperimentPlan to create an experiment plan under a specified AgentSpace. Use this operation to define the configuration of 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.
+     *
+     * @param request - CreateExperimentPlanRequest
+     * @returns CreateExperimentPlanResponse
+     */
+    async createExperimentPlan(agentSpace, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.createExperimentPlanWithOptions(agentSpace, request, headers, runtime);
+    }
+    /**
+     * Executes an experiment.
+     *
+     * @remarks
+     * Calls CreateExperimentRun to initiate an experiment execution based on an existing experiment plan. For online experiments, you typically only need to pass `experimentPlanId`. For offline experiments, you need to pass `offlineExperiments` (1 to 5 items).
+     *
+     * @param request - CreateExperimentRunRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns CreateExperimentRunResponse
+     */
+    async createExperimentRunWithOptions(agentSpace, request, headers, runtime) {
+        request.validate();
+        let query = {};
+        if (!$dara.isNull(request.clientToken)) {
+            query["clientToken"] = request.clientToken;
+        }
+        let body = {};
+        if (!$dara.isNull(request.completedAt)) {
+            body["completedAt"] = request.completedAt;
+        }
+        if (!$dara.isNull(request.completedTasks)) {
+            body["completedTasks"] = request.completedTasks;
+        }
+        if (!$dara.isNull(request.executedAt)) {
+            body["executedAt"] = request.executedAt;
+        }
+        if (!$dara.isNull(request.experimentPlanId)) {
+            body["experimentPlanId"] = request.experimentPlanId;
+        }
+        if (!$dara.isNull(request.failedTasks)) {
+            body["failedTasks"] = request.failedTasks;
+        }
+        if (!$dara.isNull(request.offlineExperiments)) {
+            body["offlineExperiments"] = request.offlineExperiments;
+        }
+        if (!$dara.isNull(request.recordName)) {
+            body["recordName"] = request.recordName;
+        }
+        if (!$dara.isNull(request.status)) {
+            body["status"] = request.status;
+        }
+        if (!$dara.isNull(request.totalTasks)) {
+            body["totalTasks"] = request.totalTasks;
+        }
+        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: "CreateExperimentRun",
+            version: "2026-05-20",
+            protocol: "HTTPS",
+            pathname: `/api/v1/experimentruns/${$dara.URL.percentEncode(agentSpace)}/execute`,
+            method: "POST",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateExperimentRunResponse({}));
+    }
+    /**
+     * Executes an experiment.
+     *
+     * @remarks
+     * Calls CreateExperimentRun to initiate an experiment execution based on an existing experiment plan. For online experiments, you typically only need to pass `experimentPlanId`. For offline experiments, you need to pass `offlineExperiments` (1 to 5 items).
+     *
+     * @param request - CreateExperimentRunRequest
+     * @returns CreateExperimentRunResponse
+     */
+    async createExperimentRun(agentSpace, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.createExperimentRunWithOptions(agentSpace, request, headers, runtime);
+    }
     /**
      * Creates a pipeline.
      *
@@ -965,6 +1117,92 @@ class Client extends openapi_core_1.default {
         let headers = {};
         return await this.deleteEvaluatorSkillWithOptions(name, skillName, request, headers, runtime);
     }
+    /**
+     * Deletes an experiment plan.
+     *
+     * @remarks
+     * Calls DeleteExperimentPlan to delete a specified experiment plan. After deletion, no new executions can be initiated based on this plan. Existing experiment records can still be queried.
+     *
+     * @param request - DeleteExperimentPlanRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns DeleteExperimentPlanResponse
+     */
+    async deleteExperimentPlanWithOptions(agentSpace, planId, request, headers, runtime) {
+        request.validate();
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "DeleteExperimentPlan",
+            version: "2026-05-20",
+            protocol: "HTTPS",
+            pathname: `/api/v1/experiments/${$dara.URL.percentEncode(agentSpace)}/plans/${$dara.URL.percentEncode(planId)}`,
+            method: "DELETE",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteExperimentPlanResponse({}));
+    }
+    /**
+     * Deletes an experiment plan.
+     *
+     * @remarks
+     * Calls DeleteExperimentPlan to delete a specified experiment plan. After deletion, no new executions can be initiated based on this plan. Existing experiment records can still be queried.
+     *
+     * @param request - DeleteExperimentPlanRequest
+     * @returns DeleteExperimentPlanResponse
+     */
+    async deleteExperimentPlan(agentSpace, planId, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.deleteExperimentPlanWithOptions(agentSpace, planId, request, headers, runtime);
+    }
+    /**
+     * Deletes an experiment record.
+     *
+     * @remarks
+     * Calls DeleteExperimentRun to delete a specified experiment run record. Deleting the record does not delete the experiment plan to which it belongs.
+     *
+     * @param request - DeleteExperimentRunRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns DeleteExperimentRunResponse
+     */
+    async deleteExperimentRunWithOptions(agentSpace, recordId, request, headers, runtime) {
+        request.validate();
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "DeleteExperimentRun",
+            version: "2026-05-20",
+            protocol: "HTTPS",
+            pathname: `/api/v1/experimentruns/${$dara.URL.percentEncode(agentSpace)}/records/${$dara.URL.percentEncode(recordId)}`,
+            method: "DELETE",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteExperimentRunResponse({}));
+    }
+    /**
+     * Deletes an experiment record.
+     *
+     * @remarks
+     * Calls DeleteExperimentRun to delete a specified experiment run record. Deleting the record does not delete the experiment plan to which it belongs.
+     *
+     * @param request - DeleteExperimentRunRequest
+     * @returns DeleteExperimentRunResponse
+     */
+    async deleteExperimentRun(agentSpace, recordId, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.deleteExperimentRunWithOptions(agentSpace, recordId, request, headers, runtime);
+    }
     /**
      * Deletes a pipeline.
      *
@@ -1422,6 +1660,92 @@ class Client extends openapi_core_1.default {
         let headers = {};
         return await this.getEvaluatorSkillWithOptions(name, skillName, request, headers, runtime);
     }
+    /**
+     * Queries an experiment plan.
+     *
+     * @remarks
+     * Calls GetExperimentPlan to query the complete configuration of a specified experiment plan, including experiment groups, data sources, evaluators, and timestamps.
+     *
+     * @param request - GetExperimentPlanRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns GetExperimentPlanResponse
+     */
+    async getExperimentPlanWithOptions(agentSpace, planId, request, headers, runtime) {
+        request.validate();
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "GetExperimentPlan",
+            version: "2026-05-20",
+            protocol: "HTTPS",
+            pathname: `/api/v1/experiments/${$dara.URL.percentEncode(agentSpace)}/plans/${$dara.URL.percentEncode(planId)}`,
+            method: "GET",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetExperimentPlanResponse({}));
+    }
+    /**
+     * Queries an experiment plan.
+     *
+     * @remarks
+     * Calls GetExperimentPlan to query the complete configuration of a specified experiment plan, including experiment groups, data sources, evaluators, and timestamps.
+     *
+     * @param request - GetExperimentPlanRequest
+     * @returns GetExperimentPlanResponse
+     */
+    async getExperimentPlan(agentSpace, planId, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.getExperimentPlanWithOptions(agentSpace, planId, request, headers, runtime);
+    }
+    /**
+     * Queries the details of an experiment run record.
+     *
+     * @remarks
+     * Calls GetExperimentRun to query the details of a specific experiment run record, including the status, progress, configuration snapshot, and associated evaluation task ID.
+     *
+     * @param request - GetExperimentRunRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns GetExperimentRunResponse
+     */
+    async getExperimentRunWithOptions(agentSpace, recordId, request, headers, runtime) {
+        request.validate();
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "GetExperimentRun",
+            version: "2026-05-20",
+            protocol: "HTTPS",
+            pathname: `/api/v1/experimentruns/${$dara.URL.percentEncode(agentSpace)}/records/${$dara.URL.percentEncode(recordId)}`,
+            method: "GET",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetExperimentRunResponse({}));
+    }
+    /**
+     * Queries the details of an experiment run record.
+     *
+     * @remarks
+     * Calls GetExperimentRun to query the details of a specific experiment run record, including the status, progress, configuration snapshot, and associated evaluation task ID.
+     *
+     * @param request - GetExperimentRunRequest
+     * @returns GetExperimentRunResponse
+     */
+    async getExperimentRun(agentSpace, recordId, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.getExperimentRunWithOptions(agentSpace, recordId, request, headers, runtime);
+    }
     /**
      * Queries a CI/CD pipeline.
      *
@@ -1694,17 +2018,25 @@ class Client extends openapi_core_1.default {
     /**
      * Queries a list of datasets.
      *
-     * @param request - ListDatasetsRequest
+     * @param tmpReq - ListDatasetsRequest
      * @param headers - map
      * @param runtime - runtime options for this request RuntimeOptions
      * @returns ListDatasetsResponse
      */
-    async listDatasetsWithOptions(agentSpace, request, headers, runtime) {
-        request.validate();
+    async listDatasetsWithOptions(agentSpace, tmpReq, headers, runtime) {
+        tmpReq.validate();
+        let request = new $_model.ListDatasetsShrinkRequest({});
+        openapi_core_2.OpenApiUtil.convert(tmpReq, request);
+        if (!$dara.isNull(tmpReq.labels)) {
+            request.labelsShrink = openapi_core_2.OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.labels, "labels", "json");
+        }
         let query = {};
         if (!$dara.isNull(request.datasetName)) {
             query["datasetName"] = request.datasetName;
         }
+        if (!$dara.isNull(request.labelsShrink)) {
+            query["labels"] = request.labelsShrink;
+        }
         if (!$dara.isNull(request.maxResults)) {
             query["maxResults"] = request.maxResults;
         }
@@ -1958,6 +2290,138 @@ class Client extends openapi_core_1.default {
         let headers = {};
         return await this.listEvaluatorsWithOptions(request, headers, runtime);
     }
+    /**
+     * Queries the list of experiment plans.
+     *
+     * @remarks
+     * Calls ListExperimentPlans to query the list of experiment plans under a specified AgentSpace for the current account. Supports fuzzy match by plan name, filtering by status, and pagination using `offset`/`limit`.
+     *
+     * @param request - ListExperimentPlansRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns ListExperimentPlansResponse
+     */
+    async listExperimentPlansWithOptions(agentSpace, request, headers, runtime) {
+        request.validate();
+        let query = {};
+        if (!$dara.isNull(request.limit)) {
+            query["limit"] = request.limit;
+        }
+        if (!$dara.isNull(request.maxResults)) {
+            query["maxResults"] = request.maxResults;
+        }
+        if (!$dara.isNull(request.nextToken)) {
+            query["nextToken"] = request.nextToken;
+        }
+        if (!$dara.isNull(request.offset)) {
+            query["offset"] = request.offset;
+        }
+        if (!$dara.isNull(request.planName)) {
+            query["planName"] = request.planName;
+        }
+        if (!$dara.isNull(request.status)) {
+            query["status"] = request.status;
+        }
+        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: "ListExperimentPlans",
+            version: "2026-05-20",
+            protocol: "HTTPS",
+            pathname: `/api/v1/experiments/${$dara.URL.percentEncode(agentSpace)}/plans`,
+            method: "GET",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListExperimentPlansResponse({}));
+    }
+    /**
+     * Queries the list of experiment plans.
+     *
+     * @remarks
+     * Calls ListExperimentPlans to query the list of experiment plans under a specified AgentSpace for the current account. Supports fuzzy match by plan name, filtering by status, and pagination using `offset`/`limit`.
+     *
+     * @param request - ListExperimentPlansRequest
+     * @returns ListExperimentPlansResponse
+     */
+    async listExperimentPlans(agentSpace, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.listExperimentPlansWithOptions(agentSpace, request, headers, runtime);
+    }
+    /**
+     * Queries the list of experiment run records.
+     *
+     * @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.
+     *
+     * @param request - ListExperimentRunsRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns ListExperimentRunsResponse
+     */
+    async listExperimentRunsWithOptions(agentSpace, request, headers, runtime) {
+        request.validate();
+        let query = {};
+        if (!$dara.isNull(request.datasetId)) {
+            query["datasetId"] = request.datasetId;
+        }
+        if (!$dara.isNull(request.experimentName)) {
+            query["experimentName"] = request.experimentName;
+        }
+        if (!$dara.isNull(request.maxResults)) {
+            query["maxResults"] = request.maxResults;
+        }
+        if (!$dara.isNull(request.nextToken)) {
+            query["nextToken"] = request.nextToken;
+        }
+        if (!$dara.isNull(request.page)) {
+            query["page"] = request.page;
+        }
+        if (!$dara.isNull(request.pageSize)) {
+            query["pageSize"] = request.pageSize;
+        }
+        if (!$dara.isNull(request.planName)) {
+            query["planName"] = request.planName;
+        }
+        if (!$dara.isNull(request.status)) {
+            query["status"] = request.status;
+        }
+        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: "ListExperimentRuns",
+            version: "2026-05-20",
+            protocol: "HTTPS",
+            pathname: `/api/v1/experimentruns/${$dara.URL.percentEncode(agentSpace)}/records`,
+            method: "GET",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListExperimentRunsResponse({}));
+    }
+    /**
+     * Queries the list of experiment run records.
+     *
+     * @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.
+     *
+     * @param request - ListExperimentRunsRequest
+     * @returns ListExperimentRunsResponse
+     */
+    async listExperimentRuns(agentSpace, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.listExperimentRunsWithOptions(agentSpace, request, headers, runtime);
+    }
     /**
      * Queries the execution history list of a pipeline.
      *
@@ -2749,6 +3213,155 @@ class Client extends openapi_core_1.default {
         let headers = {};
         return await this.updateEvaluatorSkillWithOptions(name, skillName, request, headers, runtime);
     }
+    /**
+     * Updates an experiment plan.
+     *
+     * @remarks
+     * Calls UpdateExperimentPlan to update a specified experiment plan. Fields that are not passed remain unchanged. Only plans created by the current account can be updated.
+     *
+     * @param request - UpdateExperimentPlanRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns UpdateExperimentPlanResponse
+     */
+    async updateExperimentPlanWithOptions(agentSpace, planId, request, headers, runtime) {
+        request.validate();
+        let body = {};
+        if (!$dara.isNull(request.datasetId)) {
+            body["datasetId"] = request.datasetId;
+        }
+        if (!$dara.isNull(request.datasetProject)) {
+            body["datasetProject"] = request.datasetProject;
+        }
+        if (!$dara.isNull(request.description)) {
+            body["description"] = request.description;
+        }
+        if (!$dara.isNull(request.evaluators)) {
+            body["evaluators"] = request.evaluators;
+        }
+        if (!$dara.isNull(request.experimentType)) {
+            body["experimentType"] = request.experimentType;
+        }
+        if (!$dara.isNull(request.experiments)) {
+            body["experiments"] = request.experiments;
+        }
+        if (!$dara.isNull(request.input)) {
+            body["input"] = request.input;
+        }
+        if (!$dara.isNull(request.pipelineName)) {
+            body["pipelineName"] = request.pipelineName;
+        }
+        if (!$dara.isNull(request.planName)) {
+            body["planName"] = request.planName;
+        }
+        if (!$dara.isNull(request.querySql)) {
+            body["querySql"] = request.querySql;
+        }
+        if (!$dara.isNull(request.selectedItemIds)) {
+            body["selectedItemIds"] = request.selectedItemIds;
+        }
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+            body: openapi_core_2.OpenApiUtil.parseToMap(body),
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "UpdateExperimentPlan",
+            version: "2026-05-20",
+            protocol: "HTTPS",
+            pathname: `/api/v1/experiments/${$dara.URL.percentEncode(agentSpace)}/plans/${$dara.URL.percentEncode(planId)}`,
+            method: "PUT",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateExperimentPlanResponse({}));
+    }
+    /**
+     * Updates an experiment plan.
+     *
+     * @remarks
+     * Calls UpdateExperimentPlan to update a specified experiment plan. Fields that are not passed remain unchanged. Only plans created by the current account can be updated.
+     *
+     * @param request - UpdateExperimentPlanRequest
+     * @returns UpdateExperimentPlanResponse
+     */
+    async updateExperimentPlan(agentSpace, planId, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.updateExperimentPlanWithOptions(agentSpace, planId, request, headers, runtime);
+    }
+    /**
+     * Updates an experiment run.
+     *
+     * @remarks
+     * Calls UpdateExperimentRun to update the name, status, and task counts of an experiment record. Fields that are not specified remain unchanged. Typical sequence for offline experiments: running → progress writeback → completed.
+     *
+     * @param request - UpdateExperimentRunRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns UpdateExperimentRunResponse
+     */
+    async updateExperimentRunWithOptions(agentSpace, recordId, request, headers, runtime) {
+        request.validate();
+        let query = {};
+        if (!$dara.isNull(request.clientToken)) {
+            query["clientToken"] = request.clientToken;
+        }
+        let body = {};
+        if (!$dara.isNull(request.completedAt)) {
+            body["completedAt"] = request.completedAt;
+        }
+        if (!$dara.isNull(request.completedTasks)) {
+            body["completedTasks"] = request.completedTasks;
+        }
+        if (!$dara.isNull(request.executedAt)) {
+            body["executedAt"] = request.executedAt;
+        }
+        if (!$dara.isNull(request.failedTasks)) {
+            body["failedTasks"] = request.failedTasks;
+        }
+        if (!$dara.isNull(request.recordName)) {
+            body["recordName"] = request.recordName;
+        }
+        if (!$dara.isNull(request.status)) {
+            body["status"] = request.status;
+        }
+        if (!$dara.isNull(request.totalTasks)) {
+            body["totalTasks"] = request.totalTasks;
+        }
+        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: "UpdateExperimentRun",
+            version: "2026-05-20",
+            protocol: "HTTPS",
+            pathname: `/api/v1/experimentruns/${$dara.URL.percentEncode(agentSpace)}/records/${$dara.URL.percentEncode(recordId)}`,
+            method: "PUT",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateExperimentRunResponse({}));
+    }
+    /**
+     * Updates an experiment run.
+     *
+     * @remarks
+     * Calls UpdateExperimentRun to update the name, status, and task counts of an experiment record. Fields that are not specified remain unchanged. Typical sequence for offline experiments: running → progress writeback → completed.
+     *
+     * @param request - UpdateExperimentRunRequest
+     * @returns UpdateExperimentRunResponse
+     */
+    async updateExperimentRun(agentSpace, recordId, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.updateExperimentRunWithOptions(agentSpace, recordId, request, headers, runtime);
+    }
     /**
      * Updates a pipeline.
      *