@alicloud/dataworks-public20240518 8.8.5 → 9.0.0

package/dist/client.d.ts

@@ -310,15 +310,15 @@ export default class Client extends OpenApi {
      */
     cloneDataSource(request: $_model.CloneDataSourceRequest): Promise<$_model.CloneDataSourceResponse>;
     /**
-     * Create Agent
+     * Creates an Agent.
      *
      * @remarks
-     * ## Request Description
-     * - **Agent Name**: Must be unique under the current account.
-     * - **Model Configuration**: An optional parameter used to specify the model used by the Agent and its related settings.
-     * - **Visibility Level**: Defines who can access the Agent. Supports visibility within the account, to specified projects, or to specific users.
-     * - **Visibility Scope**: When `PROJECT` or `USER` is selected as the visibility level, the specific project ID or user ID list must be further specified.
-     * - **Other Parameters**: Items such as display name and description are optional and can be filled in based on actual needs.
+     * ## Operation description
+     * - **Agent name**: Must be unique within the current account.
+     * - **Model configuration**: An optional parameter that specifies the model used by the Agent and its related settings.
+     * - **Visibility level**: Defines who can access the Agent. Supported levels include account-wide, project-specific, or user-specific visibility.
+     * - **Visibility scope**: When you set the visibility level to `PROJECT` or `USER`, you must specify the list of project IDs or user IDs.
+     * - **Other parameters**: Parameters such as display name and description are optional. Set them as needed.
      *
      * @param tmpReq - CreateAgentRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -326,29 +326,32 @@ export default class Client extends OpenApi {
      */
     createAgentWithOptions(tmpReq: $_model.CreateAgentRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateAgentResponse>;
     /**
-     * Create Agent
+     * Creates an Agent.
      *
      * @remarks
-     * ## Request Description
-     * - **Agent Name**: Must be unique under the current account.
-     * - **Model Configuration**: An optional parameter used to specify the model used by the Agent and its related settings.
-     * - **Visibility Level**: Defines who can access the Agent. Supports visibility within the account, to specified projects, or to specific users.
-     * - **Visibility Scope**: When `PROJECT` or `USER` is selected as the visibility level, the specific project ID or user ID list must be further specified.
-     * - **Other Parameters**: Items such as display name and description are optional and can be filled in based on actual needs.
+     * ## Operation description
+     * - **Agent name**: Must be unique within the current account.
+     * - **Model configuration**: An optional parameter that specifies the model used by the Agent and its related settings.
+     * - **Visibility level**: Defines who can access the Agent. Supported levels include account-wide, project-specific, or user-specific visibility.
+     * - **Visibility scope**: When you set the visibility level to `PROJECT` or `USER`, you must specify the list of project IDs or user IDs.
+     * - **Other parameters**: Parameters such as display name and description are optional. Set them as needed.
      *
      * @param request - CreateAgentRequest
      * @returns CreateAgentResponse
      */
     createAgent(request: $_model.CreateAgentRequest): Promise<$_model.CreateAgentResponse>;
     /**
-     * Creates a new agent session and returns a session ID.
+     * Creates a new agent session and returns the session ID.
      *
      * @remarks
-     * ## Description
-     * - This API creates a new agent session.
-     * - You must specify the agent name to bind to the session using the `_meta.agent.agentName` parameter.
-     * - You can specify a session source identifier in the `_meta.config.sessionSource` parameter. This allows you to search for sessions by source later.
-     * - You can add session tags using the `_meta.config.sessionTags[].sessionTagCode` parameter.
+     * ## Request description
+     * - This operation creates a new agent session.
+     * - Use `_meta.agent.agentName` to specify the bound agent name. This parameter is required.
+     *   - dataworks_data_agent: DataWorks built-in agent — Data Agent, which provides intelligent data development AI capabilities covering the entire workflow of data integration, development, O&M, governance, and analytics.
+     *   - dataworks_chatbi_agent: DataWorks built-in agent — ChatBI, which uses natural language processing and intelligent analytics technologies to automate the entire analysis workflow from requirement parsing, data extraction, and automatic code generation to visualization report output through conversational interaction.
+     *   - dataworks_ai_assistant_agent: DataWorks built-in agent — AI Assistant Service, which is a DataWorks enterprise-grade dedicated AI assistant built on open source frameworks such as OpenClaw and Hermes Agent.
+     * - Use `_meta.config.sessionSource` to pass through a session source identifier for subsequent retrieval by source.
+     * - Use `_meta.config.sessionTags[].sessionTagCode` to pass in session tags.
      *
      * @param tmpReq - CreateAgentSessionRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -356,14 +359,17 @@ export default class Client extends OpenApi {
      */
     createAgentSessionWithOptions(tmpReq: $_model.CreateAgentSessionRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateAgentSessionResponse>;
     /**
-     * Creates a new agent session and returns a session ID.
+     * Creates a new agent session and returns the session ID.
      *
      * @remarks
-     * ## Description
-     * - This API creates a new agent session.
-     * - You must specify the agent name to bind to the session using the `_meta.agent.agentName` parameter.
-     * - You can specify a session source identifier in the `_meta.config.sessionSource` parameter. This allows you to search for sessions by source later.
-     * - You can add session tags using the `_meta.config.sessionTags[].sessionTagCode` parameter.
+     * ## Request description
+     * - This operation creates a new agent session.
+     * - Use `_meta.agent.agentName` to specify the bound agent name. This parameter is required.
+     *   - dataworks_data_agent: DataWorks built-in agent — Data Agent, which provides intelligent data development AI capabilities covering the entire workflow of data integration, development, O&M, governance, and analytics.
+     *   - dataworks_chatbi_agent: DataWorks built-in agent — ChatBI, which uses natural language processing and intelligent analytics technologies to automate the entire analysis workflow from requirement parsing, data extraction, and automatic code generation to visualization report output through conversational interaction.
+     *   - dataworks_ai_assistant_agent: DataWorks built-in agent — AI Assistant Service, which is a DataWorks enterprise-grade dedicated AI assistant built on open source frameworks such as OpenClaw and Hermes Agent.
+     * - Use `_meta.config.sessionSource` to pass through a session source identifier for subsequent retrieval by source.
+     * - Use `_meta.config.sessionTags[].sessionTagCode` to pass in session tags.
      *
      * @param request - CreateAgentSessionRequest
      * @returns CreateAgentSessionResponse
@@ -776,7 +782,7 @@ export default class Client extends OpenApi {
      */
     createDatasetVersion(request: $_model.CreateDatasetVersionRequest): Promise<$_model.CreateDatasetVersionResponse>;
     /**
-     * Creates a file in DataStudio. You cannot call this operation to create Data Integration nodes.
+     * Creates a file in DataStudio. This operation does not support creating Data Integration nodes.
      *
      * @param request - CreateFileRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -784,7 +790,7 @@ export default class Client extends OpenApi {
      */
     createFileWithOptions(request: $_model.CreateFileRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateFileResponse>;
     /**
-     * Creates a file in DataStudio. You cannot call this operation to create Data Integration nodes.
+     * Creates a file in DataStudio. This operation does not support creating Data Integration nodes.
      *
      * @param request - CreateFileRequest
      * @returns CreateFileResponse
@@ -1235,13 +1241,34 @@ export default class Client extends OpenApi {
      */
     createSecurityStrategy(request: $_model.CreateSecurityStrategyRequest): Promise<$_model.CreateSecurityStrategyResponse>;
     /**
-     * 创建 Skill
+     * Saves a reusable semantic task definition. If you use a single-file source, apply for and complete the file upload first. After creation, call RunSemanticJob with the returned Name.
+     *
+     * @remarks
+     * Creates a semantic task definition.
+     *
+     * @param tmpReq - CreateSemanticJobRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns CreateSemanticJobResponse
+     */
+    createSemanticJobWithOptions(tmpReq: $_model.CreateSemanticJobRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateSemanticJobResponse>;
+    /**
+     * Saves a reusable semantic task definition. If you use a single-file source, apply for and complete the file upload first. After creation, call RunSemanticJob with the returned Name.
      *
      * @remarks
-     * ## 请求说明
-     * - `SkillMdOverride` 与 `BundleUrl` 参数二选一，必须提供其中之一。
-     * - `Visibility` 可设置为 `TENANT`、`PROJECT` 或 `USER`，分别表示账号内可见、指定项目可见或指定用户可见。
-     * - 当 `Visibility` 设置为 `PROJECT` 时，需要通过 `VisibilityScope.ProjectIds` 指定可见的项目 ID 列表；当设置为 `USER` 时，则需通过 `VisibilityScope.UserIds` 指定可见的用户 ID 列表。
+     * Creates a semantic task definition.
+     *
+     * @param request - CreateSemanticJobRequest
+     * @returns CreateSemanticJobResponse
+     */
+    createSemanticJob(request: $_model.CreateSemanticJobRequest): Promise<$_model.CreateSemanticJobResponse>;
+    /**
+     * Creates a new Skill in DataWorks.
+     *
+     * @remarks
+     * ## Request description
+     * - You must provide either SkillMdOverride or BundleUrl. One of the two parameters is required.
+     * - Visibility can be set to `TENANT`, `PROJECT`, or `USER`, which indicate visibility within the account, visibility to specified projects, or visibility to specified users, respectively.
+     * - When Visibility is set to `PROJECT`, specify the list of visible project IDs by using VisibilityScope.ProjectIds. When Visibility is set to `USER`, specify the list of visible user IDs by using VisibilityScope.UserIds.
      *
      * @param tmpReq - CreateSkillRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1249,13 +1276,13 @@ export default class Client extends OpenApi {
      */
     createSkillWithOptions(tmpReq: $_model.CreateSkillRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateSkillResponse>;
     /**
-     * 创建 Skill
+     * Creates a new Skill in DataWorks.
      *
      * @remarks
-     * ## 请求说明
-     * - `SkillMdOverride` 与 `BundleUrl` 参数二选一，必须提供其中之一。
-     * - `Visibility` 可设置为 `TENANT`、`PROJECT` 或 `USER`，分别表示账号内可见、指定项目可见或指定用户可见。
-     * - 当 `Visibility` 设置为 `PROJECT` 时，需要通过 `VisibilityScope.ProjectIds` 指定可见的项目 ID 列表；当设置为 `USER` 时，则需通过 `VisibilityScope.UserIds` 指定可见的用户 ID 列表。
+     * ## Request description
+     * - You must provide either SkillMdOverride or BundleUrl. One of the two parameters is required.
+     * - Visibility can be set to `TENANT`, `PROJECT`, or `USER`, which indicate visibility within the account, visibility to specified projects, or visibility to specified users, respectively.
+     * - When Visibility is set to `PROJECT`, specify the list of visible project IDs by using VisibilityScope.ProjectIds. When Visibility is set to `USER`, specify the list of visible user IDs by using VisibilityScope.UserIds.
      *
      * @param request - CreateSkillRequest
      * @returns CreateSkillResponse
@@ -1321,11 +1348,11 @@ export default class Client extends OpenApi {
      */
     createWorkflowInstances(request: $_model.CreateWorkflowInstancesRequest): Promise<$_model.CreateWorkflowInstancesResponse>;
     /**
-     * 删除 Agent
+     * Deletes an Agent.
      *
      * @remarks
-     * ## 请求说明
-     * 该 API 用于从 DataWorks 中删除指定名称的 Agent。调用此接口时，必须提供要删除的 Agent 的名称。
+     * ## Operation description
+     * This API operation deletes an Agent with the specified name from DataWorks. When calling this operation, you must provide the name of the Agent to delete.
      *
      * @param request - DeleteAgentRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1333,11 +1360,11 @@ export default class Client extends OpenApi {
      */
     deleteAgentWithOptions(request: $_model.DeleteAgentRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DeleteAgentResponse>;
     /**
-     * 删除 Agent
+     * Deletes an Agent.
      *
      * @remarks
-     * ## 请求说明
-     * 该 API 用于从 DataWorks 中删除指定名称的 Agent。调用此接口时，必须提供要删除的 Agent 的名称。
+     * ## Operation description
+     * This API operation deletes an Agent with the specified name from DataWorks. When calling this operation, you must provide the name of the Agent to delete.
      *
      * @param request - DeleteAgentRequest
      * @returns DeleteAgentResponse
@@ -1857,10 +1884,10 @@ export default class Client extends OpenApi {
      */
     deleteMetaCollection(request: $_model.DeleteMetaCollectionRequest): Promise<$_model.DeleteMetaCollectionResponse>;
     /**
-     * 删除自定义实体定义
+     * Deletes a metadata entity definition, including custom entity types and extension table types.
      *
      * @remarks
-     * 需要购买 DataWorks 专业版及以上版本才能使用。
+     * DataWorks Professional Edition or a more advanced edition is required.
      *
      * @param request - DeleteMetaEntityDefRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -1868,10 +1895,10 @@ export default class Client extends OpenApi {
      */
     deleteMetaEntityDefWithOptions(request: $_model.DeleteMetaEntityDefRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DeleteMetaEntityDefResponse>;
     /**
-     * 删除自定义实体定义
+     * Deletes a metadata entity definition, including custom entity types and extension table types.
      *
      * @remarks
-     * 需要购买 DataWorks 专业版及以上版本才能使用。
+     * DataWorks Professional Edition or a more advanced edition is required.
      *
      * @param request - DeleteMetaEntityDefRequest
      * @returns DeleteMetaEntityDefResponse
@@ -2122,6 +2149,27 @@ export default class Client extends OpenApi {
      * @returns DeleteSecurityStrategyResponse
      */
     deleteSecurityStrategy(request: $_model.DeleteSecurityStrategyRequest): Promise<$_model.DeleteSecurityStrategyResponse>;
+    /**
+     * Deletes a task definition by the Name of a created task. If the task is running, call KillSemanticJob with the ExecutorJobId of that run and confirm the stop before deletion.
+     *
+     * @remarks
+     * Operation description for deleting a semantic task.
+     *
+     * @param request - DeleteSemanticJobRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns DeleteSemanticJobResponse
+     */
+    deleteSemanticJobWithOptions(request: $_model.DeleteSemanticJobRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DeleteSemanticJobResponse>;
+    /**
+     * Deletes a task definition by the Name of a created task. If the task is running, call KillSemanticJob with the ExecutorJobId of that run and confirm the stop before deletion.
+     *
+     * @remarks
+     * Operation description for deleting a semantic task.
+     *
+     * @param request - DeleteSemanticJobRequest
+     * @returns DeleteSemanticJobResponse
+     */
+    deleteSemanticJob(request: $_model.DeleteSemanticJobRequest): Promise<$_model.DeleteSemanticJobResponse>;
     /**
      * Delete Skill
      *
@@ -2331,6 +2379,27 @@ export default class Client extends OpenApi {
      * @returns DissociateProjectFromResourceGroupResponse
      */
     dissociateProjectFromResourceGroup(request: $_model.DissociateProjectFromResourceGroupRequest): Promise<$_model.DissociateProjectFromResourceGroupResponse>;
+    /**
+     * Returns the download URL of artifacts by node name and an optional run ID after execution completes. If JobRunId is not specified, the result of the latest run of the node is returned.
+     *
+     * @remarks
+     * Operation description for retrieving the download URL of semantic task results.
+     *
+     * @param request - DownloadSemanticResultsRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns DownloadSemanticResultsResponse
+     */
+    downloadSemanticResultsWithOptions(request: $_model.DownloadSemanticResultsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DownloadSemanticResultsResponse>;
+    /**
+     * Returns the download URL of artifacts by node name and an optional run ID after execution completes. If JobRunId is not specified, the result of the latest run of the node is returned.
+     *
+     * @remarks
+     * Operation description for retrieving the download URL of semantic task results.
+     *
+     * @param request - DownloadSemanticResultsRequest
+     * @returns DownloadSemanticResultsResponse
+     */
+    downloadSemanticResults(request: $_model.DownloadSemanticResultsRequest): Promise<$_model.DownloadSemanticResultsResponse>;
     /**
      * Enables a process definition with the specified ID.
      *
@@ -3607,6 +3676,48 @@ export default class Client extends OpenApi {
      * @returns GetSecurityStrategyResponse
      */
     getSecurityStrategy(request: $_model.GetSecurityStrategyRequest): Promise<$_model.GetSecurityStrategyResponse>;
+    /**
+     * Queries the executor status and runtime configuration by using the ExecutorJobId returned by RunSemanticJob or ListSemanticJobRuns.
+     *
+     * @remarks
+     * Operation description for querying semantic job run details.
+     *
+     * @param request - GetSemanticJobDetailRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns GetSemanticJobDetailResponse
+     */
+    getSemanticJobDetailWithOptions(request: $_model.GetSemanticJobDetailRequest, runtime: $dara.RuntimeOptions): Promise<$_model.GetSemanticJobDetailResponse>;
+    /**
+     * Queries the executor status and runtime configuration by using the ExecutorJobId returned by RunSemanticJob or ListSemanticJobRuns.
+     *
+     * @remarks
+     * Operation description for querying semantic job run details.
+     *
+     * @param request - GetSemanticJobDetailRequest
+     * @returns GetSemanticJobDetailResponse
+     */
+    getSemanticJobDetail(request: $_model.GetSemanticJobDetailRequest): Promise<$_model.GetSemanticJobDetailResponse>;
+    /**
+     * Queries execution logs by using the ExecutorJobId returned by RunSemanticJob or ListSemanticJobRuns. The current POP contract exposes only the task and workspace identifiers and returns default log segments.
+     *
+     * @remarks
+     * Operation description for querying semantic job run logs.
+     *
+     * @param request - GetSemanticJobLogRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns GetSemanticJobLogResponse
+     */
+    getSemanticJobLogWithOptions(request: $_model.GetSemanticJobLogRequest, runtime: $dara.RuntimeOptions): Promise<$_model.GetSemanticJobLogResponse>;
+    /**
+     * Queries execution logs by using the ExecutorJobId returned by RunSemanticJob or ListSemanticJobRuns. The current POP contract exposes only the task and workspace identifiers and returns default log segments.
+     *
+     * @remarks
+     * Operation description for querying semantic job run logs.
+     *
+     * @param request - GetSemanticJobLogRequest
+     * @returns GetSemanticJobLogResponse
+     */
+    getSemanticJobLog(request: $_model.GetSemanticJobLogRequest): Promise<$_model.GetSemanticJobLogResponse>;
     /**
      * Retrieves the details of a specified Skill by name, including the body of the SKILL.md file and the bundle\\"s download link.
      *
@@ -3815,12 +3926,12 @@ export default class Client extends OpenApi {
     importCertificate(request: $_model.ImportCertificateRequest): Promise<$_model.ImportCertificateResponse>;
     importCertificateAdvance(request: $_model.ImportCertificateAdvanceRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ImportCertificateResponse>;
     /**
-     * Imports a workflow node defined by FlowSpec and its child nodes into DataStudio.
+     * Imports a workflow node defined by FlowSpec and its internal child nodes into DataStudio.
      *
      * @remarks
      * >Notice:
-     * - This operation does not support importing multiple workflows. If more than one workflow is defined in the FlowSpec, all workflows except the first one are ignored.
-     * - This is an asynchronous operation. The response returns an asynchronous task object. Call GetJobStatus to query the execution status of the task.
+     * - This operation does not support importing multiple workflows. If more than one workflow is defined in the FlowSpec, all workflows after the first one are ignored.
+     * - This is an asynchronous operation. Calling this operation returns an asynchronous task object. To query the execution status of the task, call GetJobStatus.
      *
      * @param request - ImportWorkflowDefinitionRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -3828,17 +3939,38 @@ export default class Client extends OpenApi {
      */
     importWorkflowDefinitionWithOptions(request: $_model.ImportWorkflowDefinitionRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ImportWorkflowDefinitionResponse>;
     /**
-     * Imports a workflow node defined by FlowSpec and its child nodes into DataStudio.
+     * Imports a workflow node defined by FlowSpec and its internal child nodes into DataStudio.
      *
      * @remarks
      * >Notice:
-     * - This operation does not support importing multiple workflows. If more than one workflow is defined in the FlowSpec, all workflows except the first one are ignored.
-     * - This is an asynchronous operation. The response returns an asynchronous task object. Call GetJobStatus to query the execution status of the task.
+     * - This operation does not support importing multiple workflows. If more than one workflow is defined in the FlowSpec, all workflows after the first one are ignored.
+     * - This is an asynchronous operation. Calling this operation returns an asynchronous task object. To query the execution status of the task, call GetJobStatus.
      *
      * @param request - ImportWorkflowDefinitionRequest
      * @returns ImportWorkflowDefinitionResponse
      */
     importWorkflowDefinition(request: $_model.ImportWorkflowDefinitionRequest): Promise<$_model.ImportWorkflowDefinitionResponse>;
+    /**
+     * Stops a specified run by using the ExecutorJobId returned by RunSemanticJob or ListSemanticJobRuns. A successful call only indicates that the stop request has been accepted. Query the final status by calling GetSemanticJobDetail.
+     *
+     * @remarks
+     * Operation description for stopping a semantic job run.
+     *
+     * @param request - KillSemanticJobRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns KillSemanticJobResponse
+     */
+    killSemanticJobWithOptions(request: $_model.KillSemanticJobRequest, runtime: $dara.RuntimeOptions): Promise<$_model.KillSemanticJobResponse>;
+    /**
+     * Stops a specified run by using the ExecutorJobId returned by RunSemanticJob or ListSemanticJobRuns. A successful call only indicates that the stop request has been accepted. Query the final status by calling GetSemanticJobDetail.
+     *
+     * @remarks
+     * Operation description for stopping a semantic job run.
+     *
+     * @param request - KillSemanticJobRequest
+     * @returns KillSemanticJobResponse
+     */
+    killSemanticJob(request: $_model.KillSemanticJobRequest): Promise<$_model.KillSemanticJobResponse>;
     /**
      * Retrieves a list of artifacts from a specified session.
      *
@@ -4453,10 +4585,10 @@ export default class Client extends OpenApi {
      */
     listDataQualityScans(request: $_model.ListDataQualityScansRequest): Promise<$_model.ListDataQualityScansResponse>;
     /**
-     * Queries the list of data quality rule templates in a project.
+     * Queries the list of data quality rule templates in a specified project.
      *
      * @remarks
-     * DataWorks Basic Edition or a higher edition is required.
+     * You must purchase DataWorks Basic Edition or a higher edition to use this feature.
      *
      * @param request - ListDataQualityTemplatesRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -4464,10 +4596,10 @@ export default class Client extends OpenApi {
      */
     listDataQualityTemplatesWithOptions(request: $_model.ListDataQualityTemplatesRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ListDataQualityTemplatesResponse>;
     /**
-     * Queries the list of data quality rule templates in a project.
+     * Queries the list of data quality rule templates in a specified project.
      *
      * @remarks
-     * DataWorks Basic Edition or a higher edition is required.
+     * You must purchase DataWorks Basic Edition or a higher edition to use this feature.
      *
      * @param request - ListDataQualityTemplatesRequest
      * @returns ListDataQualityTemplatesResponse
@@ -5438,6 +5570,48 @@ export default class Client extends OpenApi {
      * @returns ListSecurityStrategiesResponse
      */
     listSecurityStrategies(request: $_model.ListSecurityStrategiesRequest): Promise<$_model.ListSecurityStrategiesResponse>;
+    /**
+     * Queries the run records of a created node by its Name with paging. The JobRunId in each record is active for retrieving the results of a specific run, and the ExecutorJobId is active for getting details, logs, or stopping the run.
+     *
+     * @remarks
+     * Queries the run records of a semantic job.
+     *
+     * @param request - ListSemanticJobRunsRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns ListSemanticJobRunsResponse
+     */
+    listSemanticJobRunsWithOptions(request: $_model.ListSemanticJobRunsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ListSemanticJobRunsResponse>;
+    /**
+     * Queries the run records of a created node by its Name with paging. The JobRunId in each record is active for retrieving the results of a specific run, and the ExecutorJobId is active for getting details, logs, or stopping the run.
+     *
+     * @remarks
+     * Queries the run records of a semantic job.
+     *
+     * @param request - ListSemanticJobRunsRequest
+     * @returns ListSemanticJobRunsResponse
+     */
+    listSemanticJobRuns(request: $_model.ListSemanticJobRunsRequest): Promise<$_model.ListSemanticJobRunsResponse>;
+    /**
+     * Queries semantics node definitions of the current tenant by paging. The Name, ProjectId, and Source fields in the list items can be used for running/deleting nodes, querying run details, and verifying input scope, respectively.
+     *
+     * @remarks
+     * Queries the list of semantic task definitions.
+     *
+     * @param request - ListSemanticJobsRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns ListSemanticJobsResponse
+     */
+    listSemanticJobsWithOptions(request: $_model.ListSemanticJobsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ListSemanticJobsResponse>;
+    /**
+     * Queries semantics node definitions of the current tenant by paging. The Name, ProjectId, and Source fields in the list items can be used for running/deleting nodes, querying run details, and verifying input scope, respectively.
+     *
+     * @remarks
+     * Queries the list of semantic task definitions.
+     *
+     * @param request - ListSemanticJobsRequest
+     * @returns ListSemanticJobsResponse
+     */
+    listSemanticJobs(request: $_model.ListSemanticJobsRequest): Promise<$_model.ListSemanticJobsResponse>;
     /**
      * Lists the Skills in your account.
      *
@@ -5794,18 +5968,18 @@ export default class Client extends OpenApi {
      */
     previewDatasetVersion(request: $_model.PreviewDatasetVersionRequest): Promise<$_model.PreviewDatasetVersionResponse>;
     /**
-     * Sends a prompt to an existing session and streams the agent response.
+     * Sends a user prompt to an existing session and returns the Agent response in streaming mode.
      *
      * @remarks
-     * ## Request
-     * - This API sends a user prompt to a specified session ID and streams the agent\\"s response over SSE (Server-Sent Events).
-     * - The response may include message chunks, thought process, and tool calling status updates.
-     * - If the specified session does not exist, the API returns a 400 error in an SSE error frame.
-     * - The `stopReason` field indicates why the agent ended the turn.
-     * - You can use multiple types of content blocks in the prompt, such as text and OSS file download links.
-     * - You can provide additional metadata in the `Meta` parameter to pass more context to the server.
-     * - The response content conforms to the open-source Agent Client Protocol (ACP) specification. For more information, see https\\://agentclientprotocol.com
-     * - \\*\\*Review the billing methods and pricing for Data Agent before you use this API\\*\\*: https\\://help.aliyun.com/zh/dataworks/dataworks-data-agent-agent-billing
+     * ## Operation description
+     * - This API sends a user prompt to a specified session ID and accepts the Agent response in SSE (Server-Sent Events) streaming mode.
+     * - The response may include message fragments, thinking procedures, tool calling status updates, and other information.
+     * - If the specified session does not exist, a 400 fault is returned through an SSE error frame.
+     * - The `stopReason` field indicates why the Agent stopped the current conversation turn.
+     * - Multiple types of content blocks are supported as prompt input, such as text and OSS file download links.
+     * - You can optionally provide additional meta information `Meta` to pass more context to the server.
+     * - The returned content conforms to the open-source Agent Client Protocol (ACP) specification. For more information, visit: https://agentclientprotocol.com
+     * - **Before invoking this API, make sure you fully understand the billing methods and pricing of the Data Agent product**: https://www.alibabacloud.com/help/en/dataworks/dataworks-data-agent-agent-billing
      *
      * @param tmpReq - PromptAgentSessionRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -5813,18 +5987,18 @@ export default class Client extends OpenApi {
      */
     promptAgentSessionWithSSE(tmpReq: $_model.PromptAgentSessionRequest, runtime: $dara.RuntimeOptions): AsyncGenerator<$_model.PromptAgentSessionResponse, any, unknown>;
     /**
-     * Sends a prompt to an existing session and streams the agent response.
+     * Sends a user prompt to an existing session and returns the Agent response in streaming mode.
      *
      * @remarks
-     * ## Request
-     * - This API sends a user prompt to a specified session ID and streams the agent\\"s response over SSE (Server-Sent Events).
-     * - The response may include message chunks, thought process, and tool calling status updates.
-     * - If the specified session does not exist, the API returns a 400 error in an SSE error frame.
-     * - The `stopReason` field indicates why the agent ended the turn.
-     * - You can use multiple types of content blocks in the prompt, such as text and OSS file download links.
-     * - You can provide additional metadata in the `Meta` parameter to pass more context to the server.
-     * - The response content conforms to the open-source Agent Client Protocol (ACP) specification. For more information, see https\\://agentclientprotocol.com
-     * - \\*\\*Review the billing methods and pricing for Data Agent before you use this API\\*\\*: https\\://help.aliyun.com/zh/dataworks/dataworks-data-agent-agent-billing
+     * ## Operation description
+     * - This API sends a user prompt to a specified session ID and accepts the Agent response in SSE (Server-Sent Events) streaming mode.
+     * - The response may include message fragments, thinking procedures, tool calling status updates, and other information.
+     * - If the specified session does not exist, a 400 fault is returned through an SSE error frame.
+     * - The `stopReason` field indicates why the Agent stopped the current conversation turn.
+     * - Multiple types of content blocks are supported as prompt input, such as text and OSS file download links.
+     * - You can optionally provide additional meta information `Meta` to pass more context to the server.
+     * - The returned content conforms to the open-source Agent Client Protocol (ACP) specification. For more information, visit: https://agentclientprotocol.com
+     * - **Before invoking this API, make sure you fully understand the billing methods and pricing of the Data Agent product**: https://www.alibabacloud.com/help/en/dataworks/dataworks-data-agent-agent-billing
      *
      * @param tmpReq - PromptAgentSessionRequest
      * @param runtime - runtime options for this request RuntimeOptions
@@ -5832,18 +6006,18 @@ export default class Client extends OpenApi {
      */
     promptAgentSessionWithOptions(tmpReq: $_model.PromptAgentSessionRequest, runtime: $dara.RuntimeOptions): Promise<$_model.PromptAgentSessionResponse>;
     /**
-     * Sends a prompt to an existing session and streams the agent response.
+     * Sends a user prompt to an existing session and returns the Agent response in streaming mode.
      *
      * @remarks
-     * ## Request
-     * - This API sends a user prompt to a specified session ID and streams the agent\\"s response over SSE (Server-Sent Events).
-     * - The response may include message chunks, thought process, and tool calling status updates.
-     * - If the specified session does not exist, the API returns a 400 error in an SSE error frame.
-     * - The `stopReason` field indicates why the agent ended the turn.
-     * - You can use multiple types of content blocks in the prompt, such as text and OSS file download links.
-     * - You can provide additional metadata in the `Meta` parameter to pass more context to the server.
-     * - The response content conforms to the open-source Agent Client Protocol (ACP) specification. For more information, see https\\://agentclientprotocol.com
-     * - \\*\\*Review the billing methods and pricing for Data Agent before you use this API\\*\\*: https\\://help.aliyun.com/zh/dataworks/dataworks-data-agent-agent-billing
+     * ## Operation description
+     * - This API sends a user prompt to a specified session ID and accepts the Agent response in SSE (Server-Sent Events) streaming mode.
+     * - The response may include message fragments, thinking procedures, tool calling status updates, and other information.
+     * - If the specified session does not exist, a 400 fault is returned through an SSE error frame.
+     * - The `stopReason` field indicates why the Agent stopped the current conversation turn.
+     * - Multiple types of content blocks are supported as prompt input, such as text and OSS file download links.
+     * - You can optionally provide additional meta information `Meta` to pass more context to the server.
+     * - The returned content conforms to the open-source Agent Client Protocol (ACP) specification. For more information, visit: https://agentclientprotocol.com
+     * - **Before invoking this API, make sure you fully understand the billing methods and pricing of the Data Agent product**: https://www.alibabacloud.com/help/en/dataworks/dataworks-data-agent-agent-billing
      *
      * @param request - PromptAgentSessionRequest
      * @returns PromptAgentSessionResponse
@@ -6052,6 +6226,27 @@ export default class Client extends OpenApi {
      * @returns RollbackParameterResponse
      */
     rollbackParameter(request: $_model.RollbackParameterRequest): Promise<$_model.RollbackParameterResponse>;
+    /**
+     * Submits a semantic job for execution by its Name and returns the run identifier and executor identifier. A successful call indicates that the job has been submitted, not that the semantic model results have been generated.
+     *
+     * @remarks
+     * *Before using this operation, make sure that you fully understand the [billing method and pricing](https://www.alibabacloud.com/help/en/dataworks/dataworks-data-agent-agent-billing) of model calls used by semantic building.**
+     *
+     * @param request - RunSemanticJobRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns RunSemanticJobResponse
+     */
+    runSemanticJobWithOptions(request: $_model.RunSemanticJobRequest, runtime: $dara.RuntimeOptions): Promise<$_model.RunSemanticJobResponse>;
+    /**
+     * Submits a semantic job for execution by its Name and returns the run identifier and executor identifier. A successful call indicates that the job has been submitted, not that the semantic model results have been generated.
+     *
+     * @remarks
+     * *Before using this operation, make sure that you fully understand the [billing method and pricing](https://www.alibabacloud.com/help/en/dataworks/dataworks-data-agent-agent-billing) of model calls used by semantic building.**
+     *
+     * @param request - RunSemanticJobRequest
+     * @returns RunSemanticJobResponse
+     */
+    runSemanticJob(request: $_model.RunSemanticJobRequest): Promise<$_model.RunSemanticJobResponse>;
     /**
      * Sets the statuses of multiple instances to successful at a time.
      *
@@ -7023,6 +7218,29 @@ export default class Client extends OpenApi {
      * @returns UpdateSecurityStrategyResponse
      */
     updateSecurityStrategy(request: $_model.UpdateSecurityStrategyRequest): Promise<$_model.UpdateSecurityStrategyResponse>;
+    /**
+     * Updates a specified Skill and generates a new version.
+     *
+     * @remarks
+     * ## Request description
+     * This API allows you to update an existing Skill and create a new version based on the current highest version or a specified version. Fields not provided in the request retain their original values. You can update the Skill content by providing either `SkillMdOverride` or `BundleUrl`. You can also set additional information such as the visibility scope.
+     *
+     * @param tmpReq - UpdateSkillRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns UpdateSkillResponse
+     */
+    updateSkillWithOptions(tmpReq: $_model.UpdateSkillRequest, runtime: $dara.RuntimeOptions): Promise<$_model.UpdateSkillResponse>;
+    /**
+     * Updates a specified Skill and generates a new version.
+     *
+     * @remarks
+     * ## Request description
+     * This API allows you to update an existing Skill and create a new version based on the current highest version or a specified version. Fields not provided in the request retain their original values. You can update the Skill content by providing either `SkillMdOverride` or `BundleUrl`. You can also set additional information such as the visibility scope.
+     *
+     * @param request - UpdateSkillRequest
+     * @returns UpdateSkillResponse
+     */
+    updateSkill(request: $_model.UpdateSkillRequest): Promise<$_model.UpdateSkillResponse>;
     /**
      * Updates the business metadata for a data table in the data map. You can update only the table\\"s Readme and custom attributes.
      *
@@ -7139,4 +7357,25 @@ export default class Client extends OpenApi {
      * @returns UpdateWorkflowDefinitionResponse
      */
     updateWorkflowDefinition(request: $_model.UpdateWorkflowDefinitionRequest): Promise<$_model.UpdateWorkflowDefinitionResponse>;
+    /**
+     * Requests a temporary OSS PUT upload URL. Complete the PUT upload before the URL expires, and then pass the returned FileId to the ReferenceFileIds parameter of CreateSemanticJob.
+     *
+     * @remarks
+     * Requests an upload URL for semantic job attachments.
+     *
+     * @param request - UploadSemanticFileRequest
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns UploadSemanticFileResponse
+     */
+    uploadSemanticFileWithOptions(request: $_model.UploadSemanticFileRequest, runtime: $dara.RuntimeOptions): Promise<$_model.UploadSemanticFileResponse>;
+    /**
+     * Requests a temporary OSS PUT upload URL. Complete the PUT upload before the URL expires, and then pass the returned FileId to the ReferenceFileIds parameter of CreateSemanticJob.
+     *
+     * @remarks
+     * Requests an upload URL for semantic job attachments.
+     *
+     * @param request - UploadSemanticFileRequest
+     * @returns UploadSemanticFileResponse
+     */
+    uploadSemanticFile(request: $_model.UploadSemanticFileRequest): Promise<$_model.UploadSemanticFileResponse>;
 }