Intelligent generation - Dataphin - Alibaba Cloud Documentation Center

The intelligent generation feature uses asset metadata, such as asset source and status, and leverages large models to generate system properties for assets in batches. These properties include display names, descriptions, asset tags, and parent directories. After you confirm the information, you can list the assets in batches with a single click. This feature significantly improves the efficiency of asset listing. This topic describes how to create and manage intelligent generation tasks for table and technical metric assets.

Prerequisites

You must purchase the X-Directory Management and Asset Operation features to use intelligent generation.

Limits

Intelligent generation is supported only for specific system properties of table, field, and technical metric assets.
Intelligent generation task records are retained for only 90 days.

Permissions

Super administrators, system administrators, and users with custom global roles that have Listing Management - Manage permissions can create and manage intelligent generation tasks.

Create an intelligent generation task

You must enable the X-Directory Management intelligent application before you can create an intelligent generation task.

On the Dataphin homepage, go to Super X > Intelligent Application Management in the top menu bar.
In the navigation pane on the left, click Intelligent Application. On the Intelligent Application page, complete the model call configuration and enable the X-Directory Management intelligent application.
On the Dataphin homepage, go to Asset > Directory Management in the top menu bar.
In the navigation pane on the left, choose Auto Listing > Intelligent Generation. On the Intelligent Generation page, click the New Intelligent Generation Task button in the upper-right corner.

In the New Intelligent Generation Task dialog box, configure the parameters.

Parameter		Description
Basic Information	Task Name	Enter a name for the intelligent generation task. The name must be globally unique and cannot exceed 128 characters.
Asset Selection	Asset Type	Select the asset type for intelligent generation. Table and Metric assets are supported.
Asset Selection	Asset Scope	Define the asset scope to filter for the assets that require intelligent generation. You can filter by asset status (the "Temporarily Unlisted" status is not supported for this condition), full asset name, asset name, asset display name, asset source, and asset tags. Asset Status (the "Temporarily Unlisted" status is not supported for this property) and Asset Source: The supported filter conditions are Is and Is Not. Belongs To/Does Not Belong To: When the asset property is Asset status, you need to select a summary status for the asset. Supported statuses include pre-listing assets (including Unlisted, Listing failed, and Temporary delisting failed) and listed assets (including Listed, Update pending listing, Update listing failed, and Delisting failed). When the asset property is Asset source, you can select the asset source that corresponds to the scope of intelligently generated assets. Full Asset Name, Asset Name, and Asset Display Name: The supported filter conditions are Prefix Match, Suffix Match, Contains, Is, and Is Empty (only supported for Asset Display Name). Prefix Match, Suffix Match, and Contains: You can enter up to 256 characters. Is: You can select up to 500 assets. Is Empty: No configuration is required. Asset Tag: The supported filter conditions are Contains Any and Contains All. Custom global roles with Listing Management-Manage permissions can click the Tag Management button to navigate to the Asset > Folder Management > Other Settings > Basic Settings page to create a new tag. Contains Any: The asset must have at least one of the selected tag values to meet the condition. Contains All: The asset must have all of the selected tag values to meet the condition. Note You can configure a maximum of 10 filter conditions. The relationship between filter conditions can be configured as AND or OR.
Property Configuration	Table Properties/Field Properties/Metric Properties	Select the system properties of the asset for which you want to use intelligent generation. When the Asset Type is table, you can select Table Property, Field Property, and Metric Property (available only for metric listing management). When the Asset Type is metric, you can select Metric Property.
Property Configuration	Auto-detect Metrics	This can be configured when the asset type is Table. It is disabled by default. When disabled, custom metrics that may exist in the table are not automatically detected. If you also select metric properties, the system only intelligently generates the selected system properties for existing modeled metrics and custom metrics in the table. When enabled, custom metrics that may exist in the table are automatically detected. If you also select metric properties, the system intelligently generates the selected system properties for all metrics. Note The system only performs auto-detection for tables that support custom metrics (excluding logical tables and logical views). When generating properties for a single table, you must manually select the data category. During batch generation, if a table has an unconfigured data category, the system skips detection for that table. You can manually configure it and then run the detection again.

Click OK to create the intelligent generation task.

Manage intelligent generation tasks

The Intelligent Generation page lists all created tasks and displays the following information for each task: Task Name/Asset Type, Generated Properties, Total Assets, Generation Progress, Review Status, Creator, and Creation Time.
Total Assets: For table assets, this is a count of the tables, not the metrics.
You can search for tasks by name, filter them by asset type, creator, or generation progress, or use the Created By Me quick filter.
In the Actions column for a specific task, you can perform the following operations.
- View: Click this option to open the task details page. On this page, you can view successfully generated assets and assets that failed to generate, and perform other operations. For more information, see the Intelligent generation asset list section below.
- Delete: This operation is not available while a task is in progress. Deleting a task also deletes all its generated content. This action cannot be undone, so proceed with caution.

Intelligent generation asset list

Area	Description
① Basic information	Displays the task name, asset type, generation progress, asset scope, and generated property information. View selection rules: Hover over the view icon to see the asset scope configured for the task.
② Search	Generation Successful: You can search by full asset name or filter by asset source or review status. Generation Unsuccessful: You can search by full asset name or use quick filters for assets that are Pending Generation, In Progress, Stopped, or Generation Failed.
③ Task list	Displays the lists of successfully generated and unsuccessfully generated assets. You can select up to 10,000 assets for a single batch operation. Generation Successful: Displays the results for all selected assets where generation was required and completed successfully. This includes assets that are Pending Review, or have been set to Applied or Discarded. For assets with Applied/Discarded status, the latest saved property values are displayed (which may differ from the results at the time of the operation). You can edit, apply, discard, or regenerate properties for these assets. Generation Unsuccessful: Displays the selected assets for which intelligent generation was not successful. This includes assets that are Pending Generation, In Progress, Generation Failed, or manually Stopped. You can stop or regenerate properties for these assets. Generation successful This tab displays the asset's Name/Source, Display Name, Parent Directory, Tags, Description, Fields/Metrics, Review Status, and latest Listing Status. The Display Name, Parent Directory, Tags, and Description columns are shown based on the generation task configuration. Only properties selected for intelligent generation are displayed. Display Name, Parent Directory, Tags, Description: When the review status is Pending Review, the first row shows the latest saved value for the property, and the second row shows the intelligently generated value. When the review status is Applied/Discarded, the latest saved value for the property is shown. You can also perform the following operations on the assets. Edit: This operation is available only for assets whose listing status allows editing. Click anywhere on the asset's row (except the Actions column) or click the Edit icon in the Actions column to open the Intelligent Property Generation panel for the asset. This panel shows the intelligently generated property information. By default, it only displays the asset name and the properties selected for intelligent generation. To view or edit more content, deselect Show Only Intelligently Generated Properties in the upper-right corner. After confirming all information is correct, apply or list the asset. For more information, see Intelligent generation asset details. Apply: This operation is available only for assets in the Pending Review status. Click Apply in the Actions column, or select assets and click Application at the bottom to use the information from this intelligent generation task. Applying the changes saves the modifications to the asset using the latest intelligently generated content. This operation is available only for assets that can be edited. Discard: This operation is available only for assets in the Pending Review status. Click Discard in the Actions column, or select assets and click Discard at the bottom to discard the information from this intelligent generation task. Alternatively, you can regenerate the information directly. Edit Properties: Select assets and click Edit Properties at the bottom to complete the property information for the selected assets. For more information, see Modify properties. Regenerate: Single operation: In the Actions column, click More and select Regenerate. The relevant properties are regenerated according to the task configuration, and the asset is automatically moved from the Generation Successful list to the Generation Unsuccessful list. Batch operation: Select assets and click Regenerate at the bottom. In the Regenerate For Selected Assets dialog box, select the assets to regenerate based on their review status. List: This operation is the same as the list operation in the Manual Listing > Pre-listed Assets list. For more information, see List assets. Generation unsuccessful This tab displays the asset's Name, Asset Source, Generation Status, and Failure Reason. You can also perform the following operations on the assets. Stop: This operation is available when the generation status is In Progress. Click Stop in the Actions column, or select assets and click Stop at the bottom. This stops the generation of property information that is in progress or pending. You can regenerate it later. Regenerate: This operation is available when the generation status is Stopped or Generation Failed. Click Regenerate in the Actions column, or select assets and click Regenerate at the bottom. The relevant properties are regenerated according to the task configuration. Assets that are currently being generated are automatically skipped.

Intelligent generation asset details

The configuration is similar to that of the Intelligent Generation feature for editing pre-listed assets. The differences are described in the table below.

Parameter	Description
Basic Information	You can modify the intelligently generated property information. Tag: Users with a custom global role that has the Listing Management - Manage permission can click the Tag Management button to go to the Asset > Folder Management > Other Settings > Basic Settings page to create a new tag.
Field Information	The corresponding columns are displayed based on the properties configured when the intelligent generation task was created. If auto-detect metrics is enabled, you can configure the business type for fields. Note that if a table has an unconfigured or deleted data category, the system skips detection. You can manually configure the data category and then run the detection again.
Related Metrics	This section is displayed only for custom metric assets. The corresponding columns are displayed based on the properties configured when the intelligent generation task was created. You can click Clear next to Directory or Tags to clear the intelligently generated information with one click. If you select Overwrite Unlisted Metric Properties With Table Properties, when you save the table asset, properties of unlisted metrics such as Display Name, Description, Visibility, Data Profiling Report (if any), Data Lineage, Quality Overview (if any), and Asset Maintainers are overwritten with the table's properties.

After you confirm that all information is correct, click Application to apply the property information generated by the task.

You can perform different operations on the asset details page, depending on the asset's review status.

Pending Review: Discard, Apply, Regenerate, Apply and List.

Generated/Discarded: Cancel, Save, Regenerate, Save and List.

Discard: Discards the property information generated by this task.
Regenerate: Regenerates the property information.
Continue Generation: This operation is available only for assets with a stopped status. It resumes the generation of property information.
Apply and List: Applies the property information from this intelligent generation task and lists the asset in the directory. The listing operation is the same as that on the Manual Listing > Pre-listed Assets page. For more information, see List assets.
Cancel/Save: Cancels or saves the changes to the property information generated by this task.
Save and List: Saves the property information from this intelligent generation task and lists the asset in the directory. The listing operation is the same as that on the Manual Listing > Pre-listed Assets page. For more information, see List assets.