Xata Agent：您的 PostgreSQL AI 专家

Xata Agent 是一个开源智能代理，旨在监控您的数据库、找出问题的根本原因，并提出修复和优化建议。这就像为您团队聘请了一位经验丰富的 Postgres SRE（站点可靠性工程师）。

让 Agent 自我介绍：

聘请我作为您的 PostgreSQL AI 专家吧。我可以：

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

关于我：

• 我是开源且可扩展的。
• 我可以通过 Cloudwatch 监控 RDS 和 Aurora 的日志与指标。
• 我使用预设的 SQL 命令。我绝不会对您的数据库运行破坏性（甚至是潜在破坏性）的命令。
• 我使用一套工具和 Playbook 来引导自身，从而避免幻觉。
• 我可以运行排查语句（如查看 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 和 PostgreSQL 数据库。

请编辑项目根目录下的 .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 可遵循的故障排查步骤。它们直接用英文编写。预定义的 Playbook 位于此处。
• Integrations（集成）：例如 AWS 和 Slack 集成，包含配置和 UI 组件。

状态与路线图

虽然目前仍处于早期阶段，但我们已在 Xata 的日常运营工作中自行使用该 Agent。

• Playbooks（剧本）:
  • 常规监控
  • 配置调优
  • 慢查询分析
  • 高 CPU 分析
  • 高内存分析
  • 高连接数分析
  • 锁问题分析
  • Vacuum 操作分析
  • 支持自定义 Playbook
  • 其他 Playbook（欢迎反馈建议）
• MCP 集成:
  • 作为其他 Agent 的 MCP Server
  • 通过 MCP 网络调用工具
• 支持更多云服务提供商:
  • AWS RDS
  • AWS Aurora
  • Google Cloud SQL
  • Azure Database for PostgreSQL
  • Digital Ocean Managed Databases
  • 其他（欢迎反馈建议）
• 通知与集成:
  • 简易 Slack 集成
  • Slack AI Agent 集成 (https://github.com/xataio/agent/pull/29)
  • Discord 集成
  • 其他（欢迎反馈建议）
• 评估与测试:
  • 添加 LLM 交互的评估测试
• 审批工作流:
  • 添加审批工作流，以防 Agent 运行潜在的危险语句
  • 允许按监控计划配置工具权限

虽然 Agent 本质上是一个主要用于自托管的开源项目，但我们也在开发云版本。云版本的优势在于某些集成的安装会更便捷。如果您对云版本感兴趣，请点击此处加入等待列表。