混合查询

混合模式由 JEV 选择相关上下文，LLM 提出 SQL，再由 JEV 复核。适合需要更自由表达或较复杂 SQL 组合的查询，但仍需要检查方案是否符合实际需求。

发起查询#

在工作区选择“混合查询”，或向 POST /ask 提交：

{
  "question": "列出每位客户最近一次付款，以及它与上一次付款的差额。",
  "planner_mode": "hybrid",
  "dataset_ids": ["customers", "payments"],
  "execute": false
}

示例数据集须已在当前租户目录中注册。可以通过 knowledge 补充业务定义；execute: false 返回方案，不执行 SQL。

配置模型#

除了 JEV 服务，还需要能生成结构化输出的 LLM。使用 API transport 时，在服务端配置：

SDD_LLM_TRANSPORT=openai
SDD_LLM_MODEL=your-model
OPENAI_API_KEY=your-api-key

模型名称应选择当前服务账户可用的模型。JEV 的地址、模型和密钥仍按模型服务配置单独设置。

处理流程#

1. 选择相关定义和字段，保留主键与关联所需字段。
2. 在限定范围内读取样本，帮助理解真实取值。
3. 生成 SQL、假设及候选替代方案。
4. 检查访问权限和 SQL 合法性，并行复核输出、数据范围、关联、公式等。
5. 对明确的问题尝试受支持的修正，必要时等待用户复核。

样本只帮助理解，执行时仍使用完整的获准数据范围。计算由 SQL 完成。

修正与执行#

默认允许针对具体缺陷额外生成一次修正方案；仅有不确定性时，会保留方案等待复核，不无限重试。工作区中的“使用此解释”会重建预览，不直接执行。

plan.hybrid 保留检索范围、候选方案、检查结果、修正和用量。查看这些信息可以理解方案来源，但模型分数不等于正确率。写入仍需要单独检查并提交变更预览。

本页介绍用法与注意事项。完整参数及详细约定请参阅对应英文文档。