Xata Agent：您的 PostgreSQL AI 专家

Xata Agent 是一个开源智能代理，旨在监控您的数据库、发现问题的根本原因，并提供修复和改进建议。它就像您的团队中新入职了一位精通 Postgres 的 SRE（站点可靠性工程师）。

让 Agent 自我介绍一下：

请雇佣我作为您的 PostgreSQL AI 专家。我可以：

• 监控日志和指标以发现潜在问题。
• 主动为您的数据库实例提供配置调优建议。
• 排查性能问题并提供索引优化建议。
• 排查常见问题，如高 CPU 使用率、高内存占用、高连接数等。
• 协助您执行 vacuum 操作（是针对 Postgres 数据库，不是打扫房间）。

关于我：

• 我是开源且可扩展的。
• 我可以通过 CloudWatch 监控来自 RDS 和 Aurora 的日志与指标。
• 我使用预设的 SQL 命令。我永远不会在您的数据库上运行破坏性（甚至是潜在破坏性）的命令。
• 我使用一套工具和手册（Playbooks）来指引我，以避免产生幻觉。
• 我可以运行排查语句，例如查看 pg_stat_statements、pg_locks 等，以发现问题的根源。
• 如果出现问题，我可以通过 Slack 通知您。
• 我支持来自 OpenAI、Anthropic 和 Deepseek 的多种模型。

过往经验：

• 我一直在协助 Xata 团队监控和运维大量的活跃 Postgres 数据库。

演示

以下是该 Agent 的操作演示，时长不到 4 分钟：

https://github.com/user-attachments/assets/78f58598-c1c4-4a50-b9c5-402e912c1d8a

点击此处观看 YouTube 版本的演示。

安装 / 自托管

我们为 Agent 本身提供了 Docker 镜像。唯一的外部依赖是一个 PostgreSQL 数据库，用于存储 Agent 的配置、状态和历史记录。

我们提供了一个 docker-compose 文件来启动 Agent 和 Postgres 数据库。

编辑项目根目录下的 .env.production 文件。您至少需要设置 PUBLIC_URL 以及 OpenAI 的 API Key。

通过 docker compose 启动本地实例：

docker compose up

在浏览器访问 http://localhost:8080（或您在 .env.production 文件中设置的公共 URL），并按照引导步骤进行操作。

我们提供了一份更详细的指南，说明如何通过 docker-compose 在 EC2 实例上部署。

对于身份验证，您可以使用自己的 OAuth 提供商。

开发

请前往 apps/dbagent 目录，并按照 README 中的说明进行操作。

可扩展性

Agent 可以通过以下机制进行扩展：

• 工具（Tools）：这些是 Agent 可以调用来获取数据库信息的函数。它们使用 TypeScript 编写，详细描述请参阅此文件。
• 手册（Playbooks）：这是 Agent 排查问题时可以遵循的一系列步骤，直接以自然语言（英文）编写。预定义的手册位于此处。
• 集成（Integrations）：例如 AWS 和 Slack 集成。它们包含配置和 UI 小部件。

状态 / 路线图

尽管目前仍处于早期阶段，但我们在 Xata 的日常运维工作中已经在使用该 Agent。

• 手册（Playbooks）：
  • 常规监控
  • 配置调优
  • 慢查询分析
  • 高 CPU 分析
  • 高内存分析
  • 高连接数分析
  • 锁分析
  • Vacuum 操作分析
  • 支持自定义手册
  • 其他手册（欢迎反馈需求）
• MCP 集成：
  • 作为其他 Agent 的 MCP 服务器
  • 通过 MCP 网络调用工具
• 支持更多云服务商：
  • AWS RDS
  • AWS Aurora
  • Google Cloud SQL
  • Azure Database for PostgreSQL
  • Digital Ocean Managed Databases
  • 其他（欢迎反馈需求）
• 通知与集成：
  • 基础 Slack 集成
  • 作为 AI Agent 的 Slack 集成 (https://github.com/xataio/agent/pull/29)
  • Discord 集成
  • 其他（欢迎反馈需求）
• 评估与测试：
  • 添加 LLM 交互的评估测试
• 审批工作流：
  • 添加 Agent 执行潜在危险语句的审批工作流
  • 允许按监控计划配置可使用的工具

虽然 Agent 本质上是一个主要用于自托管的开源项目，但我们也在开发云版本。云版本的优势在于某些集成更容易安装。如果您对云版本感兴趣，请在此处注册候补名单。