数据检索¶

Obsy AI Copilot 可以帮助用户编写查询语句，也可以把自然语言转换为查看器筛选条件。两种能力的目标不同：DQL / PromQL 助手交付可阅读和复用的查询语句；查看器自然语言搜索用于筛选当前页面的数据。

DQL / PromQL 助手¶

DQL / PromQL 助手用于生成、解释、修复和评审查询语句，也可以将适合转换的 DQL 改写为平台 PromQL。生成 DQL 时，Copilot 会优先核对当前工作空间中的真实数据源、字段和标签，并对最终 DQL 进行语法检查。

该能力不会因为用户提出“查看最近日志”就默认返回 DQL。只有明确要求编写、解释、修复、评审或转换 DQL / PromQL 时，才会进入查询语言流程。

适合处理以下查询任务：

• 不熟悉 DQL 或 PromQL 语法，需要根据目标生成查询；
• 已有查询无法通过、结果口径不清楚或需要检查风险；
• 希望理解一条已有查询的过滤、聚合、分组和时间窗口；
• 需要把指标类 DQL 转换为平台 PromQL；
• 希望获得基于当前工作空间真实字段的查询，而不是通用示例。

编写或检查查询¶

直接在 Copilot 中描述查询目标，并尽量提供以下信息：

• 数据域：指标、日志、事件、链路、RUM 或其他数据类型；
• 数据对象：已知的 measurement、source、service 或字段；
• 时间范围：例如最近 30 分钟或过去 7 天；
• 统计口径：总量、速率、平均值、百分位、TopN 或分组维度；
• 输出类型：DQL、平台 PromQL，或标准 Prometheus 查询。

示例：

请为当前工作空间生成一条 DQL：统计最近 30 分钟各服务的错误日志数量，按数量倒序返回前 10 个服务。

如果需要修复或解释查询，请直接粘贴原始语句并说明期望结果。数据域、时间范围或统计口径存在歧义时，Copilot 会先要求补充信息，而不是猜测数据源和字段。

查询结果与校验¶

生成 DQL 时，Copilot 默认返回一条最符合需求且已完成语法检查的查询，并简要解释数据源、过滤条件、聚合和时间范围。字段或数据源无法从当前工作空间确认时，会说明限制并请用户选择，不会把未确认字段描述为真实存在。

生成 PromQL 时，默认使用平台支持的 measurement:field 指标口径。PromQL 不会在该流程中实际运行；请在目标查询页面执行并确认数据结果。DQL 的语法检查同样只验证语句结构，不代表查询在所选时间范围内一定有数据。

查看器自然语言搜索¶

查看器自然语言搜索会把用户描述转换为当前查看器可以识别的查询条件，并与已有查询和时间范围一起交给页面执行。它适合不熟悉查看器语法，但已经知道要筛选哪些对象、状态或数值范围的用户。

当前能力适用于已接入自然语言搜索的日志、链路、RUM、基础对象、资源目录、事件、可用性监测、安全、云账单、备份日志、Agent 监控和 LLM 等查看器。

设置筛选条件¶

在支持该能力的查看器中，用自然语言描述筛选目标。例如：

查找 service 为 checkout、状态异常并且耗时大于 2 秒的数据，只看最近 3 小时。

可以表达等于、不等于、包含、通配、正则、数值比较、区间、字段是否存在，以及 AND、OR、NOT 等组合条件。实际可用操作取决于当前字段类型。

默认情况下，Copilot 会保留查询框中已有的条件，并在后面追加新条件。如果希望替换已有条件，请明确使用“重新查询”“清空原条件”“只查”或“替换为”等表达。

条件转换规则¶

Copilot 会根据当前查看器提供的字段清单生成查询条件：

• 能与当前字段或字段别名明确对应的内容，会转换为结构化筛选条件；
• 无法确认字段的关键词，会保留为普通文本搜索，不会强行映射到相似字段；
• 服务名、资源名、ID、URL、路径和错误文本等业务值会尽量保留原文；
• 用户明确给出的时间表达会交给查看器时间控件处理。

生成结果用于当前查看器筛选，不会创建 DQL，也不会修改数据。字段未出现在当前页面可用字段中时，即使其他查看器存在同名字段，也不会将其作为结构化条件使用。