--- name: knowledge-base-management description: Manage IT knowledge bases including article creation, categorization, search optimization, self-service deflection, and continuous improvement. Use when building KB articles, implementing self-service portals, measuring KB effectiveness, or optimizing knowledge management processes. Triggers on phrases like "knowledge base", "KB article", "self-service", "deflection rate", "knowledge management", "KB taxonomy", "article quality", "search optimization", "KB analytics", "community forums", "knowledge sharing", "documentation", "runbook", "playbook". --- # Knowledge Base Management Manage IT knowledge bases including article creation, self-service portals, search optimization, and continuous improvement. ## Workflow ### 1. KB Architecture & Taxonomy ``` KNOWLEDGE BASE STRUCTURE ═══════════════════════════════════════ CATEGORY: Infrastructure Subcategory: Servers → Windows Server management → Linux administration → Virtualization (VMware, Hyper-V) → Container orchestration Subcategory: Network → VPN setup and troubleshooting → DNS resolution issues → Firewall configuration → Wi-Fi connectivity CATEGORY: Applications Subcategory: Email → Exchange administration → Outlook configuration → Shared mailbox management Subcategory: Collaboration → Teams/Slack administration → SharePoint management → Document management CATEGORY: End User Support Subcategory: Hardware → Laptop setup and configuration → Printer issues → Peripheral devices Subcategory: Software → Office 365 troubleshooting → Application installation → License activation CATEGORY: Security Subcategory: Account Management → Password reset procedures → MFA enrollment and issues → Account lockout resolution Subcategory: Compliance → Data handling procedures → Security incident reporting → Policy documentation ARTICLE TEMPLATE: ═══════════════════════════════════════ Title: [Clear, searchable problem statement] Category: [Primary category] Subcategory: [Specific area] Tags: [5-10 searchable keywords] Type: How-to / Troubleshooting / FAQ / Runbook / Policy Symptom/Problem: [What the user is experiencing] Cause: [Root cause of the issue] Solution: [Step-by-step resolution] Step 1: ... Step 2: ... Step 3: ... Prevention: [How to avoid this issue] Related Articles: [Links to relevant KBs] Last Updated: [Date] Author: [Name] Reviewed By: [Reviewer name] ``` ### 2. Article Lifecycle Management ``` KNOWLEDGE ARTICLE LIFECYCLE ═══════════════════════════════════════ Stage 1: CREATE ═══════════════════════════════════════ Trigger: → Recurring ticket pattern (>3 similar tickets in 30 days) → New product/service documentation → Incident post-mortem lessons → Customer feedback / support request Creation: → Author drafts article using template → Includes: screenshots, videos, command examples → Tags with searchable keywords → Links related articles Stage 2: REVIEW ═══════════════════════════════════════ Review checklist: → Technical accuracy verified → Steps tested and validated → Screenshots current and clear → Links functional → Accessibility compliant (WCAG) → Language clear (8th grade reading level) → Mobile-friendly formatting Approval: → Peer review (subject matter expert) → Editor review (clarity, format) → Published after dual approval Stage 3: PUBLISH & PROMOTE ═══════════════════════════════════════ → Publish to self-service portal → Add to suggested articles for related tickets → Share in relevant channels (Slack, Teams) → Surface in portal search → Link from email signatures (for support team) Stage 4: MAINTAIN ═══════════════════════════════════════ → Quarterly review of all articles → Update when products/processes change → Track usage metrics (views, helpfulness) → Retire outdated content → Merge duplicate articles Stage 5: RETIRE ═══════════════════════════════════════ Criteria: → Product/service discontinued → Superseded by new article → No views in 6+ months → Accuracy cannot be verified ``` ### 3. Self-Service & Deflection ``` SELF-SERVICE PORTAL DESIGN ═══════════════════════════════════════ Portal Features: ═══════════════════════════════════════ 1. Intelligent Search: → Natural language processing (understands "can't print") → Autocomplete suggestions → Synonym matching ("login" = "signin" = "access") → Filter by category, type, date 2. Popular Articles (Homepage): → Top 10 viewed articles → Trending articles (last 7 days) → Recently updated articles 3. Suggested Articles (Ticket Creation): → Show related KB articles before ticket form → "Did this help?" prompt with yes/no → If yes: Log as deflected, don't create ticket → If no: Allow ticket creation with article reference 4. Community Forum: → User-to-user Q&A → Upvoted answers → Expert badges DEFLECTION METRICS: ═══════════════════════════════════════ Metric Current Target ────────────────────────────────────────────────── Self-service deflection rate 35% 50% KB article views/month 15,000 25,000 "Helpful" rating 78% 85% Avg resolution (self-service) 3 min 2 min Tickets deflected by KB 1,200/mo 2,000/mo Cost per deflected ticket $0 (vs $25) DEFLECTION ANALYSIS: ═══════════════════════════════════════ Top deflected issues: 1. Password reset: 450/month (solved via self-service password reset) 2. Printer setup: 280/month (video tutorial + driver download) 3. Email configuration: 220/month (auto-config guide) 4. Software installation: 150/month (catalog + approval workflow) 5. VPN connection: 100/month (troubleshooting wizard) ``` ### 4. KB Analytics & Quality ``` KNOWLEDGE BASE ANALYTICS ═══════════════════════════════════════ USAGE ANALYTICS: ═══════════════════════════════════════ Article Performance (Top 10): ════════════════════════════════════════ Rank Article Views Helpfulness Deflections ────── ───────────────────────── ───── ─────────── ─────────── 1 How to reset your password 2,400 92% 890 2 Printer not connecting 1,800 78% 520 3 Set up email on mobile 1,500 85% 610 4 Teams audio not working 1,200 72% 340 5 Install software from catalog 900 88% 420 6 VPN connection failed 800 70% 280 7 Outlook calendar sync issues 700 65% 180 8 Screen sharing on Teams 650 82% 310 9 Request new hardware 600 90% 0* 10 Change display resolution 500 75% 220 * = request form, not deflection SEARCH ANALYTICS: ═══════════════════════════════════════ Zero-result searches (content gaps): → "Teams recording download" — 45 searches, 0 results → CREATE ARTICLE → "Excel macro not working" — 32 searches, 0 results → CREATE ARTICLE → "SharePoint permission denied" — 28 searches, 0 results → CREATE ARTICLE → "Zoom background blur" — 22 searches, 0 results → CREATE ARTICLE Missed searches (article exists but not found): → "Can't log in" → Article titled "Troubleshooting Login Issues" → Add synonyms: "can't log in", "can't sign in", "login fails" → "My computer is slow" → Article titled "Performance Optimization Guide" → Add synonyms: "computer slow", "pc slow", "slow performance" QUALITY METRICS: ═══════════════════════════════════════ Article Quality Score (AQS): → Helpfulness rating: 40% → View-to-ticket ratio: 30% → Content freshness: 15% → Completeness (template fields): 15% Overall AQS: 76/100 (Target: 80+) ``` ### 5. KB Governance ``` KNOWLEDGE GOVERNANCE FRAMEWORK ═══════════════════════════════════════ ROLES AND RESPONSIBILITIES: ═══════════════════════════════════════ Knowledge Owner: VP IT (overall accountability) Knowledge Manager: Manages KB strategy, quality, governance Subject Matter Experts: Authors and reviews in their domain Tier 1/2 Support: Create articles from recurring tickets End Users: Rate articles, submit feedback, community contributions QUALITY ASSURANCE: ═══════════════════════════════════════ Monthly: → Review top articles for accuracy → Identify content gaps (zero-result searches) → Track deflection rate trends → Review "not helpful" ratings Quarterly: → Full article audit (freshness, accuracy) → Merge/retire duplicate or outdated articles → Survey support staff for KB usability → Report to leadership on KB effectiveness Annually: → Taxonomy review and restructuring → Platform evaluation (upgrade/migrate) → Benchmarking against industry standards ``` ## Edge Cases - **Multilingual KB**: Translate articles, maintain quality across languages - **Regulated industries**: KB articles as controlled documents (versioning, approval) - **Large scale**: 10,000+ articles require AI classification and deduplication - **Community content**: Moderation workflow for user-generated articles - **Video KB**: Screen recordings, step-by-step videos with transcripts ## Integration Points - **Service desk**: ServiceNow, Jira Service Management, Freshservice - **Search**: Elasticsearch, Algolia, Azure Cognitive Search - **Analytics**: Google Analytics, custom dashboards - **Authoring**: Confluence, SharePoint, Markdown editors - **AI**: NLP for search, chatbot for article suggestion - **Collaboration**: Teams, Slack (KB sharing) ## Output ### KB Status Report ``` KNOWLEDGE BASE REPORT — Q4 2024 ═══════════════════════════════════════ Articles: 850 (active), 120 (retired) Monthly views: 15,000 Deflection rate: 35% (target: 50%) Average helpfulness: 78% Content gaps identified: 4 (articles in progress) Quality score: 76/100 (target: 80+) Top action: Create articles for top 4 zero-result searches ```