使用指南

本指南将帮助你快速上手使用 Studio AI Agent，通过自然语言对话来探索和分析你的数据资产。

常见使用场景

以下是一些实际使用示例，帮助你更好地理解如何使用 AI Agent：

场景 1：查找包含特定信息的表

你可以这样问：

有哪些表包含用户信息？

你会得到：

• 匹配的表列表

• 每个表的用途和特点说明

• 相关字段的详细信息

场景 2：了解数据模型的用途

你可以这样问：

sales_order_wide 这个模型是做什么的？

你会得到：

• 模型的业务含义说明

• 数据转换逻辑的解释

• 相关的字段和依赖关系

场景 3：追踪数据流转过程

你可以这样问：

订单数据是如何从原始表转换到最终模型的？

你会得到：

• 完整的数据转换流程说明

• 可视化的流程图（可以下载保存）

• 涉及的所有数据资产列表

快速开始

第一步：打开 AI Agent

1. 登录 Studio 后，在左侧导航栏点击 AI Agent

2. 系统会自动打开你最近一次使用的对话

3. 如果想开始新对话，点击左上角的 + 按钮

第二步：了解初始页面

当你创建新的空白对话时，页面会显示一些推荐问题，这些问题是根据你有权限访问的数据资产自动生成的。你可以：

• 直接点击这些推荐问题开始对话

• 或者直接在输入框中输入你想了解的问题

如何提问

添加数据资产作为上下文

如果你想让 AI 更准确地回答你的问题，可以在提问前先添加相关的数据资产：

1. 点击输入框中的 + 按钮

2. 在弹出的选择面板中：

   • 选择整个项目：勾选项目名称左侧的复选框

   • 选择具体资产：点击项目名称或右侧箭头，进入项目查看并勾选具体的数据资产

   • 支持多选：可以跨项目选择多个数据资产

选择技巧：

• 如果想快速添加整个文件夹下的所有资产，直接勾选文件夹即可

• 如果需要精确控制，可以进入文件夹后勾选具体的资产

• 选中的资产会显示在输入框上方，你可以随时点击 × 移除

管理你的对话

创建新对话

当你想要开始一个全新的话题时，点击左上角的 + 按钮即可创建新对话。

查看历史对话

1. 点击顶部的历史对话按钮，打开历史对话列表

2. 对话会按时间自动分组：

   • 今天

   • 昨天

   • 最近 7 天

   • 最近 30 天

   • 更早

3. 在搜索框中输入关键词，可以快速找到你需要的对话

4. 点击对话右侧的 ... 菜单，可以：

   • 重命名对话（方便后续查找）

   • 删除对话

界面功能说明

顶部导航栏

左侧：

• + 按钮：创建新对话

• 历史对话 按钮：查看所有历史对话

• 对话标题：AI 会根据你的问题自动生成标题

  • 鼠标悬停在标题上会显示编辑图标，点击即可修改标题

右侧：

• 查看资产 按钮：查看当前对话中提到的所有数据资产

  • 点击后打开资产列表，按类型（模型、表、字段等）分组显示

  • 在列表中可以直接搜索资产名称

  • 点击 "添加到对话" 可以将资产添加到输入框作为上下文

  • 点击资产名称可以在右侧查看详细信息

• 更多 菜单：可以删除当前对话

右侧资产信息面板

当你在对话中点击资产引用或从资产列表打开资产时，右侧会显示资产详细信息。在信息面板中：

• 可以看到 "对话" 按钮（仅在 AI Agent 模块中显示）

• 点击该按钮，可以将当前资产添加到对话输入框作为上下文，方便继续提问

理解 AI 的回复

回答基于用户有权限访问的内容，由 AI 生成，请谨慎参考。

查看分析过程

当 AI 回答你的问题时，你可以看到它的思考过程：

• 实时查看：AI 分析时，你可以看到它正在执行的操作

• 展开详情：点击可以展开查看每类分析操作的详细信息

• 自动收起：当 AI 开始输出最终答案时，分析过程会自动收起，方便你查看结果

阅读格式化内容

AI 的回答会使用多种格式，让内容更易读：

• 标题和列表：帮助组织内容结构

• 加粗和斜体：突出重要信息

• 代码块：展示 SQL、Python 等代码，你可以直接复制使用

• 行内代码：突出显示字段名、表名等技术术语

• 表格：展示结构化数据或进行对比

• 引用：显示重要提示或说明

查看流程图

当 AI 需要展示复杂的数据关系时，会使用流程图：

• 切换视图：在预览模式和代码模式之间切换

• 预览模式：

  • 点击全屏按钮可以放大查看

  • 点击下载按钮可以保存为 PNG 图片

• 代码模式：

  • 可以全屏查看代码

  • 可以复制代码用于其他用途

适用场景：

• 理解数据清洗的处理逻辑

• 查看数据血缘关系

查看相关资产

AI 在回答中会引用相关的数据资产，你可以：

• 点击角标：回答文本中的角标表示引用的资产，点击后可以在右侧查看详细信息

• 查看相关资产列表：回答末尾会显示「相关资产」列表

  • 点击资产名称可以查看详细信息

  • 如果资产较多，默认只显示前几项，点击"展开剩余 xxx 项"可以查看全部

关于权限

AI Agent 只能访问你有权限查看的数据资产：

• 你能看到什么：仅包括你有权限访问的项目下的数据资产

• 支持的资产类型：数据源、数据模型、语义层模型、数据管道、调度任务、数据服务、标签等

如果遇到问题：

• 如果发现 AI 无法访问某些数据，可能是因为你没有相应的权限

• 关于权限的详细说明，请参考 权限配置

使用提示

• AI 的回答基于你有权限访问的内容自动生成，请谨慎参考和使用

• 当前版本主要支持数据探索相关的提问，暂不支持数据开发任务

• 如果回答不够准确，建议你更具体地描述问题，或者添加更多相关的数据资产作为上下文

所有对话历史都会自动保存，你可以随时查看和继续之前的对话

通过添加数据资产作为引用，可以为 AI 提供更多上下文，让回答更准确

如果遇到问题，可以尝试重新提问或创建新对话重新开始