Merge pull request #168 from flashcatcloud/doc-review/2026-07-13-003402-rum-ai-query

docs(rum): document AI natural-language query in the Explorer

Author: ysyneu

en/rum/explorer/data-query.mdx

@@ -5,6 +5,46 @@ description: "Master Flashduty RUM Explorer search syntax to quickly locate and
 
 Flashduty RUM Explorer provides powerful search capabilities, allowing you to quickly locate and analyze RUM data through flexible query syntax. Queries consist of **terms** and **operators**, supporting complex search condition combinations.
 
+## AI natural-language query
+
+If you are not yet familiar with the query syntax, you can describe the data you want to find in plain language, and AI will convert it into a query for you.
+
+<Steps>
+  <Step title="Enter AI query">
+    Click the **magic wand** icon in the query input to enter AI natural-language query mode. Once active, the input border is highlighted to clearly distinguish it from regular query mode.
+  </Step>
+  <Step title="Describe your intent">
+    Describe the data you want to find in plain language (Chinese or English supported), then press **Enter** to convert. For example:
+
+    ```
+    5xx resource requests from Chrome that took longer than 2 seconds
+    ```
+
+    AI converts it into:
+
+    ```
+    browser_name:Chrome resource_status_code:>=500 resource_duration:>2s
+    ```
+  </Step>
+  <Step title="Preview and apply">
+    AI generates the corresponding query and shows a preview. When it looks right, click **Apply** and the query takes effect immediately; if the result is not what you expected, refine your description and press Enter again to regenerate, or click **Undo** to revert to the state before applying.
+  </Step>
+</Steps>
+
+<Note>
+AI generates a standard query (DQL) using the same fields and syntax as manual queries (see below). You do not need to remember field names — AI automatically picks the queryable fields based on the current event type.
+</Note>
+
+### Append instead of replace
+
+When the input already contains query conditions, the AI-generated conditions are **appended** to the existing query rather than overwriting it. This lets you build on an existing query and add filters incrementally in plain language. If the query is currently empty, the generated result is applied directly.
+
+If your description fits a different event type better, AI prompts you to switch (for example, "Switch event type to Errors") and generates the query within that event type's queryable fields.
+
+<Tip>
+Describe your intent in **plain language** in the AI input — there is no need to hand-write query syntax (such as `browser_name:Chrome`), as entering query syntax directly lowers conversion accuracy. When you need precise control over conditions, use the query syntax below instead.
+</Tip>
+
 ## Query Basics
 
 Queries support two types of terms:

zh/rum/explorer/data-query.mdx

@@ -6,6 +6,46 @@ keywords: ["RUM", "数据查看器", "用户监控", "前端监控"]
 
 Flashduty RUM 查看器提供了强大的检索能力，允许您通过灵活的查询语法快速定位和分析 RUM 数据。查询由**词项**（terms）和**操作符**（operators）组成，支持复杂的搜索条件组合。
 
+## AI 自然语言查询
+
+如果您还不熟悉查询语法，可以直接用自然语言描述想要查找的数据，AI 会自动将其转换为查询语句。
+
+<Steps>
+  <Step title="进入 AI 查询">
+    点击查询输入框中的**魔法棒**图标进入 AI 自然语言查询模式。进入后输入框边框会高亮，与普通查询模式明确区分。
+  </Step>
+  <Step title="描述查询意图">
+    用自然语言描述您想查找的数据（支持中英文），然后按**回车**转换。例如：
+
+    ```
+    来自 Chrome 浏览器、耗时超过 2 秒的 5xx 资源请求
+    ```
+
+    AI 会将其转换为：
+
+    ```
+    browser_name:Chrome resource_status_code:>=500 resource_duration:>2s
+    ```
+  </Step>
+  <Step title="预览并应用">
+    AI 生成对应的查询语句并展示预览。确认无误后点击**应用**，查询立即生效；若结果不理想，可继续修改描述后再次回车重新生成，或点击**撤销**回退到应用前的状态。
+  </Step>
+</Steps>
+
+<Note>
+AI 生成的是标准查询语句（DQL），使用的字段与语法与手动查询完全一致（详见下文）。您无需记住字段名称，AI 会根据当前事件类型自动选择可查询的字段。
+</Note>
+
+### 追加而非替换
+
+当输入框中已有查询条件时，AI 生成的条件会**追加**到现有查询之后，而不会覆盖它。因此您可以在已有查询的基础上，用自然语言逐步补充筛选条件。若当前为空查询，则直接应用生成结果。
+
+如果您的描述更适合其他事件类型，AI 会提示切换（如「将切换事件类型为 错误」），并在该事件类型的可查询字段范围内生成查询。
+
+<Tip>
+在 AI 输入框中用**自然语言**描述意图即可，无需手写查询语句（如 `browser_name:Chrome`）——直接输入查询语法反而会降低转换准确率。需要精确控制查询条件时，请改用下方的查询语法。
+</Tip>
+
 ## 查询基础
 
 查询支持两种类型的词项：