快速入门RDS Agent（兼容Hermes Agent）-云数据库 RDS(RDS)-阿里云帮助中心

RDS Agent（兼容Hermes Agent）是基于开源Hermes Agent构建的数据库原生AI Agent服务，具备自然语言交互、专业能力扩展、安全访问和运行可观测等能力。本文介绍如何开通、配置和使用RDS Agent（兼容Hermes Agent）应用，包括配置模型服务、登录WebUI、纳管数据库，以及按需接入即时通讯通道。

免费试用与体验

RDS Agent（兼容Hermes Agent）现已上线免费试用活动，欢迎体验：

领取方式：点此领取和开通。开通时请选择包年包月。
体验规格：2核4 GB。
体验时长：自创建之日起1个月。
说明
请注意核对是否开启自动续费。
参与条件：每位新用户（同一阿里云实名认证）仅限领取一次。
费用说明：试用期间RDS Agent（兼容Hermes Agent）费用全免，模型调用费用（Token费用）按正常标准收取，不包含在免费试用额度中。

计费说明

开通和使用RDS Agent（兼容Hermes Agent）可能产生以下费用：

计费项目	说明
RDS Agent（兼容Hermes Agent）应用费用	创建RDS Agent（兼容Hermes Agent）应用实例的费用，与付费类型、实例规格和存储空间有关，具体以开通页面为准。
模型调用费用	取决于选择的模型服务、模型和实际调用量。
关联云资源费用	公网流量及其他关联云产品可能产生费用，具体以对应产品的计费规则为准。

模型调用支持以下方式：

模型服务	计费说明	适用场景
RDS智算包	购买指定规格的智算包，获得按月提供的基础Token额度，调用不同模型时按对应系数折算。智算包按规格分为S/M/L/XL/2XL/4XL共6种档位，对应的基础Token额度分别为每月5亿/15亿/40亿/100亿/200亿/400亿，具体以控制台为准。	用量相对稳定，希望通过固定规格控制预算。
百炼API Key	使用阿里云百炼平台颁发的API Key，按实际消耗的Token数量计费，详见千问Plus。	希望按实际调用量付费。
Token Plan	使用百炼Token套餐包中预购的Token额度。详细套餐说明请参见Token Plan 概述。	用量可预估，已购买Token Plan套餐。
Coding Plan	使用Coding Plan AI编码套餐的请求额度，达到时段限额后调用会报错且不计费用，可避免产生超出预期的费用。支持的模型列表请参见Coding Plan概述。	已开通Coding Plan，希望使用套餐支持的模型。

重要

配置免费额度用完即停：首次开通阿里云百炼时，会自动发放各模型的新人免费额度。免费额度消耗完后，默认将按模型列表中的价格与用量计费，建议开启免费额度用完即停功能，避免产生额外费用。

步骤一：开通RDS Agent应用

登录RDS管理控制台。
在左侧导航栏，单击AI能力中心 > RDS Agent，进入AI应用市场页面。
在AI应用市场页面，单击新建AI应用。

在RDS AI应用开通页面，配置以下参数：

参数名称	描述
付费类型	支持包年包月和按量付费。实际可选项以开通页面为准。
地域	选择应用实例所在的地域。建议与主要访问的RDS实例位于同一地域，以简化网络配置。
SLR 授权	进行服务关联角色授权。如果已授权，显示为AliyunServiceRoleForRds已授权，可忽略。如果未授权，请单击前往授权，并确定授权。
AI应用	选择RDS Agent（兼容Hermes Agent）。
AI应用名	自定义AI应用名称，长度为2~128个字符，以大小写字母或中文开头，可包含大小写字母、中文、数字、点号(.)、下划线(_)、半角冒号(:)或连字符(-)。
VPC	选择RDS Agent（兼容Hermes Agent）应用所在的专有网络VPC。如果当前地域没有可用的VPC，请单击前往创建，创建完成后返回刷新选择。
交换机	选择RDS Agent（兼容Hermes Agent）应用所在的交换机。如果当前VPC下没有可用的交换机，请单击前往创建。
规格	选择实例的CPU和内存规格，例如2核4GB。
存储空间	选择实例的存储空间大小，可选范围为60~1000 GB。存储空间支持扩容，暂不支持缩容，请合理规划需要使用的存储空间大小。
模型服务	选择模型服务的配置时机：立即设置：创建实例时同步开通模型服务。选择后需配置付费类型：包年包月：购买智算包，按规格分为S/M/L/XL/2XL/4XL共6种档位（如S档99元/月含5亿基础Tokens），不同档位对应不同的基础Token额度和月费。智算包内的额度以"基础Token"为单位，调用不同模型时按消耗系数折算扣减。按量付费：按实际消耗计费，无需预购套餐包，按实际使用的Token数量计费。稍后设置：跳过模型服务配置，创建实例后再进行设置。

确认配置无误后，阅读并勾选服务协议。
单击立即购买并完成支付。
返回AI应用市场页面，等待应用状态变为运行中。

步骤二：配置应用

在AI应用市场页面单击目标应用ID，进入应用详情页，然后完成模型服务、模型选择和访问地址配置。

1. 配置模型服务

如果创建应用时选择了稍后设置，或者需要更换现有配置，请执行以下操作：

在应用配置页签的API Key区域，单击配置或更新。
选择输入方式。
从列表中选择已有API Key，或按页面提示填写相应Key。
单击执行。
确认API Key状态显示为已配置。

输入方式与计费方式的对应关系如下。

输入方式	需要准备的内容
RDS智算包	已购买且当前账号可用的RDS智算包API Key。
百炼API Key	百炼平台颁发的API Key。
Token Plan	已关联Token Plan套餐的百炼API Key。
Coding Plan	Coding Plan套餐专属API Key。

重要

不要在对话、工单、日志或公开文档中粘贴API Key。

2. 选择模型

应用配置页会展示当前使用的模型。如需切换模型，请执行以下操作：

在当前模型区域单击配置。
从页面支持的模型列表中选择目标模型。
单击确定。
等待系统自动应用新配置，然后重新发起一次对话验证模型调用。

可选模型取决于当前模型服务类型和控制台支持情况，请以页面实际展示为准。

3. 绑定公网访问地址

如果需要从公网打开WebUI，请在应用配置页签单击公网访问绑定，为应用绑定公网地址。

绑定成功后，页面会展示公网WebUI地址，您可以在本机直接通过该地址访问WebUI。如需允许其他用户或服务访问应用，请参见下文步骤三：配置白名单。

如果仅在VPC或已连通的私网环境中访问，可以使用页面展示的私网地址，无需绑定公网地址。

步骤三：配置白名单（可选）

白名单管理页签展示应用关联安全组的入方向和出方向规则：入方向规则控制哪些来源可以访问RDS Agent（兼容Hermes Agent）应用，出方向规则控制RDS Agent可以访问哪些外部资源。

1. 添加入方向规则

绑定公网访问地址后，您可以在本机直接访问WebUI。如需允许其他用户或服务访问应用，请添加入方向规则，放行对应的来源IP地址和端口。页面支持快速添加和手动添加两种方式。

添加方式	适用场景	主要参数
快速添加	使用常见端口和常见网段快速创建规则。	授权策略、授权对象和端口范围。
手动添加	需要自定义协议、端口、优先级或多个授权对象。	授权策略、优先级、协议类型、端口范围和授权对象。

手动配置端口范围时，使用起始端口/结束端口格式，例如443/443。授权对象可以填写单个IP或CIDR地址段。

2. 添加出方向规则

出方向规则用于控制RDS Agent访问模型服务、数据库、即时通讯平台等外部资源，配置方式与入方向规则相同，一般保持默认即可。

如需收紧出方向访问，仅开放任务实际需要的目标地址和端口。如果RDS Agent需要访问私网数据库，还应确认VPC路由、数据库白名单和数据库安全组同时允许访问。

重要

不建议为了临时排查问题长期允许所有IPv4地址访问全部端口。生产环境应使用固定办公网、VPN、堡垒机或其他可信来源地址，并遵循最小权限原则。

步骤四：使用RDS Agent应用

完成配置后，您可以登录WebUI与RDS Agent（兼容Hermes Agent）对话，并通过纳管数据库体验智能运维和智能问数能力。

1. 登录WebUI

确认应用状态为运行中，并已完成模型服务配置。
在应用详情页单击打开WebUI。

WebUI打开后，输入以下问题验证基础对话能力。

请介绍你当前可以使用的能力，并说明哪些操作需要用户确认。

能够正常返回回答，表示模型服务和WebUI已完成基础验证。

2. 纳管数据库

纳管数据库后，RDS Agent（兼容Hermes Agent）才能围绕您的数据库提供智能运维和智能问数服务。

在应用详情页的数据库纳管页签，单击添加连接。
选择手动填写或选择RDS实例方式，配置连接名称、数据库类型、连接地址、端口、数据库名称、账号和密码。
建议开启只读模式，开启后该连接仅允许读操作。
单击保存，等待连接创建完成。

添加成功后，WebUI对话页面会展示RDS知识库和推荐问题。

3. 使用智能运维与智能问数

RDS Agent（兼容Hermes Agent）预置了RDS Copilot智能问答、RDS实例管理等技能，纳管数据库后，您可以在WebUI中直接用自然语言发起运维分析和数据查询。例如：

查询当前实例最近一天的慢SQL情况。
统计orders表最近7天每天的订单量。

更多使用示例，请参见RDS Agent 智能运维最佳实践和RDS Agent 智能问数最佳实践。

步骤五：配置即时通讯通道（可选）

除WebUI外，RDS Agent（兼容Hermes Agent）还可以接入以下即时通讯通道。

飞书：企业自建应用，通过WebSocket长连接接收事件，支持群聊或单聊，以及富文本或Markdown消息。
企业微信：API模式智能机器人，使用长连接，无需为机器人单独开放公网回调端口。
QQ：QQ机器人官方Bot API，使用WebSocket连接，支持与机器人单聊。
个人微信：扫描二维码，通过iLink Bot建立连接，无需手动创建应用凭据。

RDS Agent（兼容Hermes Agent）集成飞书

通过以下步骤将RDS Agent（兼容Hermes Agent）与飞书集成，让您可以在飞书群聊或单聊中与AI助手进行交互。

1. 创建飞书应用

访问飞书开放平台，单击创建企业自建应用，填写应用名称和描述，选择应用图标，单击创建。
在左侧导航栏单击凭证与基础信息，复制App ID（格式如cli_xxx）和App Secret。

在左侧导航栏单击权限管理，单击批量导入/导出权限按钮，粘贴以下JSON配置，单击下一步，确认新增权限，单击申请开通。

JSON配置文件内容

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

在左侧导航栏中单击添加应用能力，选择按能力添加页签，找到机器人卡片，单击配置。
配置事件订阅：
1. 返回RDS Agent（兼容Hermes Agent）应用的配置页面，在通道配置 > 飞书区域，填入之前获取的App ID和App Secret，并单击应用。
2. 在飞书开放平台左侧导航栏单击事件与回调，在事件配置页签中单击订阅方式，选择使用长连接接收事件（WebSocket 模式），单击保存。
3. 在事件配置页面，单击添加事件，搜索事件im.message.receive_v1（接收消息），单击确认添加。
在版本管理与发布页面创建版本，填写应用版本号和更新说明，单击保存，提交审核并发布。

2. 配置机器人

配置完成后，用户可以把机器人添加到某个群里，从而实现机器人和群内成员的互动。

说明

目前仅支持在飞书电脑端添加机器人。若需在外部群中使用机器人，可参考配置文档机器人支持外部群和外部用户单聊。

飞书应用的可见范围决定哪些用户可以使用机器人。发布前请同时检查应用权限和可见范围。

RDS Agent（兼容Hermes Agent）集成企业微信

通过API模式智能机器人将RDS Agent（兼容Hermes Agent）接入企业微信，使用长连接，无需为机器人单独开放公网回调端口。

在企业微信客户端进入工作台 > 智能机器人。
创建机器人，选择API模式和长连接方式。
保存生成的Bot ID和Secret。
返回RDS Agent（兼容Hermes Agent）应用详情页，在通道配置 > 企业微信中填写Bot ID和Secret。
单击应用并等待配置完成。
将机器人加入目标群聊，@机器人发送一条测试消息。

RDS Agent（兼容Hermes Agent）集成QQ

通过QQ机器人官方Bot API将RDS Agent（兼容Hermes Agent）接入QQ，使用WebSocket连接，支持与机器人单聊。

登录QQ开放平台，并从当前提供的机器人创建入口创建QQ机器人。
保存机器人的AppID和AppSecret。
返回RDS Agent（兼容Hermes Agent）应用详情页，在通道配置 > QQ中填写App ID和App Secret。
单击应用并等待配置完成。
在QQ中与机器人发起单聊，验证消息收发。

重要

Bot Secret、App Secret等凭据通常只在创建时展示或不支持再次明文查看。请妥善保管，不要在群聊或文档中公开。

RDS Agent（兼容Hermes Agent）集成个人微信

通过扫码将个人微信与RDS Agent（兼容Hermes Agent）建立连接，直接在微信中与AI助手对话，无需手动创建应用凭据。

在应用配置 > 通道配置区域找到个人微信。
单击扫码配置。
使用微信扫描页面生成的二维码。
确认页面显示连接成功。
在微信中向绑定的机器人发送消息，并在WebUI中确认能够看到对应会话。

控制台功能概览

应用详情页提供以下功能页签，可用于RDS Agent（兼容Hermes Agent）的日常管理和问题排查。

功能页签	主要用途
基本信息	查看应用ID、规格和访问地址等信息，支持变更配置和重置密码。
白名单管理	管理公网和私网访问的入方向、出方向白名单规则。
系统状态	查看RDS Agent服务及关键依赖是否正常。
会话管理	按时间、用户、模型或消息通道查看会话记录、更新时间和Token消耗。
用量分析	查看模型调用次数、Token消耗和用量趋势。
日志查看	按时间和级别检索网关、连接、Skill或工具的运行记录。
命令助手	在应用运行环境中辅助执行诊断或管理命令。
定时任务	按计划周期运行检查、汇总或通知任务。
技能管理	查看、启用或停用RDS Agent可调用的Skill。
数据库纳管	添加和维护数据库连接，并管理SQL防火墙、SQL模板和知识库。
身份认证	集中配置访问阿里云资源或外部服务所需的身份凭据。
配置管理	查看和维护应用运行配置。
环境变量	配置应用运行时使用的变量和敏感参数。

重要

应用ID、访问地址和登录凭据属于敏感信息，请勿公开传播。

常见问题

WebUI无法访问怎么办？

确认应用处于运行中，并检查访问地址、公网绑定、入方向规则和本地网络。使用私网地址时，还需要确认客户端与应用VPC网络互通。

模型调用失败怎么办？

检查API Key是否有效，输入方式是否与API Key类型匹配，套餐额度或账户余额是否可用，以及所选模型是否受当前模型服务支持。

即时通讯机器人无法回复怎么办？

检查通道状态和凭据是否正确，并确认机器人已发布、已加入目标群或对当前用户可见。飞书还需要确认长连接和消息接收事件已经启用。

RDS Agent无法访问数据库怎么办？

依次检查VPC路由、出方向规则、数据库白名单、数据库安全组、连接地址和数据库账号权限。生产数据库建议使用独立只读账号。

应用运行异常如何排查？

建议按以下顺序定位问题：先在系统状态页签确认服务和依赖是否正常，再通过会话管理页签定位任务时间和调用范围，然后结合日志查看页签确认失败环节，最后在用量分析页签检查模型调用和Token消耗是否异常。