Hologres Agent（原Hologres AI助手）

购买 Hologres Agent

购买 Hologres Agent 的操作步骤如下：

1. 登录Hologres 管理控制台，在左侧导航栏单击AI助手。

2. 如果当前地域未购买 Hologres Agent，页面提示当前地域暂未购买Hologres AI 助手，单击去购买。

3. 在新窗口打开的Hologres Agent 售卖页，选择与您的 Hologres 实例相同的地域，根据需要选择购买时长，完成购买。

4. 购买完成后，返回 Hologres 控制台刷新页面，即可查看已购买的 Hologres Agent 实例信息。

查看 Hologres Agent 实例

购买完成后，登录 Hologres 管理控制台，在左侧导航栏单击AI助手，在打开的页面中查看 Hologres Agent 的状态和管理信息。

• 如果当前地域未购买 Hologres Agent，页面提示「当前地域暂未购买Hologres AI 助手」，单击去购买前往售卖页购买。Hologres Agent 已停机时，按钮变为去续费。

• 购买成功后，页面显示 Hologres Agent 基本信息，包括以下字段：

  字段	说明
  AI 助手 ID	Hologres Agent 实例的唯一标识
  AI 助手状态	显示运行正常或已停机。可单击释放退订并释放 Hologres Agent 实例，释放后当前地域将无法继续使用 Hologres Agent。
  剩余天数	包年包月剩余天数。可单击续费跳转至续费页面延长使用时间。
  自动续费	显示当前自动续费状态。可单击开启自动续费或关闭自动续费跳转至续费管理页面设置。
  地域	Hologres Agent 所在地域
  开始时间	Hologres Agent 实例创建时间
  结束时间	Hologres Agent 实例到期时间

Hologres Agent 是地域级别的服务。购买某个地域的 Hologres Agent 后，该地域下的 Hologres 实例即可使用 Hologres Agent 的诊断能力，无需单独关联实例。在对话中输入 @ 即可指定本次对话的目标实例。

权限要求：需要 AliyunHologresFullAccess 权限才能购买、续费和释放 Hologres Agent。

快速使用

• 快捷键：输入/选择当前 Agent 支持的技能；输入@选择当前地域下的实例，指定实例进行对话或诊断。

• 场景模板：内置实例运维、产品咨询、数仓开发、数据分析四类共 15 个场景模板，可根据业务需求选择，也可以直接使用自然语言与 Agent 对话。模板清单请参见上文的场景模板表格。

对话输入框还提供强制沙箱、Auto、深度思考、完全访问权限等开关，可根据场景按需开启。

执行历史

在对话面板左上角单击菜单按钮，选择历史会话，即可查看对应的聊天历史，默认保留 7 天。每个用户只能查看自己的历史会话记录，无法查看其他账号的记录。

定时任务

支持为运维报告设置定时任务，无需每次手动触发即可按计划自动生成实例运维报告，并通过钉钉机器人推送到指定钉钉群。当前仅运维报告支持配置定时任务。

在对话面板左上角单击菜单按钮，选择定时任务，然后单击新建任务，配置以下参数。

文件及分享

运维报告、分析结果等文件产出会在文件入口集中展示，便于统一查看与管理。在对话面板左上角单击菜单按钮，选择文件即可进入，无论手动生成还是由定时任务生成的报告，均可在此查看完整内容与历史记录。文件也可以分享给他人，分享时支持以下两种访问范围。

• 指定用户：仅选中的用户登录后可访问。用户列表来自当前主账号下的所有 RAM 用户，选择用户后获取分享链接，被分享的用户登录阿里云后即可查看内容。

• 同企业用户：同一企业的登录用户均可访问，通过分享链接查看内容。

访问分享内容时需要登录，并通过服务端权限校验。

查看用量消耗

在AI助手页面的已购买状态区域下方，可以查看 Hologres Agent 的 Token 用量消耗。页面显示最后统计时间，单击刷新按钮可更新数据。通过汇总和明细两种视图切换查看用量信息：

• 汇总视图：以卡片形式展示三个时间维度的 Token 用量——昨日用量、近一周用量、近一月用量。

• 明细视图：以表格形式展示每次请求的详细 Token 消耗，支持通过 Request ID 或 User ID 搜索过滤。表格包含以下列：

  列名	是否支持排序
  Request ID	否
  User ID	否
  开始时间	是
  结束时间	是
  输入Token	是
  输出Token	是
  总Token	是

  明细表格支持分页，每页可选择 10、20 或 50 条数据。

管理 Hologres Agent 权限

购买、续费和释放 Hologres Agent 需要 AliyunHologresFullAccess 权限。

使用 Hologres Agent 诊断能力

使用 CPU 诊断、内存诊断、慢 SQL 分析时，数据来源为监控数据、实例内慢 SQL 日志、Table Info 等元仓表数据，需要以下权限：

• HoloRAM 权限：AliyunHologresReadOnlyAccess 或 AliyunHologresFullAccess。最小权限设置示例如下：

  {
    "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": "*"
      }
    ]
  }

• Holo 实例权限：Hologres Agent 仅支持主账号和 RAM 账号连接实例，不支持 Basic 账号。账号需具备实例连接权限以及慢 SQL 日志的访问权限，其中具备 pg_read_all_stats 或 Superuser 权限即可查看实例内所有的慢 SQL 与 Table Info 日志记录，详情参见授予查看权限。

• 云监控 RAM 权限：AliyunCloudMonitorFullAccess（云监控管理权限）或 AliyunCloudMonitorReadOnlyAccess（云监控只读权限）。

缺少上述任一权限，对应功能将无法正常使用。

历史记录

每个用户仅能查看自己的历史聊天记录，无法查看其他账号的历史记录。

运维报告

默认情况下，每个用户仅能查看自己生成的运维报告。如需让其他用户查看，可以在文件入口通过分享功能授权，详情请参见文件及分享。