ADBAgent 快速入门

步骤一：创建集群

1. 登录云原生数据仓库AnalyticDB MySQL控制台。单击页面右上角购买实例。

2. 在购买页面，配置以下核心参数快速完成选型，其他参数按需选择或保持默认即可。如需了解更多参数信息，请参见创建集群。

   • 商品类型：选择按量付费。

   • 版本：选择企业版（多副本）。

   • 部署模式：选择单可用区部署。

   • 地域及主可用区：当前ADBAgent仅支持华东1（杭州）、华东2（上海）、华北2（北京）地域。

   • 自动开通PVL服务：勾选。

   • 预留资源节点数：根据需要设置。当设置为0时，不支持创建和读写内表，只支持创建和读写外表。

3. 单击立即购买，然后按照控制台提示完成后续购买操作。

   支付成功后，大约需等待10～15分钟，在集群列表页待集群状态变为运行中表示创建完成。

步骤二：创建数据库账号

ADBAgent 连接 AnalyticDB for MySQL 集群需要数据库账号，不同账号对应不同数据库权限。

1. 在集群列表页，单击目标集群ID，进入集群详情页。

2. 在左侧导航栏，单击账号管理。

3. 在用户账号页签下，单击创建账号。需要分别创建以下两个账号类型的数据库账号：

   1. 高权限账号：用于管理普通账号的权限。

   2. 普通账号：该账号将用于 ADBAgent 的数据库连接。

4. 配置普通账号权限。

   单击普通账号所在行操作列 ⋮ 按钮的编辑权限，按需选择权限配置，建议选择查询权限。

步骤三：初始化 ADBAgent

1. 在集群详情页左侧导航栏，单击ADBAgent（AI 助手）。

2. 单击免费试用。

   首次进入时，系统自动初始化，预计等待约 2 分钟。

步骤四：设置白名单

访问 ADBAgent 前，需要先将 ADBAgent 服务对公网开放，并通过网络白名单机制限制访问来源，确保只有指定 IP 可以访问。

1. 在ADBAgent（AI 助手）页面，单击白名单设置区域右上角的添加白名单分组。

2. 在添加白名单分组对话框中设置以下信息。

   • 分组名称：自定义。

   • 组内白名单：需要访问ADBAgent的机器公网IP地址或IP段。查看机器出口IP方法：

     • Shell命令行执行：curl ifconfig.co/json

     • 浏览器网页访问：https://ipconfig.com/zh

3. 单击确定。

步骤五（可选）：开通公网访问能力

当使用 ADBAgent 如下能力时，需要创建公网NAT网关，以开通公网访问能力：

• Channel 对接：连接钉钉/飞书等通讯工具。

• 智能诊断：使用 AnalyticDB for MySQL AI 诊断 Skill 实现对集群的快速诊断。

• 公网数据源：配置的数据源需要通过公网连接。

创建步骤：

1. 获取 AnalyticDB for MySQL 集群VPC和交换机信息。

   1. 登录云原生数据仓库AnalyticDB MySQL控制台，在左上角选择集群所在地域。在左侧导航栏，单击集群列表，然后单击目标集群ID。

   2. 在左侧导航栏，单击集群管理 > 集群信息。

   3. 在网络信息区域，查看VPC ID和交换机ID。

2. 创建公网 NAT 网关并绑定 EIP。

   1. 前往NAT 网关 - 公网 NAT 网关购买页。

   2. 配置公网NAT网关信息。

      • 地域：选择 AnalyticDB for MySQL 集群所在地域。

      • 网络及可用区：选择步骤1中获取的VPC和交换机信息。

      • 弹性公网IP：如果已创建 EIP 则选择已有，否则选择新购弹性公网IP。

   3. 单击立即购买。

3. 配置 SNAT 条目。

   1. 前往公网NAT网关控制台，在左侧导航栏选择NAT网关 > 公网NAT网关，然后单击新创建的NAT网关。

   2. 选择SNAT管理页签，然后单击创建SNAT条目。

   3. 选择弹性公网IP，然后单击确定创建。

步骤一：访问ADBAgent

1. 在 ADBAgent（AI 助手） 页面，单击目标服务所在行操作列的凭证，查看默认账号和默认密码。

2. 单击访问，使用默认账号和密码，即可登录 ADBAgent，开始使用。

步骤二：配置数据源

在ADBAgent页面，单击左侧导航栏的数据接入，进入数据源配置。ADBAgent 支持接入多种数据源进行数据分析，具体配置如下。

步骤三：发起分析任务

在左侧导航栏，单击新任务，然后在输入框中描述分析需求并发送。ADBAgent 自动完成意图理解、匹配 Skills、分层数据探索和 SQL 执行，并以结构化结果呈现。

• 指定场景与 Skills（可选）

  在输入框中单击 + 按钮选择分析场景，或输入 /Skill名称 直接调用特定分析 Skills，系统在对应的数据范围和分析逻辑下执行任务。分析场景与Skill配置，请参见下文。

• 多轮对话交互

  复杂数据分析场景支持多轮对话：

  • 追问分析：基于返回结果继续提问，深入挖掘数据价值。

  • 纠错修正：分析结果不符合预期时，直接指出问题，系统自动调整分析逻辑。

  • 新增需求：在分析过程中随时追加新的分析维度或筛选条件。

步骤四：将分析任务沉淀为 Skills

支持将分析过程沉淀为可复用的分析 Skills。在分析任务中，通过自然语言描述（如"将这个任务总结为一个 Skill，放到我的 Skills 里面"），即可将完整分析逻辑创建为 Skills，后续可直接调用。

步骤五：保存为分析场景

对于高频使用的业务场景，支持保存为可复用的分析场景，实现分析过程的稳定复现。

1. 在左侧导航栏，单击业务场景，进入业务场景（Plugin）页面。

2. 单击创建场景 Plugin，然后填写场景名称和描述。

3. 关联目标数据表（支持从数据库直接选择）。

4. 绑定所需的 Skills。

5. 保存后，在新建任务时选择该场景即可限定分析范围和 Skills 范围，确保分析逻辑和数据口径的一致性。

Skills 管理

在左侧导航栏，单击算子库，进入算子库（Skills）页面，管理分析 Skills。

• 交互式创建：单击创建你的技能，通过与 AI 对话描述分析需求，系统自动生成 Skills（除从分析任务创建外的另一种方式）。

• 内容精调：直接修改 Skills 内容，对分析逻辑进行人工订正。

• 公开技能市场：浏览社区 Skills，按分类筛选查找现成能力。

OpenClaw 集成

ADBAgent 支持与用户现有 OpenClaw 进行集成，将数据分析能力无缝接入当前的自动化工作流中。