Praxis Vibe 项目

一、项目简介

Praxis 是一个开源的 AI 原生数据库 Agent 平台，核心理念是将数据库转变为可对话的智能工作空间。平台通过自然语言交互的方式，让用户直接以文字描述任务目标，由 AI Agent 理解数据库的库表结构和运行时状态后，自主完成数据查询、问题诊断、异常排查和操作执行等一系列工作。项目的设计目标是让 DBA 和数据库开发者从重复性的巡检和排查工作中解放出来，将精力聚焦在更高价值的决策上。项目采用 Apache-2.0 开源许可证，支持 Docker 一键部署。

二、核心功能

• 对话式数据库操作：用户通过自然语言描述任务，Agent 自主理解库表结构后执行查询、诊断问题或提出修改建议，支持多工具协同和结果推理连续性。
• 可复用 Agent：将经过验证的工作流保存为 Agent，后续可直接对当前数据运行相同流程，实现经验积累和流程标准化。
• 定时自动化：支持为 Agent 设置定时执行计划，并将每次运行结果持久化保存，方便历史回溯和趋势分析。
• Functions（函数封装）：将参数化的 SQL 查询封装为可测试、可复用的函数，在不同任务中灵活调用。
• 知识与 Skills：可上传领域文档和 DBA 常用的检查方法作为参考资料，Agent 在执行任务时自动引用这些知识按固定方法论推进分析。

三、技术实现

Praxis 的技术架构围绕"让 AI 理解数据库"这一核心命题展开。平台内置的 Agent 在接收自然语言任务后，首先解析目标数据库的 schema 信息，获取库表结构、字段类型和索引情况；随后结合数据库运行时状态（如表大小、连接数、缓存命中率等监控指标），综合判断后生成并执行 SQL 或管理操作。每个任务周期内，Agent 可调用多个工具（SQL 执行、schema 查询、监控数据拉取、日志分析等），并在工具返回结果的基础上进行下一步推理，模拟人类 DBA 的逐步排查思路。

用户可上传内部运维文档、DBA 标准操作规程或特定业务规则作为 Skills，Agent 在分析时自动引用这些知识，保证结论符合团队既定的处理规范。项目提供 Docker 镜像，支持一键启动，也提供 Docker Compose 完整演示栈，包含 Praxis、MySQL、Prometheus 和 cAdvisor，开箱即用。

四、快速上手

1. 安装 Docker：确保本地环境已安装 Docker 和 Docker Compose。
2. 启动容器：执行 docker run -d --name praxis -p 8000:8000 -v praxis_data:/app/data sunzy2/praxis:latest，等待镜像拉取和容器启动完成。
3. 访问管理界面：在浏览器打开 http://127.0.0.1:8000，按引导完成模型提供商的 API 配置（兼容 OpenAI API 标准格式）。
4. 连接数据源：在界面中添加目标 MySQL 或 PostgreSQL 数据库连接信息，平台将自动拉取 schema 并建立上下文关联。
5. 开始对话：在对话框中用自然语言描述任务（如"帮我检查过去 7 天的数据库健康状态"），Agent 即可开始工作。

五、适用人群

• DBA（数据库管理员）：日常需要做巡检、查表、分析异常的数据库运维人员，Praxis 可将固定流程自动化，减少重复劳动。
• 后端开发者：需要频繁查询数据库结构或执行管理操作的开发人员，可通过自然语言快速完成，无需记忆复杂 SQL 语法。
• 数据工程师：需要进行数据质量检查和口径验证的数据从业者，可利用 Agent 的逐步推理能力完成系统性审查。

六、开源信息

• 开源地址：https://github.com/sunetic/praxis
• 许可证：Apache-2.0
• 技术栈：Python + Docker
• 支持数据库：MySQL、PostgreSQL
• 模型接口：兼容 OpenAI API 标准