生成知识包 | KefuAgents - 贴一条官网链接，AI 客服今天上岗

把这段 Prompt 交给你自己的 AI，在你的仓库里跑出一份可导入的客服知识包。你的代码不会离开你的机器。

把下面整段复制给你自己的 AI（Claude Code / Cursor / ChatGPT 都行），在你自己的仓库根目录运行。它只在你的机器上读你的代码和文档，产出一个 kefu-knowledge-pack/ 文件夹；KefuAgents 只收这个文件夹，不会读到你的代码。

角色

你是一名客服知识工程师。目标：从这个仓库里，整理出一份能直接用来回答客户问题的知识包，交给一个 AI 客服使用。你不是在写产品文档，也不是在写营销文案——你在写"客服坐席手边那本册子"。

先读这些

按顺序读，读不到就跳过，不要编：

README*、CONTRIBUTING*——产品是什么、给谁用；
docs/、documentation/、website/、site/、content/ 下的用户向文档；
定价与套餐的配置来源（如 pricing.*、plans.*、Stripe/Paddle 的 product 配置、落地页的定价组件）——只抄配置里真实存在的数字；
CHANGELOG*、release notes——最近几个版本改了什么、什么还没上；
法务文本：ToS、隐私政策、SLA、DPA（常在 legal/、public/、官网页面）；
已有的客服素材：FAQ 页、帮助中心、support/ 目录、历史客服邮件模板；
常见故障：issue 模板、错误码表、troubleshooting*、运维 runbook 里对用户可见 的那部分。

产出

在仓库根目录建 kefu-knowledge-pack/，按下面的结构写文件：

kefu-knowledge-pack/
  pack.yaml
  01-product-overview.md
  02-features/<feature>.md      # 一个功能一个文件：做什么、怎么用、限制、常见误解
  03-pricing-and-billing.md     # 套餐、额度、试用、退款口径
  04-account-and-security.md    # 登录、找回、权限、数据安全
  05-integrations.md            # 对接了什么、怎么配、常见坑
  06-troubleshooting.md         # 症状 → 原因 → 处理
  07-faq.md                     # Q/A 对
  08-policies.md                # ToS / 隐私 / SLA 摘要 + 原文链接
  09-boundaries.md              # 客服永远不能承诺的事

pack.yaml：

name: <包名，用短横线，如 acme-support-pack>
product: <产品名>
version: <每次重新生成就 +1，如 1、2、3>
generatedAt: <YYYY-MM-DD>
generator: <你用的 AI，如 claude-code>
languages:
  - zh
  - en

每个 md 文件开头带 front matter：

---
title: 计费与套餐
category: 03-pricing-and-billing
audience: customer
source_paths:
  - src/config/pricing.ts
  - docs/billing.md
last_verified: 2026-08-21
confidence: high
---

## 免费版有什么额度

……

## 试用期多长

……

字段说明：

title：这个文件讲什么。
category：默认写成文件名（不含 .md）。
audience：customer = 可以据此直接回答客户；internal = 只给客服团队看的背景（内部流程、已知但未公开的限制、话术边界）。拿不准就写 internal。
source_paths：这条知识是从哪几个文件推出来的，仓库相对路径。
last_verified：你确认过的日期。不确定就整行删掉，不要填今天。
confidence：high / medium / low。

条目切分按标题层级：一个 ## 标题 = 一条知识。标题就写成客户会问的那句话（「试用期多长」优于「试用策略」）。

铁律

不编造。 代码和文档里没有的数字、期限、承诺，一个字都不要写。信息缺失就把那一节整个删掉，而不是猜一个。
不确定就标 confidence: low，并在正文里写明"以官网/合同为准"。
每条都要有 source_paths。 找不到出处的内容不该进包。
分清 customer 与 internal。 内部才知道的限制、正在修的 bug、定价的历史包袱——一律 internal。
不写路线图承诺。 「下个版本会支持 X」「预计 Q3 上线」这类句子一句都不要写进 customer 条目；要写就写进 09-boundaries.md，写成"客服不能承诺功能上线时间"。
09-boundaries.md 写的是"不能说什么"，不是"能说什么"：退款能退到什么程度、补偿上限、SLA 能承诺到哪、账号操作能不能代办、数据能不能删——每一条都写清楚现在的口径，并注明这是需要人拍板的。

交付（两选一）

A. 拖进后台（最简单）：把整个 kefu-knowledge-pack/ 文件夹拖到 KefuAgents 后台的「知识档案 → 导入知识包」。

B. 用 API 直传：先到 后台「设置 → Agent 网关」 生成一个 Gateway Key （scope 勾 gateway:submit_draft，key 只显示一次），存进环境变量 KEFUAGENT_GATEWAY_KEY，然后：

# 你的 workspace：在后台「设置 → Agent 网关」页可见
# 不要把 key 写进任何会提交的文件。
cd kefu-knowledge-pack
curl -X POST "https://kefuagents.com/api/support/knowledge-pack/import" \
  -H "Authorization: Bearer $KEFUAGENT_GATEWAY_KEY" \
  -F "pack.yaml=@pack.yaml" \
  -F "01-product-overview.md=@01-product-overview.md" \
  -F "03-pricing-and-billing.md=@03-pricing-and-billing.md" \
  -F "07-faq.md=@07-faq.md" \
  -F "09-boundaries.md=@09-boundaries.md"
# 表单字段名就是包内相对路径；有多少文件就加多少个 -F。

导入之后会发生什么

使用方法、功能说明、故障排查 → 导入即发布，AI 立刻能用来回答客户；
定价、政策、边界（03 / 08 / 09）→ 进待确认队列，你在后台点一次「确认」它们才生效。钱和期限不交给 AI 自己拍板；
audience: internal 的条目永远不会逐字发给客户，只作为 AI 判断的背景；
同一个 version 重复导入不会产生重复条目。改了内容就把 version +1 再传。