瑶池数据库Agent

更新时间:
复制 MD 格式

瑶池数据库Agent(ApsaraDB Agent)是集成于瑶池数据库控制台的智能助手,旨在帮助用户更高效地管理和使用阿里云数据库。它为所有阿里云数据库产品提供统一的产品咨询与知识问答,并提供实例诊断与分析等深度智能服务。

核心能力

瑶池数据库Agent具备以下通用能力,旨在提升您管理和使用数据库的效率。

数据库全产品知识问答

您可以随时向Agent咨询关于阿里云数据库产品的功能、价格、最佳实践等问题。Agent会基于官方文档和知识库,为您提供准确、及时的回答。

image

实例诊断与分析

当数据库实例出现性能问题或异常时,您可以触发Agent进行智能诊断。Agent会分析相关指标和日志,帮助您快速定位问题根源。

说明

该功能当前仅支持云原生数据库 PolarDB和云数据库Tair(兼容Redis),后续将逐步支持其他数据库产品。

image.png

使用须知

欢迎您体验瑶池数据库Agent!在使用前,请您仔细阅读并理解以下条款:

  1. 内容准确性与服务可靠性:本服务输出的生成内容由人工智能模型生成,阿里云不对其准确性、完整性、安全性、可靠性及可用性作绝对保证。所有生成内容均不代表阿里云的立场或观点。对于您使用本服务所产生的结果,阿里云不承担任何责任。请您谨慎判断并使用生成内容,切勿过度依赖。

  2. 用户责任:您需对您使用本服务的所有行为负责。请确保您通过本服务发布、上传或传输的任何内容均符合法律法规,不侵犯任何第三方合法权益,不传播虚假信息。

  3. 数据收集与授权:为了向您提供服务,本服务会收集和处理您数据库实例的必要信息,包括基本信息、系统表信息、监控指标、事件以及日志中的关键错误信息。当您开始使用本服务时,即表示您已理解并同意以上所有条款。

使用方式

您可以通过以下入口与瑶池数据库Agent进行交互:

通用入口

单击瑶池数据库控制台的左侧、右侧边栏的image按钮,您可以随时唤起Agent对话窗口。

实例诊断与分析入口

在特定的管理和运维场景下(如资源列表、实例详情页),系统会提供触发Agent的快捷入口,帮助您结合当前上下文进行问题诊断或操作。当前仅支持云原生数据库 PolarDB和云数据库Tair(兼容Redis)产品,具体请参考PolarDB AI助手、Tair AI助手,其他产品陆续支持中。

  1. 进入瑶池控制台资源管理页面,单击需要诊断与分析的实例的AI巡检按钮。

  2. 在右侧弹出对话框中选择巡检项目和时间范围后单击开启巡检。

    image

MCP Server开源项目

瑶池数据库Agent MCP Server是基于Model Context Protocol(MCP)协议构建的开源数据库工具服务,已托管至GitHub。通过MCP Server,AI编程助手(如Cursor、Claude Desktop、Qoder等)可以直接管理和操作阿里云数据库,实现AI在IDE中自动创建数据库、建表、执行SQL验证以及调用Agent进行性能诊断的完整工作流。

项目地址:https://github.com/aliyun/alibabacloud-yaochi-db-mcp-server。

支持的数据库

MCP Server当前支持以下数据库引擎:

数据库引擎

支持的操作

云数据库RDS MySQL

创建实例、执行SQL、临时账号模式

云原生数据库PolarDB MySQL

创建集群、执行SQL、临时账号模式

云数据库MongoDB

创建副本集、执行MongoDB命令

云数据库Tair(兼容Redis)

创建实例、执行Redis命令

此外,MCP Server内置瑶池数据库Agent能力,支持所有阿里云数据库引擎的知识问答、智能诊断和最佳实践推荐。

快速入门

  1. 获取项目并安装。

    git clone https://github.com/aliyun/alibabacloud-yaochi-db-mcp-server.git
    cd alibabacloud-yaochi-db-mcp-server
    python3 -m venv .venv
    source .venv/bin/activate
    pip install .
  2. 验证安装。运行以下命令,若进入stdio等待模式(无输出),则说明安装成功。按Ctrl+C退出。

    yaochi-db-mcp-server
  3. 在AI助手的MCP配置文件中添加以下内容。

    {
      "mcpServers": {
        "yaochi-db": {
          "command": "<项目路径>/alibabacloud-yaochi-db-mcp-server/.venv/bin/yaochi-db-mcp-server",
          "env": {
            "ALIBABA_CLOUD_ACCESS_KEY_ID": "<您的AccessKey ID>",
            "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "<您的AccessKey Secret>",
            "ALIBABA_CLOUD_REGION_ID": "cn-hangzhou",
            "YAOCHI_ENABLE_WRITE_SQL": "true",
            "YAOCHI_ENABLE_DDL_SQL": "true"
          }
        }
      }
    }

主要环境变量说明如下:

环境变量

默认值

说明

ALIBABA_CLOUD_ACCESS_KEY_ID

无

必填。阿里云AccessKey ID。

ALIBABA_CLOUD_ACCESS_KEY_SECRET

无

必填。阿里云AccessKey Secret。

ALIBABA_CLOUD_REGION_ID

cn-hangzhou

默认地域ID。

YAOCHI_ENABLE_WRITE_SQL

true

是否允许INSERT、UPDATE、DELETE等DML操作。

YAOCHI_ENABLE_DDL_SQL

false

是否允许CREATE、ALTER等DDL操作。

安全机制

  • 临时账号:执行SQL时自动创建临时数据库账号,执行完成后立即销毁,不保留持久凭证。

  • SQL安全检查:自动拦截DROP、TRUNCATE等危险操作,禁止注释和多语句执行。

  • 限制性白名单:开启公网访问时,仅允许当前IP(/32),不影响已有安全规则。

  • 权限控制:通过环境变量精确控制DML和DDL操作权限。

MCP Server项目采用Apache License 2.0开源协议,欢迎前往GitHub提交Issue或Pull Request参与贡献。