# 使用指南

## 常见使用场景

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.reorc.com/cn-reorc-help-center/ai-agent/shi-yong-zhi-nan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.