产品定位
Buddy 是 DataBuddy 内置的 AI 助手，定位为数字数据员工 。它把 DataBuddy 平台的数据集成、数据建模、数据开发、数据分析、智能运维、指标管理等能力封装为可调用的技能（Skills），通过对话式交互让数据工程师与数据分析师在自然语言层面完成原本需要点击多个模块、写大量代码才能完成的工作。
Buddy 不是一个独立的工具，而是 DataBuddy 全平台的 AI 入口：在每个模块中都能以侧边栏形式被唤起，自动识别当前页面上下文（例如在 SQL 编辑器中会自动关联当前 SQL），让 AI 协助贯穿在所有数据工作流程中。
入口
主入口：左侧导航
在 DataBuddy 控制台的左侧导航栏顶部，Buddy 作为一级菜单独立存在。点击进入后，您会看到 Buddy 的主页面，包含：
左侧导航区 ：模式切换器（数据开发、数据分析）、空间列表（仅数据分析模式）、历史会话列表、定时任务、知识库。
中间对话区 ：示例场景卡片、对话输入框。
右侧产物预览区 ：在对话产生产物时展示产物预览（如 HTML 报告、看板）。
主页面提供三类专家场景卡片，点击后会自动填充示意 Prompt 到输入框：
数据工程专家 ：覆盖数据接入、ETL 开发、工作流编排、运维诊断。
数据分析专家 ：覆盖问数、异动归因、报告生成、仪表盘搭建。
数据治理专家 ：覆盖数据建模、指标注册、知识库探查。
侧边栏入口（其他模块内）
在 Studio、Workflow、Catalog 等模块中，Buddy 以可收起的右侧栏形式存在。打开后会自动识别当前页面上下文：
当前模块 | Buddy 自动识别的上下文 |
Studio SQL 编辑器 | 当前打开的 SQL 文件、所选语句 |
Studio Notebook | 当前 Notebook 的所有单元格、运行历史 |
Workflow 编辑器 | 当前工作流 DAG、所选任务节点 |
Catalog 资产页 | 当前选中的表 / 视图 / 模型 |
对话模式
Buddy 的对话框底部提供两种模式切换：
模式 | 说明 | 适用场景 |
Agent 模式 （默认） | Buddy 可对平台资产进行操作，例如生成并保存 SQL 文件、创建数据接入任务、注册指标等。 | 真实业务任务执行：取数、建表、编排工作流。 |
Ask 模式 | Buddy 仅做知识问答，不操作平台资产。 | 学习、原理讨论、概念澄清。 |
详细行为差异参见 Agent 基础能力。
对话框结构
Buddy 主页面与侧边栏的对话框结构一致，从下到上包含：
1. 示例场景区 ：Buddy 各项专家能力的卡片，点击后将示意 Prompt 填充到输入框。
2. 多行文本输入框 ：支持回车换行、Shift+回车发送，最大长度由模型上下文窗口决定。
3. 底部工具栏 （从左到右）：
文件夹选择器 ：弹出 Workspace 文件树，选择 Buddy 在本次会话中的工作目录 。选择文件夹后：
模型会优先把这个目录作为主战场，理解项目结构、读取相关文件。
生成的产物默认落盘在该目录下。
选择文件夹不限制 访问范围；如果用户要求读取其他路径的内容，Buddy 仍可访问。
上传文件 ：支持上传 CSV、Excel、JSON、SQL、图片等格式作为对话上下文。上传后展示文件名、大小、格式缩略信息，支持同时上传多个文件。详见 Agent 基础能力。
@ 引用 ：支持在对话中引用 Catalog 资产（表、指标）、Workspace 实体（SQL 文件、工作流等）、知识库三类上下文。详见 Agent 基础能力。
模式切换 ：Agent / Ask 切换。
模型选择器 ：选择本次对话使用的大模型，每个选项展示模型图标与名称。
Skills 选择 ：在 Agent 模式下，可临时挑选启用的 Skills 子集。
发送按钮 ：输入框为空时禁用。
会话组织形式
Buddy 采用与 CodeBuddy 一致的会话组织设计，分为任务 和文件空间 两类：
任务（Task）
定义 ：单次独立的对话会话，不绑定特定 Workspace 文件夹。
产出域 ：Buddy 可在该 Workspace 中任意您有权限的文件夹内产出文件。
适用场景 ：临时查询、快速咨询、概念澄清。
会话归属 ：对话结束后归档到左侧导航的任务 列表。
文件空间（Project）
定义 ：绑定 Workspace 中某个具体文件夹的会话集合。
产出域 ：本会话中所有文件产物严格限制 在所选文件夹范围内。
适用场景 ：持续性数据工程开发、团队协作、规范化项目。
会话归属 ：对话结束后归档到左侧导航项目 下，按文件夹名归类。
文件夹选择规则：
规则 | 说明 |
选择粒度 | Studio 文件树中的任意文件夹节点。 |
权限校验 | 当前账号必须对所选文件夹有 CAN EDIT 或更高权限。 |
变更限制 | 项目创建后，绑定的文件夹不可修改。 |
返回内容的标准元素
Buddy 的回复由若干标准元素组成。在一次复杂的分析对话中，您可能依次看到：
元素类型 | 说明 |
纯文本 / 富文本 | 思考过程分析、数据洞察结论、建议文字。 |
Todo 任务进度 | 可折叠的多步任务清单，每步标注「已完成 / 进行中 / 待执行」三种状态，随执行推进逐步打勾。 |
意图澄清确认框 | 当您的需求模糊或可有多种理解时，Buddy 会以选择题形式确认意图后再继续执行，避免无效执行。 |
代码块 | 深色背景语法高亮的 SQL 或 Python 代码块。右上角支持复制、查看完整 SQL、运行操作。 |
命令执行 + 终端输出 | Buddy 执行的系统命令及终端输出结果。 |
交互式 HTML 预览 | 右侧抽屉打开 HTML 可视化产物（报告、看板等），支持交互查看图表详情。 |
Markdown 表格 | 数据查询结果以表格形式渲染。 |
文件产物卡片 | 生成的 SQL 文件、报告、工作流、脚本等以卡片形式展示，点击可在右侧预览或跳转到 DataBuddy 对应模块。 |
工具调用状态 | 例如「正在读取文件……」「正在执行命令……」「正在查询数据……」的折叠块，展示 Buddy 调用外部工具的实时状态。 |
产物与跳转
Buddy 在对话中生成的所有产物都汇集在每个会话独立的产物列表 中。产物分为两类：
支持在 Buddy 内预览的产物 ：
Markdown / HTML 文件（默认渲染后展示）
SQL / Notebook / Python 文件（展示代码源文件）
仅支持跳转到对应模块查看的产物 ：
工作流 → 跳转到 Workflow
仪表盘 → 跳转到 仪表盘
每条对话的底部还会以卡片形式展示前 2 个产物的快捷入口，以及一个查看全部产物 按钮跳转到完整产物列表。
详细规则参见 Agent 基础能力。
历史会话
左侧导航的历史会话 按时间倒序排列，Buddy 自动根据会话首条消息生成会话标题。点击任一历史会话可继续对话，完整上下文（消息、产物、所选模型、所选模式）会一并恢复。
相关文档
两大场景模式——数据分析 vs 数据开发
