Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions .changeset/knowledge-bases-write-real.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
'hotcrm': patch
---

按元数据写实「HotCRM 内置四个 AI 知识库」这一整套说法(#808):文档在 12 个页面(三语共 36 个文件)宣称本应用附带 **Sales Knowledge / Product Information / Support Knowledge / Competitive Intelligence** 四个知识库,而 `src/` 里这四个名字一个都不存在——没有任何元数据声明过知识库,没有任何技能绑定到其中之一,Setup 里也没有可供填充种子内容的地方。照着旧版 Day 5 清单操作的管理员,找不到任何一个可以 seed 的东西。

四个名字**不静默删除**,改为写明「本应用不 ship 这样的独立知识库」并指向真实结构:唯一的知识面是 `crm_knowledge_article` 对象及其 7 个分类(入门指南 / 操作指南 / 故障排查 / 账务与价格 / API 与集成 / 版本说明 / 政策制度)。

- `content/docs/ai-copilot/knowledge-bases.mdx`——整页按真实结构重写:四个旧名字逐一给出实际落点,文章对象的字段与检索面,唯一会读文章的技能是 `customer_360`(按已读工单的分类/标签查询已发布文章),以及**不存在**的那些东西(文档摄取、`/knowledge/support/` 目录、嵌入与分块、夜间重新索引、Confluence/Notion 连接器、按技能绑定知识库)。
- `content/docs/service/knowledge-base.mdx`——「支持知识索引涵盖四种内容类型」与四库表改为真实的 7 个分类、4 个列表页签与发布/复核时间戳行为。
- `content/docs/administration/setup.mdx`——Day 5 的三条 seed 步骤改写为真实可执行动作(按分类写文章、设置受众、发布);产品目录一条不再说数据表「馈送产品信息知识库」。
- `content/docs/ai-copilot/sales-copilot.mdx`——邮件撰写的输入列去掉两个知识库,并写明第二个独立事实:`email_drafting` 的 instructions 从不取任何知识来源(与 #860 / PR #865 在 service 页的口径一致)。
- 另有 `content/docs/ai-copilot/skills.mdx`(每个技能的「知识库」行)、`content/docs/ai-copilot/index.mdx`、`content/docs/ai-copilot/service-copilot.mdx`、`content/docs/getting-started/introduction.mdx`、`content/docs/whats-new.mdx`、`content/docs/revenue/products.mdx` 六页的同源说法一并写实。

「元数据跟文档」(真的把这四个知识库建成元数据)是产品扩展方向,本次不预判。三语同步;纯文档改动,未触碰 `src/**`。
17 changes: 10 additions & 7 deletions content/docs/administration/setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ Business hours drive [SLA calculations](/docs/service/sla-and-escalation) — e.

- [ ] Import [products](/docs/revenue/products) — at minimum: code, name, list price, billing type
- [ ] Set up product manager (the contact for each product line)
- [ ] Upload datasheets (feeds the AI Copilot's Product Information knowledge base)
- [ ] Upload datasheets — a PDF file field on the product record, there for people to open; no knowledge base ingests it

## ✅ Day 4 — Process

Expand Down Expand Up @@ -120,14 +120,17 @@ Adjust if your support promise differs.

## ✅ Day 5 — Knowledge & AI

### 13. Knowledge bases
### 13. Knowledge articles

- [ ] Seed **Support Knowledge** with your top 20 FAQ articles
- [ ] Seed **Sales Knowledge** with your sales playbook
- [ ] Seed **Competitive Intel** with battle cards for your top 5 competitors
- [ ] Product datasheets — already in product records (synced automatically)
HotCRM ships **one** knowledge object, not a set of knowledge bases. Everything below is an ordinary record you create under **Service → Knowledge**, filed under one of the seven categories the object defines.

See [Knowledge Bases](/docs/ai-copilot/knowledge-bases).
- [ ] Write your top 20 FAQs as articles under **Troubleshooting**, **How-To** or **Getting Started**
- [ ] Put support hours, SLA promises and data-handling commitments under **Policy**
- [ ] Set each article's **Audience** — *Internal* for runbooks, *Public* for anything you would send a customer
- [ ] **Publish** them — the Copilot queries published articles only, so a draft may as well not exist
- [ ] Check the categories and tags before you call it done: matching is by category and tags, not by meaning, so a misfiled article is an invisible one

There is nothing to seed called *Sales Knowledge*, *Product Information* or *Competitive Intel* — HotCRM ships no such libraries, and no competitor object for battle cards to hang off. See [Knowledge Bases](/docs/ai-copilot/knowledge-bases) for what the Copilot can and cannot do with an article.

### 14. AI Copilot

Expand Down
17 changes: 10 additions & 7 deletions content/docs/administration/setup.zh-Hans.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ description: 让 HotCRM 为你的团队做好生产准备的第一周任务。

- [ ] 导入 [产品](/zh-Hans/docs/revenue/products) —— 至少:代码、名称、标价、计费类型
- [ ] 设置产品经理(每条产品线的联系人)
- [ ] 上传数据表(馈送 AI Copilot 的产品信息知识库)
- [ ] 上传数据表 —— 产品记录上的一个 PDF 文件字段,供人打开查看;没有任何知识库会摄取它

## ✅ 第 4 天 —— 流程

Expand Down Expand Up @@ -120,14 +120,17 @@ description: 让 HotCRM 为你的团队做好生产准备的第一周任务。

## ✅ 第 5 天 —— 知识与 AI

### 13. 知识库
### 13. 知识文章

- [ ] 用你最热门的 20 篇 FAQ 文章为 **支持知识** 填充种子内容
- [ ] 用你的销售指南为 **销售知识** 填充种子内容
- [ ] 用你最重要的 5 个竞争对手的对战卡为 **竞争情报** 填充种子内容
- [ ] 产品数据表 —— 已在产品记录中(自动同步)
HotCRM 只附带**一个**知识对象,而不是一组知识库。下面每一条都是你在**服务 → 知识**下创建的普通记录,归入该对象定义的七个分类之一。

参见 [知识库](/zh-Hans/docs/ai-copilot/knowledge-bases)。
- [ ] 把最热门的 20 个 FAQ 写成文章,归入**故障排查**、**操作指南**或**入门指南**
- [ ] 把支持时间、SLA 承诺和数据处理说明归入**政策制度**
- [ ] 逐篇设置**受众** —— 操作手册用*仅内部*,你愿意发给客户的用*公开*
- [ ] 把它们**发布** —— Copilot 只查询已发布的文章,草稿等于不存在
- [ ] 收工前复核一遍分类和标签:匹配靠的是分类与标签而不是语义,归错的文章就是找不到的文章

没有任何叫 *销售知识*、*产品信息* 或 *竞争情报* 的东西可以填充种子内容 —— HotCRM 不附带这些库,也没有可供对战卡挂靠的竞争对手对象。Copilot 拿一篇文章能做什么、不能做什么,参见 [知识库](/zh-Hans/docs/ai-copilot/knowledge-bases)。

### 14. AI Copilot

Expand Down
17 changes: 10 additions & 7 deletions content/docs/administration/setup.zh-Hant.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ description: 讓 HotCRM 為你的團隊做好生產準備的第一週任務。

- [ ] 匯入 [產品](/zh-Hant/docs/revenue/products) —— 至少:代碼、名稱、標價、計費類型
- [ ] 設置產品經理(每條產品線的聯絡人)
- [ ] 上傳資料表(饋送 AI Copilot 的產品資訊知識庫)
- [ ] 上傳資料表 —— 產品記錄上的一個 PDF 檔案欄位,供人開啟檢視;沒有任何知識庫會攝取它

## ✅ 第 4 天 —— 流程

Expand Down Expand Up @@ -120,14 +120,17 @@ description: 讓 HotCRM 為你的團隊做好生產準備的第一週任務。

## ✅ 第 5 天 —— 知識與 AI

### 13. 知識庫
### 13. 知識文章

- [ ] 用你最熱門的 20 篇 FAQ 文章為 **支援知識** 填充種子內容
- [ ] 用你的銷售指南為 **銷售知識** 填充種子內容
- [ ] 用你最重要的 5 個競爭對手的對戰卡為 **競爭情報** 填充種子內容
- [ ] 產品資料表 —— 已在產品記錄中(自動同步)
HotCRM 只附帶**一個**知識物件,而不是一組知識庫。下面每一條都是你在**服務 → 知識**下建立的普通記錄,歸入該物件定義的七個分類之一。

參見 [知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases)。
- [ ] 把最熱門的 20 個 FAQ 寫成文章,歸入**故障排查**、**操作指南**或**入門指南**
- [ ] 把支援時間、SLA 承諾和資料處理說明歸入**政策制度**
- [ ] 逐篇設定**受眾** —— 操作手冊用*僅內部*,你願意發給客戶的用*公開*
- [ ] 把它們**發布** —— Copilot 只查詢已發布的文章,草稿等於不存在
- [ ] 收工前複核一遍分類和標籤:匹配靠的是分類與標籤而不是語義,歸錯的文章就是找不到的文章

沒有任何叫 *銷售知識*、*產品資訊* 或 *競爭情報* 的東西可以填充種子內容 —— HotCRM 不附帶這些庫,也沒有可供對戰卡掛靠的競爭對手物件。Copilot 拿一篇文章能做什麼、不能做什麼,參見 [知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases)。

### 14. AI Copilot

Expand Down
4 changes: 2 additions & 2 deletions content/docs/ai-copilot/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ skills** that teach that assistant your CRM.
> only the wiring changed.

The six skills read from the same objects you see in the UI, and they know your
products, knowledge bases, and process rules.
products, knowledge articles, and process rules.

## Where you'll find it

Expand All @@ -29,7 +29,7 @@ products, knowledge bases, and process rules.
The assistant has three ingredients:

1. **Skills** — bite-sized abilities like *Draft an email*, *Qualify this lead*, *Triage this case*. See [Skills](/docs/ai-copilot/skills).
2. **Knowledge bases** — searchable libraries of product info, sales playbooks, support articles, and competitive intel. See [Knowledge Bases](/docs/ai-copilot/knowledge-bases).
2. **Knowledge articles** — one library of support articles, filed by category, that the assistant queries like any other object. There is no separate product, sales or competitive library. See [Knowledge Bases](/docs/ai-copilot/knowledge-bases).
3. **Your live CRM data** — the assistant reads from the same accounts, contacts, opportunities, and cases you do, respecting the same sharing rules.

When you ask a question, the assistant picks the right skill, pulls relevant
Expand Down
4 changes: 2 additions & 2 deletions content/docs/ai-copilot/index.zh-Hans.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ HotCRM 是 **AI 原生**的——助手是内置的,而非外挂的。但助
> Copilot"。它们已被退役,其能力迁移到了附着于平台助手的技能中。本页描述的一切依然有
> 效;变的只是接线方式。

这六项技能从你在 UI 中看到的同一批对象读取数据,并且了解你的产品、知识库和流程规则。
这六项技能从你在 UI 中看到的同一批对象读取数据,并且了解你的产品、知识文章和流程规则。

## 你会在哪里找到它

Expand All @@ -26,7 +26,7 @@ HotCRM 是 **AI 原生**的——助手是内置的,而非外挂的。但助
助手有三大要素:

1. **技能**——细分到点的能力,如*撰写邮件*、*判定此线索资格*、*分流此工单*。参见 [技能](/zh-Hans/docs/ai-copilot/skills)。
2. **知识库**——可搜索的产品信息、销售剧本、支持文章和竞争情报库。参见 [知识库](/zh-Hans/docs/ai-copilot/knowledge-bases)。
2. **知识文章**——一个按分类归档的支持文章库,助手像查询其它对象一样查询它。没有独立的产品、销售或竞争情报库。参见 [知识库](/zh-Hans/docs/ai-copilot/knowledge-bases)。
3. **你的实时 CRM 数据**——助手从你看到的同一批客户、联系人、商机和工单读取数据,并遵循相同的共享规则。

当你提出问题时,助手会选择合适的技能、拉取相关知识,并将其与你的 CRM 数据结合,生成有
Expand Down
4 changes: 2 additions & 2 deletions content/docs/ai-copilot/index.zh-Hant.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ HotCRM 是 **AI 原生**的——助手是內建的,而非外掛的。但助
> 務 Copilot」。它們已被退役,其能力遷移到了附著於平台助手的技能中。本頁描述的一切依
> 然有效;變的只是接線方式。

這六項技能從你在 UI 中看到的同一批物件讀取資料,並且了解你的產品、知識庫和流程規則。
這六項技能從你在 UI 中看到的同一批物件讀取資料,並且了解你的產品、知識文章和流程規則。

## 你會在哪裡找到它

Expand All @@ -26,7 +26,7 @@ HotCRM 是 **AI 原生**的——助手是內建的,而非外掛的。但助
助手有三大要素:

1. **技能**——細分到點的能力,如*撰寫郵件*、*判定此潛在客戶資格*、*分流此工單*。參見 [技能](/zh-Hant/docs/ai-copilot/skills)。
2. **知識庫**——可搜尋的產品資訊、銷售劇本、支援文章和競爭情報庫。參見 [知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases)。
2. **知識文章**——一個按分類歸檔的支援文章庫,助手像查詢其它物件一樣查詢它。沒有獨立的產品、銷售或競爭情報庫。參見 [知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases)。
3. **你的即時 CRM 資料**——助手從你看到的同一批客戶、聯絡人、商機和工單讀取資料,並遵循相同的共享規則。

當你提出問題時,助手會選擇合適的技能、拉取相關知識,並將其與你的 CRM 資料結合,生成有
Expand Down
Loading
Loading