Hologres:Hologres Agent (formerly Hologres AI Assistant)

Purchase Hologres Agent

To purchase Hologres Agent, perform the following steps:

1. Log on to the Hologres console. In the left-side navigation pane, click AI Assistant.

2. If Hologres Agent has not been purchased in the current region, the page prompts you to purchase it.

3. Click Buy Now. The Hologres Agent purchase page opens in a new browser tab.

   Note

   Hologres Agent is a region-level service. Make sure that you select the region that matches your Hologres instances. After the purchase, Hologres Agent becomes available to all Hologres instances in that region.

4. On the purchase page, select a subscription duration and complete the payment.

5. After the purchase is complete, return to the Hologres console and refresh the page. The page displays your Hologres Agent instance information.

If your Hologres Agent subscription has expired and the instance status is Stopped, click Renew to go to the renewal page and extend your subscription.

View the Hologres Agent instance

After the purchase is complete, log on to the Hologres console. In the left-side navigation pane, click AI Assistant to verify that Hologres Agent is activated.

Hologres Agent is a region-level service. After you purchase Hologres Agent in a region, every Hologres instance in that region can use its diagnostic capabilities. You do not need to associate instances one by one. To target a specific instance in a conversation, enter @ and select the instance.

Permission requirement: the AliyunHologresFullAccess policy is required to purchase, renew, and release Hologres Agent.

The page displays different content depending on the purchase status:

• Not purchased: The page displays a message indicating that Hologres Agent has not been purchased in the current region. Click Buy Now to go to the purchase page. If Hologres Agent has been suspended, click Renew to go to the renewal page.

• Purchased: The page displays the following information about your Hologres Agent instance:

  Field	Description
  AI Assistant ID	The unique identifier of the Hologres Agent instance.
  AI Assistant Status	The current running status: Normal or Stopped. Click Release next to the status to unsubscribe and release the Hologres Agent instance.
  Days Remaining	The number of days until the subscription expires. Click Renew to go to the renewal page and extend the subscription period.
  Auto-Renewal	Whether auto-renewal is enabled. Click Enable Auto-Renewal or Disable Auto-renewal to toggle this setting. The link redirects you to the renewal management page.
  Region	The region where Hologres Agent is deployed. This must match the region of your Hologres instances.
  Start Time	The time when the Hologres Agent instance was activated.
  End Time	The time when the current subscription expires.

Quick start

• Shortcuts: Enter / to choose a skill that the agent supports. Enter @ to choose an instance in the current region for a conversation or diagnostics.

• Scenario templates: 15 built-in templates are grouped into Instance operations, Product guidance, Warehouse development, and Data analysis. Pick the one that matches your task, or talk to the agent in natural language without using a template. For the full list, see the scenario template table above.

The input box also provides the Sandbox, Auto, Deep thinking, and Full Access switches. Enable them as needed.

Execution history

In the upper-left corner of the chat panel, click the menu button and select Conversation history to view your past conversations, which are retained for 7 days by default. Each user can view only their own session history, not the history of other accounts.

Scheduled tasks

You can create a scheduled task for an operations report so that the report is generated on schedule without manual triggering, and pushed to a DingTalk group through a DingTalk chatbot. Scheduled tasks are currently supported only for operations reports.

In the upper-left corner of the chat panel, click the menu button and select Scheduled tasks. Then click New task and configure the following parameters.

Files and sharing

Files such as operations reports and analysis results are listed in the Files entry for centralized viewing and management. To open it, click the menu button in the upper-left corner of the chat panel and select Files. Reports appear here whether you generate them manually or through a scheduled task, together with their full content and history. You can also share a file with others. The following access scopes are supported.

• Specified users: Only the selected users can access the file after they log on. The user list contains all RAM users under the current Alibaba Cloud account. After you select users, you obtain a sharing link, and the shared users can view the content after they log on to Alibaba Cloud.

• Users in the same enterprise: All logged-on users in the same enterprise can access the file through the sharing link.

Accessing shared content requires logon and passes server-side permission verification.

Monitor token usage

Below the basic information section, the Usage Consumption area displays your Hologres Agent token usage statistics. The Last Calculation Time is shown in the upper-right corner along with a refresh button.

You can switch between two views:

• Summary: Displays three cards showing token consumption over different time ranges:

  Card	Description
  Yesterday's Usage	The total number of tokens consumed on the previous day.
  Weekly Usage	The total number of tokens consumed in the last 7 days.
  Last Month's Usage	The total number of tokens consumed in the last 30 days.

• Details: Displays a table of individual request records. You can filter records by selecting Request ID or User ID from the drop-down list and entering a search value. The table contains the following columns:

  Column	Sortable
  Request ID	No
  User ID	No
  Start Time	Yes
  End Time	Yes
  Enter a Token	Yes
  Output Token	Yes
  Total Tokens	Yes

  The table supports pagination with 10, 20, or 50 records per page.

Permission for managing Hologres Agent

The AliyunHologresFullAccess policy is required to purchase, renew, and release Hologres Agent.

Permissions for diagnostic capabilities

CPU diagnostics, memory diagnostics, and slow SQL analysis rely on monitoring data, the instance's slow SQL log, and metadata tables such as Table Info. The following permissions are required:

• HoloRAM permission: AliyunHologresReadOnlyAccess or AliyunHologresFullAccess. The following is a minimal-permission example:

  {
    "Version": "1",
    "Statement": [
      {
        "Effect": "Allow",
        "Action": [
          "hologram:GetInstance",
          "hologram:GetExecuteStatementEnabled",
          "hologram:EnableExecuteStatement",
          "hologram:ListDatabases",
          "hologram:ListWarehouses",
          "hologram:ExecuteStatement"
        ],
        "Resource": "*"
      },
      {
        "Effect": "Allow",
        "Action": [
          "cms:DescribeMetricList"
        ],
        "Resource": "*"
      }
    ]
  }

• Hologres instance permission: Hologres Agent supports only Alibaba Cloud account and RAM user authentication for instance access; Basic accounts are not supported. The account must have connection permission and slow SQL log access. The pg_read_all_stats role or Superuser privileges are sufficient to view all slow SQL and Table Info records in the instance. For more information, see Prerequisites.

• CloudMonitor RAM permission: AliyunCloudMonitorFullAccess (full access to CloudMonitor) or AliyunCloudMonitorReadOnlyAccess (read-only access to CloudMonitor).

If any of the above permissions is missing, the corresponding feature is unavailable.

Chat history

Each user can view only their own chat history and cannot see the history of other accounts.

Operations reports

By default, each user can view only the operations reports that they generated. To let other users view a report, share it from the Files and sharing entry.