Просмотр исходного кода

fix(agent): 未勾选工具包时仅保留基础设施工具

- 移除“默认使用 6 个内置工具包”的回落逻辑
- tool_packs_json 为空且无旧工具组时,不注册任何业务工具,仅保留
  registerInfraTools 注册的基础设施工具
- 前端提示与方案摘要改为“仅基础工具”,同步数据模型/SQL 注释
cc 2 недель назад
Родитель
Сommit
01fbc2adf1

+ 2 - 2
ai-electron/frontend/src/ai/api/types.ts

@@ -56,7 +56,7 @@ export interface AiExpert {
   toolGroups?: string[] | null;
   /** 允许的技能白名单;null/空 = 不限制 */
   skillNames?: string[] | null;
-  /** 勾选的工具包 id 列表;构成该方案的业务工具白名单;null/空 = 使用系统内置工具包 */
+  /** 勾选的工具包 id 列表;构成该方案的业务工具白名单;null/空 = 仅基础工具(不注册业务工具) */
   toolPackIds?: string[] | null;
   /** 绑定的知识库 id;null/缺省 = 未绑定(绑定后对话自动获得 search_knowledge 工具) */
   knowledgeBaseId?: string | null;
@@ -70,7 +70,7 @@ export interface SaveExpertParams {
   /** 旧工具组(UI 已并入工具包;仅映射不到内置包的组才回落写回) */
   toolGroups?: string[];
   skillNames?: string[];
-  /** 工具包 id 列表;空 = 使用系统内置工具包 */
+  /** 工具包 id 列表;空 = 仅基础工具(不注册业务工具) */
   toolPackIds?: string[];
   /** 绑定的知识库 id;不传/null = 不绑定 */
   knowledgeBaseId?: string | null;

+ 6 - 6
ai-electron/frontend/src/ai/components/AgentFormModal.vue

@@ -79,16 +79,16 @@
           </div>
         </section>
 
-        <!-- 可用工具包(卡片多选:不勾 = 使用默认内置工具包);内置 6 个包与业务工具组同构,旧方案的工具组勾选打开时自动映射进来 -->
+        <!-- 可用工具包(卡片多选:不勾 = 仅基础工具);内置 6 个包与业务工具组同构,旧方案的工具组勾选打开时自动映射进来 -->
         <section class="ae-form__panel">
           <div class="ae-form__sec-head">
             <span class="ae-form__sec-title">可用工具包</span>
-            <span class="ae-form__count">{{ pickedPackIds.length ? `已选 ${pickedPackIds.length}` : '默认内置' }}</span>
+            <span class="ae-form__count">{{ pickedPackIds.length ? `已选 ${pickedPackIds.length}` : '仅基础工具' }}</span>
             <span class="ae-form__sp"></span>
           </div>
           <div class="ae-form__hint"
             >不勾选 =
-            使用默认内置工具包(人物画像 / 通话分析 / 交易与资金 / 轨迹出行 / 关系图谱 / 非表格材料);勾选的工具包构成业务工具白名单,未选的业务工具对模型不可见。工具包在「插件与技能 →
+            只启用基础设施工具(SQL 分析、Python、工作空间/治理表查询、知识库检索等),不注册任何业务工具;勾选的工具包构成业务工具白名单,未选的业务工具对模型不可见。工具包在「插件与技能 →
             工具包」维护。</div
           >
           <a-spin :spinning="packsLoading">
@@ -177,8 +177,8 @@
    * 研判方案新建/编辑弹框:内容版式取自新建方案页设计稿(纯页面版试过被否,回弹框,默认窗口态打开、可手动全屏)。
    *
    * 逻辑与历史弹框版完全一致:
-   *  - 勾选语义:技能不勾 = 不限制;工具包不勾 = 使用系统内置工具包
-   *    (tool_packs_json 为空时,后端回落到 6 个内置包,而不是全部业务工具),
+   *  - 勾选语义:技能不勾 = 不限制;工具包不勾 = 仅注册基础设施工具
+   *    (tool_packs_json 为空且无旧工具组时,后端不注册任何业务工具),
    *    勾选若干 = 只启用所选(工具包构成业务工具白名单,未选的对模型不可见);
    *  - 「工具组就是工具包」:内置 6 个工具包与 6 个业务工具组同名同工具(AgentToolRegistry 逐个相等),
    *    页面只保留「可用工具包」一区。旧方案的 tools_allow_json(工具组编码)打开时按组名映射成对应
@@ -284,7 +284,7 @@
   function resetChecks() {
     Object.keys(checkedPacks).forEach((k) => delete checkedPacks[k]);
     Object.keys(checkedSkills).forEach((k) => delete checkedSkills[k]);
-    // 工具包不勾 = 使用后端内置包;技能不勾 = 不限制(与后端 null 口径一致)
+    // 工具包不勾 = 仅基础工具;技能不勾 = 不限制(与后端 null 口径一致)
     const names = props.record?.skillNames || [];
     names.forEach((n) => (checkedSkills[n] = true));
     const packIds = props.record?.toolPackIds || [];

+ 3 - 3
ai-electron/frontend/src/ai/views/aiExpert/index.vue

@@ -137,7 +137,7 @@
           <div v-if="detailToolChips.length" class="ae-detail__chips">
             <span v-for="n in detailToolChips" :key="n" class="ae-detail__chip">{{ n }}</span>
           </div>
-          <div v-else class="ae-detail__none">默认内置(系统内置工具包)</div>
+          <div v-else class="ae-detail__none">仅基础工具(不注册业务工具)</div>
         </section>
 
         <section class="ae-detail__panel">
@@ -248,11 +248,11 @@
     }
   }
 
-  /** 工具摘要:勾了工具包显示包数,旧方案还有工具组的列出组名,都没有 = 默认内置 */
+  /** 工具摘要:勾了工具包显示包数,旧方案还有工具组的列出组名,都没有 = 仅基础工具 */
   function groupSummary(e: AiExpert): string {
     const groups = e.toolGroups || [];
     const packIds = e.toolPackIds || [];
-    if (!groups.length && !packIds.length) return '工具:默认内置';
+    if (!groups.length && !packIds.length) return '工具:仅基础工具';
     const parts: string[] = [];
     if (packIds.length) parts.push(`${packIds.length} 个工具包`);
     if (groups.length) parts.push(groups.map((g) => toolGroupLabel(g)).join('、'));

+ 4 - 8
ai-server/src/main/java/com/zsjz/ai/module/agent/service/AgentService.java

@@ -300,17 +300,13 @@ public class AgentService extends ServiceImpl<AgentMapper, AgentEntity> {
         // 业务工具组:旧方案配置了 tools_allow_json → 只注册并装备这些组
         // (组外工具不注册 = 模型不可见、reset_equipped_tools 也切不过去,构成真实限制)
         List<String> expertGroups = readStringList(entry.getToolsAllowJson());
-        // 工具包(tool_packs_json):包内工具与组白名单并集构成工具级白名单;
-        // 未勾选任何工具包且没有旧工具组限制时,默认使用系统内置的 6 个工具包,
-        // 而不是“不限制”把全部业务工具放开。
+        // 工具包(tool_packs_json):包内工具与组白名单并集构成工具级白名单。
+        // 未勾选任何工具包且没有旧工具组限制时,只保留 registerInfraTools 注册的基础设施工具,
+        // 不注册任何业务工具 —— 不再把“未勾选”解释为全部业务工具可用。
         Set<String> packTools = toolPackService.resolveToolNames(readStringList(entry.getToolPacksJson()));
-        if (packTools.isEmpty() && (expertGroups == null || expertGroups.isEmpty())) {
-            packTools = toolPackService.resolveBuiltinToolNames();
-        }
         if (packTools.isEmpty()) {
             if (expertGroups == null || expertGroups.isEmpty()) {
-                // 兜底:内置包未初始化时仍按全量业务工具注册(老库/空库可用性优先)
-                agentToolRegistry.registerBusinessTools(toolkit);
+                log.debug("方案未绑定工具包与工具组,仅注册基础设施工具: agentRowId={}", entry.getRowId());
             } else {
                 // enabled = 专家启用的组(限制集);初始装备仍按默认口径(person,省 token),
                 // 专家没启用 person 时重载会自动回落到「启用的组」

+ 0 - 22
ai-server/src/main/java/com/zsjz/ai/module/agent/service/ToolPackService.java

@@ -120,28 +120,6 @@ public class ToolPackService extends ServiceImpl<AgentToolPackMapper, AgentToolP
         return out;
     }
 
-    /**
-     * 内置工具包的工具名并集。
-     *
-     * <p>方案未勾选任何工具包时的默认口径:使用系统内置的 6 个包,
-     * 而不是把全部业务工具(含自建包里的任意组合)都放开。</p>
-     *
-     * @return 内置包工具名并集;库未初始化时为空
-     */
-    public Set<String> resolveBuiltinToolNames() {
-        Set<String> out = new LinkedHashSet<>();
-        for (AgentToolPackEntity entity : lambdaQuery()
-                .eq(AgentToolPackEntity::getIsBuiltin, 1)
-                .orderByAsc(AgentToolPackEntity::getId)
-                .list()) {
-            List<String> names = AgentService.readStringList(entity.getToolNames());
-            if (names != null) {
-                out.addAll(names);
-            }
-        }
-        return out;
-    }
-
     /** 入参校验:包名非空(@NotBlank 之外兜底)、工具名去重且都是已注册业务工具 */
     private List<String> validateToolNames(List<String> toolNames) {
         List<String> distinct = toolNames == null

+ 1 - 1
docs/agent-data-model.md

@@ -46,7 +46,7 @@ erDiagram
 |---|---|---|---|
 | 工具 ↔ 工具包 | **一个工具可出现在多个包**;一个包含多个工具 | `agent_tool_pack.tool_names[]`(工具名数组) | 同一个 `tool_name` 可以出现在任意多个包的数组里,互不影响 |
 | 工具包 ↔ 研判方案 | **一个包可被多个方案勾选**;一个方案可勾多个包 | `agent.tool_packs_json[]`(包 id 数组) | 同一个包 id 可以出现在任意多个方案的数组里;改包内容对所有引用它的方案**即时生效**(下次装配) |
-| 工具 ↔ 研判方案 | 传递多对多(经包)+ 直接的**工具组**白名单 | `agent.tools_allow_json[]`(组编码) | 方案最终可见的业务工具 = 所选工具组的全部工具 ∪ 所选工具包的工具;工具包与工具组都不勾 = 默认使用系统内置的 6 个工具包 |
+| 工具 ↔ 研判方案 | 传递多对多(经包)+ 直接的**工具组**白名单 | `agent.tools_allow_json[]`(组编码) | 方案最终可见的业务工具 = 所选工具组的全部工具 ∪ 所选工具包的工具;工具包与工具组都不勾 = 仅注册基础设施工具,不注册业务工具 |
 
 ## ID 约定
 

+ 1 - 1
sql/agent_tool_pack.sql

@@ -7,7 +7,7 @@
 --   2) 在「插件与技能 → 工具包」维护,在「新建研判方案」时勾选启用;
 --      与方案的 tools_allow_json(工具组白名单)叠加:
 --      组白名单 ∪ 工具包内工具 = 该方案最终可见的业务工具;
---      工具包与工具组都不勾 = 使用系统内置的 6 个工具包(默认口径);
+--      工具包与工具组都不勾 = 仅注册基础设施工具,不注册业务工具;
 --   3) 按用户隔离(user_id):只有创建者可见/可改/可删;方案绑定工具包时后端校验归属;
 --   4) tool_names 用 TEXT 存 JSON 字符串数组(与 agent.tools_allow_json 同口径,前端直接收数组)。
 --