How to use Atlan AI for documentation

Have more questions? Submit a request
πŸ§ͺ Preview feature! This feature is only available to select users for a limited period of time. The purpose of this closed preview is to allow participating users to experiment with the feature and provide valuable feedback. Once released in its final generally-available form, Atlan AI will be a paid addition to your Atlan suite. If you'd like to participate in the closed preview, reach out to your customer success manager for more information.
πŸ€“ Who can do this? Before using Atlan AI, you will need your admin user to enable Atlan AI in your Atlan workspace.

Atlan AI helps you automate the process of documenting your data assets. You can use Atlan AI to generate meaningful context for your assets and then simply review the content for accuracy and relevance. Accept, reject, or edit any AI-powered suggestions, the choice is yours!

You can use Atlan AI to:

  • Document tables and views with AI-generated descriptions
  • Document columns with AI-generated descriptions
πŸ’ͺ Did you know? To ensure full transparency, any changes made using Atlan AI will be marked as Updated using Atlan AI in the activity log.

Add a description to a table or view

You can use Atlan AI to add descriptions to your assets in Atlan and provide helpful context to your teams. Supported asset types include:

 

To add a description to a table or view using Atlan AI:

  1. From the left menu on any screen, click Assets.
  2. (Optional) Under the search bar on the Assets page, click the Table tab.
  3. (Optional) In the Filters menu on the left, click Properties to expand the menu and select Description to search for assets without a description.
  4. Click an asset to view the Overview tab in the sidebar.
  5. Under Description, navigate to the text box and click use Atlan AI to add an Atlan AI-suggested description to the table asset.
  6. Once Atlan AI has generated a description, you can:
    • Click anywhere in the text box to edit the text and then click Apply.
    • Click Apply to add the description to your asset.
    • Click Discard to discard the AI-generated description.
    • Click the retry button to generate a new description, compare the two to select the most relevant option, and then click Apply.
  7. (Optional) From the sidebar tabs on the right, click the Activity tab to view the changelog β€” including the Updated using Atlan AI stamp, user information, and timestamp for the update.

Your AI-suggested table or view description is now live! πŸŽ‰

Add a description to a column

You can use Atlan AI to add descriptions to your columns from the following:

  • Overview tab in the sidebar for column assets
  • Column preview section in the asset profile for table and view assets
  • Columns tab in the sidebar for table and view assets

Supported asset types include:

In this example, we'll use Atlan AI to add a description to a column from the Column preview section in a table asset profile.

 

To add a description to a column using Atlan AI:

  1. From the left menu on any screen, click Assets.
  2. (Optional) Under the search bar on the Assets page, click the Table tab.
  3. Right-click an asset and then select Open profile to view its asset profile. 
  4. From the asset profile, navigate to the Column Preview section and select a column to document.
  5. Under Description, click use Atlan AI to add an AI-generated description to the column.
  6. Once Atlan AI has generated a description, you can:
    • Click anywhere in the text box to edit the text and then click Apply.
    • Click Apply to add the description to your asset.
    • Click Discard to discard the AI-generated description.
    • Click the retry button to generate a new description, compare the two to select the most relevant option, and then click Apply.
  7. (Optional) From the sidebar tabs on the right, click the Activity tab to view the changelog β€” including the Updated using Atlan AI stamp, user information, and timestamp for the update.

Your AI-suggested column descriptions are now live! πŸŽ‰

πŸ’ͺ Did you know? If there are automated suggestions for asset descriptions, the option to use Atlan AI to document such assets will be unavailable. Automated suggestions are based on user-generated descriptions for similar assets and may be more accurate than Atlan AI-generated descriptions.

Related articles

Was this article helpful?
0 out of 0 found this helpful