Wegent Knowledge Base Skill

You now have access to Wegent Knowledge Base management tools.

Available Tools

• list_knowledge_bases: List all knowledge bases accessible to the current user

  • scope: "personal" (your own), "group" (team), or "all" (default)
  • group_name: Specify group name when scope="group"

• list_documents: List all documents in a knowledge base

  • knowledge_base_id: ID of the knowledge base

• create_knowledge_base: Create a new knowledge base

  • name: Knowledge base display name
  • description: Optional description
  • namespace: "default" (personal) or a group namespace (requires Maintainer+)
  • kb_type: "notebook" (default) or "classic"
  • summary_enabled: Enable automatic summary generation (default: true)

• create_document: Create a new document in a knowledge base

  • knowledge_base_id: Target knowledge base ID
  • name: Document name
  • source_type: "text" (paste content), "file" (base64 encoded), or "web" (URL to scrape)
  • content: Document content when source_type="text"
  • file_base64: Base64 encoded file when source_type="file"
  • file_extension: File extension when source_type="file"
  • url: URL to fetch when source_type="web"
  • trigger_indexing: Whether to trigger RAG indexing (default: true)
  • trigger_summary: Whether to trigger summary generation (default: true)

• read_document_content: Read raw document content with offset/limit pagination

  • document_id: Document ID to read
  • offset: Character offset to start reading from (default: 0)
  • limit: Maximum number of characters to return (uses the backend default when omitted)
  • returns: content slice, total_length, returned_length, has_more, kb_id

• update_document_content: Update a document's content for text documents and editable plain-text files

  • document_id: Document ID to update
  • content: New content (replaces existing content)
  • trigger_reindex: Whether to trigger RAG re-indexing (default: true)

Usage Notes

• All operations inherit the current user's permissions
• After creating or updating documents, indexing happens asynchronously
• Documents may show status "pending" until indexing completes
• For web scraping, the URL content is fetched and stored as document content
• update_document_content supports text documents and plain-text file documents such as txt, md, and markdown; binary files like pdf or docx still require creating or replacing the source file instead of inline editing
• Default behavior: if user doesn't specify scope, use scope="all" directly (no extra confirmation).
• Avoid loops: if a tool call fails, report the error once and stop retrying/re-loading the skill unless the user changes inputs.
• Long documents should be read incrementally: start with the backend default limit, then continue with offset = previous_offset + previous_returned_length while has_more=true

Example Workflow

1. First, list available knowledge bases:

   Copy

   list_knowledge_bases(scope="all")
   

2. List documents in a specific knowledge base:

   Copy

   list_documents(knowledge_base_id=123)
   

3. Create a new knowledge base:

   Copy

   create_knowledge_base(
     name="My KB",
     description="My personal notes",
     namespace="default",
     kb_type="notebook"
   )
   

4. Create a new text document:

   Copy

   create_document(
     knowledge_base_id=123,
     name="Meeting Notes",
     source_type="text",
     content="Notes from today's meeting..."
   )
   

5. Update document content:

   textCopy

   update_document_content(
     document_id=456,
     content="Updated notes with new information...",
     trigger_reindex=true
   )
   

6. Read long document content incrementally:

   textCopy

   read_document_content(
     document_id=456,
     offset=0
   )