knowledge_skill

Overview

This skill searches the WeKnora knowledge base to find documentation, configuration guides, feature descriptions, and troubleshooting steps. It combines keyword and vector search with intelligent tag filtering to return precise, relevant results. Use it when you need actionable how-to instructions or authoritative product docs. The skill exposes simple scripts to list tags and run filtered searches.

How this skill works

First it fetches available knowledge tags to understand the knowledge base structure. It maps user intent to one or more tags, then runs a hybrid search (keyword + vector) with optional tag filters to improve precision. Results are returned as JSON containing content, relevance score, and metadata for easy consumption or display.

When to use it

• You ask “how to” or “how do I” about product setup, configuration, or usage
• You need feature documentation, API references, or usage examples
• You want troubleshooting steps, common issues, or best practices
• You need targeted results for a specific area by filtering with tags

Best practices

• Get the list of available tags first to guide precise queries
• Map user keywords to suggested tags (e.g., tesla, miline, moon) before searching
• Use tag-mode 'any' for broader results or 'all' for strict intersection
• Include clear, compact queries to leverage vector search effectively
• Fallback to an untagged search when tag mapping is uncertain

Example use cases

• Find a gateway configuration guide by mapping keywords to the 'tesla' tag
• Search CI/CD pipeline examples using the 'miline' tag and deployment keywords
• Locate task scheduling documentation by filtering with the 'moon' tag
• Retrieve common troubleshooting steps by querying the '常见问题' tag
• Run an untagged search for general architecture or design questions