SIDE BUSINESS / 2026.11.19
客户要的不是再写一轮帮助中心文章,也不是再搭一套 FAQ 知识库,而是把这一周的工单,收成一份可核对的知识库补洞清单:哪类问题缺文、哪类该改文、依据是哪些工单。
结论先说:报价请拆成周数 × 约定工单量与聚类上限,再单列超限条目与检索失败返工;不要按人天糊成一笔「智能知识库优化顾问费」。下文是接单方法(公开标准 + 假设测算),不承诺收入,也不会把未发生的客户口碑或工单下降写成事实。
工单量管「要看多少」;人工复核管「你敢不敢签字」;失败路径管「检索被截断或限流时钱从哪出」。少写一行,返工时就会把利润吃掉。
先钉交付范围与边界
接单前用一页纸钉死任务,避免做成「帮你们把知识库变好」这种无底洞。本文的交付物停在补洞清单,不代写帮助中心正文——写文是另一张报价单。
- 任务示例:按周从客服工单中归纳主题簇,对照现有帮助中心文章,出具缺文 / 改文 / 无需处理的清单,并附上证据工单与检索语句。
- 包含:W 周的工单检索与就绪核对、约定上限内的聚类与人工复核、对每个主题簇检索现有文章、一份补洞清单(主题、工单量、示例工单编号、已有文章命中或未命中、建议动作)、一次合入说明。
- 不包含:代写或上线帮助中心文章、重建 FAQ 知识库、接入机器人自动回复、驻场值班、对方 Zendesk 年费、无限返工,或承诺「聚类一定准」「补文后工单必降」。
- 停止条件:要求用未授权工单数据;拒绝人工复核聚类结果;或一周工单量、主题簇数超出约定 20%——暂停并改报价。要求把文章写完并发布,另案。
和近文的差别:帮助中心周更卖的是文稿,店铺菜单 / FAQ 周更卖的是知识库维护,客服提示词卖的是单张工单怎么回,会议纪要报价卖的是决议和看板。本文只谈这一种交付物:按周出具的补洞清单。
成本怎么拆:公开方法与假设
公开方法(可对客户讲清逻辑)分两段官方检索,再加一段必须人工签字的聚类。聚类规则是团队方法,不是已在本文核验的 Zendesk「官方聚类」或「官方补洞」接口。
工单一侧,用 Ticketing Search API:GET /api/v2/search?query={query}。官方查询语法可写 type:ticket status:open,日期字段用 created / updated / solved,格式为 YYYY-MM-DD。查询字符串必须做 URL 编码。官方写明:该接口每查询最多返回 1,000 条,每页最多 100 条;若按每页 100 条请求到 page=11,会返回 422 Insufficient Resource Error。count 可以大于 1,000,例如实际有 5,000 条时 count 为 5,000,但接口仍只返回前 1,000 条。大数据集应按日期范围拆开检索,或改用 Export Search Results。新工单写入搜索索引「可能需要几分钟」。

封面是同一套 Search API 文档里的 Results limit 小节,不是实际调用回包。看到 count 大于 1,000,不能假装清单已经覆盖全部工单;报价必须单列拆窗、导出和截断说明,不能把这一段藏进一笔含糊的周费。
知识库一侧,用 Help Center 的 Search Articles:GET /api/v2/help_center/articles/search。官方写明默认每页 25 篇,最多返回 1,000 条结果,per_page 为 1 到 100;请求里至少要提供 queryそしてcategoryそしてsectionそしてlabel_names 之一。返回对象除文章字段外还有 snippet,可用来判断是真命中还是只搜到了相邻词。对每个主题簇写清检索语句和命中 / 未命中,清单才能被复核。

官方还有 List Suggested Articles(GET /api/v2/help_center/deflection/suggestions属query 必填且最长 200 个字符),那是按单次查询给建议文章,不能代替按周聚类后的补洞清单。不要把两条能力写成同一件事。
限流也要写进成本。官方 Suite 套餐表里,Support 与 Help Center API 的每分钟请求上限按套餐不同:Team 200、Growth 400、Professional 400、Enterprise 700、Enterprise Plus 2500。超出时接口返回 429,并带 Retry-After。Help Center API 的限额数值与 Support API 相同,但不共用同一个计数桶。表中数字以你客户的实际套餐为准,不要把文档示例头 X-Rate-Limit: 700 当成所有账户的上限。

假设测算(表内数字可整行替换,不是行情中位数,更不是成交承诺):
- 每周工单检索与上限核对:假设 0.15–0.25 人日,含按日期拆窗、索引未就绪的有限次重试,以及
count超过 1,000 时的说明。 - 主题聚类与人工复核:假设 0.4–0.6 人日;这是签字强度,不是把标题丢进模型就结束。
- 对各主题簇检索现有文章并记录命中:假设 0.2–0.35 人日。
- 超出约定的工单量或主题簇,按份另计:假设每超限主题簇 0.05–0.10 人日。
- 返工预留:建议按上述小计的 20%–30% 单列,覆盖 429 退避、检索被截断、聚类被退回、文案标签或语言环境不符。
把人日单价写成客户可见变量 R(元/人日)。你可以用自己的成本核算填 R,不要把别人的朋友圈报价贴进来装权威。
报价表:按周的可替换变量
下面是可替换变量的报价骨架。把 R、单位工时、返工比例、每周工单上限 T 和主题簇上限 C 换成你的数即可;报价单发给客户时请保留可编辑表格。
W 是周数,T 是每周已含的工单量上限,C 是每周已含的主题簇上限,E 是超出 C 的主题簇份数之和(不要先合并各周再扣上限)。先约定检索窗口、语言环境和有限次重试;超出返工预留、1,000 条截断未处理完,或触发 429 且无法在约定时间内退避完成时,暂停并确认补费用后再继续。
| 行项 | 数量变量 | 单价变量 | 小计公式 |
|---|---|---|---|
| 工单检索与上限核对 | W | 0.2×R | W×0.2×R |
| 主题聚类与人工复核(每周≤C 个) | W | 0.5×R | W×0.5×R |
| 文章检索与补洞清单 | W | 0.28×R | W×0.28×R |
| 超限主题簇(超出 C 的份数) | E | 0.08×R | E×0.08×R |
| 返工预留 | - | 25% | 0.25×(上四行之和) |
例(假设测算,非成交价):W=4、每周工单上限 T=800、C=12、E=5、R=2000 元/人日 → 检索核对 1600、聚类复核 4000、文章检索与清单 2240、超限 800;小计 8640;返工 2160;示意合计约 1.08 万。若某周 count 超过 1,000 且客户要求补齐剩余窗口,按拆窗追加,不包含在上表基础周费里。
报价还需另加税与付款节点。客户改范围时,只改 W / T / C / E,不要重写故事。
验证、付款节点与停止条件
报价单要写清验收,否则「补洞清单」会变成口头禅。
- 预付:签约后启动;未预付不把对方工单拉进你的工作区。
- 中期:W 周都完成工单检索;写明实际使用的查询语句、窗口和
count;若超过 1,000 条,已按日期拆窗或标注未覆盖部分及处理路径。 - 尾款:补洞清单已交付:每个主题簇有工单量、至少一条证据工单编号、文章检索语句与命中或未命中、建议动作为新建 / 修订 / 无需处理之一;超限份数 E 已对账。清单不含已写完的帮助中心正文。
- 停止:客户要求承诺「补文后工单必降」或「聚类准确率 xx%」;拒绝人工复核;提供未授权数据;或把「代写并发布文章」写成交付结果——标为范围外,另案报价。
与近文的分工:4055 卖的是帮助中心文稿周更,3954 卖的是店铺菜单 / FAQ 知识库维护,4066 卖的是单张工单提示词,5291 卖的是按场次的会议决议和看板。本文卖的是按周计的补洞清单,并把官方检索上限、截断和 429 写进报价。
当社の判断:这类交付的定价锚点是「约定窗口内的工单量 + 你愿意签字复核的主题簇数量 + 检索被截断或限流时的返工预留」,不是故事份数,也不是文章篇数。表内系数请换成你的 R 与工时,勿把示例数字当市场价传播。
参考リンク
- Zendesk Developers:Search API(Results limit 与查询入口)(
https://developer.zendesk.com/api-reference/ticketing/ticket-management/search/) - Zendesk Developers:Using the Search API(查询语法与日期格式)(
https://developer.zendesk.com/documentation/api-basics/working-with-data/searching-with-the-zendesk-api/) - Zendesk Developers:Help Center Search(Search Articles)(
https://developer.zendesk.com/api-reference/help_center/help-center-api/help_center_search/) - Zendesk Developers:Rate limits(Suite 套餐表与 429 / Retry-After)(
https://developer.zendesk.com/api-reference/introduction/rate-limits/)


评论列表 (0条):
加载更多评论 読み込み中...