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:
@@ -65,7 +65,7 @@ If previous slugs are provided above, you MUST follow these rules:
|
||||
Each entity should have:
|
||||
- "name": The entity name in {{.Language}} (human-readable)
|
||||
- "slug": URL-friendly slug, format "entity/<lowercase-hyphenated-name>" (use romanized/pinyin form for non-Latin names). **Reuse previous slug if the entity was extracted before.**
|
||||
- "aliases": An array of strings representing alternative names, abbreviations, acronyms or translations of the entity found in the document. Provide [] if none.
|
||||
- "aliases": An array of strings representing names that refer to THE EXACT SAME entity. Only include: official abbreviations (e.g. "IBM" for "International Business Machines"), full/short name variants (e.g. "腾讯" for "腾讯控股有限公司"), translations (e.g. "Apple" for "苹果公司"), and well-known alternate names (e.g. "Alphabet" for "Google母公司"). Do NOT include parent categories, related products, generic terms, or broader concepts. Provide [] if none.
|
||||
- "description": **Index listing summary** — one sentence, 15-40 words, in {{.Language}}. Describes WHAT this entity IS and its role in the document. Must be self-contained (understandable without reading the full page). This will be displayed in the wiki index.
|
||||
- "details": A 2-5 sentence summary in {{.Language}} of key facts from the document. **Image rule**: If the document contains relevant <image> elements in an <images> tag, include them in the details using Markdown syntax: .
|
||||
|
||||
@@ -75,7 +75,7 @@ Only include entities that are substantively discussed (mentioned at least twice
|
||||
Each concept should have:
|
||||
- "name": The concept name in {{.Language}} (human-readable)
|
||||
- "slug": URL-friendly slug, format "concept/<lowercase-hyphenated-name>" (use romanized/pinyin form for non-Latin names). **Reuse previous slug if the concept was extracted before.**
|
||||
- "aliases": An array of strings representing alternative names, abbreviations, acronyms or translations of the concept found in the document. Provide [] if none.
|
||||
- "aliases": An array of strings representing names that refer to THE EXACT SAME concept. Only include: official abbreviations (e.g. "RAG" for "Retrieval-Augmented Generation"), full/short name variants, and well-known synonyms used interchangeably in the field. Do NOT include sub-topics, related techniques, broader categories, or implementation details. Provide [] if none.
|
||||
- "description": **Index listing summary** — one sentence, 15-40 words, in {{.Language}}. Defines WHAT this concept IS. Must be self-contained (understandable without reading the full page). This will be displayed in the wiki index.
|
||||
- "details": A 2-5 sentence explanation in {{.Language}} as discussed in the document. **Image rule**: If the document contains relevant <image> elements in an <images> tag, include them in the details using Markdown syntax: .
|
||||
|
||||
|
||||
@@ -12,12 +12,13 @@ import (
|
||||
|
||||
type wikiReplaceTextTool struct {
|
||||
BaseTool
|
||||
wikiPageService interfaces.WikiPageService
|
||||
kbIDs []string
|
||||
wikiPageService interfaces.WikiPageService
|
||||
knowledgeService interfaces.KnowledgeService
|
||||
kbIDs []string
|
||||
}
|
||||
|
||||
// NewWikiReplaceTextTool creates a new wiki_replace_text tool
|
||||
func NewWikiReplaceTextTool(wikiPageService interfaces.WikiPageService, kbIDs []string) types.Tool {
|
||||
func NewWikiReplaceTextTool(wikiPageService interfaces.WikiPageService, kbIDs []string, knowledgeService interfaces.KnowledgeService) types.Tool {
|
||||
return &wikiReplaceTextTool{
|
||||
BaseTool: NewBaseTool(
|
||||
ToolWikiReplaceText,
|
||||
@@ -40,14 +41,15 @@ func NewWikiReplaceTextTool(wikiPageService interfaces.WikiPageService, kbIDs []
|
||||
"source_refs": {
|
||||
"type": "array",
|
||||
"items": {"type": "string"},
|
||||
"description": "An optional list of source knowledge IDs that justify this change. If provided, these will COMPLETELY REPLACE the existing source_refs of the page."
|
||||
"description": "An optional list of source knowledge IDs (UUIDs only) that justify this change. If provided, these will COMPLETELY REPLACE the existing source_refs of the page."
|
||||
}
|
||||
},
|
||||
"required": ["slug", "old_text", "new_text"]
|
||||
}`),
|
||||
),
|
||||
wikiPageService: wikiPageService,
|
||||
kbIDs: kbIDs,
|
||||
wikiPageService: wikiPageService,
|
||||
knowledgeService: knowledgeService,
|
||||
kbIDs: kbIDs,
|
||||
}
|
||||
}
|
||||
|
||||
@@ -85,13 +87,13 @@ func (t *wikiReplaceTextTool) Execute(ctx context.Context, args json.RawMessage)
|
||||
existingPage.Content = strings.Replace(existingPage.Content, params.OldText, params.NewText, 1)
|
||||
|
||||
if len(params.SourceRefs) > 0 {
|
||||
existingPage.SourceRefs = params.SourceRefs
|
||||
existingPage.SourceRefs = resolveSourceRefs(ctx, t.knowledgeService, params.SourceRefs)
|
||||
}
|
||||
|
||||
_, err = t.wikiPageService.UpdatePage(ctx, existingPage)
|
||||
if err != nil {
|
||||
return &types.ToolResult{Success: false, Error: "Failed to update page: " + err.Error()}, nil
|
||||
}
|
||||
|
||||
|
||||
return &types.ToolResult{Success: true, Output: fmt.Sprintf("Successfully replaced text on page %s.", params.Slug)}, nil
|
||||
}
|
||||
|
||||
@@ -137,6 +137,7 @@ func (t *wikiReadPageTool) Execute(ctx context.Context, args json.RawMessage) (*
|
||||
<title>%s</title>
|
||||
<slug>%s</slug>
|
||||
<type>%s</type>
|
||||
<aliases>%s</aliases>
|
||||
</metadata>
|
||||
<relationships>
|
||||
<links_to>%s</links_to>
|
||||
@@ -153,6 +154,7 @@ func (t *wikiReadPageTool) Execute(ctx context.Context, args json.RawMessage) (*
|
||||
</content>
|
||||
</wiki_page>`,
|
||||
page.Title, page.Slug, page.PageType,
|
||||
strings.Join(page.Aliases, ", "),
|
||||
strings.Join(outLinksDesc, ", "),
|
||||
strings.Join(inLinksDesc, ", "),
|
||||
strings.Join(sourcesDesc, "\n"),
|
||||
@@ -278,10 +280,15 @@ func (t *wikiSearchTool) Execute(ctx context.Context, args json.RawMessage) (*ty
|
||||
snippetTag = fmt.Sprintf("\n<match_snippet>%s</match_snippet>", snippet)
|
||||
}
|
||||
|
||||
aliasesTag := ""
|
||||
if len(p.Aliases) > 0 {
|
||||
aliasesTag = fmt.Sprintf("\n<aliases>%s</aliases>", strings.Join(p.Aliases, ", "))
|
||||
}
|
||||
|
||||
if seen {
|
||||
fmt.Fprintf(&sb, "<page>\n<title>%s</title>\n<slug>%s</slug>\n<type>%s</type>\n<summary>(summary omitted, already seen in previous search)</summary>%s\n</page>\n", p.Title, p.Slug, p.PageType, snippetTag)
|
||||
fmt.Fprintf(&sb, "<page>\n<title>%s</title>\n<slug>%s</slug>\n<type>%s</type>%s\n<summary>(summary omitted, already seen in previous search)</summary>%s\n</page>\n", p.Title, p.Slug, p.PageType, aliasesTag, snippetTag)
|
||||
} else {
|
||||
fmt.Fprintf(&sb, "<page>\n<title>%s</title>\n<slug>%s</slug>\n<type>%s</type>\n<summary>%s</summary>%s\n</page>\n", p.Title, p.Slug, p.PageType, p.Summary, snippetTag)
|
||||
fmt.Fprintf(&sb, "<page>\n<title>%s</title>\n<slug>%s</slug>\n<type>%s</type>%s\n<summary>%s</summary>%s\n</page>\n", p.Title, p.Slug, p.PageType, aliasesTag, p.Summary, snippetTag)
|
||||
}
|
||||
}
|
||||
sb.WriteString("</search_results>")
|
||||
@@ -327,6 +334,36 @@ func parseStringOrArray(val any) []string {
|
||||
return nil
|
||||
}
|
||||
|
||||
// resolveSourceRefs enriches plain knowledge UUIDs to "uuid|title" format.
|
||||
// Refs already in "uuid|title" format are left unchanged.
|
||||
func resolveSourceRefs(ctx context.Context, knowledgeService interfaces.KnowledgeService, refs []string) []string {
|
||||
if len(refs) == 0 || knowledgeService == nil {
|
||||
return refs
|
||||
}
|
||||
resolved := make([]string, 0, len(refs))
|
||||
for _, ref := range refs {
|
||||
if strings.Contains(ref, "|") {
|
||||
resolved = append(resolved, ref)
|
||||
continue
|
||||
}
|
||||
kn, err := knowledgeService.GetKnowledgeByIDOnly(ctx, ref)
|
||||
if err != nil || kn == nil {
|
||||
resolved = append(resolved, ref)
|
||||
continue
|
||||
}
|
||||
title := kn.Title
|
||||
if title == "" {
|
||||
title = kn.FileName
|
||||
}
|
||||
if title != "" {
|
||||
resolved = append(resolved, ref+"|"+title)
|
||||
} else {
|
||||
resolved = append(resolved, ref)
|
||||
}
|
||||
}
|
||||
return resolved
|
||||
}
|
||||
|
||||
func extractSnippet(content string, query string) string {
|
||||
if content == "" || query == "" {
|
||||
return ""
|
||||
|
||||
@@ -13,12 +13,13 @@ import (
|
||||
|
||||
type wikiWritePageTool struct {
|
||||
BaseTool
|
||||
wikiPageService interfaces.WikiPageService
|
||||
kbIDs []string
|
||||
wikiPageService interfaces.WikiPageService
|
||||
knowledgeService interfaces.KnowledgeService
|
||||
kbIDs []string
|
||||
}
|
||||
|
||||
// NewWikiWritePageTool creates a new wiki_write_page tool
|
||||
func NewWikiWritePageTool(wikiPageService interfaces.WikiPageService, kbIDs []string) types.Tool {
|
||||
func NewWikiWritePageTool(wikiPageService interfaces.WikiPageService, kbIDs []string, knowledgeService interfaces.KnowledgeService) types.Tool {
|
||||
return &wikiWritePageTool{
|
||||
BaseTool: NewBaseTool(
|
||||
ToolWikiWritePage,
|
||||
@@ -54,14 +55,15 @@ func NewWikiWritePageTool(wikiPageService interfaces.WikiPageService, kbIDs []st
|
||||
"source_refs": {
|
||||
"type": "array",
|
||||
"items": {"type": "string"},
|
||||
"description": "A list of source knowledge IDs that contributed to this page. If provided, these will COMPLETELY REPLACE the existing source_refs of the page."
|
||||
"description": "A list of source knowledge IDs (UUIDs only) that contributed to this page. If provided, these will COMPLETELY REPLACE the existing source_refs of the page."
|
||||
}
|
||||
},
|
||||
"required": ["slug", "title", "summary", "content", "page_type"]
|
||||
}`),
|
||||
),
|
||||
wikiPageService: wikiPageService,
|
||||
kbIDs: kbIDs,
|
||||
wikiPageService: wikiPageService,
|
||||
knowledgeService: knowledgeService,
|
||||
kbIDs: kbIDs,
|
||||
}
|
||||
}
|
||||
|
||||
@@ -95,6 +97,8 @@ func (t *wikiWritePageTool) Execute(ctx context.Context, args json.RawMessage) (
|
||||
return &types.ToolResult{Success: false, Error: "Failed to check existing page: " + err.Error()}, nil
|
||||
}
|
||||
|
||||
resolvedRefs := resolveSourceRefs(ctx, t.knowledgeService, params.SourceRefs)
|
||||
|
||||
var action string
|
||||
if existingPage != nil {
|
||||
// Update
|
||||
@@ -104,8 +108,8 @@ func (t *wikiWritePageTool) Execute(ctx context.Context, args json.RawMessage) (
|
||||
existingPage.PageType = params.PageType
|
||||
existingPage.Aliases = params.Aliases
|
||||
|
||||
if len(params.SourceRefs) > 0 {
|
||||
existingPage.SourceRefs = params.SourceRefs
|
||||
if len(resolvedRefs) > 0 {
|
||||
existingPage.SourceRefs = resolvedRefs
|
||||
}
|
||||
|
||||
_, err = t.wikiPageService.UpdatePage(ctx, existingPage)
|
||||
@@ -123,7 +127,7 @@ func (t *wikiWritePageTool) Execute(ctx context.Context, args json.RawMessage) (
|
||||
Content: params.Content,
|
||||
PageType: params.PageType,
|
||||
Aliases: params.Aliases,
|
||||
SourceRefs: params.SourceRefs,
|
||||
SourceRefs: resolvedRefs,
|
||||
}
|
||||
_, err = t.wikiPageService.CreatePage(ctx, newPage)
|
||||
if err != nil {
|
||||
|
||||
Reference in New Issue
Block a user