mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
d42bd3f156
Generated-By: mintlify-agent Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
280 lines
9.5 KiB
Plaintext
280 lines
9.5 KiB
Plaintext
---
|
||
title: "创建帮助中心"
|
||
sidebarTitle: "帮助中心"
|
||
description: "在 Mintlify 上构建自助式帮助中心，帮助客户找到答案，减少支持工单量，并随团队规模扩展。"
|
||
keywords: ["support", "customer", "self-service", "FAQ"]
|
||
---
|
||
|
||
支持中心可以帮助客户解决问题，并查找与你的产品相关的信息。客户如果能自己找到答案，就能更快获得帮助，而你的支持团队也可以把精力集中在需要专业知识的复杂问题上。
|
||
|
||
Mintlify 提供可随客户规模扩展的支持中心基础设施。
|
||
|
||
* **AI 驱动的搜索**： [assistant](/zh/assistant/index) 使用你的支持内容回答客户问题，因此用户即使不知道应该去哪查，或不知道要搜索的具体术语，也能找到答案。
|
||
* **反馈收集**：内置的[反馈小组件](/zh/optimize/feedback)允许客户为文章评分并报告问题，帮助你改进内容。
|
||
* **Analytics**：跟踪哪些文章被查看、客户提出了哪些问题，以及他们在哪些地方遇到困难。
|
||
* **认证**：使用 [SSO 或 OAuth](/zh/deploy/authentication-setup) 基于客户方案或账户类型展示个性化内容。
|
||
|
||
<div id="prerequisites">
|
||
## 前置条件
|
||
</div>
|
||
|
||
如果你还没有创建 Mintlify 项目，请先查看[快速开始](/zh/quickstart) 来部署你的网站。
|
||
|
||
* 针对最常见支持主题的文档内容
|
||
* 在 Mintlify 组织中的管理员权限
|
||
* 用于托管支持中心的 domain
|
||
|
||
<div id="migrate-existing-content">
|
||
## 迁移现有内容
|
||
</div>
|
||
|
||
如果你是从头开始创建支持中心，可以直接跳到[规划支持中心结构](#plan-your-support-center-structure)。
|
||
|
||
<div id="audit-existing-content">
|
||
### 审核现有内容
|
||
</div>
|
||
|
||
审查你当前的支持资源，以确定需要迁移的内容。
|
||
|
||
* **帮助文章**：你涵盖了哪些主题？哪些文章的浏览量最高？
|
||
* **常见问题（FAQ）**：有没有适合扩展为完整文章的常见问题？
|
||
* **支持工单**：客户反复咨询哪些问题？这些问题应整理成自助内容。
|
||
* **产品文档**：支持内容和产品文档之间是否有重叠？
|
||
|
||
<div id="export-your-existing-content">
|
||
### 导出现有内容
|
||
</div>
|
||
|
||
* 将内容导出为 **Markdown**，以最简单的方式迁移到 Mintlify。
|
||
* 如果无法导出为 Markdown，则先导出为 **HTML**，再转换为 Markdown。
|
||
* 导出 **工单数据**，用以识别需要编写文档的常见问题。
|
||
|
||
<div id="plan-your-support-center-structure">
|
||
## 规划支持中心的结构
|
||
</div>
|
||
|
||
围绕客户问题，而不是产品功能来组织支持中心。客户带着问题和目标而来，因此要以符合他们对产品的理解方式和常见任务的思路来构建内容。
|
||
|
||
<Tip>
|
||
回顾你的支持工单，了解客户实际在咨询什么。这有助于你为内容划分优先级，并围绕真实问题来组织导航结构。
|
||
</Tip>
|
||
|
||
```json
|
||
{
|
||
"navigation": {
|
||
"groups": [
|
||
{
|
||
"group": "Get Started",
|
||
"pages": [
|
||
"getting-started/quick-setup",
|
||
"getting-started/first-steps"
|
||
]
|
||
},
|
||
{
|
||
"group": "Account",
|
||
"pages": [
|
||
"account/billing",
|
||
"account/plans",
|
||
"account/team-management",
|
||
"account/security"
|
||
]
|
||
},
|
||
{
|
||
"group": "使用产品",
|
||
"pages": [
|
||
"product/feature-one",
|
||
"product/feature-two",
|
||
"product/integrations"
|
||
]
|
||
},
|
||
{
|
||
"group": "Troubleshooting",
|
||
"pages": [
|
||
"troubleshooting/common-errors",
|
||
"troubleshooting/connectivity",
|
||
"troubleshooting/performance"
|
||
]
|
||
}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
有关更多配置选项，请参见 [Navigation](/zh/organize/navigation)。
|
||
|
||
<div id="write-effective-support-content">
|
||
## 撰写高效的支持内容
|
||
</div>
|
||
|
||
支持内容应帮助客户快速解决问题。每篇文章都应解答一个具体的问题或解决一个具体的难题。将相关内容进行分组组织，而不是创建信息量过大、篇幅过长的页面。
|
||
|
||
<div id="structure-articles-for-scanning">
|
||
### 优化文章结构，便于快速浏览
|
||
</div>
|
||
|
||
用户在浏览支持页面时，会快速扫视以寻找自己遇到的具体问题。请使用清晰的标题和简短的段落。
|
||
|
||
```mdx Example support page
|
||
---
|
||
title: "修复登录问题"
|
||
description: "排查登录账户时的常见问题"
|
||
---
|
||
|
||
## 重置密码
|
||
|
||
如果您忘记了密码,请从登录页面请求重置链接。
|
||
|
||
1. 前往登录页面。
|
||
2. 选择**忘记密码**。
|
||
3. 输入您的电子邮件地址。
|
||
4. 检查收件箱中的重置链接。
|
||
|
||
## 清除浏览器缓存
|
||
|
||
旧的缓存数据可能导致登录问题。清除浏览器缓存后重试。
|
||
|
||
## 检查账户状态
|
||
|
||
如果您的账户被暂停或停用,登录时会看到错误提示。
|
||
如果您认为这是误操作,请联系支持团队。
|
||
```
|
||
|
||
<div id="include-step-by-step-instructions">
|
||
### 包含分步骤的操作说明
|
||
</div>
|
||
|
||
在说明如何完成某项操作时，请使用编号步骤。
|
||
|
||
<Steps>
|
||
<Step title="前往设置">
|
||
点击工具栏中的齿轮 icon。
|
||
</Step>
|
||
|
||
<Step title="选择账单">
|
||
点击导航菜单中的 **Billing**。
|
||
</Step>
|
||
|
||
<Step title="更新支付方式">
|
||
点击当前支付方式旁的 **Update**，然后输入新的付款信息。
|
||
</Step>
|
||
</Steps>
|
||
|
||
<div id="add-visual-aids">
|
||
### 添加视觉辅助内容
|
||
</div>
|
||
|
||
截图和示意图可以帮助用户确认自己来对了地方。
|
||
|
||
```mdx Example screenshot
|
||
|
||
```
|
||
|
||
<div id="set-up-the-assistant">
|
||
## 设置 AI 助手
|
||
</div>
|
||
|
||
AI 助手会基于你的支持内容回答客户问题。你可以在[控制台](https://dashboard.mintlify.com/products/assistant/settings)中进行配置。
|
||
|
||
<Steps>
|
||
<Step title="添加示例问题">
|
||
添加客户常问的问题，例如：
|
||
|
||
* “如何取消我的订阅？”
|
||
* “为什么我的付款被拒绝？”
|
||
* “如何添加团队成员？”
|
||
|
||
示例问题会显示为快捷按钮，帮助客户一键获取答案。
|
||
</Step>
|
||
|
||
<Step title="设置转接邮箱">
|
||
为 AI 助手无法回答的问题配置支持邮箱。这样可以确保在自助服务不足以解决问题时，客户仍然能够联系到你的团队。
|
||
</Step>
|
||
|
||
<Step title="审查对话记录">
|
||
定期检查 AI 助手的对话记录，以识别：
|
||
|
||
* AI 助手无法回答的问题（内容缺口）
|
||
* 不正确或不完整的回答（需要改进的内容）
|
||
* 常见问题模式（需要优先处理的内容）
|
||
</Step>
|
||
</Steps>
|
||
|
||
<div id="enable-feedback-collection">
|
||
## 启用反馈收集
|
||
</div>
|
||
|
||
反馈可以帮助你了解哪些页面对用户有帮助，哪些页面需要改进。查看[反馈](/zh/optimize/feedback)，了解用户认为哪些页面有帮助、哪些需要改进。阅读所有评论，并根据有价值的反馈更新页面。
|
||
|
||
<div id="set-up-analytics">
|
||
## 配置 Analytics
|
||
</div>
|
||
|
||
监控客户如何使用你的支持中心，从而持续优化内容。
|
||
|
||
* **热门文章**：哪些文章获得最多浏览？确保这些文章内容准确并得到良好维护。
|
||
* **搜索查询**：客户会搜索什么？针对常见却没有结果的搜索创建相应内容。
|
||
* **AI 助手对话**：AI 助手会收到哪些问题？借此识别内容缺口。
|
||
|
||
<div id="restrict-content-by-customer-segment">
|
||
## 按客户分群限制内容访问
|
||
</div>
|
||
|
||
如果有不同的客户等级或产品套餐，可以使用基于分组的访问控制，为各个客户群体展示与其最相关的内容。
|
||
|
||
<Steps>
|
||
<Step title="设置认证">
|
||
配置[认证](/zh/deploy/authentication-setup)，在客户访问支持中心时识别其身份。
|
||
</Step>
|
||
|
||
<Step title="配置用户分组">
|
||
在用户数据中返回分组信息，根据套餐类型、账户状态或其他属性定义客户分群。详情参见[用户数据格式](/zh/deploy/authentication-setup#user-data-format)。
|
||
</Step>
|
||
|
||
<Step title="按分组为内容打标签">
|
||
使用 frontmatter 指定每篇文章可见的 groups。
|
||
|
||
```mdx
|
||
---
|
||
title: "Enterprise SSO setup"
|
||
groups: ["enterprise"]
|
||
---
|
||
```
|
||
</Step>
|
||
</Steps>
|
||
|
||
<div id="maintain-your-support-center">
|
||
## 维护你的支持中心
|
||
</div>
|
||
|
||
随着产品变化，支持内容也会过时。建立流程来保持内容的准确性。
|
||
|
||
<Steps>
|
||
<Step title="配合产品发布进行更新">
|
||
当你发布产品变更时，更新受影响的支持文章。把文档更新纳入你的发布流程中。
|
||
</Step>
|
||
|
||
<Step title="定期审查反馈">
|
||
每周查看文章评分和客户反馈。及时处理负面反馈，它通常表明内容令人困惑或存在错误。
|
||
</Step>
|
||
|
||
<Step title="监控支持工单">
|
||
如果客户就你的支持中心已涵盖的问题提交工单，调查为什么自助服务没有奏效。文章可能难以找到、不清晰或不完整。
|
||
</Step>
|
||
|
||
<Step title="归档过时内容">
|
||
删除或归档关于已废弃功能的文章。过时的内容会让客户感到困惑，降低他们对你支持中心的信任。
|
||
</Step>
|
||
</Steps>
|
||
|
||
<div id="next-steps">
|
||
## 下一步
|
||
</div>
|
||
|
||
你的支持中心已经可以上线了。部署完成后：
|
||
|
||
1. 在你的产品和网站中添加指向支持中心的链接。
|
||
2. 监控 AI 助手对话和搜索查询，以发现内容缺口。
|
||
3. 每周查看反馈评分并改进评分较低的文章。
|
||
4. 跟踪工单量，以衡量自助服务的有效性。
|
||
|
||
一个优秀的支持中心既能降低支持成本，又能提升客户满意度。投入精力打造能够高效解答常见问题的内容。 |