fix(agent): exclude wiki-only KBs from quick-answer (RAG) mode

Quick-answer agent mode retrieves purely through vector/keyword chunk
search and ships with no `allowed_tools`, so the existing capability
filter (which only reads from `allowed_tools`) let wiki-only KBs through
in every entry point. End result: users could @-mention, select, and
receive suggested questions from wiki-only KBs in quick-answer mode,
but the underlying retrieval always returned empty.

Treat "RAG-only" as an implicit property of `agent_mode = quick-answer`
and union it with the tool-derived filter. The same predicate is now
used everywhere the user can pick or be steered toward a KB:

Backend
- `tools.DeriveKBFilterForAgent` / `KBSatisfiesAgentRequirements`
  layer the implicit quick-answer requirement on top of tool derivation.
- `ListKnowledgeBases`, `SearchKnowledge` (shared-agent `@file`),
  `resolveKnowledgeBasesFromAgent` (chat runtime), `/search` IM command,
  and `GetSuggestedQuestions` now all use the agent-mode-aware variant.
- `GetSuggestedQuestions` also skips the wiki-page fallback for
  quick-answer agents to cover the `selected` / explicit-kb-ids paths
  where a wiki-only KB could still slip through.

Frontend
- `deriveKbFilterForAgent` / `kbSatisfiesAgentRequirements` mirror the
  Go helpers.
- `@` mention dropdown (`Input-field.vue`) uses the new helper.
- Agent editor's "specified KB" picker (`AgentEditorModal.vue`) grays
  out wiki-only KBs for quick-answer agents with a tooltip, and the
  pre-save warning fires for quick-answer mode too.
- i18n: add `agentEditor.agentType.kbMismatch.quickAnswer` across all
  four locales.
This commit is contained in:
wizardchen
2026-05-12 15:41:47 +08:00
committed by lyingbug
parent a082c04d28
commit d199628701
13 changed files with 185 additions and 23 deletions
+11 -4
View File
@@ -20,8 +20,8 @@ import { getConversationConfig, updateConversationConfig, type ConversationConfi
import { useI18n } from 'vue-i18n';
import AttachmentUpload, { type AttachmentFile } from './AttachmentUpload.vue';
import {
kbSatisfiesToolRequirements,
deriveKbFilterFromTools,
kbSatisfiesAgentRequirements,
deriveKbFilterForAgent,
toolsConsumeFiles,
type ScopeCapabilities,
} from '@/utils/tool-capabilities';
@@ -303,12 +303,19 @@ const kbToScopeCaps = (kb: any): Partial<ScopeCapabilities> => {
};
};
// 当前智能体的 agent_mode(quick-answer / smart-reasoning),用于把
// "RAG-only 模式不能 @ wiki-only 知识库"这种隐式约束带进 KB 过滤。
const agentMode = computed(() => {
if (!hasAgentConfig.value) return '';
return currentAgentConfig.value?.agent_mode || '';
});
// "all" 模式 + 智能体工具有 KB 依赖时的兼容性过滤;'selected'/'none' 不在这里二次过滤
// (selected 由编辑器负责,none 已经空表)。
const isKbCompatibleWithAgent = (kb: any): boolean => {
if (!hasAgentConfig.value) return true;
if (agentKBSelectionMode.value !== 'all') return true;
return kbSatisfiesToolRequirements(kbToScopeCaps(kb), agentAllowedTools.value);
return kbSatisfiesAgentRequirements(kbToScopeCaps(kb), agentMode.value, agentAllowedTools.value);
};
// 仅在用户没输入搜索词、且是因智能体工具兼容性把列表清空的场景展示专用空态文案
@@ -318,7 +325,7 @@ const mentionEmptyHint = computed(() => {
if (agentKBSelectionMode.value !== 'all') return '';
// 列表为空 && 兼容性过滤器其实是有效的(否则"全部"不会被剔空)
if (mentionItems.value.length !== 0) return '';
const filter = deriveKbFilterFromTools(agentAllowedTools.value);
const filter = deriveKbFilterForAgent(agentMode.value, agentAllowedTools.value);
if (!filter) return '';
return t('mentionDetail.noCompatibleKbForAgent');
});