From 42872e1b05dbd8c91cc188a6c4e446df3bff1fde Mon Sep 17 00:00:00 2001
From: aries_ckt <916701291@qq.com>
Date: Sat, 21 Mar 2026 23:42:43 +0800
Subject: [PATCH] doc:update datasource docs
---
docs/data_analysis_planning_agent.md | 302 ++++++++++++++++++
.../getting-started/concepts/architecture.md | 139 ++++++++
.../integrations/doris_install.md | 40 +++
.../integrations/gaussdb_install.md | 41 +++
.../integrations/mysql_install.md | 46 +++
.../integrations/oceanbase_install.md | 40 +++
.../integrations/sqlite_install.md | 37 +++
.../integrations/starrocks_install.md | 40 +++
.../integrations/vertica_install.md | 40 +++
docs/docs/overview.mdx | 4 +-
docs/docs/sandbox/index.md | 245 ++++++++++++++
docs/sidebars.js | 49 ++-
docs/static/img/dbgpt_vision.png | Bin 0 -> 6045205 bytes
13 files changed, 1013 insertions(+), 10 deletions(-)
create mode 100644 docs/data_analysis_planning_agent.md
create mode 100644 docs/docs/getting-started/concepts/architecture.md
create mode 100644 docs/docs/installation/integrations/doris_install.md
create mode 100644 docs/docs/installation/integrations/gaussdb_install.md
create mode 100644 docs/docs/installation/integrations/mysql_install.md
create mode 100644 docs/docs/installation/integrations/oceanbase_install.md
create mode 100644 docs/docs/installation/integrations/sqlite_install.md
create mode 100644 docs/docs/installation/integrations/starrocks_install.md
create mode 100644 docs/docs/installation/integrations/vertica_install.md
create mode 100644 docs/docs/sandbox/index.md
create mode 100644 docs/static/img/dbgpt_vision.png
diff --git a/docs/data_analysis_planning_agent.md b/docs/data_analysis_planning_agent.md
new file mode 100644
index 000000000..08c248651
--- /dev/null
+++ b/docs/data_analysis_planning_agent.md
@@ -0,0 +1,302 @@
+# Data Analysis Planning Agent
+
+基于`react_agent.py`开发的具有自主规划能力的数据分析智能体，能够理解数据分析需求、制定分析计划并系统性地执行。
+
+## 核心特性
+
+### 🎯 自主规划能力
+- **需求理解**: 深度理解业务问题和分析目标
+- **计划制定**: 创建系统性的数据分析步骤计划
+- **动态调整**: 根据分析结果动态调整后续步骤
+
+### 📊 全流程分析
+- **数据源检查**: 自动识别和检查可用数据源
+- **数据加载**: 智能加载和预处理数据
+- **探索性分析**: 进行全面的数据探索
+- **统计分析**: 执行统计检验和深度分析
+- **可视化**: 生成图表和可视化结果
+- **洞察提取**: 提供业务洞察和建议
+
+### 🤖 智能决策
+- **步骤优化**: 根据数据特点优化分析步骤
+- **工具选择**: 智能选择最适合的分析工具
+- **结果验证**: 验证分析结果的可靠性
+
+## 架构设计
+
+### 继承结构
+```
+DataAnalysisPlanningAgent
+├── 继承自 ConversableAgent
+├── 扩展 ReActAgent 的规划能力
+└── 集成数据分析专用工具
+```
+
+### 核心组件
+
+#### 1. 规划状态管理
+```python
+class DataAnalysisPlanningAgent(ConversableAgent):
+ analysis_plan: Optional[List[Dict[str, Any]]] # 分析计划
+ current_step: int = Field(default=0) # 当前步骤
+ planning_complete: bool = Field(default=False) # 规划完成状态
+```
+
+#### 2. 专用工具集
+- `create_analysis_plan`: 创建分析计划
+- `examine_data_sources`: 检查数据源
+- `load_data`: 加载数据
+- `explore_data`: 探索性分析
+- `statistical_analysis`: 统计分析
+- `create_visualization`: 创建可视化
+- `generate_insights`: 生成洞察
+
+#### 3. 智能提示模板
+```python
+_DATA_AGENT_SYSTEM_TEMPLATE = """
+You are an expert data analyst with strong planning and execution capabilities.
+
+1. Planning Phase: 理解目标、识别数据、创建计划
+2. Execution Phase: 加载数据、执行分析、生成结果
+3. Communication Phase: 展示发现、提供洞察、建议后续
+"""
+```
+
+## 使用方法
+
+### 基础使用
+
+```python
+from dbgpt.agent.expand.data_agent import DataAnalysisPlanningAgent
+from dbgpt.agent.resource import ToolPack, ResourcePack
+
+# 1. 创建工具
+tools = [DataSourceTool(), LoadDataTool(), ExploreDataTool()]
+tool_pack = ToolPack(tools=tools)
+
+# 2. 创建资源包
+resource_pack = ResourcePack()
+resource_pack._resources["tools"] = tool_pack
+
+# 3. 创建Agent
+agent = DataAnalysisPlanningAgent(resource=resource_pack)
+
+# 4. 发送分析请求
+message = AgentMessage(content="分析销售数据趋势，提供业务洞察")
+response = await agent.act(message, sender=None)
+```
+
+### 高级配置
+
+```python
+# 自定义规划参数
+agent = DataAnalysisPlanningAgent(
+ max_retry_count=25, # 增加重试次数
+ resource=resource_pack,
+ llm_client=your_llm_client
+)
+
+# 设置分析目标
+agent.profile.goal = "专注于电商数据分析，提供精准的业务洞察"
+```
+
+## 工作流程
+
+### 1. 需求理解阶段
+```
+用户输入 → 理解业务问题 → 识别分析目标 → 确定数据需求
+```
+
+### 2. 规划制定阶段
+```
+数据需求 → 检查数据源 → 制定分析计划 → 估算时间和资源
+```
+
+### 3. 执行分析阶段
+```
+执行计划 → 数据加载 → 探索分析 → 深度分析 → 结果验证
+```
+
+### 4. 结果呈现阶段
+```
+分析结果 → 生成洞察 → 创建可视化 → 提供建议 → 完成任务
+```
+
+## 示例场景
+
+### 场景1: 销售趋势分析
+```python
+question = "分析我们的销售数据，识别趋势并提供业务规划洞察"
+
+# Agent会自动执行：
+# 1. 创建销售趋势分析计划
+# 2. 检查可用的销售数据源
+# 3. 加载销售数据
+# 4. 进行趋势分析
+# 5. 生成可视化图表
+# 6. 提供业务洞察和建议
+```
+
+### 场景2: 客户细分分析
+```python
+question = "进行客户细分分析，识别不同客户群体特征"
+
+# Agent会自动执行：
+# 1. 制定客户细分分析计划
+# 2. 检查客户数据
+# 3. 执行细分算法
+# 4. 分析各群体特征
+# 5. 提供营销建议
+```
+
+## 扩展开发
+
+### 添加自定义工具
+
+```python
+class CustomAnalysisTool(BaseTool):
+ @property
+ def name(self) -> str:
+ return "custom_analysis"
+
+ @property
+ def description(self) -> str:
+ return "执行自定义分析逻辑"
+
+ async def async_execute(self, **kwargs):
+ # 实现自定义分析逻辑
+ return {"result": "自定义分析结果"}
+
+# 添加到Agent
+agent.resource._resources["custom_analysis"] = CustomAnalysisTool()
+```
+
+### 自定义规划逻辑
+
+```python
+class CustomDataAnalysisAgent(DataAnalysisPlanningAgent):
+ async def create_custom_plan(self, objective: str):
+ # 实现自定义规划逻辑
+ custom_plan = [
+ {"step": 1, "action": "custom_preprocessing"},
+ {"step": 2, "action": "custom_analysis"},
+ ]
+ self.analysis_plan = custom_plan
+ return custom_plan
+```
+
+## 最佳实践
+
+### 1. 数据准备
+- 确保数据源可访问
+- 提供数据文档和元数据
+- 预处理常见数据质量问题
+
+### 2. 目标设定
+- 明确分析目标和业务问题
+- 提供背景信息和约束条件
+- 设定期望的输出格式
+
+### 3. 工具配置
+- 根据分析需求配置合适工具
+- 确保工具参数正确设置
+- 提供工具使用文档
+
+### 4. 结果验证
+- 验证分析结果的合理性
+- 检查数据质量影响
+- 确认业务洞察的准确性
+
+## 故障排除
+
+### 常见问题
+
+#### 1. 规划失败
+```
+问题: Agent无法创建有效的分析计划
+解决: 检查数据源可用性，明确分析目标
+```
+
+#### 2. 工具执行错误
+```
+问题: 数据分析工具执行失败
+解决: 检查工具参数，验证数据格式
+```
+
+#### 3. 结果质量差
+```
+问题: 分析结果不够深入或准确
+解决: 提供更多背景信息，调整分析策略
+```
+
+### 调试方法
+
+```python
+# 启用详细日志
+import logging
+logging.basicConfig(level=logging.DEBUG)
+
+# 检查Agent状态
+print(f"Planning complete: {agent.planning_complete}")
+print(f"Current step: {agent.current_step}")
+print(f"Analysis plan: {agent.analysis_plan}")
+```
+
+## 性能优化
+
+### 1. 缓存策略
+- 缓存数据加载结果
+- 缓存分析计算结果
+- 缓存常用查询结果
+
+### 2. 并行处理
+- 并行执行独立分析任务
+- 异步处理数据加载
+- 批量处理相似请求
+
+### 3. 资源管理
+- 合理管理内存使用
+- 优化计算资源分配
+- 控制并发任务数量
+
+## 未来规划
+
+### 短期目标
+- [ ] 添加更多预定义分析模板
+- [ ] 优化规划算法
+- [ ] 增强错误处理能力
+
+### 中期目标
+- [ ] 支持多数据源联合分析
+- [ ] 集成机器学习模型
+- [ ] 添加实时分析能力
+
+### 长期目标
+- [ ] 支持自然语言交互
+- [ ] 自动化报告生成
+- [ ] 智能推荐系统
+
+## 贡献指南
+
+欢迎提交Issue和Pull Request来改进这个项目！
+
+### 开发环境设置
+```bash
+# 安装依赖
+pip install -r requirements.txt
+
+# 运行测试
+pytest tests/
+
+# 代码格式化
+black src/
+```
+
+### 提交规范
+- 使用清晰的提交信息
+- 添加适当的测试用例
+- 更新相关文档
+
+## 许可证
+
+MIT License - 详见LICENSE文件
\ No newline at end of file
diff --git a/docs/docs/getting-started/concepts/architecture.md b/docs/docs/getting-started/concepts/architecture.md
new file mode 100644
index 000000000..ba43d4251
--- /dev/null
+++ b/docs/docs/getting-started/concepts/architecture.md
@@ -0,0 +1,139 @@
+---
+sidebar_position: 0
+title: Architecture
+summary: "DB-GPT repo layout and ReAct-centered runtime architecture"
+read_when:
+ - You want the shortest mental model for how DB-GPT is organized
+ - You need to understand how UI, API, agents, skills, tools, and data resources connect
+---
+
+# Architecture
+
+DB-GPT is organized as a Python monorepo with a ReAct-centered agent runtime.
+The Web UI sends requests to the application layer, the ReAct Agent executes in an
+agent runtime loop, and the agent uses tools, skills, databases, and knowledge
+resources to produce analysis results back to the UI.
+
+## Repository layout
+
+```text
+DB-GPT/
+├── packages/
+│ ├── dbgpt-core/ # Core agent, memory, planning, RAG, model abstractions
+│ ├── dbgpt-app/ # Application server, API routes, scenes, UI asset hosting
+│ ├── dbgpt-serve/ # Service layer: knowledge, flow, agent resources, app services
+│ ├── dbgpt-ext/ # Extensions: datasources, storage backends, RAG connectors
+│ ├── dbgpt-client/ # Python client SDK
+│ ├── dbgpt-sandbox/ # Sandbox execution runtime for safe code/tool execution
+│ └── dbgpt-accelerator/ # Acceleration packages
+├── web/ # Next.js Web UI
+├── skills/ # Built-in skills and reusable workflows
+├── configs/ # TOML configuration files
+└── docs/ # Docusaurus documentation
+```
+
+## Package roles
+
+| Package | Role |
+|---|---|
+| `dbgpt-core` | Core agent framework, ReAct parser/action flow, memory, planning, RAG, model interfaces |
+| `dbgpt-app` | FastAPI application server, chat APIs, runtime orchestration, static UI hosting |
+| `dbgpt-serve` | Resource services for knowledge, datasource, flow, app, and agent support |
+| `dbgpt-ext` | External connectors such as database/storage/RAG integrations |
+| `dbgpt-client` | Client SDK for DB-GPT APIs |
+| `dbgpt-sandbox` | Isolated execution runtimes for code and tool execution |
+| `skills/` | Packaged domain workflows, scripts, templates, and references |
+
+## High-level architecture
+
+```mermaid
+flowchart TB
+ User["User"] --> UI["Web UI / Chat Apps"]
+ UI --> API["dbgpt-app API"]
+
+ subgraph Runtime["agent_runtime"]
+ Agent["ReAct Agent"]
+ Loop["Thought -> Action -> Observation Loop"]
+ Action["Tool / Skill / Resource Selection"]
+ Agent --> Loop --> Action --> Agent
+ end
+
+ API --> Runtime
+
+ subgraph Resources["External resources"]
+ DB["Structured databases"]
+ KB["Unstructured data / knowledge space"]
+ Skill["Skills"]
+ Tool["Built-in tools"]
+ Sandbox["Sandbox runtime"]
+ end
+
+ Action --> DB
+ Action --> KB
+ Action --> Skill
+ Action --> Tool
+ Action --> Sandbox
+
+ Runtime --> Result["Analysis result / report / chart"]
+ Result --> UI
+```
+
+## How it works
+
+1. The user interacts with the Web UI or another client.
+2. `dbgpt-app` receives the request and routes it to the agent chat API.
+3. The request enters the `agent_runtime` execution loop.
+4. The ReAct Agent reasons step by step and chooses the next action.
+5. The agent loads and uses external resources as needed:
+ - structured databases for SQL analysis
+ - unstructured knowledge spaces for retrieval
+ - skills for reusable workflows
+ - built-in tools for task execution
+ - sandbox runtimes for safe code execution
+6. The agent combines observations and produces the final analysis output.
+7. The result is streamed back to the UI for display.
+
+## Agent runtime model
+
+The runtime is the conceptual execution layer that drives the ReAct loop.
+In the codebase, this is implemented through the agent builder, resource manager,
+ReAct parser/action flow, and the API streaming handlers that connect to the UI.
+
+Key implementation anchors:
+
+- `packages/dbgpt-core/src/dbgpt/agent/expand/react_agent.py`
+- `packages/dbgpt-core/src/dbgpt/agent/util/react_parser.py`
+- `packages/dbgpt-app/src/dbgpt_app/openapi/api_v1/agentic_data_api.py`
+- `web/hooks/use-react-agent-chat.ts`
+- `packages/dbgpt-sandbox/src/dbgpt_sandbox/sandbox/execution_layer/runtime_factory.py`
+
+## Resources used by the agent
+
+### Structured data
+
+Databases and queryable tabular sources are used for SQL-style analysis, schema
+linking, and report generation.
+
+### Unstructured data
+
+Knowledge spaces and document collections provide retrieval support for
+unstructured content.
+
+### Skills
+
+Built-in skills package repeatable workflows into reusable task units. The agent
+can load and execute them during a session.
+
+### Built-in tools
+
+Tools include SQL execution, shell/code execution, HTML rendering, search, and
+other task-specific operations registered through the resource manager.
+
+## Result delivery
+
+The output path is designed to be user-facing:
+
+`ReAct Agent` → `agent_runtime` → `streamed result` → `Web UI`
+
+This makes the architecture suitable for interactive data analysis, report
+generation, and tool-assisted reasoning.
diff --git a/docs/docs/installation/integrations/doris_install.md b/docs/docs/installation/integrations/doris_install.md
new file mode 100644
index 000000000..b694c1833
--- /dev/null
+++ b/docs/docs/installation/integrations/doris_install.md
@@ -0,0 +1,40 @@
+# Apache Doris
+
+Apache Doris is a real-time analytical data warehouse supported by DB-GPT through
+the native connector in `dbgpt_ext.datasource.rdbms.conn_doris`.
+
+### Install Dependencies
+
+Doris uses the MySQL-compatible driver path.
+
+```bash
+uv sync --all-packages \
+--extra "base" \
+--extra "datasource_mysql" \
+--extra "rag" \
+--extra "storage_chromadb" \
+--extra "dbgpts"
+```
+
+### Prepare Apache Doris
+
+Prepare a Doris instance and start the DB-GPT webserver:
+
+```bash
+uv run dbgpt start webserver --config configs/dbgpt-proxy-openai.toml
+```
+
+### Apache Doris Configuration
+
+Use the datasource UI or configuration fields for:
+
+- host
+- port
+- user
+- password
+- database
+- driver (`mysql+pymysql`)
+
+The Doris connector is implemented in:
+
+- `packages/dbgpt-ext/src/dbgpt_ext/datasource/rdbms/conn_doris.py`
diff --git a/docs/docs/installation/integrations/gaussdb_install.md b/docs/docs/installation/integrations/gaussdb_install.md
new file mode 100644
index 000000000..2cee687f1
--- /dev/null
+++ b/docs/docs/installation/integrations/gaussdb_install.md
@@ -0,0 +1,41 @@
+# GaussDB
+
+GaussDB is an enterprise-grade relational database supported by DB-GPT through the
+native connector in `dbgpt_ext.datasource.rdbms.conn_gaussdb`.
+
+### Install Dependencies
+
+GaussDB uses the PostgreSQL-compatible driver path.
+
+```bash
+uv sync --all-packages \
+--extra "base" \
+--extra "datasource_postgres" \
+--extra "rag" \
+--extra "storage_chromadb" \
+--extra "dbgpts"
+```
+
+### Prepare GaussDB
+
+Prepare a GaussDB instance and start the DB-GPT webserver:
+
+```bash
+uv run dbgpt start webserver --config configs/dbgpt-proxy-openai.toml
+```
+
+### GaussDB Configuration
+
+Use the datasource UI or configuration fields for:
+
+- host
+- port
+- user
+- password
+- database
+- schema
+- driver (`postgresql+psycopg2`)
+
+The GaussDB connector is implemented in:
+
+- `packages/dbgpt-ext/src/dbgpt_ext/datasource/rdbms/conn_gaussdb.py`
diff --git a/docs/docs/installation/integrations/mysql_install.md b/docs/docs/installation/integrations/mysql_install.md
new file mode 100644
index 000000000..9c8ae3d8e
--- /dev/null
+++ b/docs/docs/installation/integrations/mysql_install.md
@@ -0,0 +1,46 @@
+# MySQL
+
+MySQL is a widely used open-source relational database system. DB-GPT includes a
+native MySQL datasource connector in `dbgpt_ext.datasource.rdbms.conn_mysql`.
+
+### Install Dependencies
+
+First, install the MySQL datasource dependency set.
+
+```bash
+uv sync --all-packages \
+--extra "base" \
+--extra "datasource_mysql" \
+--extra "rag" \
+--extra "storage_chromadb" \
+--extra "dbgpts"
+```
+
+### Prepare MySQL
+
+Prepare a MySQL service and database, then start the DB-GPT webserver:
+
+```bash
+uv run dbgpt start webserver --config configs/dbgpt-proxy-openai.toml
+```
+
+Optionally:
+
+```bash
+uv run python packages/dbgpt-app/src/dbgpt_app/dbgpt_server.py --config configs/dbgpt-proxy-openai.toml
+```
+
+### MySQL Configuration
+
+Use the datasource UI or configuration fields for:
+
+- host
+- port
+- user
+- password
+- database
+- driver (`mysql+pymysql`)
+
+The MySQL connector is implemented in:
+
+- `packages/dbgpt-ext/src/dbgpt_ext/datasource/rdbms/conn_mysql.py`
diff --git a/docs/docs/installation/integrations/oceanbase_install.md b/docs/docs/installation/integrations/oceanbase_install.md
new file mode 100644
index 000000000..c565c4df3
--- /dev/null
+++ b/docs/docs/installation/integrations/oceanbase_install.md
@@ -0,0 +1,40 @@
+# OceanBase
+
+OceanBase is a distributed SQL database supported by DB-GPT through the native
+connector in `dbgpt_ext.datasource.rdbms.conn_oceanbase`.
+
+### Install Dependencies
+
+OceanBase support is built on the OceanBase-compatible MySQL driver path already
+used by the connector.
+
+```bash
+uv sync --all-packages \
+--extra "base" \
+--extra "rag" \
+--extra "storage_chromadb" \
+--extra "dbgpts"
+```
+
+### Prepare OceanBase
+
+Prepare an OceanBase instance and start the DB-GPT webserver:
+
+```bash
+uv run dbgpt start webserver --config configs/dbgpt-proxy-openai.toml
+```
+
+### OceanBase Configuration
+
+Use the datasource UI or configuration fields for:
+
+- host
+- port
+- user
+- password
+- database
+- driver (`mysql+ob`)
+
+The OceanBase connector is implemented in:
+
+- `packages/dbgpt-ext/src/dbgpt_ext/datasource/rdbms/conn_oceanbase.py`
diff --git a/docs/docs/installation/integrations/sqlite_install.md b/docs/docs/installation/integrations/sqlite_install.md
new file mode 100644
index 000000000..e0d688071
--- /dev/null
+++ b/docs/docs/installation/integrations/sqlite_install.md
@@ -0,0 +1,37 @@
+# SQLite
+
+SQLite is a lightweight embedded relational database. DB-GPT includes a native
+SQLite connector in `dbgpt_ext.datasource.rdbms.conn_sqlite`.
+
+### Install Dependencies
+
+SQLite support is available in the base installation and does not require an
+additional datasource extra.
+
+```bash
+uv sync --all-packages \
+--extra "base" \
+--extra "rag" \
+--extra "storage_chromadb" \
+--extra "dbgpts"
+```
+
+### Prepare SQLite
+
+Prepare a SQLite database file path such as `./data/demo.db`, then start the server:
+
+```bash
+uv run dbgpt start webserver --config configs/dbgpt-proxy-openai.toml
+```
+
+### SQLite Configuration
+
+Use the datasource UI or configuration fields for:
+
+- path
+- check_same_thread
+- driver (`sqlite`)
+
+The SQLite connector is implemented in:
+
+- `packages/dbgpt-ext/src/dbgpt_ext/datasource/rdbms/conn_sqlite.py`
diff --git a/docs/docs/installation/integrations/starrocks_install.md b/docs/docs/installation/integrations/starrocks_install.md
new file mode 100644
index 000000000..b0dc4e96e
--- /dev/null
+++ b/docs/docs/installation/integrations/starrocks_install.md
@@ -0,0 +1,40 @@
+# StarRocks
+
+StarRocks is a high-performance analytical database supported by DB-GPT through
+the native connector in `dbgpt_ext.datasource.rdbms.conn_starrocks`.
+
+### Install Dependencies
+
+Install the base dependency set and the StarRocks SQLAlchemy driver required by
+your environment.
+
+```bash
+uv sync --all-packages \
+--extra "base" \
+--extra "rag" \
+--extra "storage_chromadb" \
+--extra "dbgpts"
+```
+
+### Prepare StarRocks
+
+Prepare a StarRocks instance and start the DB-GPT webserver:
+
+```bash
+uv run dbgpt start webserver --config configs/dbgpt-proxy-openai.toml
+```
+
+### StarRocks Configuration
+
+Use the datasource UI or configuration fields for:
+
+- host
+- port
+- user
+- password
+- database
+- driver (`starrocks`)
+
+The StarRocks connector is implemented in:
+
+- `packages/dbgpt-ext/src/dbgpt_ext/datasource/rdbms/conn_starrocks.py`
diff --git a/docs/docs/installation/integrations/vertica_install.md b/docs/docs/installation/integrations/vertica_install.md
new file mode 100644
index 000000000..4ee34a7f5
--- /dev/null
+++ b/docs/docs/installation/integrations/vertica_install.md
@@ -0,0 +1,40 @@
+# Vertica
+
+Vertica is an analytical SQL data warehouse supported by DB-GPT through the native
+connector in `dbgpt_ext.datasource.rdbms.conn_vertica`.
+
+### Install Dependencies
+
+Install the Vertica datasource extra.
+
+```bash
+uv sync --all-packages \
+--extra "base" \
+--extra "datasource_vertica" \
+--extra "rag" \
+--extra "storage_chromadb" \
+--extra "dbgpts"
+```
+
+### Prepare Vertica
+
+Prepare a Vertica instance and start the DB-GPT webserver:
+
+```bash
+uv run dbgpt start webserver --config configs/dbgpt-proxy-openai.toml
+```
+
+### Vertica Configuration
+
+Use the datasource UI or configuration fields for:
+
+- host
+- port
+- user
+- password
+- database
+- driver (`vertica+vertica_python`)
+
+The Vertica connector is implemented in:
+
+- `packages/dbgpt-ext/src/dbgpt_ext/datasource/rdbms/conn_vertica.py`
diff --git a/docs/docs/overview.mdx b/docs/docs/overview.mdx
index 1fbb0d9fc..dd8591b38 100644
--- a/docs/docs/overview.mdx
+++ b/docs/docs/overview.mdx
@@ -8,11 +8,9 @@ import CommandCopyCard from "@site/src/components/mdx/CommandCopyCard";
# DB-GPT
- 
+ 
-> *"In the Data 3.0 era, based on models and databases, enterprises and developers can build their own bespoke applications with less code."*
-
An open-source AI data assistant that connects to your data, writes SQL and code, runs skills in sandboxed environments, and turns analysis into reports, insights, and action.
DB-GPT is also a platform for building AI-native data agents, workflows, and applications with agents, AWEL, RAG, and multi-model support.
diff --git a/docs/docs/sandbox/index.md b/docs/docs/sandbox/index.md
new file mode 100644
index 000000000..265d8ea07
--- /dev/null
+++ b/docs/docs/sandbox/index.md
@@ -0,0 +1,245 @@
+---
+sidebar_position: 0
+title: Sandbox Overview
+---
+
+# Sandbox Overview
+
+DB-GPT uses a sandbox to let agents execute code and tools in an isolated runtime
+instead of running directly in the host environment.
+
+This matters for agent workflows because an agent often needs to do more than
+reason in text. It may need to run code, execute shell commands, install
+dependencies, generate files, and keep execution state across multiple steps.
+
+The sandbox is the execution boundary that makes those actions safer and more
+manageable.
+
+## What is a sandbox?
+
+In DB-GPT, a sandbox is an isolated execution environment used by an agent when it
+needs to execute code, run commands, or manipulate files as part of a task.
+
+Instead of letting the agent operate directly on the host system, the sandbox
+provides:
+
+- process isolation
+- resource limits
+- controlled working directories
+- optional dependency installation
+- session lifecycle management
+- a clear boundary between reasoning and execution
+
+## How the sandbox works with agents
+
+The agent decides **what** to do next. The sandbox executes **how** that action is
+run.
+
+```mermaid
+flowchart TB
+ User["User / UI"] --> API["dbgpt-app API"]
+ API --> Agent["ReAct Agent / Agent Logic"]
+ Agent --> Decide["Select tool or code action"]
+ Decide --> Sandbox["Sandbox Runtime"]
+
+ subgraph SandboxLayer["Sandbox execution"]
+ Session["Session lifecycle"]
+ Exec["Code / shell execution"]
+ Files["File & report generation"]
+ Limits["Memory / CPU / timeout / isolation"]
+ end
+
+ Sandbox --> Session
+ Sandbox --> Exec
+ Sandbox --> Files
+ Sandbox --> Limits
+
+ Exec --> Observation["Execution result / observation"]
+ Observation --> Agent
+ Agent --> Result["Final answer / report / UI output"]
+```
+
+## Why agents need a sandbox
+
+An agent that can execute code without isolation is difficult to operate safely in
+real environments. The sandbox gives DB-GPT a dedicated runtime for actions such
+as:
+
+- code execution
+- shell command execution
+- dependency installation
+- file creation and retrieval
+- multi-step stateful analysis
+
+This is especially important for data analysis, report generation, and tool-driven
+workflows where the agent must combine reasoning with real execution.
+
+## DB-GPT's current sandbox solution
+
+DB-GPT's sandbox implementation lives in:
+
+- `packages/dbgpt-sandbox/`
+
+The current design is a layered, extensible sandbox runtime with multiple backend
+options.
+
+### Runtime backends
+
+The runtime factory automatically chooses the best available backend in this order:
+
+- Docker
+- Podman
+- Nerdctl
+- Local runtime
+
+Implementation anchor:
+
+- `packages/dbgpt-sandbox/src/dbgpt_sandbox/sandbox/execution_layer/runtime_factory.py`
+
+This allows DB-GPT to prefer container isolation when available and fall back to a
+local execution mode for development or environments without container support.
+
+## Layered architecture in `dbgpt-sandbox`
+
+DB-GPT's sandbox is implemented as a small runtime system with several layers.
+
+### 1. Execution layer
+
+The execution layer provides the runtime implementations and the core abstractions.
+
+- `base.py` defines shared runtime/session/result/config interfaces
+- `docker_runtime.py`, `podman_runtime.py`, `nerdctl_runtime.py`, `local_runtime.py`
+ implement concrete runtimes
+- `runtime_factory.py` selects the runtime backend
+
+### 2. Control layer
+
+The control layer manages task lifecycle and execution orchestration.
+
+Implementation anchor:
+
+- `packages/dbgpt-sandbox/src/dbgpt_sandbox/sandbox/control_layer/control_layer.py`
+
+This layer handles operations such as:
+
+- connect
+- configure
+- execute
+- status
+- disconnect
+- get file
+
+It also manages session creation and session-scoped execution.
+
+### 3. User layer
+
+The user layer exposes the sandbox service interface used by callers.
+
+Implementation anchors:
+
+- `packages/dbgpt-sandbox/src/dbgpt_sandbox/sandbox/user_layer/service.py`
+- `packages/dbgpt-sandbox/src/dbgpt_sandbox/sandbox/user_layer/schemas.py`
+
+### 4. Display layer
+
+The display layer packages outputs for runtime-specific display or file-oriented
+results.
+
+Implementation anchor:
+
+- `packages/dbgpt-sandbox/src/dbgpt_sandbox/sandbox/display_layer/display_layer.py`
+
+## Session model and stateful execution
+
+One important part of the DB-GPT sandbox design is that it supports **session-based
+stateful execution**.
+
+That means:
+
+- a sandbox session can be created once
+- multiple execution steps can run in the same session
+- installed dependencies can remain available in later steps
+- files produced in one step can be reused in the next step
+
+This is important for agent workflows where a task is solved through multiple
+reasoning and execution rounds rather than a single tool call.
+
+## Current integration in DB-GPT app
+
+Today, DB-GPT already uses sandbox execution in application-side agent tooling.
+
+For example, the `shell_interpreter` tool in:
+
+- `packages/dbgpt-app/src/dbgpt_app/openapi/api_v1/agentic_data_api.py`
+
+uses `dbgpt-sandbox` `LocalRuntime` to execute shell commands with:
+
+- process isolation
+- memory limits
+- timeout limits
+- security validation
+
+The current implementation there is **stateless per call** for shell execution: each
+tool call creates a temporary sandbox session and destroys it after completion.
+
+So the repo currently contains both:
+
+- a more complete `dbgpt-sandbox` design for reusable sandbox sessions
+- a practical app-side integration already using sandboxed execution for tools
+
+## What DB-GPT supports today
+
+Based on the current `dbgpt-sandbox` implementation, DB-GPT is moving toward a
+general-purpose agent runtime that supports:
+
+- multi-runtime sandbox execution
+- safe code and shell execution
+- stateful sandbox sessions
+- dependency installation inside the sandbox
+- task lifecycle control
+- file retrieval from sandbox sessions
+
+This makes the sandbox suitable for agent scenarios such as:
+
+- code agents
+- data analysis agents
+- report generation agents
+- browser/computer style execution runtimes in future extensions
+
+## High-level view of the current DB-GPT sandbox direction
+
+```mermaid
+flowchart TB
+ Apps["Agent applications"] --> Access["Access layer"]
+ Access --> Runtime["Agent sandbox runtime"]
+
+ subgraph AccessLayer["Access layer"]
+ SDK["SDK / API / CLI"]
+ end
+
+ subgraph RuntimeLayer["Sandbox runtime"]
+ Code["Code execution"]
+ Browser["Browser / GUI style execution"]
+ SessionMgmt["Lifecycle / snapshot / state / files"]
+ Isolation["Isolation / limits / runtime selection"]
+ end
+
+ Runtime --> Code
+ Runtime --> Browser
+ Runtime --> SessionMgmt
+ Runtime --> Isolation
+```
+
+This diagram is conceptual. It shows the direction of the sandbox as a dedicated
+runtime layer under agent applications, while the current repo implementation
+already provides the execution, control, session, and runtime selection foundations
+in `dbgpt-sandbox`.
+
+## Key implementation anchors
+
+- `packages/dbgpt-sandbox/README.md`
+- `packages/dbgpt-sandbox/src/docs/architecture.md`
+- `packages/dbgpt-sandbox/src/docs/usage.md`
+- `packages/dbgpt-sandbox/src/dbgpt_sandbox/sandbox/execution_layer/runtime_factory.py`
+- `packages/dbgpt-sandbox/src/dbgpt_sandbox/sandbox/control_layer/control_layer.py`
+- `packages/dbgpt-app/src/dbgpt_app/openapi/api_v1/agentic_data_api.py`
diff --git a/docs/sidebars.js b/docs/sidebars.js
index 50f9ae58b..22fd4debc 100755
--- a/docs/sidebars.js
+++ b/docs/sidebars.js
@@ -155,11 +155,19 @@ const sidebars = {
type: "category",
label: "Datasource Integrations",
items: [
+ { type: "doc", id: "installation/integrations/mysql_install" },
+ { type: "doc", id: "installation/integrations/sqlite_install" },
{ type: "doc", id: "installation/integrations/clickhouse_install" },
{ type: "doc", id: "installation/integrations/postgres_install" },
{ type: "doc", id: "installation/integrations/duckdb_install" },
+ { type: "doc", id: "installation/integrations/hive_install" },
{ type: "doc", id: "installation/integrations/mssql_install" },
{ type: "doc", id: "installation/integrations/oracle_install" },
+ { type: "doc", id: "installation/integrations/oceanbase_install" },
+ { type: "doc", id: "installation/integrations/gaussdb_install" },
+ { type: "doc", id: "installation/integrations/doris_install" },
+ { type: "doc", id: "installation/integrations/starrocks_install" },
+ { type: "doc", id: "installation/integrations/vertica_install" },
],
},
{
@@ -250,6 +258,14 @@ const sidebars = {
},
],
},
+ {
+ type: "category",
+ label: "Sandbox",
+ collapsed: true,
+ collapsible: true,
+ items: [{ type: "doc", id: "sandbox/index", label: "Overview" }],
+ },
+
{
type: "category",
@@ -353,8 +369,6 @@ const sidebars = {
collapsible: true,
items: [
{ type: "doc", id: "modules/rag", label: "RAG Overview" },
- { type: "doc", id: "application/graph_rag", label: "GraphRAG" },
- { type: "doc", id: "application/apps/chat_knowledge", label: "Chat Knowledge Base" },
{
type: "category",
label: "RAG Integrations",
@@ -376,10 +390,10 @@ const sidebars = {
{ type: "doc", id: "awel/cookbook/first_rag_with_awel" },
],
},
- { type: "doc", id: "application/advanced_tutorial/rag", label: "Advanced RAG" },
],
},
+
{
type: "category",
label: "Datasources",
@@ -388,7 +402,6 @@ const sidebars = {
items: [
{ type: "doc", id: "modules/connections", label: "Connections Overview" },
{ type: "doc", id: "application/datasources", label: "Datasources" },
- { type: "doc", id: "agents/introduction/database", label: "Agent + Database" },
{
type: "category",
label: "Datasource Integrations",
@@ -538,11 +551,19 @@ const sidebars = {
type: "category",
label: "Datasource Integrations",
items: [
+ { type: "doc", id: "installation/integrations/mysql_install" },
+ { type: "doc", id: "installation/integrations/sqlite_install" },
{ type: "doc", id: "installation/integrations/clickhouse_install" },
{ type: "doc", id: "installation/integrations/postgres_install" },
{ type: "doc", id: "installation/integrations/duckdb_install" },
+ { type: "doc", id: "installation/integrations/hive_install" },
{ type: "doc", id: "installation/integrations/mssql_install" },
{ type: "doc", id: "installation/integrations/oracle_install" },
+ { type: "doc", id: "installation/integrations/oceanbase_install" },
+ { type: "doc", id: "installation/integrations/gaussdb_install" },
+ { type: "doc", id: "installation/integrations/doris_install" },
+ { type: "doc", id: "installation/integrations/starrocks_install" },
+ { type: "doc", id: "installation/integrations/vertica_install" },
],
},
{
@@ -583,18 +604,25 @@ const sidebars = {
sidebarDatasources: [
{ type: "doc", id: "modules/connections", label: "Connections Overview" },
{ type: "doc", id: "application/datasources", label: "Datasources" },
- { type: "doc", id: "agents/introduction/database", label: "Agent + Database" },
{
type: "category",
label: "Datasource Integrations",
collapsed: false,
collapsible: false,
items: [
+ { type: "doc", id: "installation/integrations/mysql_install" },
+ { type: "doc", id: "installation/integrations/sqlite_install" },
{ type: "doc", id: "installation/integrations/clickhouse_install" },
{ type: "doc", id: "installation/integrations/postgres_install" },
{ type: "doc", id: "installation/integrations/duckdb_install" },
+ { type: "doc", id: "installation/integrations/hive_install" },
{ type: "doc", id: "installation/integrations/mssql_install" },
{ type: "doc", id: "installation/integrations/oracle_install" },
+ { type: "doc", id: "installation/integrations/oceanbase_install" },
+ { type: "doc", id: "installation/integrations/gaussdb_install" },
+ { type: "doc", id: "installation/integrations/doris_install" },
+ { type: "doc", id: "installation/integrations/starrocks_install" },
+ { type: "doc", id: "installation/integrations/vertica_install" },
],
},
{
@@ -611,6 +639,8 @@ const sidebars = {
],
},
],
+ sidebarSandbox: [{ type: "doc", id: "sandbox/index", label: "Overview" }],
+
sidebarAwel: [
{ type: "doc", id: "awel/awel", label: "What is AWEL?" },
@@ -711,7 +741,6 @@ const sidebars = {
sidebarKnowledge: [
{ type: "doc", id: "modules/rag", label: "RAG Overview" },
{ type: "doc", id: "application/graph_rag", label: "GraphRAG" },
- { type: "doc", id: "application/apps/chat_knowledge", label: "Chat Knowledge Base" },
{
type: "category",
label: "RAG Integrations",
@@ -735,7 +764,6 @@ const sidebars = {
{ type: "doc", id: "awel/cookbook/first_rag_with_awel" },
],
},
- { type: "doc", id: "application/advanced_tutorial/rag", label: "Advanced RAG" },
],
sidebarTools: [
@@ -912,6 +940,13 @@ module.exports = {
collapsible: true,
items: sidebars.sidebarDatasources,
},
+ {
+ type: "category",
+ label: "Sandbox",
+ collapsed: true,
+ collapsible: true,
+ items: sidebars.sidebarSandbox,
+ },
{
type: "category",
label: "AWEL",
diff --git a/docs/static/img/dbgpt_vision.png b/docs/static/img/dbgpt_vision.png
new file mode 100644
index 0000000000000000000000000000000000000000..03950d07bbbcbe2d819a68891ae1100f2b82de51
GIT binary patch
literal 6045205
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
z
zihr%V`r6-&SSuDM+_!b6Z%p_mV@b%+5;?aq4F)^>t9Hv}Bi6d-oF<1sm19&$Uin8V
zB-&txzZG^d$;28=b!%k>C;D4@f(9|btAK=4A?ec>UA_@HXZ9;nfdC~>uura5>+~{|)>Lk~YPI{f{s^?~JWu;|=3GNRTIhh<}z+x@3-B;E-x!nZb!t7pm((z!5wJPY3b*Cv7qko$X5TPR-!E>?hJ2MM1
zZr9V(c>n(IfByOBsJUX>JREtFQ?=ok|Iq;hwR1agrKN}Jdxc$W{DKbCio%skx+oL;
z*A9&;YSLNhq*C#LSY`^jsY+u7EZZU8AFtHEGmQ%fiQLZ?5%;yV&B
zNjd|7TWB2s$gqfD7ln*arAkTrWd*#w?;DC15fq_RpI_9(zQRl>oFHnR&&D*?S~urJ
z)+;*-{4VUOP!3e|MIM{VH!u+?NnXkFMkW!0Ug@6AX8<4*V_xsxef#aV-+lSzm#^Nu
zdHwqJS6_Vf>ebWp^W)Q}4|IY%60?MDq$jpLFf-VoLOi7F5i5!dEzA6AlS&r6zb{LdADqDL6_7r3?Pg~Vf
zE4?c{h=?0S$KAo6yPLIUvz3eb8Gxnt=(Wn^(A7I}kva)hadhivh2^z|#pN(En(Is;
zgYAM8N|Dyb-NC+Xd35?2ZmGc~7Lmo;wbi2+(9cI%8TVb_QF6-a%GxH*F&aZvklHYQ
zWP=9}+3uwU3;lNZ1A2a`1g?VC5I|GRx%;|rGh-5VMLMRybFQ2}(>+Z5S(dbzp+{Zv
z5eC*;N(_aBFe2baEKBPa)z}CxhC2rLl;v%PJyw=IGueNinZU5f6!u2>Wy^#sum|vX
zJofoTBXX4lOooK+85%3gc58lS49z#KY~swU1eq|}29Skf$a#fmWvh~oX8y1=ez!ZI
zdbNA~`yAnDT7~(T+s|=UG+QckUpGtJy3STGIm?tZQ$^zZ7&V!UEXo9smDYt1UoTiF
z_zauUko8)JXNEvJN7q8u+;^`-n9QSj5et{;Ie`})PqzQi_0m4wWMPe?8(7kw>6#(3E25}J=GYk@d#mTNaE)?
zN;|%(WR2=yY&i|aHV4mu%=cfo7`T&>de+Qoq|zMxR32i1ILwd
z^VO+&{x&na&jVYSv)tqJlf18))#McPy$U0e?RK_@3@|uh?NjNYR7+WPZWZGvK^vuA
zqmzkNazeRk*(-rkc%t+e$5$+^vi4j!OW^Doa^96KgSqDMIfCz#u1-uk~qo$9p`JCnhT`*?@!6>GvWd_gu4$}K>5{m
zg%^DZcGTLbq$DW}w7*7D08IygtI_7msaai*_R39ql
z>PH%*IrHRCp8wkKdmPmszC%@PX@TOTp&a&Z_7e4BEZ@TW)YsPNUO0TA$~W!MEDv3l
zN6yik!9qfkX6|50x1%;!kySxMe^PtjdLFZ8!j0
z8;H?uI5Uz~vS?{*ErJwVJ!YAb-rtrnl)ZCzQO(H`y|QLBxQznQhS3g(N{^!G;w275zF*b7oRM`)*Nv8Kae|rEWjO
zR^{z257HaQV(~2w6@jC3t9!prj@dp?{Q!NyvwoUcR%>FQU(MgGwKDgqKb@cRTrzV^ERmZt+gFJ^n1m&rG@~6q7
z^jaw1Z8`Xhb+WS4|RZlDWVt!>|_Bk`Iesnbi6jP($sXwwA2+z@e6cXlK#ed
z!~o=8a6wg0Kfm6+40p-ARGe|x!KrzWnMe$uWWK4`foLiX{IUvW0a=Y`Uoq@>_uM-C
zD0#BNZ^h8|Sp`aBlXf1-Y*S6ma5~}&|H5__^w`kyYTSJ={U?_;uQ{dEBi33WJ_(D6
zu=E1MaUyBkrqdI!$|ujVi=zgAGmfK&)*bc|(TEkxGGi^cH(Twj7YU2r3zJSQbZuKim--WcZz>!7~HIXwaft?&=q+Q-tP$HoiM4
zQ%NqZg?e-}*Y@xPX+I0>hDtC|J|Ybm)ve2L4pLy51Z0LqS}FjGSoh7&fv?`Z`}pZO
z*6lu&NeyIVuvt*3RfVk)LHa4)dfoTq@o*Kf{PB2jZF2=g{vqcz?zGHYi)K0^WAPo4
zMPgZdMA%XEcL@!2Al4FbX=%SCYRHgzcaAripCy8+kzd=T4n7ayDh$0;j%|Q5HKdeg
zl>nTq^OMzn&YjB$HD29;YVOZK#4UMZJ}!`HVT-VEqY+T^WttEZ%(PR+2H>$GVp$NC
ziN!UF3|ncD%OWyNlMFJ`R#+ql@1cO)TBt}%WGoSQrbSw;hkj#b93B)Iu`(8Af2})<
zY)UEah%lzRGnj&n$hadC?q7cS)py_j=8G@CBzEq8UUT>z@%HT(bB+%mK4mU<5Oy$>
zzjLc_EtCE?UAi$rTK`)tvd`LoHH#&LcZ>ZF!#Uv;qU+Pcfb47pZ@EQfA|BH
zbtWkmbsuPapk{Npeq)6G7RO}xPAsX+L*;8y0m=or8GFK3<}eO*n`X#d=~jU*{d-DU
z2>m7%BOz4ls!To{>NjFv83lBh%3R6uDDH#t2_iEPh7^UbSH{VVtR-&dT>@XRj3toD
z`mtVH5R+VMX?k%JameNLWf_^1tz;lUhgHqm*tAb*g&U?1Wek#|fzm7nDeN2unpl`6
zA|d88qGE+}u85l5_Q>=|GlUPKS*;w<5sS>FT4aWYP9(Jo_RArImwZ!_Q88>GqEZa15eU
z2SB6%d=fZmW=w5xrm`_5;n1{ErSL|YYGjo2YDe)54vc$y?hh?zu
zd1V;tSZA7HDmrBwY_7H7tX#U8e^IKswMj<3iaj60G>g@@l-qc
z$juD8X6Ar5n{-MMatqv?r(N+U0}?R(R0aU5X}x)0At2!Q|ko
z%%I%4-lCYXXrrM3Z_rP39|dkx|87K{D1JVVBZni2GtEU|VM3op9d}Vy#?28|X_k|y
z>V%qUpu{~pBPmPmhXXp~fK~6c(&9QPfUHslkWzz6iYh5!73{s(%3_Fd6h|VtG?dA7
zG`dO1Mx?1I1%o2DO!->wnaR1HOrZGW&{mGVG_y(`!3>COsEu_A&