The DataWorks AI assistant supports scheduled inspection of monitoring rule alerts and specified task exceptions. It can integrate with IM platforms such as DingTalk for real-time push notifications, diagnostics, and automatic issue remediation. You can complete the entire workflow of receiving, analyzing, confirming, and fixing alerts on your mobile device without switching to a PC, significantly improving O&M efficiency.
Overview
The DataWorks AI assistant provides built-in inspection templates for various scenarios, including alerts, abnormal instances, data quality, and data governance. It also supports custom inspection capabilities. This topic uses "monitoring specified task failures" as an example to describe how to configure scheduled inspection tasks through the AI assistant, receive alert notifications on IM platforms such as DingTalk, and enable the AI assistant to automatically fix abnormal issues. You can follow this practice to integrate your existing alert rules in DataWorks with IM platforms such as DingTalk.
DataWorks AI assistant documentation: Use AI assistant services.
DataWorks console: https://dataworks.console.alibabacloud.com/overview.
Scenario and results
Traditional monitoring alerts typically only notify you of task errors, and the handling process still requires PC-side operations or switching between multiple applications. The DataWorks AI assistant supports integration with IM platforms such as DingTalk to proactively push alert messages to your mobile device. You can directly complete diagnostics, remediation, and rerun operations within the IM client, achieving end-to-end closed-loop handling from receiving alerts to resolving issues.
The final results of this practice are as follows:
User
user Duses natural language commands in the DingTalk applicationDataWorksAIAssistant01to have the AI assistant service instanceAI Assistantsubscribe to failure alerts for a specified task.When a task fails, the AI assistant automatically pushes the alert, diagnostic results, and remediation plan to
user D.After
user Dconfirms the plan, the AI assistant automatically performs code modification, deployment, and instance rerun operations on behalf ofuser Dto fix the issue.
Configuration planning
Before you start, plan the following information:
AI assistant instance name: The name of the AI assistant service instance created in DataWorks.
Execution identity: The identity (RAM user or RAM role) used by the AI assistant to perform operations.
IM application information: The name of the enterprise internal application created on the IM platform (such as DingTalk) and the organization it belongs to.
Network connection method: The network interaction method between the AI assistant and the IM platform (internal network or public network).
The planning for this example is as follows:
Configuration item | Planned value |
AI assistant instance name |
|
Execution identity | Current logon user |
DingTalk application name |
|
Network connection method | Internal network |
Step 1: Configure task monitoring alerts
Objective: Define the tasks to monitor and the conditions that trigger alerts to ensure that the DataWorks system can generate alert events available for subscription.
Problem addressed: The prerequisite for the AI assistant to subscribe to alerts is that a valid monitoring rule exists and can generate alert events when conditions are met. You need to first determine "which task to monitor and what conditions trigger an alert", and then create a custom monitoring rule in DataWorks Operation Center.
General instructions:
Create a custom monitoring rule in DataWorks Operation Center.
In the rule, specify the objects to monitor and the trigger conditions.
Alert events generated by the rule can be subscribed to by the AI assistant, in addition to being sent through the notification methods you select (SMS, email, etc.). The AI assistant subscribes to alert events regardless of the notification method configured for the alerts.
Configuration in this example (set an error alert for the
Regional Transaction Ranking Analysistask in the Retail E-commerce workspace):Configuration item
Description
Example value
Rule name
A custom name for the alert rule.
Regional Transaction Ranking Analysis Failure Alert
Rule object
The name of the task to monitor.
Regional Transaction Ranking Analysis 02
Trigger condition
The task status that triggers an alert (error, incomplete, etc.).
Error
Alert action
The notification method after an alert is triggered. Select based on your needs.
Select based on your needs (does not affect IM-side subscriptions).
Result: After the configuration is complete, when the "Regional Transaction Ranking Analysis 02" task encounters an exception, DataWorks triggers an alert event. You can view the alert record in the Alert Information list in Operation Center and receive notifications configured in the alert action (SMS, email, or DingTalk message). This alert event is the content that the AI assistant can subscribe to later.
Step 2: Create an AI assistant service
Objective: Create an AI assistant service instance so that the AI assistant can operate DataWorks on your behalf.
Problem addressed: The AI assistant needs a runtime carrier. You must specify whose identity the AI assistant uses to perform operations (which determines permissions), what resources it uses to run (which determines resources), and what capabilities it has (which determines the scope of executable operations).
General instructions and example configuration: Log on to the DataWorks console and create an AI assistant service instance with the following settings:
Parameter
Description
Example value
Instance name
A custom name for the AI assistant service.
AI Assistant
Use scenario
Select the capability scope of the AI assistant. After you select DataWorks Assistant, the AI assistant has DataWorks O&M-related skills.
DataWorks Assistant
Resource group
Select the serverless resource group used to run the AI assistant service.
The AI assistant service continuously consumes resource group quota after it is started. We recommend that you use a separate resource group from the one used for production tasks.
General-purpose resource group
Execution identity
The identity used by the AI assistant when it performs DataWorks operations. If you select
Current logon user, all operations performed by the AI assistant are equivalent to operations performed by that user.Current DataWorks logon user (user D)
Result: After the instance is created, you can view the "AI Assistant" instance in the AI assistant service list on the DataWorks console, and its status is displayed as Running. At this point, the AI assistant has DataWorks O&M capabilities, but it is not yet connected to any IM platform. You cannot interact with the AI assistant through DingTalk yet. The following steps complete the IM integration.
Step 3: Connect the AI assistant to DingTalk
Objective: Establish a communication channel between the AI assistant and DingTalk to enable real-time interaction in DingTalk.
Problem addressed: By default, the AI assistant can only be used on the web. By binding it to a DingTalk application, you can enable IM interaction capabilities.
3.1 DingTalk side: Create a DingTalk application
Objective: Create an enterprise internal application on the DingTalk Open Platform to obtain connection credentials.
General description: You need to create an internal enterprise application on the DingTalk Open Platform. After creation, the DingTalk platform assigns a Client ID and Client Secret to the application. These credentials are used for identity verification when binding the application on the DataWorks side.
Actions in this example: Create a DingTalk application named "DataWorksAIAssistant01" and obtain the credentials: Client ID and Client Secret.
Result: After the application is created and published, you can find it by searching in the DingTalk client. However, at this point, it is not yet bound to an AI assistant and cannot respond to messages.
3.2 DataWorks side: Configure the IM channel
Objective: Bind the DingTalk application to the AI assistant service instance so that the AI assistant can interact with you through the DingTalk application.
General description: Go to the configuration details page of the AI assistant service instance. In the IM channel configuration, enter the
Client IDandClient Secretof the DingTalk application, and perform a connectivity test. If the test shows that the network is not connected, click One-Click Network Setup to configure the network.Actions in this example: You bind the Client ID and Client Secret of the DingTalk application "DataWorksAIAssistant01" to the AI assistant service instance "AI Assistant", and connect through the internal network. You need to complete the following network configurations (one-click configuration is supported in the DataWorks console):
Configure DingTalk internal network domain name resolution for the VPC bound to the resource group where the AI assistant service runs.
Configure secure cross-VPC internal network access.
The internal network solution relies on PrivateZone and PrivateLink, which incur additional costs.
Result: After the configuration is complete, the connectivity test shows "Success". You search for the application "DataWorksAIAssistant01" in DingTalk, open the chat window, and send a simple command (such as "Briefly introduce yourself"). The AI assistant returns a response. This indicates that the communication channel between the AI assistant and DingTalk is established, and you can interact with the AI assistant in real time through DingTalk.
Step 4: Subscribe to alerts through the AI assistant
Objective: Use natural language commands to have the AI assistant start monitoring alert events for a specified task and verify end-to-end availability.
Problem addressed: After infrastructure configuration is complete, you need to activate the alert subscription feature of the AI assistant through explicit commands.
General description: Send a subscription command to the AI assistant in the DingTalk chat window. You can specify the monitoring target and other information in the command: workspace ID, task name, and trigger conditions.
Command in this example:
Create alert inspection. When the alert rule "Regional Transaction Ranking Analysis Failure Alert" in workspace 959211 is triggered, immediately push the alert to this chat window with problem diagnosis and solutions..
Result: After the command is sent, the AI assistant automatically subscribes to alert information triggered by the specified rule and replies with a confirmation message indicating that monitoring has started. From this point on, whenever the "Regional Transaction Ranking Analysis 02" task triggers a failure alert, the AI assistant proactively pushes a message in the DingTalk chat window. By default, the system scans for alert messages once every minute.
Keyword in the command: Alert inspection.
Alert service configuration adjustments:
Create an inspection:
Create alert inspection, monitor <workspace name>.Adjust inspection interval:
Alert service inspection interval 5 minutes.Modify alert source:
Alert service alert source channel phone,sms.Modify alert recipients:
Alert service alert contacts Zhang San, Li Si(separate multiple recipients with commas;allindicates all recipients).Manage monitored workspaces:
Alert service add monitoring <workspace name>/Alert service remove monitoring <workspace name>.Manage push targets:
Alert service add push to current group/Alert service remove push <group name>.
Step 5: Handle alerts through the AI assistant
Objective: The AI assistant pushes alert information and automatically fixes issues, forming a complete closed-loop handling process.
Problem addressed: Achieve automatic issue remediation through a mobile device.
General description: When an alert is pushed, it includes the root cause and a remediation plan. After you confirm that the plan is feasible, reply with an execution command to the AI assistant, and the AI assistant automatically performs the remediation operations.
Result: In this example, the constructed task failure scenario is caused by a partitioned table query that does not specify a partition filter condition, resulting in an error. When the alert is pushed, it includes the root cause and a remediation plan. After you confirm that the plan is feasible, reply with an execution command to the AI assistant. The AI assistant then automatically performs the following operations on behalf of "user D": modify the task code or configuration → deploy to the production environment → rerun the failed instance → resolve the alert. Throughout the entire process, you do not need to leave DingTalk or switch to a PC.
The following content simulates the complete interaction between user D and the AI assistant in an IM client (such as DingTalk).
1. Push alerts
When a task fails, the AI assistant proactively pushes an alert card in the IM group chat or private chat with the following content:
[Alert Inspection] - DataWorks Alert Diagnostic Report |
2026-07-09 13:15:42 |
Root cause: The SQL query did not specify a partition filter condition for the partitioned table |
Impact: The regional trade ranking analysis task cannot run, and trade data statistics are interrupted. |
Remediation steps (in execution order):
|
Preventive measures: When multiple users collaborate on the same node, communicate and coordinate to avoid later commits overwriting others' fixes. We recommend that you enable code change notifications to detect conflicts in a timely manner. |
2. Fix the issue
After reviewing the AI assistant's diagnosis and recommended plan on the mobile device, user D clicked the "Confirm Fix" button or directly replied with a confirmation command.
[User - user D]: Confirm fix3. Execution
After receiving the confirmation command, the AI assistant starts the remediation workflow and provides real-time status updates in the conversation.
[AI Assistant]: Command received. Executing the remediation workflow on your behalf...... [AI Assistant]: Remediation complete. The instance of task Regional Transaction Ranking Analysis 02 has been successfully rerun.4. Verification
After the remediation is complete, you can verify the results in the following ways:
Method 1 (IM client): The AI assistant proactively reports the final execution result, such as "The instance has been successfully rerun."
Method 2 (DataWorks console): Log on to the DataWorks console. On the Operation Center > Cycle Instances page, filter and view the instance of the
Regional Transaction Ranking Analysis 02task on the business date2023-10-26. The instance status should be displayed as successful.
Join the official communication group
First, click the application link to join the "Alibaba Cloud Big Data AI Platform" organization. Then scan the QR code below to join the AI assistant product DingTalk communication group. After joining, you can receive dedicated product technical support.
DingTalk group ID: 149605034971
DingTalk group QR code:
