feat: Enhance Wiki Fixer agent with improved issue handling and UI updates

- Updated the agent system prompt to refine the workflow for fixing issues, emphasizing the need to verify if issues still exist before making edits.
- Introduced a new `embeddedMode` prop in the frontend components to manage UI behavior based on the context of use.
- Simplified issue fix prompts in multiple languages for clarity, ensuring users receive concise instructions for resolving issues.
- Enhanced the WikiBrowser component to improve the display of issues and actions, including updated icons and streamlined interaction elements.

These changes significantly improve the user experience and functionality of the Wiki Fixer agent, fostering more efficient issue resolution and content management.
This commit is contained in:
wizardchen
2026-04-10 21:04:55 +08:00
parent bd096454e1
commit 995e2157cd
13 changed files with 170 additions and 120 deletions
+5 -1
View File
@@ -285,6 +285,10 @@ const props = defineProps({
assistantMessageId: {
type: String,
required: false
},
embeddedMode: {
type: Boolean,
default: false
}
});
@@ -1950,7 +1954,7 @@ defineExpose({
<!-- 控制栏 -->
<div class="control-bar">
<!-- 左侧控制按钮 -->
<div class="control-left">
<div class="control-left" v-if="!embeddedMode">
<!-- Agent 模式切换按钮 -->
<div
ref="agentModeButtonRef"
+3 -3
View File
@@ -1656,9 +1656,9 @@ export default {
issueFixSuggestions: 'Content Optimization Suggestions ({count})',
issueFixSingle: 'Fix',
fixStartError: 'Failed to start fix assistant',
issueFixPromptSingle: 'Please help me fix the following issue on page [[{slug}]]:\n\n- [{type}] {desc}\n\nOnce resolved, please call the `wiki_update_issue` tool to mark this issue (ID: {id}) as resolved.',
issueFixPromptAutoStart: 'Please help me fix all pending issues on page [[{slug}]]:',
issueFixPromptAutoEnd: 'Once resolved, please call the `wiki_update_issue` tool to mark these issues as resolved.',
issueFixPromptSingle: 'Please fix the issue (ID: {id}) on page [[{slug}]].',
issueFixPromptAutoStart: 'Please fix the following issues on page [[{slug}]]:',
issueFixPromptAutoEnd: '',
},
buttons: {
create: 'Create Knowledge Base',
+3 -3
View File
@@ -2179,9 +2179,9 @@ export default {
issueFixSuggestions: "콘텐츠 최적화 제안 ({count})",
issueFixSingle: "수정",
fixStartError: "수정 도우미 시작 실패",
issueFixPromptSingle: "페이지 [[{slug}]] 의 다음 문제를 수정해 주세요:\n\n- [{type}] {desc}\n\n해결 완료 후 `wiki_update_issue` 도구를 호출하여 이 문제(ID: {id})를 해결됨으로 표시해 주세요.",
issueFixPromptAutoStart: "페이지 [[{slug}]] 의 모든 보류 중인 문제를 수정해 주세요:",
issueFixPromptAutoEnd: "해결 완료 후 `wiki_update_issue` 도구를 호출하여 이 문제들을 해결됨으로 표시해 주세요.",
issueFixPromptSingle: "페이지 [[{slug}]] 의 문제(ID: {id})를 수정해 주세요.",
issueFixPromptAutoStart: "페이지 [[{slug}]] 의 다음 문제들을 수정해 주세요:",
issueFixPromptAutoEnd: "",
},
buttons: {
create: "지식베이스 생성",
+3 -3
View File
@@ -1858,9 +1858,9 @@ export default {
issueFixSuggestions: 'Предложения по оптимизации ({count})',
issueFixSingle: 'Исправить',
fixStartError: 'Не удалось запустить помощник исправления',
issueFixPromptSingle: 'Пожалуйста, помогите исправить следующую проблему на странице [[{slug}]]:\n\n- [{type}] {desc}\n\nПосле устранения проблемы, пожалуйста, вызовите инструмент `wiki_update_issue`, чтобы пометить эту проблему (ID: {id}) как решенную.',
issueFixPromptAutoStart: 'Пожалуйста, помогите исправить все ожидающие проблемы на странице [[{slug}]]:',
issueFixPromptAutoEnd: 'После устранения проблем, пожалуйста, вызовите инструмент `wiki_update_issue`, чтобы пометить эти проблемы как решенные.',
issueFixPromptSingle: 'Пожалуйста, исправьте проблему (ID: {id}) на странице [[{slug}]].',
issueFixPromptAutoStart: 'Пожалуйста, исправьте следующие проблемы на странице [[{slug}]]:',
issueFixPromptAutoEnd: '',
},
buttons: {
create: 'Создать базу знаний',
+3 -3
View File
@@ -2164,9 +2164,9 @@ export default {
issueFixSuggestions: "内容优化建议 ({count})",
issueFixSingle: "修复",
fixStartError: "启动修复助手失败",
issueFixPromptSingle: "请帮我修复页面 [[{slug}]] 上的以下问题:\n\n- [{type}] {desc}\n\n解决完毕后,请调用 `wiki_update_issue` 工具将该问题 (ID: {id}) 标记为已解决。",
issueFixPromptAutoStart: "请帮我修复页面 [[{slug}]] 上的所有待处理问题:",
issueFixPromptAutoEnd: "解决完毕后,请调用 `wiki_update_issue` 工具将这些问题标记为已解决。",
issueFixPromptSingle: "请修复页面 [[{slug}]] 上的问题 (ID: {id})。",
issueFixPromptAutoStart: "请修复页面 [[{slug}]] 上的以下问题:",
issueFixPromptAutoEnd: "",
},
buttons: {
create: "创建知识库",
+10 -10
View File
@@ -164,10 +164,10 @@ const fetchSuggestedQuestions = async () => {
suggestedQuestionsLoading.value = true;
// 加载期间保留旧数据,不清空,避免布局抖动
try {
const agentId = useSettingsStoreInstance.selectedAgentId;
const agentId = props.embeddedMode ? props.agentId : useSettingsStoreInstance.selectedAgentId;
if (!agentId) return;
const selectedKBs = useSettingsStoreInstance.getSelectedKnowledgeBases();
const selectedFiles = useSettingsStoreInstance.getSelectedFiles();
const selectedKBs = props.embeddedMode ? props.kbIds : useSettingsStoreInstance.getSelectedKnowledgeBases();
const selectedFiles = props.embeddedMode ? [] : useSettingsStoreInstance.getSelectedFiles();
const res = await getSuggestedQuestions(agentId, {
knowledge_base_ids: selectedKBs.length > 0 ? selectedKBs : undefined,
knowledge_ids: selectedFiles.length > 0 ? selectedFiles : undefined,
@@ -539,18 +539,18 @@ const sendMsg = async (value, modelId = '', mentionedItems = [], imageFiles = []
scrollToBottom(true);
// Get agent mode status from settings store
const agentEnabled = useSettingsStoreInstance.isAgentEnabled;
const agentEnabled = props.embeddedMode ? (props.agentId && props.agentId !== 'builtin-quick-answer') : useSettingsStoreInstance.isAgentEnabled;
// Get web search status from settings store
const webSearchEnabled = useSettingsStoreInstance.isWebSearchEnabled;
const webSearchEnabled = props.embeddedMode ? false : useSettingsStoreInstance.isWebSearchEnabled;
// Get memory status from settings store
const enableMemory = useSettingsStoreInstance.isMemoryEnabled;
const enableMemory = props.embeddedMode ? false : useSettingsStoreInstance.isMemoryEnabled;
// Get knowledge_base_ids from settings store (selected by user via KnowledgeBaseSelector)
// Merge @mentioned KB/file IDs so retrieval uses the same targets user @mentioned (including shared KBs)
const sidebarKbIds = useSettingsStoreInstance.settings.selectedKnowledgeBases || [];
const sidebarFileIds = useSettingsStoreInstance.settings.selectedFiles || [];
const sidebarKbIds = props.embeddedMode ? props.kbIds : (useSettingsStoreInstance.settings.selectedKnowledgeBases || []);
const sidebarFileIds = props.embeddedMode ? [] : (useSettingsStoreInstance.settings.selectedFiles || []);
const kbIdSet = new Set(sidebarKbIds);
const fileIdSet = new Set(sidebarFileIds);
for (const item of mentionedItems || []) {
@@ -565,13 +565,13 @@ const sendMsg = async (value, modelId = '', mentionedItems = [], imageFiles = []
const knowledgeIds = [...fileIdSet];
// Get selected agent ID (backend resolves shared agent and its tenant from share relation)
const selectedAgentId = useSettingsStoreInstance.selectedAgentId || '';
const selectedAgentId = props.embeddedMode ? props.agentId : (useSettingsStoreInstance.selectedAgentId || '');
// Use agent-chat endpoint when agent is enabled, otherwise use knowledge-chat
const endpoint = agentEnabled ? '/api/v1/agent-chat' : '/api/v1/knowledge-chat';
// Get selected MCP services from settings store (if available)
const mcpServiceIds = useSettingsStoreInstance.settings.selectedMCPServices || [];
const mcpServiceIds = props.embeddedMode ? [] : (useSettingsStoreInstance.settings.selectedMCPServices || []);
await startStream({
session_id: session_id.value,
@@ -232,14 +232,12 @@
trigger="click"
:overlayInnerStyle="{ padding: 0, boxShadow: 'var(--td-shadow-3)', borderRadius: '8px', width: '560px', maxWidth: '90vw' }"
>
<t-tag
theme="warning"
variant="light-outline"
<span
class="wiki-issue-trigger"
:title="$t('knowledgeEditor.wikiBrowser.issueTitle', { count: pageIssues.length })"
>
<template #icon><t-icon name="error-circle" /></template>
{{ $t('knowledgeEditor.wikiBrowser.issueTitle', { count: pageIssues.length }) }}
</t-tag>
<t-icon name="error-circle-filled" style="color: var(--td-warning-color);" />
</span>
<template #content>
<div class="wiki-issue-popup-content">
@@ -248,28 +246,29 @@
<span>{{ $t('knowledgeEditor.wikiBrowser.issueFixSuggestions', { count: pageIssues.length }) }}</span>
</div>
<t-button size="small" theme="primary" variant="base" @click="triggerAutoFix">
<template #icon><t-icon name="magic" /></template>
<template #icon><t-icon name="tools" /></template>
{{ $t('knowledgeEditor.wikiBrowser.issueFixBtn') }}
</t-button>
</div>
<div class="wiki-issue-popup-list">
<div v-for="issue in pageIssues" :key="issue.id" class="wiki-issue-popup-item">
<div class="wiki-issue-popup-main">
<div class="wiki-issue-popup-tags">
<t-tag v-if="issue.issue_type === 'mixed_entities'" theme="warning" variant="light" size="small">{{ $t('knowledgeEditor.wikiBrowser.issueMixed') }}</t-tag>
<t-tag v-else-if="issue.issue_type === 'contradictory_facts'" theme="danger" variant="light" size="small">{{ $t('knowledgeEditor.wikiBrowser.issueConflict') }}</t-tag>
<t-tag v-else-if="issue.issue_type === 'out_of_date'" theme="default" variant="light" size="small">{{ $t('knowledgeEditor.wikiBrowser.issueOutdated') }}</t-tag>
<t-tag v-else theme="primary" variant="light" size="small">{{ $t('knowledgeEditor.wikiBrowser.issueAttention') }}</t-tag>
</div>
<div class="wiki-issue-popup-desc">
{{ issue.description }}
</div>
<div class="wiki-issue-popup-meta">
<span class="wiki-issue-popup-reporter">
{{ issue.reported_by === 'wiki-researcher-agent' ? $t('knowledgeEditor.wikiBrowser.issueAiLinter') : $t('knowledgeEditor.wikiBrowser.issueReportedBy', { reporter: issue.reported_by }) }}
</span>
<div class="wiki-issue-popup-list">
<div v-for="issue in pageIssues" :key="issue.id" class="wiki-issue-popup-item">
<div class="wiki-issue-popup-main">
<div class="wiki-issue-popup-tags">
<t-tag v-if="issue.issue_type === 'mixed_entities'" theme="warning" variant="light" size="small">{{ $t('knowledgeEditor.wikiBrowser.issueMixed') }}</t-tag>
<t-tag v-else-if="issue.issue_type === 'contradictory_facts'" theme="danger" variant="light" size="small">{{ $t('knowledgeEditor.wikiBrowser.issueConflict') }}</t-tag>
<t-tag v-else-if="issue.issue_type === 'out_of_date'" theme="default" variant="light" size="small">{{ $t('knowledgeEditor.wikiBrowser.issueOutdated') }}</t-tag>
<t-tag v-else theme="primary" variant="light" size="small">{{ $t('knowledgeEditor.wikiBrowser.issueAttention') }}</t-tag>
</div>
<div class="wiki-issue-popup-desc">
{{ issue.description }}
</div>
<div class="wiki-issue-popup-meta">
<span class="wiki-issue-popup-reporter">
{{ issue.reported_by === 'wiki-researcher-agent' ? $t('knowledgeEditor.wikiBrowser.issueAiLinter') : $t('knowledgeEditor.wikiBrowser.issueReportedBy', { reporter: issue.reported_by }) }}
</span>
<div class="wiki-issue-popup-actions">
<span class="wiki-issue-popup-action" @click="triggerFixIssue(issue)" style="margin-right: 12px; font-weight: 500;">
<t-icon name="magic" style="margin-right: 2px;" />{{ $t('knowledgeEditor.wikiBrowser.issueFixSingle') }}
<t-icon name="tools" style="margin-right: 4px;" />{{ $t('knowledgeEditor.wikiBrowser.issueFixSingle') }}
</span>
<span class="wiki-issue-popup-action" style="color: var(--td-text-color-placeholder);" @click="handleIssueIgnore(issue.id)">{{ $t('knowledgeEditor.wikiBrowser.issueIgnore') }}</span>
</div>
@@ -277,6 +276,7 @@
</div>
</div>
</div>
</div>
</template>
</t-popup>
</h2>
@@ -377,10 +377,12 @@
<span class="wiki-issue-popup-reporter">
{{ issue.reported_by === 'wiki-researcher-agent' ? $t('knowledgeEditor.wikiBrowser.issueAiLinter') : $t('knowledgeEditor.wikiBrowser.issueReportedBy', { reporter: issue.reported_by }) }}
</span>
<span class="wiki-issue-popup-action" @click="navigateToSlugAndFix(issue.slug)" style="margin-right: 12px; font-weight: 500;">
<t-icon name="arrow-right-circle" style="margin-right: 2px;" />{{ $t('knowledgeEditor.wikiBrowser.issueGoFix') }}
</span>
<span class="wiki-issue-popup-action" style="color: var(--td-text-color-placeholder);" @click="handleGlobalIssueIgnore(issue.id)">{{ $t('knowledgeEditor.wikiBrowser.issueIgnore') }}</span>
<div class="wiki-issue-popup-actions">
<span class="wiki-issue-popup-action" @click="navigateToSlugAndFix(issue.slug)" style="margin-right: 12px; font-weight: 500;">
<t-icon name="arrow-right-circle" style="margin-right: 4px;" />{{ $t('knowledgeEditor.wikiBrowser.issueGoFix') }}
</span>
<span class="wiki-issue-popup-action" style="color: var(--td-text-color-placeholder);" @click="handleGlobalIssueIgnore(issue.id)">{{ $t('knowledgeEditor.wikiBrowser.issueIgnore') }}</span>
</div>
</div>
</div>
</div>
@@ -882,21 +884,8 @@ async function handleIssueIgnore(issueId: string) {
}
async function startFixSession(prompt: string) {
settingsStore.selectAgent("builtin-wiki-fixer", null)
const sessionData: any = {
agent_config: {
enabled: true,
max_iterations: 30,
temperature: 0.7,
knowledge_bases: [props.knowledgeBaseId],
knowledge_ids: [],
allowed_tools: ["thinking", "wiki_read_page", "wiki_search", "wiki_read_source_doc", "wiki_edit_page", "wiki_read_issue", "wiki_update_issue"]
}
}
try {
const res = await createSessions(sessionData)
const res = await createSessions({})
if (res && (res as any).data && (res as any).data.id) {
const sessionId = (res as any).data.id
const now = new Date().toISOString()
@@ -930,8 +919,6 @@ function triggerFixIssue(issue: WikiPageIssue) {
if (!selectedPage.value) return
const prompt = t('knowledgeEditor.wikiBrowser.issueFixPromptSingle', {
slug: selectedPage.value.slug,
type: issue.issue_type,
desc: issue.description,
id: issue.id
})
startFixSession(prompt)
@@ -942,10 +929,9 @@ function triggerAutoFix() {
let prompt = t('knowledgeEditor.wikiBrowser.issueFixPromptAutoStart', { slug: selectedPage.value.slug }) + '\n\n'
pageIssues.value.forEach((issue, idx) => {
prompt += `${idx + 1}. [${issue.issue_type}] ${issue.description} (ID: ${issue.id})\n`
prompt += `${idx + 1}. Issue ID: ${issue.id}\n`
})
prompt += '\n' + t('knowledgeEditor.wikiBrowser.issueFixPromptAutoEnd')
startFixSession(prompt)
}
@@ -2446,13 +2432,16 @@ onUnmounted(() => {
// ── Issues Popup ──
.wiki-issue-trigger {
margin-left: 12px;
margin-left: 8px;
cursor: pointer;
transition: all 0.2s ease;
user-select: none;
display: flex;
align-items: center;
justify-content: center;
font-size: 20px;
transition: opacity 0.2s ease;
&:hover {
filter: brightness(0.95);
opacity: 0.8;
}
}
@@ -2492,21 +2481,21 @@ onUnmounted(() => {
flex-direction: column;
max-height: 400px;
overflow-y: auto;
gap: 12px;
padding: 8px 12px;
}
.wiki-issue-popup-item {
display: flex;
padding: 16px;
gap: 12px;
border-bottom: 1px solid var(--td-component-stroke);
transition: background-color 0.2s ease;
&:last-child {
border-bottom: none;
}
border: 1px solid var(--td-component-border);
border-radius: 6px;
transition: box-shadow 0.2s ease, border-color 0.2s ease;
background: var(--td-bg-color-container);
&:hover {
background: var(--td-bg-color-container-hover);
border-color: var(--td-brand-color-light);
}
}
@@ -2550,12 +2539,20 @@ onUnmounted(() => {
display: flex;
align-items: center;
gap: 16px;
margin-top: 4px;
margin-top: 8px;
padding-top: 12px;
border-top: 1px dashed var(--td-component-stroke);
}
.wiki-issue-popup-reporter {
font-size: 12px;
color: var(--td-text-color-placeholder);
flex: 1;
}
.wiki-issue-popup-actions {
display: flex;
align-items: center;
}
.wiki-issue-popup-action {