package com.xly.tool; import dev.langchain4j.agent.tool.P; import dev.langchain4j.agent.tool.Tool; import org.springframework.jdbc.core.JdbcTemplate; import org.springframework.stereotype.Component; import java.util.List; import java.util.Map; /** * 知识图谱查询工具(M1)。 * *

目前只暴露 {@link #findForms} 一个只读能力:按关键词检索 ERP 业务表单目录 * (视图 {@code viw_ai_useful_forms},1748 张有用业务表单)。这是「表单名 → formId/moduleId」 * 定位的过渡实现,也是后续 KgSearch / formId 解析的雏形。 * *

表单目录是**全局元数据**(对所有品牌一致),不涉及行级/租户数据,因此不需要租户过滤。 */ @Component public class KgQueryTool { private final JdbcTemplate jdbc; public KgQueryTool(JdbcTemplate jdbc) { this.jdbc = jdbc; } @Tool("按关键词检索 ERP 业务表单目录,返回匹配的表单名、底层数据源、所属菜单id(moduleId) 与表单id(formId)。" + "当用户提到某类单据或报表、但你不确定具体是哪一张表单时,先用它来定位。最多返回 15 条。") public String findForms( @P("表单名或业务关键词,例如:报价 / 客户 / 库存 / 送货 / 应收 / 采购订单") String keyword) { if (keyword == null || keyword.isBlank()) { return "请提供一个表单名或业务关键词再检索。"; } String kw = keyword.trim(); String like = "%" + kw + "%"; List> rows = jdbc.queryForList( "SELECT af.sFormTitle, af.sDataSource, af.sExecType, af.sModuleId, af.sFormId " + "FROM viw_ai_useful_forms af " + "LEFT JOIN viw_kg_form f ON f.sFormId = af.sFormId " + "WHERE af.sFormTitle LIKE ? " + "ORDER BY COALESCE(f.bAiTool,0) DESC, (af.sExecType='table') DESC, " + "(COALESCE(f.iUpstream,0)+COALESCE(f.iDownstream,0)) DESC, CHAR_LENGTH(af.sFormTitle) ASC " + "LIMIT 12", like); if (rows.isEmpty()) { return "没有找到名称包含「" + kw + "」的业务表单。可以换个更常见的说法,或告诉我更具体的单据名称。"; } StringBuilder sb = new StringBuilder(); sb.append("找到 ").append(rows.size()).append(" 张与「").append(kw).append("」相关的业务表单:\n\n"); sb.append("| 表单 | 数据源(").append("表/视图/存储过程) | 菜单id | 表单id |\n"); sb.append("|---|---|---|---|\n"); for (Map r : rows) { sb.append("| ").append(str(r.get("sFormTitle"))) .append(" | ").append(str(r.get("sDataSource"))).append(" · ").append(str(r.get("sExecType"))) .append(" | ").append(str(r.get("sModuleId"))) .append(" | ").append(str(r.get("sFormId"))) .append(" |\n"); } return sb.toString(); } private static String str(Object o) { return o == null ? "" : o.toString(); } }