Loading...
Loading...
Compare original and translation side by side
| User Need | Content Type | Format | AI Role |
|---|---|---|---|
| "How do I..." | How-To | Step-by-step | Suggest next steps |
| "Why isn't..." | Troubleshooting | Problem -> Cause -> Fix | Diagnose & resolve |
| "What is..." | Conceptual | Explanation | Summarize context |
| "Quick answer" | FAQ | Q&A pairs | Instant response |
| "Full specs" | Reference | Tables, lists | Search & retrieve |
| "Learn feature" | Tutorial | Video + interactive | Personalized path |
| 用户需求 | 内容类型 | 格式 | AI角色 |
|---|---|---|---|
| "如何操作..." | 操作指南 | 分步说明 | 建议下一步操作 |
| "为什么无法..." | 故障排查 | 问题->原因->解决方案 | 诊断并解决问题 |
| "什么是..." | 概念解释 | 说明文档 | 总结上下文信息 |
| "快速解答" | FAQ | 问答对 | 即时响应 |
| "完整规格" | 参考文档 | 表格、列表 | 搜索与检索 |
| "学习功能" | 教程 | 视频+交互式内容 | 个性化学习路径 |
| Company Stage | Platform | Monthly Cost | Best For |
|---|---|---|---|
| Enterprise | Zendesk | $55+/agent | Complex workflows, compliance |
| Growth/SaaS | Intercom | $29/seat + $0.99/resolution | Conversational, PLG |
| SMB/Startup | Freshdesk | $29-69/agent | Budget-friendly, native AI |
| Developer-focused | GitBook/Notion | $0-20/user | Docs-as-code |
| 企业阶段 | 平台 | 月均成本 | 适用场景 |
|---|---|---|---|
| 企业级 | Zendesk | $55+/agent | 复杂工作流、合规要求 |
| 成长期/SaaS | Intercom | $29/seat + $0.99/resolution | 对话式交互、PLG模式 |
| 中小企业/初创公司 | Freshdesk | $29-69/agent | 高性价比、原生AI功能 |
| 开发者导向 | GitBook/Notion | $0-20/user | 文档即代码模式 |
| Aspect | Traditional (Pre-2024) | Modern (2025-2026) |
|---|---|---|
| Support model | Separate help portal | Embedded in-app help |
| AI role | Search assistant | Higher automation with safe escalation |
| Search | Keyword matching | Semantic + RAG |
| Content | Text-heavy articles | Visual-first (video, GIF, screenshots) |
| Personalization | Same for all users | By role, version, behavior |
| Maintenance | Manual curation | AI-driven freshness detection |
| Navigation | Category browsing | Conversational + contextual |
| 维度 | 传统模式（2024年前） | 现代模式（2025-2026） |
|---|---|---|
| 支持模式 | 独立帮助门户 | 嵌入式应用内帮助 |
| AI角色 | 搜索助手 | 高自动化+安全升级机制 |
| 搜索方式 | 关键词匹配 | 语义搜索+RAG |
| 内容形式 | 纯文本为主的文章 | 视觉优先（视频、GIF、截图） |
| 个性化程度 | 所有用户统一内容 | 按角色、版本、行为个性化 |
| 维护方式 | 人工整理 | AI驱动的内容新鲜度检测 |
| 导航方式 | 分类浏览 | 对话式+上下文导航 |
| Trend | Description | Impact |
|---|---|---|
| Voice Search | Users speak instead of type to find information | Requires natural language KB content |
| Proactive AI | AI detects/resolves issues before users report | Reduces inbound support volume |
| Embedded Help | Help surfaces in-context, not separate portal | Higher engagement, lower friction |
| AI Operations Lead | New role supervising AI agent behavior | Shift from execution to oversight |
| Hallucination Mitigation | RAG grounding to reduce AI fabrication | Requires citation/source linking |
| 趋势 | 描述 | 影响 |
|---|---|---|
| 语音搜索 | 用户通过语音而非文字查找信息 | 需要自然语言风格的知识库内容 |
| 主动式AI | AI在用户报告前检测并解决问题 | 降低 inbound支持请求量 |
| 嵌入式帮助 | 帮助内容在上下文场景中展示，而非独立门户 | 更高参与度、更低使用门槛 |
| AI运营负责人 — 新增角色，负责监督AI Agent行为 | 从执行转向监管 | |
| 幻觉缓解 | 基于RAG的事实锚定，减少AI生成错误内容 | 需要引用来源链接 |
HIERARCHY LIMITS
- Maximum depth: 2-3 levels
- Top-level categories: 5-9 (cognitive load principle)
- Articles per category: 10-20 (scannable)
- Avoid: Deep nesting, internal org structureHIERARCHY LIMITS
- Maximum depth: 2-3 levels
- Top-level categories: 5-9 (cognitive load principle)
- Articles per category: 10-20 (scannable)
- Avoid: Deep nesting, internal org structureSTANDARD CATEGORIES (adapt to product)
1. Getting Started — First-run, setup, quick wins
2. [Core Feature 1] — Primary use case
3. [Core Feature 2] — Secondary use case
4. Account & Billing — Settings, payments, security
5. Integrations — Third-party connections
6. Troubleshooting — Common issues, error codes
7. API & Developers — Technical documentation
8. What's New — Changelog, releasesSTANDARD CATEGORIES (adapt to product)
1. Getting Started — First-run, setup, quick wins
2. [Core Feature 1] — Primary use case
3. [Core Feature 2] — Secondary use case
4. Account & Billing — Settings, payments, security
5. Integrations — Third-party connections
6. Troubleshooting — Common issues, error codes
7. API & Developers — Technical documentation
8. What's New — Changelog, releasesMODERN AI SUPPORT FLOW (2025)
User query
-> Intent detection (semantic understanding)
-> RAG retrieval (KB + tickets + docs)
-> Response and action (answer and/or execute task)
-> Escalation check (confidence below threshold?)
-> Human agent (if needed)MODERN AI SUPPORT FLOW (2025)
User query
-> Intent detection (semantic understanding)
-> RAG retrieval (KB + tickets + docs)
-> Response and action (answer and/or execute task)
-> Escalation check (confidence below threshold?)
-> Human agent (if needed)| Capability | Example | Platform |
|---|---|---|
| Task execution | Process refund | Ada, Zendesk AI |
| Appointment booking | Schedule call | Chatbase, Calendly |
| Account updates | Change plan | Fin AI, custom |
| Ticket creation | Escalate to human | All platforms |
| Multi-system lookup | Check order + shipping | MCP integrations |
| 能力 | 示例 | 平台 |
|---|---|---|
| 任务执行 | 处理退款 | Ada, Zendesk AI |
| 预约预订 | 安排通话 | Chatbase, Calendly |
| 账户更新 | 更改套餐 | Fin AI, 自定义开发 |
| 工单创建 | 升级至人工客服 | 所有平台 |
| 多系统查询 | 检查订单+物流状态 | MCP集成 |
AI-FRIENDLY WRITING RULES
DO:
- Clear headings with keywords
- Structured data (tables, lists)
- Explicit step numbering
- Error messages verbatim
- Unique article titles
DON'T:
- Ambiguous pronouns
- Implicit assumptions
- Marketing fluff in support content
- Duplicate content across articlesAI-FRIENDLY WRITING RULES
DO:
- Clear headings with keywords
- Structured data (tables, lists)
- Explicit step numbering
- Error messages verbatim
- Unique article titles
DON'T:
- Ambiguous pronouns
- Implicit assumptions
- Marketing fluff in support content
- Duplicate content across articles| Metric | Definition | Benchmark |
|---|---|---|
| Self-Service Rate | % issues resolved without agent | 60-80% |
| Deflection Rate | Tickets avoided via KB | 30-50% |
| Search Success | % searches -> helpful result | >70% |
| CSAT (KB) | Article helpfulness rating | >80% positive |
| Time to Resolution | Self-service completion time | <3 min |
| Zero-Result Rate | Searches with no results | <5% |
| 指标 | 定义 | 基准值 |
|---|---|---|
| 自助服务率 | 无需人工介入解决的问题占比 | 60-80% |
| 工单分流率 | 通过知识库避免的工单占比 | 30-50% |
| 搜索成功率 | 搜索后获得有用结果的占比 | >70% |
| 知识库CSAT评分 | 文章有用性评分 | >80%好评 |
| 解决时长 | 自助服务完成时间 | <3分钟 |
| 零结果搜索率 | 无结果的搜索占比 | <5% |
FRESHNESS INDICATORS
- Last updated > 6 months -> Review required
- Last updated > 12 months -> Likely stale
- No views in 90 days -> Consider archive
- High bounce rate -> Content mismatch
QUALITY INDICATORS
- Thumbs down > 20% -> Rewrite needed
- Escalation after viewing -> Content gap
- Search -> immediate exit -> Title mismatchFRESHNESS INDICATORS
- Last updated > 6 months -> Review required
- Last updated > 12 months -> Likely stale
- No views in 90 days -> Consider archive
- High bounce rate -> Content mismatch
QUALITY INDICATORS
- Thumbs down > 20% -> Rewrite needed
- Escalation after viewing -> Content gap
- Search -> immediate exit -> Title mismatchSELF-SERVICE ROI FORMULA
Monthly Savings = (Deflected Tickets x $13) - Platform Cost
Example:
- 1,000 deflected tickets/month
- $13 average agent cost
- $500 platform cost
- ROI = ($13,000 - $500) = $12,500/monthSELF-SERVICE ROI FORMULA
Monthly Savings = (Deflected Tickets x $13) - Platform Cost
Example:
- 1,000 deflected tickets/month
- $13 average agent cost
- $500 platform cost
- ROI = ($13,000 - $500) = $12,500/month| Pattern | Use Case | Tools |
|---|---|---|
| Tooltips | Field-level guidance | Native, Appcues |
| Hotspots | Feature discovery | UserPilot, Pendo |
| Checklists | Onboarding progress | Whatfix, Chameleon |
| Tours | New feature intro | Intercom, Appcues |
| Contextual Help | Error recovery | Custom, Zendesk |
| 模式 | 适用场景 | 工具 |
|---|---|---|
| 提示框 | 字段级指导 | 原生工具, Appcues |
| 热点指引 | 功能发现 | UserPilot, Pendo |
| 任务清单 | 入门进度追踪 | Whatfix, Chameleon |
| 功能导览 | 新功能介绍 | Intercom, Appcues |
| 上下文帮助 | 错误恢复 | 自定义开发, Zendesk |
VIDEO TUTORIALS
- Length: 2-4 minutes (40% higher completion)
- Format: Screen recording + voiceover
- Chapters: Clickable sections
- Captions: Always include (accessibility)
INTERACTIVE GUIDES
- Click-through walkthroughs
- Sandbox environments
- Progress saving
- Skip option for experienced usersVIDEO TUTORIALS
- Length: 2-4 minutes (40% higher completion)
- Format: Screen recording + voiceover
- Chapters: Clickable sections
- Captions: Always include (accessibility)
INTERACTIVE GUIDES
- Click-through walkthroughs
- Sandbox environments
- Progress saving
- Skip option for experienced users| Resource | Content |
|---|---|
| article-templates.md | Complete templates for all 5 article types |
| taxonomy-patterns.md | Category structures, tagging, search optimization |
| ai-integration.md | RAG setup, chatbot config, platform integrations |
| platform-guides.md | Zendesk, Intercom, Freshdesk, GitBook setup |
| learning-paths.md | Onboarding sequences, tutorial design, courses |
| metrics-optimization.md | KPI tracking, analytics, A/B testing |
| knowledge-ops.md | Governance, workflows, and operating cadence |
| sources.json | Curated sources with |
| 资源 | 内容 |
|---|---|
| article-templates.md | 5种文章类型的完整模板 |
| taxonomy-patterns.md | 分类结构、标签体系、搜索优化 |
| ai-integration.md | RAG设置、聊天机器人配置、平台集成 |
| platform-guides.md | Zendesk, Intercom, Freshdesk, GitBook设置指南 |
| learning-paths.md | 入门序列设计、教程开发、课程建设 |
| metrics-optimization.md | KPI追踪、数据分析、A/B测试 |
| knowledge-ops.md | 治理机制、工作流、运营节奏 |
| sources.json | 带 |
add_as_web_search: trueadd_as_web_search: true"help center best practices 2026""[specific platform] vs alternatives 2026""AI customer support trends January 2026""knowledge base platforms 2026""help center best practices 2026""[specific platform] vs alternatives 2026""AI customer support trends January 2026""knowledge base platforms 2026"