ADBAgent入门指南

三层数据探索

ADBAgent 采用"按需分层、逐层递进"的智能策略，将数据探索标准化为三个层次，以最小成本提供全链路数据洞察。

核心价值：简单问题秒级响应，复杂问题深度洞察，让数据分析更精准、更高效。

数据分析行业 Skills

在广告营销与效果归因领域，ADBAgent 内置转化率分析、投放诊断等行业级 Skills，构建了一套"从宏观趋势到微观根因，再到策略闭环"的深度诊断体系。

步骤一：创建集群

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 范围，确保分析逻辑和数据口径的一致性。

前提条件

OpenClaw 调用 ADBAgent 前，需要先将 OpenClaw 所在机器的出口公网 IP 地址加入 ADBAgent 的白名单。具体操作，请参见步骤四：设置白名单。

Channels接入

如果您的OpenClaw已接入钉钉、飞书等通讯工具，那您可以直接通过这些工具，借助OpenClaw和ADBAgent交互。

接入方式

1. 获取 Skill

   ADBAgent 通过 Skill 与 OpenClaw 集成，请联系研发团队获取相关 Skill。获取 Skill 压缩包后，解压并放置到 OpenClaw 的 Skill 目录下。

   参考路径：~/.openclaw/workspace/skills/

2. 写入访问信息

   将 ADBAgent 的访问信息填写到 ADBAgent Skill 目录下的 config.json 文件中。访问信息请联系研发团队获取。

3. 验证 Skill 识别

   检查 OpenClaw 是否已自动识别 ADBAgent Skill，可通过以下任一方式：

   • OpenClaw Dashboard：技能 > Refresh > Workspace Skills。

   • Shell 命令：openclaw skills。

   如果未识别到该 Skill，可尝试重启 OpenClaw：openclaw gateway restart。

4. 开始使用

   直接在 OpenClaw 中通过自然语言发送指令，例如：

   • "用 ADBAgent 帮我分析 xxx"

   • "用 ADBAgent 帮我分析 xxx，使用 xxx 数据库表和 xxx 技能。"

输出模式

ADBAgent Skill 默认使用 Summary 模式，仅展示分析过程中的关键信息。如需查看更详细的中间过程或 SQL 执行结果，可使用 Verbose 模式，通过自然语言指定即可，例如：

• "用 ADBAgent 的 verbose 模式，帮我分析 xxx"

• "用 ADBAgent，我要看详细过程，帮我分析 xxx"