本文档汇总 Buddy Agent 基础能力中的定时任务、产物与产物变更、上传文件、@ 能力、ASK 模式等能力，包括定时任务、产物与产物变更、上传文件、@ 能力、ASK 模式。各能力相对独立，您可以直接跳到对应章节阅读。
定时任务
概述
定时任务让 Buddy 在您预设的时间或周期内自动触发一次 AI 会话，按照您配置好的 Prompt 调用相应的 Skills 与模型，自动产出报告、巡检结论、汇总数据等。其本质是一种「定时触发的 AI 对话执行机制」。
典型用法包括：
每天凌晨 03:00 自动生成「昨日用户增长分析报告」。
每周一 00:00 自动扫描数仓异常并输出问题列表。
每月 1 号上午 09:00 汇总上月 PR 与 Issue 情况。
定时任务在所有模式（数据开发、数据分析）下通用。
前提条件
已开通 DataBuddy 服务并完成 Buddy 入口的基础初始化。
当前账号在目标 Workspace（数据开发模式）或分析空间（数据分析模式）下具备使用 Buddy 的权限。
创建任务前已确认希望使用的 Skills、模型与 Prompt 范例。
使用限制
限制项 | 说明 |
触发上下文 | 每次触发会创建一个新的 AI 会话，不会复用历史会话上下文 |
历史关联 | 定时任务的执行历史不计入左侧导航的「最近任务」列表 |
执行频率 | 仅支持「每天」「按间隔」「单次」三种模式 |
适用范围 | 数据开发模式与数据分析模式均可使用，配置项一致 |
操作步骤
步骤 1：进入定时任务列表
1. 在 Buddy 左侧导航栏选择 定时任务。
2. 主页面以卡片方式展示所有已创建的定时任务。
每张卡片展示：
字段 | 说明 |
任务名称 | 创建时填写的名称 |
执行周期 | 例如「每日 · 03:00」「每周一 · 00:00」 |
提示词 | 任务运行时实际发送的 Prompt（截断展示） |
任务状态 | 正常（绿色）或 已暂停 |
步骤 2：创建定时任务
Buddy 支持三种创建方式：
方式 A：通过 UI 创建
1. 在定时任务列表右上角点击 + 新建，打开创建弹窗。
2. 填写以下配置项：
名称
Prompt 配置、Skills 与模型选择
执行频率
生效日期区间（可选）
3. 点击 保存。新建的任务默认处于 正常 状态。
方式 B：从模板添加
1. 在定时任务列表右上角点击 从模板添加。
2. 在模板列表中按场景选择一个模板（区分数据开发模式与数据分析模式）。
3. 进入创建弹窗，Prompt、Skills 等字段已自动填入，您可按需调整。
4. 点击 保存。
方式 C：通过自然语言创建
在对话框中直接描述任务，例如：
帮我创建一个定时任务：每天早上 9 点生成一份昨日 GMV 报告，发送到 DataBuddy。
Buddy 解析后会弹出一个预填好的创建确认卡片，您确认后即可保存。
步骤 3：查看任务执行记录
1. 在定时任务列表点击某张卡片，进入 执行记录 页面。
2. 列表按时间倒序排列，每条记录包含：
字段 | 说明 |
执行结果 | 成功 / 失败 |
运行状态 | 运行中 / 运行完成 |
执行时间 | 触发时间 |
记录数量 | 本次会话产出的产物数 |
已读状态 | 未查看的完成记录会显示小红点 |
3. 点击某条记录可进入对应会话，查看完整对话流与产物。
定时任务的会话不会出现在左侧导航的「最近任务」中。如需查看历史，请始终通过执行记录入口进入。
步骤 4：管理定时任务
在定时任务的编辑、详情面板，您可以执行以下操作：
操作 | 说明 |
暂停 | 暂停后任务停止按计划触发，状态变为「已暂停」 |
恢复 | 将「已暂停」状态恢复为「正常」 |
测试运行 | 立即手动触发一次执行，可用于验证 Prompt 是否正确 |
删除 | 删除定时任务（不可恢复） |
参数说明（定时任务）
基础配置
参数 | 说明 | 是否必填 | 默认值 | 取值范围 |
名称 | 定时任务名称 | 是 | - | 自定义文本 |
Prompt 配置 | 触发时实际发送给 AI 的指令文本 | 是 | - | 自然语言 |
Skills 选择 | 任务执行可使用的 Skills 集合 | 否 | 当前模式默认 Skills | 可多选 |
模型选择 | 任务执行使用的大模型 | 否 | 当前默认模型 | 平台支持的模型 |
执行频率 | 触发周期 | 是 | - | 每天 / 按间隔 / 单次 |
生效日期区间 | 任务有效时间窗 | 否 | 永久生效 | 起止日期 |
执行频率
类型 | 说明 |
每天 | 每天固定时间执行一次 |
按间隔 | 每 N 小时或 N 分钟执行一次 |
单次 | 仅在指定时间点执行一次 |
生效日期区间
字段 | 说明 |
起始时间 | 默认空表示立即生效 |
结束时间 | 默认空表示永久生效 |
校验规则 | 结束时间必须大于等于起始时间 |
验证结果（定时任务）
操作完成后，您可以通过以下方式确认：
1. 任务卡片显示在列表中，状态为 正常。
2. 在编辑面板单击测试运行，立即触发一次执行，并在执行记录中产生一条新记录。
3. 到达计划时间后，执行记录会按时序自动新增条目。
常见问题（定时任务）
Q：定时任务每次会基于上次会话上下文继续吗？
不会。每次触发都是创建一个全新的 AI 会话，仅基于您配置的 Prompt 与 Skills 执行，避免历史上下文累积造成结果漂移。
Q：测试运行与正式触发有差异吗？
测试运行使用与正式触发完全相同的 Prompt、Skills 与模型，结果会进入执行记录列表，可作为预演验证。
Q：暂停的任务还能测试运行吗？
可以。在暂停状态下编辑面板仍提供 测试运行 与 恢复 按钮。
Q：可以将定时任务的执行结果发送到企业微信或邮件吗？
可以通过 Prompt 让 Buddy 在执行后调用平台通知能力发送（依赖具体 Skills），但定时任务本身不内置消息推送通道。
产物与产物变更
概述
产物（Artifact） 是 Buddy 在一次会话中生成的可复用结果，包括 Markdown、HTML、Notebook、SQL 文件、Python 文件、数据接入任务、工作流、仪表盘、模型实验等。每个会话维护一份独立的产物列表，集中展示本次对话产生的所有产物。
产物变更 在产物面板中提供「变更」Tab，您可以查看每个文件型产物从「基线版本」到「最新版本」的差异，并以左右对比（side-by-side diff）的方式审阅 AI 做了哪些修改。
产物类型与展示方式
产物类型 | 预览方式 | 跳转方式 |
Markdown（.md） | 渲染后预览 | 跳转至 Studio 查看源文件 |
HTML（图表 / 报告 / 仪表盘） | 渲染后预览 | 跳转至 Studio 查看源文件 |
Notebook（.ipynb） | 展示源代码 | 跳转至 Studio Notebook 编辑器 |
SQL（.sql） | 展示源代码 | 跳转至 Studio SQL 编辑器 |
Python（.py） | 展示源代码 | 跳转至 Studio |
数据接入任务（实时 / 离线） | 不支持预览 | 跳转至数据接入模块 |
工作流 | 不支持预览 | 跳转至 Workflow 模块 |
仪表盘 | 不支持预览 | 跳转至仪表盘模块 |
模型实验 | 不支持预览 | 跳转至模型实验模块 |
前提条件
当前会话中至少有一次 AI 回复产生了产物。
您对产物所在的 Studio 文件夹或目标模块有相应的查看、编辑权限。
使用限制
限制项 | 说明 |
产物归属 | 产物列表按会话维护，不同会话之间产物互相独立 |
文件变更适用范围 | 仅文件型产物支持 diff，工作流、数据接入任务等实体型产物不支持 |
仪表盘场景 | 仪表盘没有侧边栏入口，需在主页面或对话页面查看 |
模式默认 | 除仪表盘外，其他模块默认进入数据开发模式 |
在对话流中查看产物
对话底部产物卡片
当一次 AI 回复产生产物时，回复消息底部会自动展示产物卡片：
元素 | 说明 |
标题行 | 任务产生产物（N 个）： ，N 为本次回复产生的产物总数 |
产物卡片 | 按字母顺序展示前 2 个产物（文件图标 + 文件名） |
查看全部按钮 | 当产物超过 2 个时显示 查看全部产物 → |
交互行为：
操作 | 行为 |
点击单个产物卡片 | 打开右侧产物面板并自动定位到该产物的预览 |
点击不可预览的产物（工作流、数据接入任务等） | 跳转至对应模块 |
点击「查看全部产物 →」 | 打开右侧产物面板并展示完整产物列表 |
Buddy 主页面下，一轮对话结束后若产生了产物会默认拉起产物列表；侧边栏内嵌时不自动拉起。
操作步骤
步骤 1：打开产物面板
通过以下任一方式打开右侧产物面板：
点击对话流中产物卡片或「查看全部产物 →」按钮。
在 Buddy 主页面右上角单击产物入口。
产物面板顶部包含两个 Tab：
Tab | 说明 |
产物列表 | 默认 Tab，展示本会话所有产物 |
变更 | 展示本会话内所有发生过变更的文件型产物 |
步骤 2：预览或跳转产物
在「产物列表」Tab 中，点击某个产物：
可预览类型：在右侧预览区直接展开，例如 Markdown 渲染后内容、HTML 报告交互预览、SQL 代码块。
不可预览类型：直接跳转至对应模块，例如工作流、数据接入任务。
文件型产物预览页右上角支持：
操作 | 说明 |
导出 | 按文件类型导出为原格式、Word、PDF（详见下表） |
修改 | 跳转 Studio 编辑文件 |
复制链接 | 复制产物访问链接，并提示需在 Studio 中配置访问权限 |
导出格式支持
产物类型 | 原格式 | Word | PDF |
Markdown | 支持 | 不支持 | 支持 |
HTML | 支持 | 支持 | 支持 |
SQL | 支持 | 不支持 | 不支持 |
工作流 / 仪表盘等实体 | 不支持 | 不支持 | 不支持 |
其他文本文件 | 支持 | 不支持 | 不支持 |
步骤 3：查看文件变更
1. 在产物面板顶部切换到 变更 Tab。
2. 列表中展示本会话内所有发生过变更的文件型产物，每项包含：
文件名
增删行数统计：
+N / -N3. 点击某个文件项，右侧切换到 side-by-side diff 视图，左侧为基线版本，右侧为最新版本。
工作流、数据接入任务等实体型产物不在「变更」Tab 中展示。
步骤 4：理解 diff 的基线规则
「变更」Tab 比较的是同一个会话内文件从「基线版本」到「最新版本」的差异。基线版本的确定规则统一为：该文件最早的有内容的版本。具体分为三种场景：
场景 A：会话前已有文件 → 会话中修改
基线版本 = 会话开始时文件的原始内容
最新版本 = 最后一轮修改后的内容
diff 展示原始内容与最终内容的差异
场景 B：会话中新建 → 没有后续修改
基线版本 = 空（文件之前不存在）
最新版本 = 新建时的内容（v1）
diff 展示所有行均为「新增」
场景 C：会话中新建 → 又有后续修改
基线版本 = 新建时的第一版内容（v1）
最新版本 = 最后一轮修改后的内容
diff 展示 v1 与最新版本之间的差异（不是「空 vs v3」）
关键区分：场景 B 与场景 C 的区别在于新建后是否有后续修改。
在对话中复用产物
Buddy 提供以下方式将产物在不同会话间流转：
验证结果（产物与产物变更）
完成对话后您可以通过以下方式确认：
1. 对话末尾出现产物卡片，并可点击进入预览。
2. 右侧产物面板的「产物列表」Tab 显示本会话所有产物。
3. 对修改过的文件，「变更」Tab 中可见对应条目并能正确展示 diff。
常见问题（产物与产物变更）
Q：产物列表是和会话绑定还是和 Workspace 绑定？
产物列表按会话维护，每次新建会话产物列表清空。但产物对应的实际文件依然保存在 Studio 或对应模块中，可通过文件路径或链接持续访问。
Q：复制了产物链接发给同事后，对方打开提示无权限怎么办？
Buddy 在您复制链接时已提示「请确保用户有权限可以访问该链接」。请进入 Studio 对应文件，单独配置该用户的访问权限。
Q：在对话中删除了一个产物的源文件，diff 还能查看吗？
源文件被外部删除后，预览功能不可用。建议在产物面板查看 diff 后再做物理删除。
Q：仪表盘为什么没有侧边栏 Buddy 入口？
仪表盘场景下产物即为仪表盘本身，Buddy 不再作为侧边栏出现以避免视觉冲突；可通过左侧导航的 Buddy 主入口进入。
上传文件
概述
Buddy 对话框支持您直接将本地文件作为对话上下文上传，让 AI 在回答时基于这些文件中的内容进行分析、提取或转换。常见用途包括：
上传 CSV、Excel 让 Buddy 帮助理解数据结构、生成建模建议或分析数据。
上传 SQL 文件让 Buddy 协助审查、改写或解释逻辑。
上传 JSON 让 Buddy 解析结构、转换为目标格式。
上传图片让 Buddy 基于多模态能力解读截图、原型图、报错信息等。
前提条件
当前账号在所在 Workspace（数据开发模式）或分析空间（数据分析模式）下具备 Buddy 使用权限。
已打开 Buddy 主页面或侧边栏。
使用限制
限制项 | 说明 |
文件类型 | CSV、Excel、JSON、SQL、图片等常见格式 |
上传数量 | 支持单次同时上传多个文件 |
适用范围 | 仅作为本次会话的上下文使用，不会自动写入知识库 |
操作步骤
步骤 1：在对话框中上传文件
1. 在对话框底部点击 上传文件 图标。
2. 在弹出的文件选择器中选择一个或多个本地文件，或直接将文件拖入对话框。
3. 上传完成后，对话框上方展示已上传文件，每项包含：
文件名
文件大小
格式缩略信息
步骤 2：撰写问题并发送
在对话框中输入问题，Buddy 在思考时会自动读取已上传文件作为上下文。例如：
帮我分析这份 CSV 中各渠道在最近 30 天的转化率差异
Buddy 在思考过程中会展示「正在读取文件…」的工具调用状态，回答中会引用文件中的具体数据。
步骤 3：移除文件
如果需要移除某个已上传的文件，点击文件卡片上的 ✕ 即可。
步骤 4：升级为长期知识
如果您希望该文件后续多次复用，可在对话产物详情页或知识库入口将文件沉淀到知识库：
1. 通过对话生成产物后，可在产物详情右上角选择产物作为知识学习。
2. 直接在 知识库 中通过 从本地上传 重新上传作为长期知识。
与 @ 引用、知识库的区别
能力 | 适用范围 | 时效性 | 是否参与跨会话检索 |
上传文件 | 当前会话 | 临时 | 否 |
@ 引用 | 当前会话 | 临时 | 否（但被引用对象本身长期存在） |
知识库 | 同模式下所有会话 / 当前分析空间 | 长期 | 是 |
常见问题（上传文件）
Q：上传的文件保存在哪里？会被其他人看到吗？
上传的文件仅作为当前会话的上下文使用，不会自动公开或写入到 Catalog。其他人无法在您未主动分享的情况下访问。
Q：可以上传多个文件让 Buddy 一次性分析吗？
可以。一次上传多个文件时，Buddy 会在思考过程中按需读取相关文件。如果文件之间存在引用关系，您可以在 Prompt 中明确指出，例如「以 a.csv 为主表，关联 b.csv 中的渠道明细」。
Q：上传的图片可以被 Buddy 看懂吗？
可以。Buddy 通过多模态模型解读图片内容，包括截图、报错信息、架构图等。回答效果与图片清晰度和内容复杂度相关。
@ 能力
概述
Buddy 在对话输入框中提供 @ 能力：通过 @ 符号在所有可用对象（表、文件、指标模型、知识文件等）中精确选择一个或多个对象作为本轮回答的上下文，让 Buddy 不再需要靠自然语言猜测要操作的对象，避免找错表、改错文件。
@ 能力适用于以下两种诉求：
明确指代：让 Buddy 直接基于您指定的对象进行操作或回答（例如「@用户复购率指标开发.sql 这个查询太慢了，帮我优化」）。
组合上下文：同时引用多个对象形成复合上下文（例如「@dwd_order_detail @电商业务数据字典 按字典里的口径统计昨日退款率」）。
前提条件
已打开 Buddy 对话框（主页面、侧边栏或嵌入页面均可）。
当前账号对希望引用对象具备查看权限。
您所在的模式决定可被 @ 的对象类型，详见下方 可被 @ 的对象类型。
使用限制
限制项 | 说明 |
触发方式 | 直接键入 @ 或通过 + 菜单选择「@ 指定上下文」 |
引用数量 | 单次对话可连续 @ 多个对象，每个对象独立成 chip |
删除方式 | 点击 chip 右侧 ✕，或按 Backspace 从右往左逐个删除 |
模式差异 | 数据开发模式与数据分析模式可被 @ 的对象类型不同 |
搜索范围 | 输入关键字时跨所有对象类型全局模糊搜索 |
操作步骤
步骤 1：触发 @ 浮窗
通过以下任一方式触发：
方式 | 行为 |
直接输入 @ | 在光标位置插入 @，弹出上下文选择浮窗 |
点击对话框左侧 + 菜单 > @ 指定上下文 | 同上 |
步骤 2：浏览对象列表
浮窗结构如下：
区域 | 说明 |
顶部「最近使用」区 | 展示最近 6 个被 @ 选中过的对象，按时间倒序，每行展示「图标 + 名称 + 灰色路径」 |
对象类型列表 |
操作方式：
1. 点击某个对象类型 → 进入第二层，展示该类型下的全部条目。
2. 第二层顶部点击 ‹ 返回 即可回到第一层。
3. 点击某个条目即将该对象插入对话框。
步骤 3：搜索对象
在 @ 之后继续键入关键字（例如
@数规）：行为 | 说明 |
实时搜索 | 输入即触发，无需回车 |
全局检索 | 跨所有对象类型搜索，不受当前层级限制 |
模糊匹配 | 例如「@数规」会命中「数仓开发规范」 |
无结果 | 显示「没有匹配的结果」 |
步骤 4：在对话中使用
选择对象后，输入框光标处插入一个 chip：
@ + 类型图标 + 名称 + ✕
发送消息后，AI 回答中会明确标识使用了该指定对象（例如思考过程中显示「正在读取 SQL 文件…」工具调用，并在结果中关联该对象）。
可被 @ 的对象类型
@ 能力在不同模式下可见的对象类型不同，二级展示信息如下：
数据开发模式
对象类型 | 二级信息展示 |
表 | 表名 + Catalog 路径（例如 databuddy_showtime_donot_delete/ads_olist/ads_customer_repurchase_analysis） |
Notebooks | Notebook 名 + 文件路径（例如 Workspace/new_notebook_0423.ipynb） |
SQL | SQL 名 + 文件路径（例如 Workspace/at_100f_script_100_58GUb14r.sql） |
文件 | Studio 中的 Markdown / TXT 等文件名 + 路径 |
文件夹 | Studio 文件夹名 + 路径（例如 Workspace/Users/joshshzhou@xxxxx） |
工作流 | 工作流名称 + 工作流 ID |
指标模型 | 指标模型名 + 中文名 |
知识文件 | 知识文件名 + 所属知识库名 |
数据分析模式
对象类型 | 二级信息展示 |
表（分析空间内的表） | 表名 + Catalog 路径 |
指标模型（分析空间内的指标模型） | 指标模型名 + 中文名 |
知识文件 | 知识文件名 + 所属知识库名 |
数据分析模式下 @ 仅能引用当前分析空间内的资产，避免跨空间检索带来的歧义。
典型场景与预期 AI 行为
数据开发模式
场景 | 用户输入示例 | 预期 AI 行为 |
表变更 | @dwd_order_detail 给这张表加一个 refund_amount 字段 | 直接修改该表，新增字段 |
修改 Notebook | @零售业务月度库存分析.ipynb 补充一段异常检测逻辑 | 读取该 Notebook 已有 cell，在末尾追加异常检测代码 |
SQL 优化 | @用户复购率指标开发.sql 这个查询太慢了，帮我优化 | 读取 SQL 全文，分析瓶颈，给出优化后的 SQL |
引用文档建模 | @数仓分层建设规范.md 帮我按照这个规范对 ods_payment 表做分层设计 | 按 ODS/DWD/DWS/ADS 规则输出建模方案 |
引用需求单生成开发说明 | @【空间配置需求单】新增「客单价 ARPU」指标配置申请.md 帮我基于该空间配置需求单，生成对应的数据开发需求说明 | 基于指标配置申请生成数据开发需求单 |
文件夹批量分析 | @xx 文件夹 帮我看看这个文件夹下 SQL 有哪些可以优化的 | 遍历文件夹内 SQL 文件，输出优化建议 |
工作流排查 | @T+1调度工作流编排 昨天这个流程失败了，帮我排查可能原因 | 分析工作流执行过程并列出失败原因 |
修改指标模型 | @ecommerce_trade_model 在这个模型内新增 GMV 指标 | 修改指标模型，新增指标 |
知识库约束 | @SQL 开发最佳实践知识库 帮我 review 你刚刚生成的代码是否符合规范 | 读取知识库规则，检查刚生成的 SQL |
数据分析模式
场景 | 用户输入示例 | 预期 AI 行为 |
指定表查询 | @gmv_daily 查一下上周每天的 GMV 变化 | 仅使用该表生成查询，不再做智能选表 |
指定指标模型 | @ecommerce_trade_model 本月转化率是多少 | 在该模型中选择转化率指标，不去其他模型推断 |
仿照模板生成报告 | @财务分析月报 参考这个格式，生成本月的财务分析月报 | 基于该报告结构生成新报告 |
引用业务术语解释 | @财务分析术语 查询一下最近三个财务月的 GMV | 从知识文件提取「财务月」「GMV」定义后生成查询 |
表 + 知识文件组合 | @dwd_order_detail @电商业务数据字典 按字典里的口径统计昨日退款率 | 用指定表查询，结合知识文件中的口径计算退款率 |
验证结果（@ 能力）
完成上述操作后，您可以通过以下方式确认：
1. 输入框中出现对应 chip，发送后消息卡片上保留该 chip 信息。
2. AI 思考过程中显示读取该对象的工具调用，回答中正确使用该对象。
3. 重新打开 @ 浮窗时，最近选用的对象出现在「最近使用」区。
常见问题（@ 能力）
Q：为什么 @ 浮窗里看不到我刚创建的表？
请确认：
1. 对象已成功创建并在 Catalog / Studio 中可见。
2. 当前账号对该对象有查看权限。
3. 数据分析模式下，@ 仅展示当前分析空间内的资产，跨空间不会出现在浮窗中。
Q：可以一次 @ 多少个对象？
没有硬上限，您可以连续 @ 多个对象，每个独立成一个 chip。但建议控制在 5 个以内，避免上下文过长导致 AI 信息过载。
Q：搜索时如何快速精确命中？
输入对象名称的关键字片段即可，Buddy 会做模糊匹配。例如键入「数规」可命中「数仓开发规范」。
Q：被 @ 的对象会被复制到对话中吗？
不会。chip 仅作为引用标识，AI 在执行时基于权限实时读取原对象，原对象的修改会在下次引用时生效。
ASK 模式
概述
Buddy 的对话框底部提供两种运行模式：Agent 模式 与 Ask 模式。
模式 | 行为 |
Agent 模式（默认） | Buddy 可读取并修改平台资产：生成并保存 SQL 文件、创建数据接入任务、注册指标、执行终端命令等 |
Ask 模式 | Buddy 仅做只读问答与探索：可读取文件与元数据，不修改任何资产，不执行终端命令 |
Ask 模式适用于以下诉求：
学习与查询：基于 DataBuddy 官方文档知识库回答产品使用问题。
元数据探查：快速查询 Catalog 中的表、字段、指标元数据。
避免误操作：调研、讨论、教学等场景中防止不小心改动资产。
Ask 模式与 Agent 模式对接的知识库、上下文、@ 引用范围完全一致；唯一区别在于只有只读工具可用。
适用场景
场景 | 模式建议 |
我要让 Buddy 完成一个真实的开发或分析任务并落地 | Agent |
我只想了解某个产品功能怎么用 | Ask |
我想看 Catalog 中某张表的字段和血缘 | Ask |
我想确认 SQL 写法是否符合规范，但不希望它真去执行 | Ask |
数据接入模块中调用「数据源文档」 | Ask（默认） |
前提条件
已打开 Buddy 对话框（主页面或侧边栏均可）。
当前账号在所在 Workspace 或分析空间下具备 Buddy 使用权限。
使用限制
限制项 | 说明 |
资产修改 | 完全不允许 |
终端命令 | 完全不允许 |
文件读取 | 允许（与 Agent 模式一致） |
元数据查询 | 允许 |
知识库与上下文 | 与 Agent 模式共用同一份配置 |
操作步骤
步骤 1：切换到 Ask 模式
1. 在对话框底部找到模式切换控件，默认显示为 Agent。
2. 点击模式切换控件，选择 Ask。
切换后，控件右侧的 tooltip 会提示：
Ask 模式：仅能读取文件，不可进行修改Agent 模式：可以执行文件操作、终端命令等
步骤 2：在 Ask 模式中提问
直接在输入框中提问。例如：
WeData 中 Workflow 是怎么和 Studio 的 SQL 文件关联的？
Buddy 会基于：
DataBuddy 官方文档知识库
当前 Workspace / 分析空间内的元数据
您 @ 引用的对象
本会话历史上下文
生成回答。回答中不会触发任何资产修改或命令执行。
步骤 3：在依赖模块中自动使用
部分模块默认呼起 Ask 模式以避免误操作，例如：
模块 | 默认模式 |
数据接入模块的「数据源文档」功能 | Ask |
仪表盘 | （仪表盘无侧边栏） |
其他模块（侧边栏） | 默认数据开发模式下的 Agent |
您仍可在对话框底部手动切换模式。
步骤 4：必要时切回 Agent 执行
当您确认要落地变更时，再次点击模式切换控件，切回 Agent：
1. 切回 Agent 模式后，输入框上方仍保留之前会话的上下文。
2. 直接发送变更请求即可，Buddy 会按 Agent 模式执行。
切到 Ask 模式不会清空会话历史，但 Ask 模式下生成的产物若涉及执行步骤会被跳过；如果之后切回 Agent 重新执行，Buddy 会基于上下文重新落地变更。
与其他能力的关系
能力 | Ask 模式下的行为 |
@ 引用 | 完全可用，详见 本文 @ 能力章节 |
上传文件 | 完全可用，详见 本文上传文件章节 |
知识库检索 | |
产物生成 | 仅支持只读类产物（如 Markdown 总结、HTML 报告预览）；不会创建工作流、数据接入任务、指标等需要落地的资产 |
定时任务 | 定时任务支持选择 Ask 或 Agent 模式（详见 本文定时任务章节） |
数据复核 | 复核流程不依赖模式，可在两种模式下发起 |
验证结果（Ask 模式）
完成上述操作后，您可以通过以下方式确认：
1. 对话框底部模式切换控件显示为 Ask。
2. 提交修改类请求（例如「帮我把这张表加一个字段」）时，Buddy 会拒绝执行并提示需切换到 Agent 模式。
3. 提交只读类请求（例如「这张表有哪些字段」）时正常返回结果。
常见问题（Ask 模式）
Q：Ask 模式下 Buddy 的回答会比 Agent 模式更慢、更快吗？
回答速度差别不大。Ask 模式由于不涉及资产写入与命令执行，回答的「执行步骤」减少，整体体感会更直接。
Q：Ask 模式下可以读取我没有权限的资产吗？
不能。Ask 模式只是限制了「写入与执行」，权限校验依然按账号实际权限进行；不能查看您原本无权访问的资产。
Q：Ask 模式下能用 @ 引用吗？
可以。@ 能力在两种模式下完全一致，详见 本文 @ 能力章节。
Q：什么时候默认会进入 Ask 模式？
目前数据接入模块的「数据源文档」功能默认呼起 Ask 模式，其他模块默认 Agent 模式。
相关文档
成员与权限管理
