Hologres AI Assistant is an intelligent assistant built into the Hologres console. Powered by large language models, it helps you use Hologres more efficiently. Whether you are new to Hologres or an experienced data engineer, you can interact with AI Assistant in natural language to quickly solve problems.
Typical use cases
AI Assistant covers the following typical scenarios when you use Hologres:
-
Knowledge Q&A: I'm new and want to get started with Hologres quickly
-
Don't know how to use a feature
-
Want to learn what scenarios Hologres is suitable for
-
Learn SQL best practices
-
-
Intelligent development assistance: I'm a developer and want to improve efficiency
-
Can't write SQL, need code assistance
-
Queries run slow, need optimization advice
-
Want to understand the correct usage of a feature
-
-
Instance diagnostics and operations: I'm in operations and need to troubleshoot issues
-
Slow queries on the instance
-
Want to analyze resource usage
-
Need performance tuning advice
-
-
SQL tuning: I'm a DBA and need to optimize SQL
-
Analyze slow SQL and error SQL
-
Get systematic SQL tuning recommendations based on SQL statements and execution plans
-
-
Intelligent data analysis: I'm an analyst and want self-service data access
-
Don't know SQL but need data
-
Want to quickly generate visualization reports
-
Need data interpretation and trend analysis
-
Activate AI Assistant
Before you use AI Assistant, you must purchase the service and activate the required permissions.
Purchase AI Assistant
-
Go to the AI Assistant purchase page, select the region that matches your Hologres instance, confirm the order, and complete the payment. For more information, see Billing standards.
-
If this is your first time activating the service, follow the page prompts to also activate DataWorks (see Purchase and activate DataWorks) and grant the AliyunServiceRoleForDataWorks service-linked role service-linked role. DataWorks does not incur additional charges — activation alone is enough.
-
After activation, log on to the Hologres Management Console and open the AI Assistant and AI Node page to see your AI Assistant instance. If the page reports that the DataWorks status cannot be detected, click Refresh on the page to re-check.
AI Assistant infrastructure depends on DataWorks. When activating AI Assistant, you must also activate DataWorks. There is no additional charge for DataWorks activation — activation alone is sufficient.
Billing standards
Before July 1, 2026, Hologres AI Assistant is in public preview at no charge.
Starting July 1, 2026, AI Assistant transitions to general availability with pay-as-you-go billing based on token consumption. For more information, see Hologres AI Assistant billing announcement.
The following table lists the billing rates and supported regions.
Region |
Billable item |
0 < Tokens per request ≤ 256K |
256K < Tokens per request ≤ 1M |
China regions:
| Input (USD/1K tokens) | 0.00240 | 0.00960 |
Explicit cache creation (USD/1K tokens) | 0.00300 | 0.01200 | |
Explicit cache hit (USD/1K tokens) | 0.00024 | 0.00096 | |
Implicit cache hit (USD/1K tokens) | 0.00048 | 0.00192 | |
Output (USD/1K tokens) | 0.01440 | 0.05760 | |
International regions:
| Input (USD/1K tokens) | 0.00033 | 0.00132 |
Explicit cache creation (USD/1K tokens) | 0.00041 | 0.00165 | |
Explicit cache hit (USD/1K tokens) | 0.00003 | 0.00013 | |
Implicit cache hit (USD/1K tokens) | 0.00007 | 0.00026 | |
Output (USD/1K tokens) | 0.00198 | 0.00792 |
Access AI Assistant
After activation, you can access AI Assistant through the Hologres console or HoloWeb. The following steps use the Hologres console as an example:
-
Log on to the Hologres Management Console.
-
In the left-side navigation pane, click AI Assistant and AI Node.
-
Click the AI Assistant tab at the top of the page.
If you have not activated AI Assistant, the page displays This account has not activated HoloAI Assistant. Click Buy Now to complete activation.
Use AI Assistant
View AI Assistant instance information
After you open the AI Assistant tab on the AI Assistant and AI Node page, the page header shows the basic information of your AI Assistant instance, which helps you manage the instance and monitor usage:
|
Field |
Description |
|
AI Assistant ID |
The unique identifier of the AI Assistant instance, for example |
|
AI Assistant status |
The running status of the instance. When the status is Normal, the instance is ready to use. Click Release to release the instance. |
|
Remaining days |
The number of days remaining before the instance expires. Click Renew to extend the validity period. |
|
Auto-renewal |
Indicates whether auto-renewal is enabled. Click Enable Auto-Renewal to prevent the instance from being released on expiration. |
|
Region |
The region where the AI Assistant instance is located. |
|
Start time / End time |
The start and end of the instance validity period. |
|
Usage |
Displays the Token usage for yesterday, the last 7 days, and the last 30 days. Switch between Summary and Details views, and click the refresh icon to retrieve the latest statistics. |
Use the chat panel
On the AI Assistant tab, click the floating AI Assistant icon in the lower-right corner to open the chat panel and start interacting with AI Assistant. The chat panel contains the following areas:
-
Suggested prompts: When you first open the chat panel, the welcome page lists example questions (such as "What can Hologres AI Assistant do?" and "How do I accelerate a data warehouse?"). Click any prompt to start a conversation.
-
Input box: Type your question in the input box at the bottom of the chat panel and press Enter or click the send button to submit.
-
Answer area: Responses are rendered in Markdown, including headings, lists, and SQL code blocks (with a one-click copy button). Each answer ends with an expandable Knowledge Retrieval panel that shows the referenced documents, and a response time indicator.
-
New chat: Click the New chat button in the upper-right corner of the chat panel to clear the current session and start a new conversation. The current session is automatically saved to chat history.
-
Chat history: Click the Search history button in the upper-right corner to open the Chat history panel and view or search past conversations. The panel lists conversation titles in reverse chronological order and shows a note that only the last 7 days of conversations are retained, along with the current record count.
FAQ
Q: Can AI Assistant access my business data?
A: No. AI Assistant does not connect to your Hologres instances and cannot access data stored in your instances.
Q: Why are some answers not accurate?
A: Try providing more context in your question, such as table structures, SQL statements, or specific error messages. This helps AI Assistant generate more relevant responses.
Q: Does using AI Assistant affect instance performance?
A: No. All AI Assistant operations are read-only and target only metadata. They do not affect the performance of your business queries.