Xata Agent：精通 PostgreSQL 的 AI 助手

[正文内容]

xataio/agent

一个精通 PostgreSQL 的 AI 助手。

xata.io

License

Apache-2.0 license 47 stars 0 forks

xataio/agent

main BranchesTags Go to file Code

Folders and files

Name| Name| Last commit message| Last commit date
---|---|---|---

Latest commit

History

42 Commits
.github| .github
.husky| .husky
.vscode| .vscode
apps/dbagent| apps/dbagent
brand-kit| brand-kit
configs| configs
packages| packages
.dockerignore| .dockerignore
.env.production| .env.production
.gitignore| .gitignore
.nvmrc| .nvmrc
.prettierignore| .prettierignore
.prettierrc.js| .prettierrc.js
.prettierrc.precommit.js| .prettierrc.precommit.js
Dockerfile| Dockerfile
LICENSE| LICENSE
README.md| README.md
docker-compose.yml| docker-compose.yml
package.json| package.json
pnpm-lock.yaml| pnpm-lock.yaml
pnpm-workspace.yaml| pnpm-workspace.yaml
tsconfig.json| tsconfig.json
turbo.json| turbo.json
vitest.config.ts| vitest.config.ts
View all files

Repository files navigation

• README
• Apache-2.0 license

Xata Agent，您的 PostgreSQL AI 专家

Xata Agent 是一个开源的助手，可以监控您的数据库，查找问题的根本原因，并提出修复和改进建议。它就像您的团队中新来了一位拥有丰富 Postgres 经验的 SRE 工程师。

让 Agent 自我介绍一下：

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

• 监控日志和指标，找出潜在问题。
• 主动建议您对数据库实例进行配置调整。
• 排除性能问题，并提出索引建议。
• 排除常见问题，如 CPU 使用率高、内存使用率高、连接数高等。
• 帮助您 vacuum (您的 Postgres 数据库，而不是您的房间)。

更多关于我：

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

过往经验：

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

演示

以下是一个不到 4 分钟的 Agent 实际操作演示： Xata.Agent.demo.mp4 YouTube 版本。

安装/自托管

我们为 Agent 本身提供 Docker 镜像。唯一的其他依赖项是一个 Postgres 数据库，Agent 将在其中存储其配置、状态和历史记录。

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

编辑项目根目录中的 .env.production 文件。您需要为至少 OpenAI 设置 PUBLIC_URL 和 API 密钥。

通过 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
  • 调查高内存
  • 调查高连接数
  • 调查锁
  • 调查 vacuuming
  • 其他剧本（请告知我们）
• MCP 集成：
  • 充当其他 Agent 的 MCP 服务器
  • 通过 MCP 通过网络调用工具
• 支持更多云提供商：
  • AWS RDS
  • AWS Aurora
  • Google Cloud SQL
  • Azure Database for PostgreSQL
  • Digital Ocean Managed Databases
  • 其他（请告知我们）
• 通知和集成：
  • 简单的 Slack 集成
  • Slack 集成作为 AI 助手 (#29)
  • Discord 集成
  • 其他（请告知我们）
• 评估和测试：
  • 增加与 LLM 交互的评估测试 (#38)
• 批准工作流程：
  • 为 Agent 增加批准工作流程，以运行潜在的危险语句
  • 允许配置每个监控计划定义的工具

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

关于

AI agent expert in PostgreSQL xata.io

Topics

agent postgres ai postgresql openai llm anthropic

Resources

Readme

License

Apache-2.0 license Activity Custom properties

Stars

47 stars

Watchers

4 watching

Forks

0 forks Report repository

Releases

No releases published

Packages 0

No packages published

Contributors 3

Languages

• TypeScript 96.6%
• CSS 1.7%
• JavaScript 1.3%
• Dockerfile 0.4%

Footer

© 2025 GitHub, Inc.

Footer navigation

• Terms
• Privacy
• Security
• Status
• Docs
• Contact
• Manage cookies
• Do not share my personal information

You can’t perform that action at this time.