> For the complete documentation index, see [llms.txt](https://docs.reorc.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.reorc.com/cn-reorc-help-center/ai-agent/shi-yong-zhi-nan.md).

# 使用指南

## 常见使用场景

以下是一些实际使用示例，帮助你更好地理解如何使用 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 的回复

{% hint style="info" %}
回答基于用户有权限访问的内容，由 AI 生成，请谨慎参考。
{% endhint %}

### 查看分析过程

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

* **实时查看**：AI 分析时，你可以看到它正在执行的操作
* **展开详情**：点击可以展开查看每类分析操作的详细信息
* **自动收起**：当 AI 开始输出最终答案时，分析过程会自动收起，方便你查看结果

### 阅读格式化内容

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

* **标题和列表**：帮助组织内容结构
* **加粗和斜体**：突出重要信息
* **代码块**：展示 SQL、Python 等代码，你可以直接复制使用
* **行内代码**：突出显示字段名、表名等技术术语
* **表格**：展示结构化数据或进行对比
* **引用**：显示重要提示或说明

### 查看流程图

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

* **切换视图**：在预览模式和代码模式之间切换
* **预览模式**：
  * 点击全屏按钮可以放大查看
  * 点击下载按钮可以保存为 PNG 图片
* **代码模式**：
  * 可以全屏查看代码
  * 可以复制代码用于其他用途

**适用场景**：

* 理解数据清洗的处理逻辑
* 查看数据血缘关系

### 查看相关资产

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

* **点击角标**：回答文本中的角标表示引用的资产，点击后可以在右侧查看详细信息
* **查看相关资产列表**：回答末尾会显示「相关资产」列表
  * 点击资产名称可以查看详细信息
  * 如果资产较多，默认只显示前几项，点击"展开剩余 xxx 项"可以查看全部

## 关于权限

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

* **你能看到什么**：仅包括你有权限访问的项目下的数据资产
* **支持的资产类型**：数据源、数据模型、语义层模型、数据管道、调度任务、数据服务、标签等

**如果遇到问题**：

* 如果发现 AI 无法访问某些数据，可能是因为你没有相应的权限
* 关于权限的详细说明，请参考 [权限配置](/cn-reorc-help-center/ai-agent/quan-xian-pei-zhi.md)

## 使用提示

{% hint style="danger" %}

* AI 的回答基于你有权限访问的内容自动生成，请谨慎参考和使用
* 当前版本主要支持数据探索相关的提问，暂不支持数据开发任务
* 如果回答不够准确，建议你更具体地描述问题，或者添加更多相关的数据资产作为上下文 
  {% endhint %}

{% hint style="info" %}
所有对话历史都会自动保存，你可以随时查看和继续之前的对话

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

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