From 6834ff3d3f127bcd7db69c0c4ec7da58e60489d3 Mon Sep 17 00:00:00 2001 From: os-zhuang Date: Sun, 2 Aug 2026 11:28:43 +0000 Subject: [PATCH] docs: align README/copilot pages with the shipped skills-only surface (#589) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The README claimed "2 AI agents (sales-copilot, service-copilot), 20 flows, 5 sharing rules" seventy lines above a layout block that correctly described a skills-only surface with 23 flows. Both now state the numbers that objectstack.config.ts actually registers: 0 app-owned agents, 6 skills, 23 flows, 9 sharing rules, 8 datasets. Rewrite the six published copilot pages (en/zh-Hans/zh-Hant) as skill docs at their existing URLs. The personas were retired in #512; the capability ships as six skills on the platform `ask` assistant. Activation is documented from each skill's real triggerConditions, and writes are named as the HotCRM actions the skills call (convert_lead, schedule_followup, escalate_case, close_case) instead of inline buttons that do not exist. Follow the rename through the AI Copilot index, the Skills and Knowledge Bases pages, the glossary's "Agent (AI)" entry, the customization guide (which told developers to edit the long-deleted src/agents/sales-copilot.agent.ts) and every inbound link label. live-schema.* is left untouched — it is #606's scope. Banner the archived Salesforce comparison: it describes a ~148-object, 13-package architecture and marks sla_policy/queue/email_to_case/pricebook as implemented when none exist, so its "~95% parity" headline misled anyone evaluating the repo. Correct docs/ARCHITECTURE.md: drop the deleted src/agents and the never-created src/cubes from the diagram, 1.0.5 -> 2.2.2, and remove the `ai` capability from `requires` (removed in 2.2.0 because it is fail-fast under ObjectStack 16). Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_019SS7C5SXpniKeCApxgARyf --- .changeset/docs-align-retired-agents.md | 34 +++++++ README.md | 4 +- content/docs/ai-copilot/index.mdx | 49 ++++++---- content/docs/ai-copilot/index.zh-Hans.mdx | 44 +++++---- content/docs/ai-copilot/index.zh-Hant.mdx | 44 +++++---- content/docs/ai-copilot/knowledge-bases.mdx | 6 +- .../ai-copilot/knowledge-bases.zh-Hans.mdx | 6 +- .../ai-copilot/knowledge-bases.zh-Hant.mdx | 6 +- content/docs/ai-copilot/sales-copilot.mdx | 89 +++++++++++++------ .../docs/ai-copilot/sales-copilot.zh-Hans.mdx | 79 ++++++++++------ .../docs/ai-copilot/sales-copilot.zh-Hant.mdx | 83 +++++++++++------ content/docs/ai-copilot/service-copilot.mdx | 89 ++++++++++--------- .../ai-copilot/service-copilot.zh-Hans.mdx | 82 ++++++++--------- .../ai-copilot/service-copilot.zh-Hant.mdx | 88 +++++++++--------- content/docs/ai-copilot/skills.mdx | 14 +-- content/docs/ai-copilot/skills.zh-Hans.mdx | 14 +-- content/docs/ai-copilot/skills.zh-Hant.mdx | 14 +-- content/docs/analytics/index.mdx | 2 +- content/docs/analytics/index.zh-Hans.mdx | 2 +- content/docs/analytics/index.zh-Hant.mdx | 2 +- content/docs/customization/ai-skills.mdx | 34 +++---- .../docs/customization/ai-skills.zh-Hans.mdx | 33 +++---- .../docs/customization/ai-skills.zh-Hant.mdx | 33 +++---- content/docs/getting-started/quick-tour.mdx | 4 +- .../getting-started/quick-tour.zh-Hans.mdx | 4 +- .../getting-started/quick-tour.zh-Hant.mdx | 4 +- content/docs/guides/email-and-calendar.mdx | 2 +- .../guides/email-and-calendar.zh-Hans.mdx | 2 +- .../guides/email-and-calendar.zh-Hant.mdx | 2 +- content/docs/reference/glossary.mdx | 2 +- content/docs/reference/glossary.zh-Hans.mdx | 2 +- content/docs/reference/glossary.zh-Hant.mdx | 2 +- content/docs/sales/index.mdx | 4 +- content/docs/sales/index.zh-Hans.mdx | 2 +- content/docs/sales/index.zh-Hant.mdx | 2 +- content/docs/service/cases.mdx | 4 +- content/docs/service/cases.zh-Hans.mdx | 2 +- content/docs/service/cases.zh-Hant.mdx | 2 +- content/docs/service/index.mdx | 4 +- content/docs/service/index.zh-Hans.mdx | 2 +- content/docs/service/index.zh-Hant.mdx | 2 +- content/docs/whats-new.zh-Hans.mdx | 2 +- content/docs/whats-new.zh-Hant.mdx | 2 +- docs/ARCHITECTURE.md | 29 ++++-- .../2026-02/SALESFORCE_FEATURE_COMPARISON.md | 21 +++++ 45 files changed, 574 insertions(+), 379 deletions(-) create mode 100644 .changeset/docs-align-retired-agents.md diff --git a/.changeset/docs-align-retired-agents.md b/.changeset/docs-align-retired-agents.md new file mode 100644 index 00000000..3ab619d3 --- /dev/null +++ b/.changeset/docs-align-retired-agents.md @@ -0,0 +1,34 @@ +--- +'hotcrm': patch +--- + +Docs alignment: correct the metadata counts in the README, rewrite the AI copilot +pages as skill docs, and disclaim the archived Salesforce comparison. + +The README advertised "2 AI agents (sales-copilot, service-copilot), 20 flows, +5 sharing rules" three paragraphs above a repository-layout block that correctly +called the AI surface skills-only with 23 flows. The real numbers, taken from +`objectstack.config.ts`, are **0 app-owned agents, 6 AI skills, 23 flows and 9 +sharing rules**; both README passages now say that, and the `8 datasets` count was +added so the two lists agree. + +The published `ai-copilot/sales-copilot` and `ai-copilot/service-copilot` pages (en, +zh-Hans, zh-Hant) still described two AI personas that were retired in #512 — "it +lives in the right-side chat panel and as inline buttons" for capabilities that ship +today as six skills on the platform `ask` assistant. They are rewritten as skill docs +at their existing URLs, with the activation rules taken from each skill's real +`triggerConditions` and the write paths named as the actual HotCRM actions +(`convert_lead`, `schedule_followup`, `escalate_case`, `close_case`) the skills call. +The AI Copilot index, the Skills page, the glossary's "Agent (AI)" entry, the +customization guide (which told developers to edit a long-deleted +`src/agents/sales-copilot.agent.ts`) and every inbound link label were updated to +match. + +`docs/archive/2026-02/SALESFORCE_FEATURE_COMPARISON.md` now opens with a +retired-architecture banner. It describes a ~148-object, 13-package product and marks +`sla_policy`, `queue`, `email_to_case` and `pricebook` as implemented — none exist — +so its "~95% Salesforce parity" headline was actively misleading anyone evaluating the +repo. Finally `docs/ARCHITECTURE.md` was corrected: the diagram no longer draws the +deleted `src/agents` or the never-created `src/cubes`, the manifest table reads +`2.2.2` instead of `1.0.5`, and `requires` no longer lists the `ai` capability that +was removed in 2.2.0. diff --git a/README.md b/README.md index 0799d67f..ae2d1ae6 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ # HotCRM > **The reference app for AI-written enterprise software.** A complete CRM — -> 15 objects, 20 flows, 4 dashboards, 2 AI copilots, 4 languages — is roughly +> 15 objects, 23 flows, 4 dashboards, 6 AI skills, 4 languages — is roughly > **170k tokens** of typed [ObjectStack](https://github.com/objectstack-ai/objectstack) > metadata (~18,000 lines): the entire enterprise CRM fits in a single agent > context window, so an AI can hold it whole, reason about it, and refactor it. @@ -57,7 +57,7 @@ HotCRM is a complete, opinionated CRM built as the **first official application* | `crm_product` | | | | | `crm_forecast` | | | | -Plus **2 AI agents** (sales-copilot, service-copilot), **4 dashboards**, **20 flows**, **13 actions**, **6 AI skills**, **4 language bundles** (en, zh-CN, es-ES, ja-JP), **6 permission profiles**, **12 positions**, and **5 sharing rules**. +Plus **6 AI skills** (a skills-only surface — HotCRM defines no agents of its own; the skills attach to the platform `ask` assistant), **4 dashboards**, **23 flows**, **13 actions**, **8 datasets**, **4 language bundles** (en, zh-CN, es-ES, ja-JP), **6 permission profiles**, **12 positions**, and **9 sharing rules**. > **Business reader?** The ObjectStack docs tour every one of these capabilities in plain business language — [What Can It Do?](https://objectstack.ai/docs/capabilities) — with HotCRM as the running example on every page. diff --git a/content/docs/ai-copilot/index.mdx b/content/docs/ai-copilot/index.mdx index f8fe92f2..a4d161df 100644 --- a/content/docs/ai-copilot/index.mdx +++ b/content/docs/ai-copilot/index.mdx @@ -5,47 +5,58 @@ description: The AI assistant embedded throughout HotCRM — what it can do, whe # AI Copilot -HotCRM is **AI-native** — the assistant is built in, not bolted on. Two specialised copilots ship out of the box: +HotCRM is **AI-native** — the assistant is built in, not bolted on. But the assistant +itself is not something HotCRM ships: it is the **platform assistant** (`ask`) that +every ObjectStack environment already provides. What HotCRM contributes is **six +skills** that teach that assistant your CRM. -- The **Sales Copilot** helps reps qualify leads, draft emails, forecast revenue, and get a 360° view of accounts. -- The **Service Copilot** helps agents triage cases, see the full customer history, and draft customer responses. +> **No app-owned agents.** HotCRM used to define two agents of its own — a "Sales +> Copilot" and a "Service Copilot". They were retired, and their capability moved into +> skills that attach to the platform assistant. Everything on this page still works; +> only the wiring changed. -Both run on top of your CRM data — they read from the same objects you see in the UI, and they know your products, knowledge bases, and process rules. +The six skills read from the same objects you see in the UI, and they know your +products, knowledge bases, and process rules. ## Where you'll find it -- 🪄 **Copilot panel** — a chat panel that opens from the right edge of every page. -- ⚡ **Inline actions** — buttons like *"Qualify this lead"*, *"Draft reply"*, *"Summarize case"* on record detail pages. -- 📋 **Suggestions** — automatic insights in dashboards (*"3 deals are at risk this week"*). +- 🪄 **Assistant panel** — the chat panel the platform opens from the right edge of every page. +- 🎯 **Context activation** — skills declare the record they belong to, so opening a lead and asking *"is this worth a call?"* runs Lead Qualification without you naming it. +- 📈 **Dashboard questions** — the forecasting skill also activates on dashboards, so you can ask *"what's at risk this week?"* where the numbers already are. ## How it works (in plain terms) -The Copilot has three ingredients: +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). -3. **Your live CRM data** — the Copilot reads from the same accounts, contacts, opportunities, and cases you do, respecting the same sharing rules. +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 Copilot picks the right skill, pulls relevant knowledge, and combines it with your CRM data to produce a grounded answer — with citations back to the source records and articles. +When you ask a question, the assistant picks the right skill, pulls relevant +knowledge, and combines it with your CRM data to produce a grounded answer — with +citations back to the source records and articles. ## What it won't do - ❌ See records you can't see — it respects sharing and field-level security. - ❌ Take actions without your confirmation — drafted emails and updates are previewed first. - ❌ Fabricate data — every claim is traceable to a record or knowledge source. +- ❌ Reach for tools of its own — skills declare no bespoke tools, so every write goes through a real HotCRM action with the same permission checks as the button. -## Two flavours +## Two groupings of skills -| Copilot | Audience | Built-in skills | -| --- | --- | --- | -| [**Sales Copilot**](/docs/ai-copilot/sales-copilot) | Sales reps, sales managers | Lead qualification, email drafting, revenue forecasting, 360° customer view | -| [**Service Copilot**](/docs/ai-copilot/service-copilot) | Service agents, support managers | Case triage, 360° customer view, email drafting | +The six skills are documented in two role-shaped groups. This is a documentation +convenience, not a runtime boundary — one assistant runs all six, and it will use a +"sales" skill on a service question whenever that is the right answer. -Both copilots can call each other's skills when relevant — for example, the Service Copilot can use the Sales Copilot's *Customer 360°* skill to show what the customer has bought. +| Group | Audience | Skills | +| --- | --- | --- | +| [**Sales Skills**](/docs/ai-copilot/sales-copilot) | Sales reps, sales managers | Live Data, Lead Qualification, Email Drafting, Revenue Forecasting, Customer 360° | +| [**Service Skills**](/docs/ai-copilot/service-copilot) | Service agents, support managers | Live Data, Case Triage, Customer 360°, Email Drafting | ## Start here -- [Sales Copilot](/docs/ai-copilot/sales-copilot) — what reps and managers can do. -- [Service Copilot](/docs/ai-copilot/service-copilot) — what agents can do. +- [Sales Skills](/docs/ai-copilot/sales-copilot) — what reps and managers can do. +- [Service Skills](/docs/ai-copilot/service-copilot) — what agents can do. - [Skills](/docs/ai-copilot/skills) — the full skill library. -- [Knowledge Bases](/docs/ai-copilot/knowledge-bases) — the RAG indexes the Copilot reads from. +- [Knowledge Bases](/docs/ai-copilot/knowledge-bases) — the RAG indexes the assistant reads from. diff --git a/content/docs/ai-copilot/index.zh-Hans.mdx b/content/docs/ai-copilot/index.zh-Hans.mdx index 4292d12f..cf65f5f3 100644 --- a/content/docs/ai-copilot/index.zh-Hans.mdx +++ b/content/docs/ai-copilot/index.zh-Hans.mdx @@ -5,47 +5,53 @@ description: 嵌入 HotCRM 各处的 AI 助手——它能做什么、在哪里 # AI Copilot -HotCRM 是 **AI 原生**的——助手是内置的，而非外挂的。开箱即用地提供两个专门的 Copilot： +HotCRM 是 **AI 原生**的——助手是内置的，而非外挂的。但助手本身并非由 HotCRM 提供：它 +是每个 ObjectStack 环境已经自带的 **平台助手**（`ask`）。HotCRM 贡献的是 **六项技 +能**，让这个助手学会你的 CRM。 -- **销售 Copilot** 帮助销售代表判定线索资格、撰写邮件、预测收入，并获得客户的 360° 全景视图。 -- **服务 Copilot** 帮助客服坐席分流工单、查看完整的客户历史，并撰写客户回复。 +> **没有应用自有的智能体。** HotCRM 曾定义过两个自己的智能体——"销售 Copilot"和"服务 +> Copilot"。它们已被退役，其能力迁移到了附着于平台助手的技能中。本页描述的一切依然有 +> 效；变的只是接线方式。 -两者都运行在你的 CRM 数据之上——它们从你在 UI 中看到的同一批对象读取数据，并且了解你的产品、知识库和流程规则。 +这六项技能从你在 UI 中看到的同一批对象读取数据，并且了解你的产品、知识库和流程规则。 ## 你会在哪里找到它 -- 🪄 **Copilot 面板**——一个从每个页面右侧边缘打开的聊天面板。 -- ⚡ **内联操作**——记录详情页上的按钮，如*"判定此线索资格"*、*"撰写回复"*、*"总结工单"*。 -- 📋 **建议**——仪表盘中的自动洞察（*"本周有 3 笔交易存在风险"*）。 +- 🪄 **助手面板**——平台从每个页面右侧边缘打开的聊天面板。 +- 🎯 **上下文激活**——技能声明了自己所属的记录，因此打开一条线索并问 *"这条值得打个电话吗？"*，无需点名就会运行线索资格判定。 +- 📈 **在仪表盘上提问**——收入预测技能也会在仪表盘上激活，你可以就地问 *"本周有什么风险？"*。 ## 它如何运作（通俗地说） -Copilot 有三大要素： +助手有三大要素： 1. **技能**——细分到点的能力，如*撰写邮件*、*判定此线索资格*、*分流此工单*。参见 [技能](/zh-Hans/docs/ai-copilot/skills)。 2. **知识库**——可搜索的产品信息、销售剧本、支持文章和竞争情报库。参见 [知识库](/zh-Hans/docs/ai-copilot/knowledge-bases)。 -3. **你的实时 CRM 数据**——Copilot 从你看到的同一批客户、联系人、商机和工单读取数据，并遵循相同的共享规则。 +3. **你的实时 CRM 数据**——助手从你看到的同一批客户、联系人、商机和工单读取数据，并遵循相同的共享规则。 -当你提出问题时，Copilot 会选择合适的技能、拉取相关知识，并将其与你的 CRM 数据结合，生成有依据的答案——并附带回溯到源记录和文章的引用。 +当你提出问题时，助手会选择合适的技能、拉取相关知识，并将其与你的 CRM 数据结合，生成有 +依据的答案——并附带回溯到源记录和文章的引用。 ## 它不会做什么 - ❌ 查看你看不到的记录——它遵循共享和字段级安全。 - ❌ 未经你确认就执行操作——撰写好的邮件和更新会先预览。 - ❌ 编造数据——每一条声明都可追溯到一条记录或一个知识来源。 +- ❌ 使用自带的专属工具——技能不声明任何专属工具，每一次写入都经由真实的 HotCRM 操作完成，权限校验与点击按钮时完全一致。 -## 两种形态 +## 技能的两种分组 -| Copilot | 受众 | 内置技能 | -| --- | --- | --- | -| [**销售 Copilot**](/zh-Hans/docs/ai-copilot/sales-copilot) | 销售代表、销售经理 | 线索资格判定、邮件撰写、收入预测、360° 客户视图 | -| [**服务 Copilot**](/zh-Hans/docs/ai-copilot/service-copilot) | 服务坐席、支持经理 | 工单分流、360° 客户视图、邮件撰写 | +六项技能按角色分成两组来编写文档。这只是文档上的便利，而非运行时边界——同一个助手运行 +全部六项技能，只要"销售"技能是正确答案，它也会用它来回答服务问题。 -两个 Copilot 在相关时可以互相调用对方的技能——例如，服务 Copilot 可以使用销售 Copilot 的 *Customer 360°* 技能来展示客户购买过什么。 +| 分组 | 受众 | 技能 | +| --- | --- | --- | +| [**销售技能**](/zh-Hans/docs/ai-copilot/sales-copilot) | 销售代表、销售经理 | 实时数据、线索资格判定、邮件撰写、收入预测、Customer 360° | +| [**服务技能**](/zh-Hans/docs/ai-copilot/service-copilot) | 服务坐席、支持经理 | 实时数据、工单分流、Customer 360°、邮件撰写 | ## 从这里开始 -- [销售 Copilot](/zh-Hans/docs/ai-copilot/sales-copilot)——销售代表和经理能做什么。 -- [服务 Copilot](/zh-Hans/docs/ai-copilot/service-copilot)——坐席能做什么。 +- [销售技能](/zh-Hans/docs/ai-copilot/sales-copilot)——销售代表和经理能做什么。 +- [服务技能](/zh-Hans/docs/ai-copilot/service-copilot)——坐席能做什么。 - [技能](/zh-Hans/docs/ai-copilot/skills)——完整的技能库。 -- [知识库](/zh-Hans/docs/ai-copilot/knowledge-bases)——Copilot 读取的 RAG 索引。 +- [知识库](/zh-Hans/docs/ai-copilot/knowledge-bases)——助手读取的 RAG 索引。 diff --git a/content/docs/ai-copilot/index.zh-Hant.mdx b/content/docs/ai-copilot/index.zh-Hant.mdx index 117f62cf..805173cd 100644 --- a/content/docs/ai-copilot/index.zh-Hant.mdx +++ b/content/docs/ai-copilot/index.zh-Hant.mdx @@ -5,47 +5,53 @@ description: 嵌入 HotCRM 各處的 AI 助手——它能做什麼、在哪裡 # AI Copilot -HotCRM 是 **AI 原生**的——助手是內建的，而非外掛的。開箱即用地提供兩個專門的 Copilot： +HotCRM 是 **AI 原生**的——助手是內建的，而非外掛的。但助手本身並非由 HotCRM 提供：它 +是每個 ObjectStack 環境已經自帶的 **平台助手**（`ask`）。HotCRM 貢獻的是 **六項技 +能**，讓這個助手學會你的 CRM。 -- **銷售 Copilot** 幫助銷售代表判定潛在客戶資格、撰寫郵件、預測收入，並獲得客戶的 360° 全景視圖。 -- **服務 Copilot** 幫助客服坐席分流工單、查看完整的客戶歷史，並撰寫客戶回覆。 +> **沒有應用自有的智能體。** HotCRM 曾定義過兩個自己的智能體——「銷售 Copilot」和「服 +> 務 Copilot」。它們已被退役，其能力遷移到了附著於平台助手的技能中。本頁描述的一切依 +> 然有效；變的只是接線方式。 -兩者都執行在你的 CRM 資料之上——它們從你在 UI 中看到的同一批物件讀取資料，並且了解你的產品、知識庫和流程規則。 +這六項技能從你在 UI 中看到的同一批物件讀取資料，並且了解你的產品、知識庫和流程規則。 ## 你會在哪裡找到它 -- 🪄 **Copilot 面板**——一個從每個頁面右側邊緣開啟的聊天面板。 -- ⚡ **內聯操作**——記錄詳情頁上的按鈕，如*「判定此潛在客戶資格」*、*「撰寫回覆」*、*「總結工單」*。 -- 📋 **建議**——儀表板中的自動洞察（*「本週有 3 筆交易存在風險」*）。 +- 🪄 **助手面板**——平台從每個頁面右側邊緣開啟的聊天面板。 +- 🎯 **情境啟用**——技能宣告了自己所屬的記錄，因此打開一筆潛在客戶並問 *「這筆值得打個電話嗎？」*，無需點名就會執行潛在客戶資格判定。 +- 📈 **在儀表板上提問**——收入預測技能也會在儀表板上啟用，你可以就地問 *「本週有什麼風險？」*。 ## 它如何運作（通俗地說） -Copilot 有三大要素： +助手有三大要素： 1. **技能**——細分到點的能力，如*撰寫郵件*、*判定此潛在客戶資格*、*分流此工單*。參見 [技能](/zh-Hant/docs/ai-copilot/skills)。 2. **知識庫**——可搜尋的產品資訊、銷售劇本、支援文章和競爭情報庫。參見 [知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases)。 -3. **你的即時 CRM 資料**——Copilot 從你看到的同一批客戶、聯絡人、商機和工單讀取資料，並遵循相同的共享規則。 +3. **你的即時 CRM 資料**——助手從你看到的同一批客戶、聯絡人、商機和工單讀取資料，並遵循相同的共享規則。 -當你提出問題時，Copilot 會選擇合適的技能、拉取相關知識，並將其與你的 CRM 資料結合，生成有依據的答案——並附帶回溯到來源記錄和文章的引用。 +當你提出問題時，助手會選擇合適的技能、拉取相關知識，並將其與你的 CRM 資料結合，生成有 +依據的答案——並附帶回溯到來源記錄和文章的引用。 ## 它不會做什麼 - ❌ 查看你看不到的記錄——它遵循共享和欄位級安全。 - ❌ 未經你確認就執行操作——撰寫好的郵件和更新會先預覽。 - ❌ 編造資料——每一條聲明都可追溯到一條記錄或一個知識來源。 +- ❌ 使用自帶的專屬工具——技能不宣告任何專屬工具，每一次寫入都經由真實的 HotCRM 操作完成，權限校驗與點擊按鈕時完全一致。 -## 兩種形態 +## 技能的兩種分組 -| Copilot | 受眾 | 內建技能 | -| --- | --- | --- | -| [**銷售 Copilot**](/zh-Hant/docs/ai-copilot/sales-copilot) | 銷售代表、銷售經理 | 潛在客戶資格判定、郵件撰寫、收入預測、360° 客戶視圖 | -| [**服務 Copilot**](/zh-Hant/docs/ai-copilot/service-copilot) | 服務坐席、支援經理 | 工單分流、360° 客戶視圖、郵件撰寫 | +六項技能按角色分成兩組來編寫文件。這只是文件上的便利，而非執行時邊界——同一個助手執行 +全部六項技能，只要「銷售」技能是正確答案，它也會用它來回答服務問題。 -兩個 Copilot 在相關時可以互相呼叫對方的技能——例如，服務 Copilot 可以使用銷售 Copilot 的 *Customer 360°* 技能來展示客戶購買過什麼。 +| 分組 | 受眾 | 技能 | +| --- | --- | --- | +| [**銷售技能**](/zh-Hant/docs/ai-copilot/sales-copilot) | 銷售代表、銷售經理 | 即時資料、潛在客戶資格判定、郵件撰寫、收入預測、Customer 360° | +| [**服務技能**](/zh-Hant/docs/ai-copilot/service-copilot) | 服務坐席、支援經理 | 即時資料、工單分流、Customer 360°、郵件撰寫 | ## 從這裡開始 -- [銷售 Copilot](/zh-Hant/docs/ai-copilot/sales-copilot)——銷售代表和經理能做什麼。 -- [服務 Copilot](/zh-Hant/docs/ai-copilot/service-copilot)——坐席能做什麼。 +- [銷售技能](/zh-Hant/docs/ai-copilot/sales-copilot)——銷售代表和經理能做什麼。 +- [服務技能](/zh-Hant/docs/ai-copilot/service-copilot)——坐席能做什麼。 - [技能](/zh-Hant/docs/ai-copilot/skills)——完整的技能庫。 -- [知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases)——Copilot 讀取的 RAG 索引。 +- [知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases)——助手讀取的 RAG 索引。 diff --git a/content/docs/ai-copilot/knowledge-bases.mdx b/content/docs/ai-copilot/knowledge-bases.mdx index 63d41049..e6c363b4 100644 --- a/content/docs/ai-copilot/knowledge-bases.mdx +++ b/content/docs/ai-copilot/knowledge-bases.mdx @@ -13,9 +13,9 @@ This is the layer that makes the Copilot's answers **grounded** — every fact, | Knowledge base | Used by | What's in it | | --- | --- | --- | -| 📘 **Sales Knowledge** | Sales Copilot | Playbooks, objection handling, qualification frameworks, win/loss notes | +| 📘 **Sales Knowledge** | Sales skills | Playbooks, objection handling, qualification frameworks, win/loss notes | | 📗 **Product Information** | Sales + Service | Product datasheets, feature specs, release notes, FAQs | -| 🎧 **Support Knowledge** | Service Copilot | KB articles, troubleshooting guides, runbooks | +| 🎧 **Support Knowledge** | Service skills | KB articles, troubleshooting guides, runbooks | | ⚔️ **Competitive Intel** | Sales | Competitor profiles, battle cards, win/loss analyses | ## How they work (in plain terms) @@ -49,7 +49,7 @@ The sales rep's playbook, in searchable form. ## 📗 Product Information -Everything about what you sell. Read by both sales and service copilots. +Everything about what you sell. Read by both the sales and the service skills. **Typical contents**: diff --git a/content/docs/ai-copilot/knowledge-bases.zh-Hans.mdx b/content/docs/ai-copilot/knowledge-bases.zh-Hans.mdx index fc773f40..c821bea0 100644 --- a/content/docs/ai-copilot/knowledge-bases.zh-Hans.mdx +++ b/content/docs/ai-copilot/knowledge-bases.zh-Hans.mdx @@ -13,9 +13,9 @@ description: 为 AI Copilot 提供依据的四个可搜索知识库——销售 | 知识库 | 使用者 | 内含什么 | | --- | --- | --- | -| 📘 **销售知识** | 销售 Copilot | 剧本、异议处理、资格判定框架、赢单/失单笔记 | +| 📘 **销售知识** | 销售技能 | 剧本、异议处理、资格判定框架、赢单/失单笔记 | | 📗 **产品信息** | 销售 + 服务 | 产品数据表、功能规格、发布说明、常见问题 | -| 🎧 **支持知识** | 服务 Copilot | 知识库文章、故障排查指南、操作手册 | +| 🎧 **支持知识** | 服务技能 | 知识库文章、故障排查指南、操作手册 | | ⚔️ **竞争情报** | 销售 | 竞争对手画像、对战卡、赢单/失单分析 | ## 它们如何运作（通俗地说） @@ -49,7 +49,7 @@ description: 为 AI Copilot 提供依据的四个可搜索知识库——销售 ## 📗 产品信息 -关于你所销售内容的一切。由销售和服务两个 Copilot 读取。 +关于你所销售内容的一切。由销售和服务两组技能读取。 **典型内容**： diff --git a/content/docs/ai-copilot/knowledge-bases.zh-Hant.mdx b/content/docs/ai-copilot/knowledge-bases.zh-Hant.mdx index 064139bf..93487d30 100644 --- a/content/docs/ai-copilot/knowledge-bases.zh-Hant.mdx +++ b/content/docs/ai-copilot/knowledge-bases.zh-Hant.mdx @@ -13,9 +13,9 @@ description: 為 AI Copilot 提供依據的四個可搜尋知識庫——銷售 | 知識庫 | 使用者 | 內含什麼 | | --- | --- | --- | -| 📘 **銷售知識** | 銷售 Copilot | 劇本、異議處理、資格判定框架、贏單/失單筆記 | +| 📘 **銷售知識** | 銷售技能 | 劇本、異議處理、資格判定框架、贏單/失單筆記 | | 📗 **產品資訊** | 銷售 + 服務 | 產品資料表、功能規格、發布說明、常見問題 | -| 🎧 **支援知識** | 服務 Copilot | 知識庫文章、故障排查指南、操作手冊 | +| 🎧 **支援知識** | 服務技能 | 知識庫文章、故障排查指南、操作手冊 | | ⚔️ **競爭情報** | 銷售 | 競爭對手畫像、對戰卡、贏單/失單分析 | ## 它們如何運作（通俗地說） @@ -49,7 +49,7 @@ description: 為 AI Copilot 提供依據的四個可搜尋知識庫——銷售 ## 📗 產品資訊 -關於你所銷售內容的一切。由銷售和服務兩個 Copilot 讀取。 +關於你所銷售內容的一切。由銷售和服務兩組技能讀取。 **典型內容**： diff --git a/content/docs/ai-copilot/sales-copilot.mdx b/content/docs/ai-copilot/sales-copilot.mdx index 9ca9ffda..a82d85fb 100644 --- a/content/docs/ai-copilot/sales-copilot.mdx +++ b/content/docs/ai-copilot/sales-copilot.mdx @@ -1,11 +1,20 @@ --- -title: Sales Copilot -description: The AI sales assistant — qualify leads, draft emails, forecast revenue, and get a 360° customer view. +title: Sales Skills +description: The sales-side AI skills — qualify leads, draft emails, forecast revenue, and get a 360° customer view. --- -# Sales Copilot +# Sales Skills -The Sales Copilot is your AI partner for the sales process. It lives in the right-side chat panel and as inline buttons on lead, contact, account, and opportunity pages. +HotCRM does not ship an assistant of its own. It ships **skills** — packaged AI +abilities that attach to the **platform assistant** (`ask`) that every ObjectStack +environment already provides. When you open the assistant panel inside HotCRM, the +sales skills below are what it knows how to do. + +> **Where the personas went.** Earlier versions of this page described a "Sales +> Copilot" agent. HotCRM no longer defines its own agents: the same capability now +> lives in five skills registered through `src/skills/`, and the platform assistant +> selects among them. Nothing was lost — the wiring moved from an app-owned agent to +> the platform one. ## Who it's for @@ -13,36 +22,56 @@ The Sales Copilot is your AI partner for the sales process. It lives in the righ - **Sales managers** — pipeline and forecast intelligence. - **Sales operations** — bulk insights and what-if analysis. -## What it can do +## How a skill gets picked + +You do not choose a skill from a menu. Each skill declares the record context it +belongs to, and the assistant activates it when that context matches: + +| Skill | Activates on | +| --- | --- | +| 🎯 Lead Qualification | a `crm_lead` record | +| 📈 Revenue Forecasting | a `crm_opportunity` record or a dashboard | +| 🔄 Live Data, ✍️ Email Drafting, 🔭 Customer 360° | any context — always available | + +So opening a lead and typing *"is this one worth a call?"* runs Lead Qualification +without you naming it. -The Sales Copilot ships with five core skills. They can be invoked by chatting (*"Qualify this lead"*) or by clicking inline buttons. +## The sales skills ### 1. 🔄 Live Data — the foundation -Before it qualifies a lead, drafts an email, or forecasts a number, the Sales Copilot grounds itself in **live data**. Every turn, it calls `describe_object` and `query_records` against the live metadata + record store — not a cached snapshot. That's why adding a field at 10:00:00 lets the Copilot answer a question about it at 10:00:05 with zero retraining. +Before it qualifies a lead, drafts an email, or forecasts a number, the assistant +grounds itself in **live data**. Every turn, it calls `describe_object` and +`query_records` against the live metadata + record store — not a cached snapshot. +That's why adding a field at 10:00:00 lets the assistant answer a question about it +at 10:00:05 with zero retraining. -See [Live Schema (Wow #1)](/docs/ai-copilot/live-schema) for the 30-second demo. Everything below composes on top of this skill. +See [Live Schema (Wow #1)](/docs/ai-copilot/live-schema) for the 30-second demo. +Everything below composes on top of this skill. ### 2. 🎯 Lead Qualification -Ask the Copilot to qualify a lead and it scores them on the BANT framework: +Ask the assistant to qualify a lead and it scores them 0–100 on the BANT framework: - **Budget** — is there budget for what you sell? - **Authority** — is this person the decision maker? - **Need** — is there a clear, articulated need? - **Timeline** — is there urgency? -The Copilot pulls signals from the lead record, any campaign engagement history, related accounts (if matched), and recent emails. It returns: +It reads the lead record and its related activity history, then returns: -- A **score** (Hot 🔥 / Warm 🌡️ / Cold ❄️). -- A **rationale** citing the signals. -- A **recommended next action** ("schedule discovery call", "nurture", "disqualify"). +- A **score** (0–100) with one line of justification per BANT dimension. +- The **field or activity** each judgement was drawn from. +- The single **recommended next step**, with the lead ID cited. -Click **Accept** to update the lead's status and rating automatically. +If the score is 70 or above and you agree, the skill calls the real **Convert Lead** +action. Otherwise it calls **Schedule Follow-up** with the date it recommends. +Conversion is never performed without your explicit confirmation. ### 3. ✍️ Email Drafting -Highlight any record (lead, contact, opportunity) and ask the Copilot to draft an email. It produces a context-aware draft using: +On any record (lead, contact, opportunity), ask for an email draft. It produces a +context-aware draft using: - The contact's name, role, and account. - The opportunity stage and amount (if relevant). @@ -50,7 +79,7 @@ Highlight any record (lead, contact, opportunity) and ask the Copilot to draft a - The relevant product datasheet from the Product Information knowledge base. - The sales playbook from the Sales Knowledge knowledge base. -Common email templates the Copilot handles well: +Common email shapes it handles well: - **Introduction** — first outreach after a lead is captured. - **Discovery follow-up** — after a discovery call. @@ -59,11 +88,11 @@ Common email templates the Copilot handles well: - **Renewal reminder** — to a contract holder ahead of expiration. - **Win celebration** — to the customer after closed-won. -You always **preview and edit** before sending. The Copilot never sends on its own. +You always **preview and edit** before sending. The skill never sends on its own. ### 4. 📈 Revenue Forecasting -Ask *"What's my forecast for this quarter?"* and the Copilot returns: +Ask *"What's my forecast for this quarter?"* and you get: - **Closed** — committed revenue (closed-won this period). - **Commit** — opportunities >80% probability in the period. @@ -71,11 +100,12 @@ Ask *"What's my forecast for this quarter?"* and the Copilot returns: - **Pipeline** — everything else. - **Risk callouts** — deals slipping, stale opportunities, missing close dates. -Forecasts respect role hierarchy — a rep sees their own number, a manager sees their team's, a director sees the rollup. +Forecasts respect your position and sharing rules — a rep sees their own number, a +manager sees their team's, a director sees the rollup. ### 5. 🔭 Customer 360° -On any account or contact, ask *"Give me a 360° view"* and the Copilot summarizes: +On any account or contact, ask *"Give me a 360° view"* and you get: - **Relationship snapshot** — account tier, customer-since date, account owner. - **Active deals** — open opportunities with stage and amount. @@ -84,24 +114,27 @@ On any account or contact, ask *"Give me a 360° view"* and the Copilot summariz - **Contracts** — active and upcoming renewals. - **Marketing engagement** — recent campaigns the customer engaged with. -Perfect for prep before a meeting — "give me Customer 360 on Acme" and you walk in informed. +Perfect for prep before a meeting — "give me Customer 360 on Acme" and you walk in +informed. ## Tips for reps -- ✅ Use *Qualify this lead* the moment a new lead lands — it saves 15 minutes per lead. -- ✅ For email drafts, give the Copilot the **goal** in one sentence: *"Push for a meeting next week"* — better than a generic *"draft a follow-up"*. +- ✅ Ask to qualify the moment a new lead lands — it saves 15 minutes per lead. +- ✅ For email drafts, give the **goal** in one sentence: *"Push for a meeting next week"* — better than a generic *"draft a follow-up"*. - ✅ Ask *"What's at risk in my pipeline?"* every Monday morning. ## Tips for managers - ✅ Use *Customer 360* before every customer-facing meeting your team has. - ✅ Run *Revenue forecast* mid-week to spot slipping deals before the EOQ scramble. -- ✅ Ask *"Which reps need coaching?"* — the Copilot flags reps with stale pipelines or unusually long stage times. +- ✅ Ask *"Which reps need coaching?"* — the forecasting skill flags reps with stale pipelines or unusually long stage times. ## Limits -- The Copilot **respects sharing** — it can only reference records you can see. -- It **won't auto-send** emails, **won't auto-update** records, and **won't bulk-change** data without explicit confirmation. -- For sensitive customers, the Copilot **redacts** flagged fields (configurable by admins). +- Skills **respect sharing** — they can only reference records you can see. +- They **won't auto-send** emails, **won't auto-update** records, and **won't bulk-change** data without explicit confirmation. +- Skills declare no bespoke tools: every write goes through a real HotCRM action, so the same permission checks apply as when you click the button yourself. -See [Skills](/docs/ai-copilot/skills) for the full skill specification and [Knowledge Bases](/docs/ai-copilot/knowledge-bases) for how to keep the Copilot's answers fresh and accurate. +See [Skills](/docs/ai-copilot/skills) for the full skill specification and +[Knowledge Bases](/docs/ai-copilot/knowledge-bases) for how to keep the answers fresh +and accurate. diff --git a/content/docs/ai-copilot/sales-copilot.zh-Hans.mdx b/content/docs/ai-copilot/sales-copilot.zh-Hans.mdx index 736f1f75..fe37ead9 100644 --- a/content/docs/ai-copilot/sales-copilot.zh-Hans.mdx +++ b/content/docs/ai-copilot/sales-copilot.zh-Hans.mdx @@ -1,11 +1,18 @@ --- -title: 销售 Copilot -description: AI 销售助手——判定线索资格、撰写邮件、预测收入，并获得 360° 客户视图。 +title: 销售技能 +description: 销售侧的 AI 技能——判定线索资格、撰写邮件、预测收入，并获得 360° 客户视图。 --- -# 销售 Copilot +# 销售技能 -销售 Copilot 是你在销售流程中的 AI 伙伴。它存在于右侧聊天面板，并以内联按钮形式出现在线索、联系人、客户和商机页面上。 +HotCRM 本身不提供助手。它提供的是 **技能**——打包好的 AI 能力，附着在每个 +ObjectStack 环境已经自带的 **平台助手**（`ask`）之上。当你在 HotCRM 中打开助手面板 +时，下面这些销售技能就是它会做的事。 + +> **人格设定去哪了。** 本页的早期版本描述过一个"销售 Copilot"智能体。HotCRM 不再定 +> 义自己的智能体：同样的能力现在存在于通过 `src/skills/` 注册的五项技能中，由平台助 +> 手在其中做选择。没有任何能力丢失——只是接线方式从应用自有的智能体挪到了平台的那一 +> 个。 ## 它面向谁 @@ -13,36 +20,53 @@ description: AI 销售助手——判定线索资格、撰写邮件、预测收 - **销售经理**——管道和预测情报。 - **销售运营**——批量洞察和假设分析。 -## 它能做什么 +## 技能是怎样被选中的 + +你不需要从菜单里挑选技能。每项技能都声明了自己所属的记录上下文，助手在上下文匹配时 +自动激活它： + +| 技能 | 激活于 | +| --- | --- | +| 🎯 线索资格判定 | `crm_lead` 记录 | +| 📈 收入预测 | `crm_opportunity` 记录或仪表盘 | +| 🔄 实时数据、✍️ 邮件撰写、🔭 Customer 360° | 任意上下文——始终可用 | + +所以打开一条线索并输入 *"这条值得打个电话吗？"*，无需点名就会运行线索资格判定。 -销售 Copilot 内置五项核心技能。它们可以通过聊天（*"判定此线索资格"*）或点击内联按钮来调用。 +## 销售技能清单 ### 1. 🔄 实时数据——基础 -在判定线索资格、撰写邮件或预测数字之前，销售 Copilot 会将自身建立在 **实时数据** 之上。每一轮，它都针对实时元数据 + 记录存储调用 `describe_object` 和 `query_records`——而非缓存的快照。这就是为什么在 10:00:00 添加一个字段，Copilot 能在 10:00:05 回答关于它的问题，且零重新训练。 +在判定线索资格、撰写邮件或预测数字之前，助手会将自身建立在 **实时数据** 之上。每一 +轮，它都针对实时元数据 + 记录存储调用 `describe_object` 和 `query_records`——而非缓存 +的快照。这就是为什么在 10:00:00 添加一个字段，助手能在 10:00:05 回答关于它的问题，且 +零重新训练。 -参见 [实时模式（Wow #1）](/zh-Hans/docs/ai-copilot/live-schema) 中的 30 秒演示。下面的一切都构建在此技能之上。 +参见 [实时模式（Wow #1）](/zh-Hans/docs/ai-copilot/live-schema) 中的 30 秒演示。下面 +的一切都构建在此技能之上。 ### 2. 🎯 线索资格判定 -让 Copilot 判定一个线索的资格，它会按 BANT 框架为其评分： +让助手判定一条线索的资格，它会按 BANT 框架给出 0–100 的评分： - **Budget（预算）**——是否有购买你所售产品的预算？ - **Authority（权限）**——此人是决策者吗？ - **Need（需求）**——是否有清晰、明确表达的需求？ - **Timeline（时间线）**——是否有紧迫性？ -Copilot 从线索记录、任何活动参与历史、相关客户（如已匹配）和近期邮件中提取信号。它返回： +它读取线索记录及其相关活动历史，然后返回： -- 一个 **评分**（热门 🔥 / 温热 🌡️ / 冷淡 ❄️）。 -- 一份引用信号的 **理由**。 -- 一个 **建议的下一步操作**（"安排探询通话"、"培育"、"取消资格"）。 +- 一个 **评分**（0–100），每个 BANT 维度附一行理由。 +- 每项判断所依据的 **字段或活动**。 +- 单一的 **建议下一步**，并引用线索 ID。 -点击 **接受** 即可自动更新线索的状态和评级。 +若评分达到 70 及以上且你同意，技能会调用真实的 **转换线索** 操作；否则它会调用 **安排 +跟进** 并给出建议的日期。未经你明确确认，绝不执行转换。 ### 3. ✍️ 邮件撰写 -高亮任意记录（线索、联系人、商机），让 Copilot 撰写一封邮件。它会使用以下内容生成一份感知上下文的草稿： +在任意记录（线索、联系人、商机）上请求邮件草稿。它会使用以下内容生成一份感知上下文的 +草稿： - 联系人的姓名、角色和所属客户。 - 商机阶段和金额（如相关）。 @@ -50,7 +74,7 @@ Copilot 从线索记录、任何活动参与历史、相关客户（如已匹配 - 来自产品信息知识库的相关产品数据表。 - 来自销售知识知识库的销售剧本。 -Copilot 能很好地处理的常见邮件模板： +它能很好处理的常见邮件形态： - **介绍**——线索捕获后的首次触达。 - **探询跟进**——探询通话之后。 @@ -59,11 +83,11 @@ Copilot 能很好地处理的常见邮件模板： - **续约提醒**——在到期前发给合同持有人。 - **赢单庆祝**——在赢单成交后发给客户。 -你始终在发送前 **预览和编辑**。Copilot 从不擅自发送。 +你始终在发送前 **预览和编辑**。技能从不擅自发送。 ### 4. 📈 收入预测 -问 *"我这个季度的预测是多少？"*，Copilot 会返回： +问 *"我这个季度的预测是多少？"*，你会得到： - **Closed（已成交）**——已承诺收入（本期赢单成交）。 - **Commit（承诺）**——本期内概率 >80% 的商机。 @@ -71,11 +95,11 @@ Copilot 能很好地处理的常见邮件模板： - **Pipeline（管道）**——其余一切。 - **风险提示**——滑落的交易、陈旧的商机、缺失的成交日期。 -预测遵循角色层级——销售代表看到自己的数字，经理看到团队的，总监看到汇总。 +预测遵循你的岗位与共享规则——销售代表看到自己的数字，经理看到团队的，总监看到汇总。 ### 5. 🔭 Customer 360° -在任意客户或联系人上，问 *"给我一个 360° 视图"*，Copilot 会总结： +在任意客户或联系人上，问 *"给我一个 360° 视图"*，你会得到： - **关系快照**——客户层级、成为客户的日期、客户负责人。 - **进行中的交易**——带阶段和金额的开放商机。 @@ -88,20 +112,21 @@ Copilot 能很好地处理的常见邮件模板： ## 给销售代表的提示 -- ✅ 新线索一落地就使用 *判定此线索资格*——每个线索节省 15 分钟。 -- ✅ 撰写邮件时，用一句话给 Copilot 一个 **目标**：*"推动下周开个会"*——比泛泛的 *"撰写一封跟进邮件"* 更好。 +- ✅ 新线索一落地就请求资格判定——每个线索节省 15 分钟。 +- ✅ 撰写邮件时，用一句话说明 **目标**：*"推动下周开个会"*——比泛泛的 *"撰写一封跟进邮件"* 更好。 - ✅ 每周一早上问 *"我的管道里有什么风险？"*。 ## 给经理的提示 - ✅ 在团队的每次面向客户的会议前使用 *Customer 360*。 - ✅ 在周中运行 *收入预测*，在季末冲刺前发现滑落的交易。 -- ✅ 问 *"哪些销售代表需要辅导？"*——Copilot 会标记管道陈旧或阶段停留异常长的销售代表。 +- ✅ 问 *"哪些销售代表需要辅导？"*——收入预测技能会标记管道陈旧或阶段停留异常长的销售代表。 ## 限制 -- Copilot **遵循共享**——它只能引用你能看到的记录。 -- 它 **不会自动发送** 邮件、**不会自动更新** 记录，也 **不会批量更改** 数据，除非有明确确认。 -- 对于敏感客户，Copilot 会 **遮蔽** 标记的字段（可由管理员配置）。 +- 技能 **遵循共享**——它们只能引用你能看到的记录。 +- 它们 **不会自动发送** 邮件、**不会自动更新** 记录，也 **不会批量更改** 数据，除非有明确确认。 +- 技能不声明任何专属工具：每一次写入都经由真实的 HotCRM 操作完成，因此与你亲手点击按钮时的权限校验完全一致。 -参见 [技能](/zh-Hans/docs/ai-copilot/skills) 了解完整的技能规格，参见 [知识库](/zh-Hans/docs/ai-copilot/knowledge-bases) 了解如何保持 Copilot 答案的新鲜和准确。 +参见 [技能](/zh-Hans/docs/ai-copilot/skills) 了解完整的技能规格，参见 +[知识库](/zh-Hans/docs/ai-copilot/knowledge-bases) 了解如何保持答案的新鲜和准确。 diff --git a/content/docs/ai-copilot/sales-copilot.zh-Hant.mdx b/content/docs/ai-copilot/sales-copilot.zh-Hant.mdx index 7adebcfe..9a9e73c9 100644 --- a/content/docs/ai-copilot/sales-copilot.zh-Hant.mdx +++ b/content/docs/ai-copilot/sales-copilot.zh-Hant.mdx @@ -1,48 +1,72 @@ --- -title: 銷售 Copilot -description: AI 銷售助手——判定潛在客戶資格、撰寫郵件、預測收入，並獲得 360° 客戶視圖。 +title: 銷售技能 +description: 銷售側的 AI 技能——判定潛在客戶資格、撰寫郵件、預測收入，並獲得 360° 客戶視圖。 --- -# 銷售 Copilot +# 銷售技能 -銷售 Copilot 是你在銷售流程中的 AI 夥伴。它存在於右側聊天面板，並以內聯按鈕形式出現在潛在客戶、聯絡人、客戶和商機頁面上。 +HotCRM 本身不提供助手。它提供的是 **技能**——打包好的 AI 能力，附著在每個 +ObjectStack 環境已經自帶的 **平台助手**（`ask`）之上。當你在 HotCRM 中打開助手面板 +時，下面這些銷售技能就是它會做的事。 + +> **人格設定去哪了。** 本頁的早期版本描述過一個「銷售 Copilot」智能體。HotCRM 不再定 +> 義自己的智能體：同樣的能力現在存在於透過 `src/skills/` 註冊的五項技能中，由平台助手 +> 在其中做選擇。沒有任何能力遺失——只是接線方式從應用自有的智能體挪到了平台的那一個。 ## 它面向誰 - **銷售代表**——處理潛在客戶和交易的日常夥伴。 - **銷售經理**——管道和預測情報。 -- **銷售維運**——批量洞察和假設分析。 +- **銷售營運**——批次洞察和假設分析。 + +## 技能是怎樣被選中的 + +你不需要從選單裡挑選技能。每項技能都宣告了自己所屬的記錄情境，助手在情境匹配時自動啟 +用它： + +| 技能 | 啟用於 | +| --- | --- | +| 🎯 潛在客戶資格判定 | `crm_lead` 記錄 | +| 📈 收入預測 | `crm_opportunity` 記錄或儀表板 | +| 🔄 即時資料、✍️ 郵件撰寫、🔭 Customer 360° | 任意情境——始終可用 | -## 它能做什麼 +所以打開一筆潛在客戶並輸入 *「這筆值得打個電話嗎？」*，無需點名就會執行潛在客戶資格判 +定。 -銷售 Copilot 內建五項核心技能。它們可以透過聊天（*「判定此潛在客戶資格」*）或點擊內聯按鈕來呼叫。 +## 銷售技能清單 ### 1. 🔄 即時資料——基礎 -在判定潛在客戶資格、撰寫郵件或預測數字之前，銷售 Copilot 會將自身建立在 **即時資料** 之上。每一輪，它都針對即時元資料 + 記錄儲存呼叫 `describe_object` 和 `query_records`——而非快取的快照。這就是為什麼在 10:00:00 新增一個欄位，Copilot 能在 10:00:05 回答關於它的問題，且零重新訓練。 +在判定潛在客戶資格、撰寫郵件或預測數字之前，助手會將自身建立在 **即時資料** 之上。每 +一輪，它都針對即時中繼資料 + 記錄儲存呼叫 `describe_object` 和 `query_records`——而非快 +取的快照。這就是為什麼在 10:00:00 新增一個欄位，助手能在 10:00:05 回答關於它的問題， +且零重新訓練。 -參見 [即時結構（Wow #1）](/zh-Hant/docs/ai-copilot/live-schema) 中的 30 秒示範。下面的一切都構建在此技能之上。 +參見 [即時模式（Wow #1）](/zh-Hant/docs/ai-copilot/live-schema) 中的 30 秒示範。下面的 +一切都構建在此技能之上。 ### 2. 🎯 潛在客戶資格判定 -讓 Copilot 判定一個潛在客戶的資格，它會按 BANT 框架為其評分： +讓助手判定一筆潛在客戶的資格，它會按 BANT 框架給出 0–100 的評分： - **Budget（預算）**——是否有購買你所售產品的預算？ - **Authority（權限）**——此人是決策者嗎？ - **Need（需求）**——是否有清晰、明確表達的需求？ - **Timeline（時間線）**——是否有緊迫性？ -Copilot 從潛在客戶記錄、任何活動參與歷史、相關客戶（如已匹配）和近期郵件中提取信號。它返回： +它讀取潛在客戶記錄及其相關活動歷史，然後回傳： -- 一個 **評分**（熱門 🔥 / 溫熱 🌡️ / 冷淡 ❄️）。 -- 一份引用信號的 **理由**。 -- 一個 **建議的下一步操作**（「安排探詢通話」、「培育」、「取消資格」）。 +- 一個 **評分**（0–100），每個 BANT 維度附一行理由。 +- 每項判斷所依據的 **欄位或活動**。 +- 單一的 **建議下一步**，並引用潛在客戶 ID。 -點擊 **接受** 即可自動更新潛在客戶的狀態和評級。 +若評分達到 70 及以上且你同意，技能會呼叫真實的 **轉換潛在客戶** 操作；否則它會呼叫 +**安排跟進** 並給出建議的日期。未經你明確確認，絕不執行轉換。 ### 3. ✍️ 郵件撰寫 -高亮任意記錄（潛在客戶、聯絡人、商機），讓 Copilot 撰寫一封郵件。它會使用以下內容生成一份感知上下文的草稿： +在任意記錄（潛在客戶、聯絡人、商機）上請求郵件草稿。它會使用以下內容產生一份感知情境 +的草稿： - 聯絡人的姓名、角色和所屬客戶。 - 商機階段和金額（如相關）。 @@ -50,7 +74,7 @@ Copilot 從潛在客戶記錄、任何活動參與歷史、相關客戶（如已 - 來自產品資訊知識庫的相關產品資料表。 - 來自銷售知識知識庫的銷售劇本。 -Copilot 能很好地處理的常見郵件範本： +它能很好處理的常見郵件形態： - **介紹**——潛在客戶捕獲後的首次觸達。 - **探詢跟進**——探詢通話之後。 @@ -59,11 +83,11 @@ Copilot 能很好地處理的常見郵件範本： - **續約提醒**——在到期前發給合約持有人。 - **贏單慶祝**——在贏單成交後發給客戶。 -你始終在發送前 **預覽和編輯**。Copilot 從不擅自發送。 +你始終在發送前 **預覽和編輯**。技能從不擅自發送。 ### 4. 📈 收入預測 -問 *「我這個季度的預測是多少？」*，Copilot 會返回： +問 *「我這一季的預測是多少？」*，你會得到： - **Closed（已成交）**——已承諾收入（本期贏單成交）。 - **Commit（承諾）**——本期內機率 >80% 的商機。 @@ -71,16 +95,16 @@ Copilot 能很好地處理的常見郵件範本： - **Pipeline（管道）**——其餘一切。 - **風險提示**——滑落的交易、陳舊的商機、缺失的成交日期。 -預測遵循角色層級——銷售代表看到自己的數字，經理看到團隊的，總監看到彙總。 +預測遵循你的職位與共享規則——銷售代表看到自己的數字，經理看到團隊的，總監看到彙總。 ### 5. 🔭 Customer 360° -在任意客戶或聯絡人上，問 *「給我一個 360° 視圖」*，Copilot 會總結： +在任意客戶或聯絡人上，問 *「給我一個 360° 視圖」*，你會得到： - **關係快照**——客戶層級、成為客戶的日期、客戶負責人。 - **進行中的交易**——帶階段和金額的開放商機。 - **近期活動**——最近一次通話、會議、郵件。 -- **未結工單**——任何服務工單，及其優先級和存續時長。 +- **未結工單**——任何服務工單，及其優先順序和存續時長。 - **合約**——有效及即將到來的續約。 - **行銷參與**——客戶近期參與的活動。 @@ -88,20 +112,21 @@ Copilot 能很好地處理的常見郵件範本： ## 給銷售代表的提示 -- ✅ 新潛在客戶一落地就使用 *判定此潛在客戶資格*——每個潛在客戶節省 15 分鐘。 -- ✅ 撰寫郵件時，用一句話給 Copilot 一個 **目標**：*「推動下週開個會」*——比泛泛的 *「撰寫一封跟進郵件」* 更好。 +- ✅ 新潛在客戶一落地就請求資格判定——每筆節省 15 分鐘。 +- ✅ 撰寫郵件時，用一句話說明 **目標**：*「推動下週開個會」*——比泛泛的 *「撰寫一封跟進郵件」* 更好。 - ✅ 每週一早上問 *「我的管道裡有什麼風險？」*。 ## 給經理的提示 - ✅ 在團隊的每次面向客戶的會議前使用 *Customer 360*。 - ✅ 在週中執行 *收入預測*，在季末衝刺前發現滑落的交易。 -- ✅ 問 *「哪些銷售代表需要輔導？」*——Copilot 會標記管道陳舊或階段停留異常長的銷售代表。 +- ✅ 問 *「哪些銷售代表需要輔導？」*——收入預測技能會標記管道陳舊或階段停留異常長的銷售代表。 ## 限制 -- Copilot **遵循共享**——它只能引用你能看到的記錄。 -- 它 **不會自動發送** 郵件、**不會自動更新** 記錄，也 **不會批量更改** 資料，除非有明確確認。 -- 對於敏感客戶，Copilot 會 **遮蔽** 標記的欄位（可由管理員配置）。 +- 技能 **遵循共享**——它們只能引用你能看到的記錄。 +- 它們 **不會自動發送** 郵件、**不會自動更新** 記錄，也 **不會批次更改** 資料，除非有明確確認。 +- 技能不宣告任何專屬工具：每一次寫入都經由真實的 HotCRM 操作完成，因此與你親手點擊按鈕時的權限校驗完全一致。 -參見 [技能](/zh-Hant/docs/ai-copilot/skills) 了解完整的技能規格，參見 [知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases) 了解如何保持 Copilot 答案的新鮮和準確。 +參見 [技能](/zh-Hant/docs/ai-copilot/skills) 了解完整的技能規格，參見 +[知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases) 了解如何保持答案的新鮮和準確。 diff --git a/content/docs/ai-copilot/service-copilot.mdx b/content/docs/ai-copilot/service-copilot.mdx index 6bfeee05..77c367e6 100644 --- a/content/docs/ai-copilot/service-copilot.mdx +++ b/content/docs/ai-copilot/service-copilot.mdx @@ -1,11 +1,20 @@ --- -title: Service Copilot -description: The AI service-agent assistant — triage cases, see full customer history, draft replies. +title: Service Skills +description: The service-side AI skills — triage cases, see full customer history, draft replies. --- -# Service Copilot +# Service Skills -The Service Copilot is your AI partner for resolving customer issues fast. It lives in the right-side chat panel and as inline actions on case detail pages. +HotCRM does not ship an assistant of its own. It ships **skills** — packaged AI +abilities that attach to the **platform assistant** (`ask`) that every ObjectStack +environment already provides. When a service agent opens the assistant panel on a +case, the skills below are what it knows how to do. + +> **Where the personas went.** Earlier versions of this page described a "Service +> Copilot" agent. HotCRM no longer defines its own agents: the same capability now +> lives in skills registered through `src/skills/`, and the platform assistant selects +> among them. Nothing was lost — the wiring moved from an app-owned agent to the +> platform one. ## Who it's for @@ -13,11 +22,17 @@ The Service Copilot is your AI partner for resolving customer issues fast. It li - **Support managers** — case routing and SLA compliance. - **Knowledge managers** — flagging gaps in the support knowledge base. -## What it can do +## How a skill gets picked + +Case Triage declares `crm_case` as its record context, so it activates the moment an +agent asks a question while viewing a case. Customer 360°, Email Drafting, and Live +Data carry no context restriction and are available everywhere. + +## The service skills ### 1. 🚦 Case Triage -When a new case lands, the Copilot can triage it in one click. It analyses: +Ask the assistant to triage a case and it analyses: - The **subject** and **description**. - The **customer's profile** (account tier, customer-since, contract). @@ -29,15 +44,17 @@ It returns: - **Suggested priority** (Low / Medium / High / Critical) with a rationale tied to the [SLA matrix](/docs/service/sla-and-escalation). - **Suggested category** (Bug, Question, Feature Request, Billing). -- **Suggested team / queue** based on the product or topic. -- **Top 3 matching KB articles** with confidence scores. +- **Top matching KB articles**. - A **draft first reply** that acknowledges the issue and links to the KB articles. +- A pointer to the right next action — **Escalate Case** or **Close Case**. -Agents can accept, edit, or reject each suggestion individually. +Agents accept, edit, or reject each suggestion individually. The skill never changes +the case on its own: it hands off to the same `escalate_case` / `close_case` actions +an agent would click. ### 2. 🔭 Customer 360° -On any case, ask *"Give me the customer's history"* and the Copilot surfaces: +On any case, ask *"Give me the customer's history"* and you get: - **All prior cases** (open and closed) for the same contact and account. - **Contract status** — what they've bought, when it expires, what tier of support they're entitled to. @@ -45,11 +62,13 @@ On any case, ask *"Give me the customer's history"* and the Copilot surfaces: - **Last touchpoints** — recent emails, calls, meetings. - **Account health signals** — escalations, churn risk flags, satisfaction scores. -This is the difference between *"I see this is your first case"* and *"I see this is the 3rd time you've hit this issue this quarter — let me escalate."* +This is the difference between *"I see this is your first case"* and *"I see this is +the 3rd time you've hit this issue this quarter — let me escalate."* ### 3. ✍️ Email / Reply Drafting -The Copilot drafts customer replies tuned for service tone: +The same Email Drafting skill the sales side uses will draft customer replies tuned +for service tone: - **Acknowledgment** — *"We've received your case and are investigating."* - **Asking for more info** — bug reproduction steps, screenshots, logs. @@ -57,47 +76,37 @@ The Copilot drafts customer replies tuned for service tone: - **Resolution** — explaining what was done. - **Closure** — confirming everything's resolved. -All drafts cite the Support Knowledge articles they pulled from, so agents can verify the source. The Copilot never sends — agents preview and edit first. - -## Inline actions on case pages - -| Button | What it does | -| --- | --- | -| **🚦 Triage** | Runs the triage skill and pre-fills priority, category, queue. | -| **📚 Find articles** | Searches Support Knowledge for matching KB articles. | -| **✍️ Draft reply** | Drafts a customer-facing reply based on case state. | -| **🔭 Customer 360** | Opens the customer history side-panel. | -| **🔁 Suggest similar** | Finds similar resolved cases. | - -## What the Copilot does for you in the background +All drafts cite the Support Knowledge articles they pulled from, so agents can verify +the source. Nothing is sent automatically — agents preview and edit first. -Even without you asking, the Service Copilot is busy: +### 4. 🔄 Live Data -- **Auto-suggests articles** as the agent types into the case description. -- **Flags repeat issues** — "this contact has filed 4 similar cases". -- **Warns on SLA risk** — "this case will breach SLA in 47 minutes". -- **Highlights sentiment** — angry-customer detection in the email thread. +Every service skill composes on Live Data: the assistant re-reads the case object's +schema before answering, so a field an admin added this morning is usable this +afternoon. See [Live Schema (Wow #1)](/docs/ai-copilot/live-schema). ## Tips for agents -- ✅ **Triage every new case** — it's a 5-second click and saves you sorting/routing time. +- ✅ **Triage every new case** — it's one question and saves you sorting/routing time. - ✅ Use **Customer 360** before any phone call — knowing the contract tier shapes the conversation. -- ✅ **Trust but verify** the KB suggestions — if the Copilot's confidence is below 70%, double-check. +- ✅ **Trust but verify** the KB suggestions — check the cited article before you send. ## Tips for managers -- ✅ Track **Copilot acceptance rate** — if your agents reject most triage suggestions, your KB needs work. -- ✅ Use **Suggest similar** during deflection meetings — patterns of repeated cases reveal product issues. +- ✅ Track how often triage suggestions are accepted — if your agents reject most of them, your KB needs work. +- ✅ Look for patterns of repeated cases during deflection meetings — they reveal product issues. ## Tips for knowledge managers -- ✅ When the Copilot can't find a matching article for a case, it logs the **gap** — review these weekly to identify new articles to write. -- ✅ Articles that the Copilot cites frequently are your **highest-value content** — keep them updated. +- ✅ When the assistant can't find a matching article for a case, that's a knowledge gap — review these to identify new articles to write. +- ✅ Articles cited frequently are your **highest-value content** — keep them updated. ## Limits -- The Copilot respects [sharing rules](/docs/administration/sharing-and-security) — it only sees what the agent can see. -- It **won't close cases** or **mark them resolved** without explicit agent action. -- For VIP/escalated customers, the Copilot **routes to humans first** rather than auto-suggesting deflection. +- Skills respect [sharing rules](/docs/administration/sharing-and-security) — they only see what the agent can see. +- They **won't close cases** or **mark them resolved** without explicit agent action. +- Skills declare no bespoke tools: every state change goes through a real HotCRM action, so the same permission checks apply as when an agent clicks the button. -See [Skills](/docs/ai-copilot/skills) for the full skill spec and [Knowledge Bases](/docs/ai-copilot/knowledge-bases) for the Support Knowledge index that powers replies. +See [Skills](/docs/ai-copilot/skills) for the full skill spec and +[Knowledge Bases](/docs/ai-copilot/knowledge-bases) for the Support Knowledge index +that powers replies. diff --git a/content/docs/ai-copilot/service-copilot.zh-Hans.mdx b/content/docs/ai-copilot/service-copilot.zh-Hans.mdx index 342dad8c..cad77c7e 100644 --- a/content/docs/ai-copilot/service-copilot.zh-Hans.mdx +++ b/content/docs/ai-copilot/service-copilot.zh-Hans.mdx @@ -1,11 +1,17 @@ --- -title: 服务 Copilot -description: AI 服务坐席助手——分流工单、查看完整客户历史、撰写回复。 +title: 服务技能 +description: 服务侧的 AI 技能——分流工单、查看完整客户历史、撰写回复。 --- -# 服务 Copilot +# 服务技能 -服务 Copilot 是你快速解决客户问题的 AI 伙伴。它存在于右侧聊天面板，并以内联操作形式出现在工单详情页上。 +HotCRM 本身不提供助手。它提供的是 **技能**——打包好的 AI 能力，附着在每个 +ObjectStack 环境已经自带的 **平台助手**（`ask`）之上。当服务坐席在工单上打开助手面板 +时，下面这些技能就是它会做的事。 + +> **人格设定去哪了。** 本页的早期版本描述过一个"服务 Copilot"智能体。HotCRM 不再定义 +> 自己的智能体：同样的能力现在存在于通过 `src/skills/` 注册的技能中，由平台助手在其中 +> 做选择。没有任何能力丢失——只是接线方式从应用自有的智能体挪到了平台的那一个。 ## 它面向谁 @@ -13,11 +19,16 @@ description: AI 服务坐席助手——分流工单、查看完整客户历史 - **支持经理**——工单路由和 SLA 合规。 - **知识管理员**——标记支持知识库中的空缺。 -## 它能做什么 +## 技能是怎样被选中的 + +工单分流声明了 `crm_case` 作为记录上下文，因此坐席在查看工单时提问，它就会激活。 +Customer 360°、邮件撰写和实时数据没有上下文限制，处处可用。 + +## 服务技能清单 ### 1. 🚦 工单分流 -当一个新工单落地时，Copilot 可一键将其分流。它会分析： +请助手分流一个工单，它会分析： - **主题** 和 **描述**。 - **客户的画像**（客户层级、成为客户的日期、合同）。 @@ -29,15 +40,16 @@ description: AI 服务坐席助手——分流工单、查看完整客户历史 - **建议的优先级**（低 / 中 / 高 / 紧急），并附带与 [SLA 矩阵](/zh-Hans/docs/service/sla-and-escalation) 关联的理由。 - **建议的分类**（缺陷、问题咨询、功能请求、账单）。 -- 基于产品或主题的 **建议团队 / 队列**。 -- 带置信度评分的 **最匹配的前 3 篇知识库文章**。 +- **最匹配的知识库文章**。 - 一份 **首次回复草稿**，确认问题并链接到知识库文章。 +- 指向正确下一步操作的指引——**升级工单** 或 **关闭工单**。 -坐席可以逐条接受、编辑或拒绝每条建议。 +坐席可以逐条接受、编辑或拒绝每条建议。技能自身绝不修改工单：它把动作交给坐席本来就会 +点击的 `escalate_case` / `close_case` 操作。 ### 2. 🔭 Customer 360° -在任意工单上，问 *"给我客户的历史"*，Copilot 会呈现： +在任意工单上，问 *"给我客户的历史"*，你会得到： - **所有过往工单**（未结和已结）——针对同一联系人和客户。 - **合同状态**——他们购买了什么、何时到期、有权享受何种层级的支持。 @@ -45,11 +57,12 @@ description: AI 服务坐席助手——分流工单、查看完整客户历史 - **最近的接触点**——近期邮件、通话、会议。 - **客户健康信号**——升级、流失风险标记、满意度评分。 -这就是 *"我看到这是您第一个工单"* 与 *"我看到这是您本季度第 3 次遇到这个问题——让我来升级处理"* 之间的差别。 +这就是 *"我看到这是您第一个工单"* 与 *"我看到这是您本季度第 3 次遇到这个问题——让我 +来升级处理"* 之间的差别。 ### 3. ✍️ 邮件 / 回复撰写 -Copilot 撰写针对服务语气调优的客户回复： +销售侧使用的同一项邮件撰写技能，也会撰写针对服务语气调优的客户回复： - **确认收悉**——*"我们已收到您的工单，正在调查。"* - **索取更多信息**——缺陷重现步骤、截图、日志。 @@ -57,47 +70,36 @@ Copilot 撰写针对服务语气调优的客户回复： - **解决**——说明已完成的处理。 - **关闭**——确认一切已解决。 -所有草稿都会引用其所提取的支持知识文章，以便坐席核实来源。Copilot 从不发送——坐席先预览和编辑。 - -## 工单页面上的内联操作 - -| 按钮 | 它的作用 | -| --- | --- | -| **🚦 分流** | 运行分流技能并预填优先级、分类、队列。 | -| **📚 查找文章** | 在支持知识中搜索匹配的知识库文章。 | -| **✍️ 撰写回复** | 基于工单状态撰写面向客户的回复。 | -| **🔭 Customer 360** | 打开客户历史侧边面板。 | -| **🔁 推荐相似** | 查找相似的已解决工单。 | - -## Copilot 在后台为你做什么 +所有草稿都会引用其所提取的支持知识文章，以便坐席核实来源。不会自动发送任何内容——坐席 +先预览和编辑。 -即使你没有提出请求，服务 Copilot 也在忙碌： +### 4. 🔄 实时数据 -- **自动推荐文章**——当坐席输入工单描述时。 -- **标记重复问题**——"此联系人已提交 4 个相似工单"。 -- **SLA 风险预警**——"此工单将在 47 分钟内违反 SLA"。 -- **高亮情绪**——邮件线程中的愤怒客户检测。 +每项服务技能都构建在实时数据之上：助手在回答之前会重新读取工单对象的模式，因此管理员 +今早新增的字段今天下午就能用上。参见 +[实时模式（Wow #1）](/zh-Hans/docs/ai-copilot/live-schema)。 ## 给坐席的提示 -- ✅ **为每个新工单分流**——只需 5 秒的点击，节省你的排序/路由时间。 +- ✅ **为每个新工单分流**——只需问一句，节省你的排序/路由时间。 - ✅ 在任何电话通话前使用 **Customer 360**——了解合同层级会影响对话方式。 -- ✅ **信任但要核实** 知识库建议——如果 Copilot 的置信度低于 70%，请再次确认。 +- ✅ **信任但要核实** 知识库建议——发送前先查看被引用的文章。 ## 给经理的提示 -- ✅ 跟踪 **Copilot 接受率**——如果你的坐席拒绝了大多数分流建议，说明你的知识库需要完善。 -- ✅ 在化解会议中使用 **推荐相似**——重复工单的模式揭示了产品问题。 +- ✅ 跟踪分流建议的接受率——如果你的坐席拒绝了大多数建议，说明你的知识库需要完善。 +- ✅ 在化解会议中留意重复工单的模式——它们揭示了产品问题。 ## 给知识管理员的提示 -- ✅ 当 Copilot 找不到与工单匹配的文章时，它会记录这个 **空缺**——每周审查这些记录，以确定要撰写的新文章。 -- ✅ Copilot 频繁引用的文章是你 **价值最高的内容**——保持它们更新。 +- ✅ 当助手找不到与工单匹配的文章时，那就是一处知识空缺——审查这些情况，以确定要撰写的新文章。 +- ✅ 被频繁引用的文章是你 **价值最高的内容**——保持它们更新。 ## 限制 -- Copilot 遵循 [共享规则](/zh-Hans/docs/administration/sharing-and-security)——它只能看到坐席能看到的内容。 -- 它 **不会关闭工单**，也 **不会将其标记为已解决**，除非坐席明确操作。 -- 对于 VIP/已升级的客户，Copilot 会 **优先路由给人工**，而非自动推荐化解。 +- 技能遵循 [共享规则](/zh-Hans/docs/administration/sharing-and-security)——它们只能看到坐席能看到的内容。 +- 它们 **不会关闭工单**，也 **不会将其标记为已解决**，除非坐席明确操作。 +- 技能不声明任何专属工具：每一次状态变更都经由真实的 HotCRM 操作完成，因此与坐席亲手点击按钮时的权限校验完全一致。 -参见 [技能](/zh-Hans/docs/ai-copilot/skills) 了解完整的技能规格，参见 [知识库](/zh-Hans/docs/ai-copilot/knowledge-bases) 了解为回复提供动力的支持知识索引。 +参见 [技能](/zh-Hans/docs/ai-copilot/skills) 了解完整的技能规格，参见 +[知识库](/zh-Hans/docs/ai-copilot/knowledge-bases) 了解为回复提供动力的支持知识索引。 diff --git a/content/docs/ai-copilot/service-copilot.zh-Hant.mdx b/content/docs/ai-copilot/service-copilot.zh-Hant.mdx index 2105f60b..958d0d5d 100644 --- a/content/docs/ai-copilot/service-copilot.zh-Hant.mdx +++ b/content/docs/ai-copilot/service-copilot.zh-Hant.mdx @@ -1,11 +1,17 @@ --- -title: 服務 Copilot -description: AI 服務坐席助手——分流工單、查看完整客戶歷史、撰寫回覆。 +title: 服務技能 +description: 服務側的 AI 技能——分流工單、查看完整客戶歷史、撰寫回覆。 --- -# 服務 Copilot +# 服務技能 -服務 Copilot 是你快速解決客戶問題的 AI 夥伴。它存在於右側聊天面板，並以內聯操作形式出現在工單詳情頁上。 +HotCRM 本身不提供助手。它提供的是 **技能**——打包好的 AI 能力，附著在每個 +ObjectStack 環境已經自帶的 **平台助手**（`ask`）之上。當服務坐席在工單上打開助手面板 +時，下面這些技能就是它會做的事。 + +> **人格設定去哪了。** 本頁的早期版本描述過一個「服務 Copilot」智能體。HotCRM 不再定 +> 義自己的智能體：同樣的能力現在存在於透過 `src/skills/` 註冊的技能中，由平台助手在其 +> 中做選擇。沒有任何能力遺失——只是接線方式從應用自有的智能體挪到了平台的那一個。 ## 它面向誰 @@ -13,11 +19,16 @@ description: AI 服務坐席助手——分流工單、查看完整客戶歷史 - **支援經理**——工單路由和 SLA 合規。 - **知識管理員**——標記支援知識庫中的空缺。 -## 它能做什麼 +## 技能是怎樣被選中的 + +工單分流宣告了 `crm_case` 作為記錄情境，因此坐席在檢視工單時提問，它就會啟用。 +Customer 360°、郵件撰寫和即時資料沒有情境限制，處處可用。 + +## 服務技能清單 ### 1. 🚦 工單分流 -當一個新工單落地時，Copilot 可一鍵將其分流。它會分析： +請助手分流一個工單，它會分析： - **主題** 和 **描述**。 - **客戶的畫像**（客戶層級、成為客戶的日期、合約）。 @@ -25,31 +36,33 @@ description: AI 服務坐席助手——分流工單、查看完整客戶歷史 - 工單中引用的 **產品**。 - **支援知識** 知識庫中的匹配文章。 -它返回： +它回傳： -- **建議的優先級**（低 / 中 / 高 / 緊急），並附帶與 [SLA 矩陣](/zh-Hant/docs/service/sla-and-escalation) 關聯的理由。 +- **建議的優先順序**（低 / 中 / 高 / 緊急），並附帶與 [SLA 矩陣](/zh-Hant/docs/service/sla-and-escalation) 關聯的理由。 - **建議的分類**（缺陷、問題諮詢、功能請求、帳單）。 -- 基於產品或主題的 **建議團隊 / 佇列**。 -- 帶置信度評分的 **最匹配的前 3 篇知識庫文章**。 +- **最匹配的知識庫文章**。 - 一份 **首次回覆草稿**，確認問題並連結到知識庫文章。 +- 指向正確下一步操作的指引——**升級工單** 或 **關閉工單**。 -坐席可以逐條接受、編輯或拒絕每條建議。 +坐席可以逐條接受、編輯或拒絕每條建議。技能自身絕不修改工單：它把動作交給坐席本來就會 +點擊的 `escalate_case` / `close_case` 操作。 ### 2. 🔭 Customer 360° -在任意工單上，問 *「給我客戶的歷史」*，Copilot 會呈現： +在任意工單上，問 *「給我客戶的歷史」*，你會得到： - **所有過往工單**（未結和已結）——針對同一聯絡人和客戶。 - **合約狀態**——他們購買了什麼、何時到期、有權享受何種層級的支援。 - **進行中的商機**——以便坐席知道是否正在與一位正處於採購中的客戶交談。 - **最近的接觸點**——近期郵件、通話、會議。 -- **客戶健康信號**——升級、流失風險標記、滿意度評分。 +- **客戶健康訊號**——升級、流失風險標記、滿意度評分。 -這就是 *「我看到這是您第一個工單」* 與 *「我看到這是您本季度第 3 次遇到這個問題——讓我來升級處理」* 之間的差別。 +這就是 *「我看到這是您第一個工單」* 與 *「我看到這是您本季第 3 次遇到這個問題——讓我 +來升級處理」* 之間的差別。 ### 3. ✍️ 郵件 / 回覆撰寫 -Copilot 撰寫針對服務語氣調優的客戶回覆： +銷售側使用的同一項郵件撰寫技能，也會撰寫針對服務語氣調優的客戶回覆： - **確認收悉**——*「我們已收到您的工單，正在調查。」* - **索取更多資訊**——缺陷重現步驟、截圖、日誌。 @@ -57,47 +70,36 @@ Copilot 撰寫針對服務語氣調優的客戶回覆： - **解決**——說明已完成的處理。 - **關閉**——確認一切已解決。 -所有草稿都會引用其所提取的支援知識文章，以便坐席核實來源。Copilot 從不發送——坐席先預覽和編輯。 - -## 工單頁面上的內聯操作 - -| 按鈕 | 它的作用 | -| --- | --- | -| **🚦 分流** | 執行分流技能並預填優先級、分類、佇列。 | -| **📚 查找文章** | 在支援知識中搜尋匹配的知識庫文章。 | -| **✍️ 撰寫回覆** | 基於工單狀態撰寫面向客戶的回覆。 | -| **🔭 Customer 360** | 開啟客戶歷史側邊面板。 | -| **🔁 推薦相似** | 查找相似的已解決工單。 | - -## Copilot 在後台為你做什麼 +所有草稿都會引用其所提取的支援知識文章，以便坐席核實來源。不會自動發送任何內容——坐席 +先預覽和編輯。 -即使你沒有提出請求，服務 Copilot 也在忙碌： +### 4. 🔄 即時資料 -- **自動推薦文章**——當坐席輸入工單描述時。 -- **標記重複問題**——「此聯絡人已提交 4 個相似工單」。 -- **SLA 風險預警**——「此工單將在 47 分鐘內違反 SLA」。 -- **高亮情緒**——郵件線程中的憤怒客戶偵測。 +每項服務技能都構建在即時資料之上：助手在回答之前會重新讀取工單物件的模式，因此管理員 +今早新增的欄位今天下午就能用上。參見 +[即時模式（Wow #1）](/zh-Hant/docs/ai-copilot/live-schema)。 ## 給坐席的提示 -- ✅ **為每個新工單分流**——只需 5 秒的點擊，節省你的排序/路由時間。 +- ✅ **為每個新工單分流**——只需問一句，節省你的排序/路由時間。 - ✅ 在任何電話通話前使用 **Customer 360**——了解合約層級會影響對話方式。 -- ✅ **信任但要核實** 知識庫建議——如果 Copilot 的置信度低於 70%，請再次確認。 +- ✅ **信任但要核實** 知識庫建議——發送前先查看被引用的文章。 ## 給經理的提示 -- ✅ 追蹤 **Copilot 接受率**——如果你的坐席拒絕了大多數分流建議，說明你的知識庫需要完善。 -- ✅ 在化解會議中使用 **推薦相似**——重複工單的模式揭示了產品問題。 +- ✅ 追蹤分流建議的接受率——如果你的坐席拒絕了大多數建議，說明你的知識庫需要完善。 +- ✅ 在化解會議中留意重複工單的模式——它們揭示了產品問題。 ## 給知識管理員的提示 -- ✅ 當 Copilot 找不到與工單匹配的文章時，它會記錄這個 **空缺**——每週審查這些記錄，以確定要撰寫的新文章。 -- ✅ Copilot 頻繁引用的文章是你 **價值最高的內容**——保持它們更新。 +- ✅ 當助手找不到與工單匹配的文章時，那就是一處知識空缺——審查這些情況，以確定要撰寫的新文章。 +- ✅ 被頻繁引用的文章是你 **價值最高的內容**——保持它們更新。 ## 限制 -- Copilot 遵循 [共享規則](/zh-Hant/docs/administration/sharing-and-security)——它只能看到坐席能看到的內容。 -- 它 **不會關閉工單**，也 **不會將其標記為已解決**，除非坐席明確操作。 -- 對於 VIP/已升級的客戶，Copilot 會 **優先路由給人工**，而非自動推薦化解。 +- 技能遵循 [共享規則](/zh-Hant/docs/administration/sharing-and-security)——它們只能看到坐席能看到的內容。 +- 它們 **不會關閉工單**，也 **不會將其標記為已解決**，除非坐席明確操作。 +- 技能不宣告任何專屬工具：每一次狀態變更都經由真實的 HotCRM 操作完成，因此與坐席親手點擊按鈕時的權限校驗完全一致。 -參見 [技能](/zh-Hant/docs/ai-copilot/skills) 了解完整的技能規格，參見 [知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases) 了解為回覆提供動力的支援知識索引。 +參見 [技能](/zh-Hant/docs/ai-copilot/skills) 了解完整的技能規格，參見 +[知識庫](/zh-Hant/docs/ai-copilot/knowledge-bases) 了解為回覆提供動力的支援知識索引。 diff --git a/content/docs/ai-copilot/skills.mdx b/content/docs/ai-copilot/skills.mdx index 05f540e3..65f68c24 100644 --- a/content/docs/ai-copilot/skills.mdx +++ b/content/docs/ai-copilot/skills.mdx @@ -1,15 +1,15 @@ --- title: Skills -description: The full library of AI Copilot skills — what each one does, where it appears, and what data it uses. +description: The full library of HotCRM AI skills — what each one does, where it appears, and what data it uses. --- # Skills -A **skill** is a bite-sized AI ability the Copilot can perform — like *"qualify this lead"* or *"draft a customer reply"*. Skills are the building blocks of both the [Sales Copilot](/docs/ai-copilot/sales-copilot) and the [Service Copilot](/docs/ai-copilot/service-copilot). +A **skill** is a bite-sized AI ability the platform assistant can perform — like *"qualify this lead"* or *"draft a customer reply"*. Skills are all HotCRM contributes to the assistant; they are documented in two groups, [Sales Skills](/docs/ai-copilot/sales-copilot) and [Service Skills](/docs/ai-copilot/service-copilot). ## Why skills, not "one big AI" -Breaking the Copilot into skills makes it: +Packaging the capability as skills rather than one prompt makes it: - **Predictable** — each skill has a defined input, output, and behavior. - **Auditable** — admins can see what each skill reads from and writes to. @@ -39,7 +39,7 @@ HotCRM ships with six core skills: | **Writes** | Nothing — read-only | | **Knowledge base** | None — purely metadata + records | -This is the skill behind **[Wow #1 — Live Schema](/docs/ai-copilot/live-schema)**: add a field in the admin console, and the Copilot uses it on the very next turn. Every other Sales / Service skill composes on top of Live Data, so the same live-schema property applies transitively — Lead Qualification can score a lead on a custom field added 10 seconds ago. +This is the skill behind **[Wow #1 — Live Schema](/docs/ai-copilot/live-schema)**: add a field in the admin console, and the assistant uses it on the very next turn. Every other Sales / Service skill composes on top of Live Data, so the same live-schema property applies transitively — Lead Qualification can score a lead on a custom field added 10 seconds ago. ### 🎯 Lead Qualification @@ -95,10 +95,10 @@ This is the skill behind **[Wow #1 — Live Schema](/docs/ai-copilot/live-schema Skills can call other skills. For example: -- The Service Copilot's *Case Triage* skill can invoke *Customer 360* to check if the customer is high-value before assigning priority. -- The Sales Copilot's *Email Drafting* skill can invoke *Customer 360* to ground the email in real account context. +- The *Case Triage* skill can invoke *Customer 360* to check if the customer is high-value before assigning priority. +- The *Email Drafting* skill can invoke *Customer 360* to ground the email in real account context. -This composition is automatic — you ask one question, the Copilot wires up whatever skills it needs. +This composition is automatic — you ask one question, the assistant wires up whatever skills it needs. ## What every skill respects diff --git a/content/docs/ai-copilot/skills.zh-Hans.mdx b/content/docs/ai-copilot/skills.zh-Hans.mdx index 2a54e290..e1ffea9d 100644 --- a/content/docs/ai-copilot/skills.zh-Hans.mdx +++ b/content/docs/ai-copilot/skills.zh-Hans.mdx @@ -1,15 +1,15 @@ --- title: 技能 -description: AI Copilot 技能的完整库——每项技能做什么、出现在哪里，以及使用哪些数据。 +description: HotCRM AI 技能的完整库——每项技能做什么、出现在哪里，以及使用哪些数据。 --- # 技能 -**技能**是 Copilot 可以执行的细分到点的 AI 能力——比如 *"判定此线索资格"* 或 *"撰写客户回复"*。技能是 [销售 Copilot](/zh-Hans/docs/ai-copilot/sales-copilot) 和 [服务 Copilot](/zh-Hans/docs/ai-copilot/service-copilot) 两者的构建模块。 +**技能**是平台助手可以执行的细分到点的 AI 能力——比如 *"判定此线索资格"* 或 *"撰写客户回复"*。技能是 HotCRM 对助手的全部贡献；它们按两组编写文档：[销售技能](/zh-Hans/docs/ai-copilot/sales-copilot) 和 [服务技能](/zh-Hans/docs/ai-copilot/service-copilot)。 ## 为什么用技能，而非"一个大 AI" -将 Copilot 拆分为技能使它： +把能力打包为技能（而不是一段大提示词）使它： - **可预测**——每项技能都有明确定义的输入、输出和行为。 - **可审计**——管理员可以看到每项技能从哪里读取、向哪里写入。 @@ -39,7 +39,7 @@ HotCRM 内置六项核心技能： | **写入** | 无——只读 | | **知识库** | 无——纯粹是元数据 + 记录 | -这是 **[Wow #1 — 实时模式](/zh-Hans/docs/ai-copilot/live-schema)** 背后的技能：在管理控制台中添加一个字段，Copilot 在下一轮就会使用它。其他每项销售 / 服务技能都构建在实时数据之上，因此同样的实时模式特性会传递地适用——线索资格判定可以根据 10 秒前添加的自定义字段为线索评分。 +这是 **[Wow #1 — 实时模式](/zh-Hans/docs/ai-copilot/live-schema)** 背后的技能：在管理控制台中添加一个字段，助手在下一轮就会使用它。其他每项销售 / 服务技能都构建在实时数据之上，因此同样的实时模式特性会传递地适用——线索资格判定可以根据 10 秒前添加的自定义字段为线索评分。 ### 🎯 线索资格判定 @@ -95,10 +95,10 @@ HotCRM 内置六项核心技能： 技能可以调用其他技能。例如： -- 服务 Copilot 的 *工单分流* 技能可以调用 *Customer 360* 来检查客户在分配优先级前是否为高价值客户。 -- 销售 Copilot 的 *邮件撰写* 技能可以调用 *Customer 360* 将邮件建立在真实的客户上下文之上。 +- *工单分流* 技能可以调用 *Customer 360* 来检查客户在分配优先级前是否为高价值客户。 +- *邮件撰写* 技能可以调用 *Customer 360* 将邮件建立在真实的客户上下文之上。 -这种组合是自动的——你问一个问题，Copilot 会接好它所需的任何技能。 +这种组合是自动的——你问一个问题，助手会接好它所需的任何技能。 ## 每项技能都遵循什么 diff --git a/content/docs/ai-copilot/skills.zh-Hant.mdx b/content/docs/ai-copilot/skills.zh-Hant.mdx index 5f1462ac..b32ae52b 100644 --- a/content/docs/ai-copilot/skills.zh-Hant.mdx +++ b/content/docs/ai-copilot/skills.zh-Hant.mdx @@ -1,15 +1,15 @@ --- title: 技能 -description: AI Copilot 技能的完整庫——每項技能做什麼、出現在哪裡，以及使用哪些資料。 +description: HotCRM AI 技能的完整庫——每項技能做什麼、出現在哪裡，以及使用哪些資料。 --- # 技能 -**技能**是 Copilot 可以執行的細分到點的 AI 能力——比如 *「判定此潛在客戶資格」* 或 *「撰寫客戶回覆」*。技能是 [銷售 Copilot](/zh-Hant/docs/ai-copilot/sales-copilot) 和 [服務 Copilot](/zh-Hant/docs/ai-copilot/service-copilot) 兩者的構建模塊。 +**技能**是平台助手可以執行的細分到點的 AI 能力——比如 *「判定此潛在客戶資格」* 或 *「撰寫客戶回覆」*。技能是 HotCRM 對助手的全部貢獻；它們按兩組編寫文件：[銷售技能](/zh-Hant/docs/ai-copilot/sales-copilot) 和 [服務技能](/zh-Hant/docs/ai-copilot/service-copilot)。 ## 為什麼用技能，而非「一個大 AI」 -將 Copilot 拆分為技能使它： +把能力打包為技能（而不是一段大提示詞）使它： - **可預測**——每項技能都有明確定義的輸入、輸出和行為。 - **可稽核**——管理員可以看到每項技能從哪裡讀取、向哪裡寫入。 @@ -39,7 +39,7 @@ HotCRM 內建六項核心技能： | **寫入** | 無——唯讀 | | **知識庫** | 無——純粹是元資料 + 記錄 | -這是 **[Wow #1 — 即時結構](/zh-Hant/docs/ai-copilot/live-schema)** 背後的技能：在管理主控台中新增一個欄位，Copilot 在下一輪就會使用它。其他每項銷售 / 服務技能都構建在即時資料之上，因此同樣的即時結構特性會傳遞地適用——潛在客戶資格判定可以根據 10 秒前新增的自訂欄位為潛在客戶評分。 +這是 **[Wow #1 — 即時結構](/zh-Hant/docs/ai-copilot/live-schema)** 背後的技能：在管理主控台中新增一個欄位，助手在下一輪就會使用它。其他每項銷售 / 服務技能都構建在即時資料之上，因此同樣的即時結構特性會傳遞地適用——潛在客戶資格判定可以根據 10 秒前新增的自訂欄位為潛在客戶評分。 ### 🎯 潛在客戶資格判定 @@ -95,10 +95,10 @@ HotCRM 內建六項核心技能： 技能可以呼叫其他技能。例如： -- 服務 Copilot 的 *工單分流* 技能可以呼叫 *Customer 360* 來檢查客戶在分配優先級前是否為高價值客戶。 -- 銷售 Copilot 的 *郵件撰寫* 技能可以呼叫 *Customer 360* 將郵件建立在真實的客戶上下文之上。 +- *工單分流* 技能可以呼叫 *Customer 360* 來檢查客戶在分配優先級前是否為高價值客戶。 +- *郵件撰寫* 技能可以呼叫 *Customer 360* 將郵件建立在真實的客戶上下文之上。 -這種組合是自動的——你問一個問題，Copilot 會接好它所需的任何技能。 +這種組合是自動的——你問一個問題，助手會接好它所需的任何技能。 ## 每項技能都遵循什麼 diff --git a/content/docs/analytics/index.mdx b/content/docs/analytics/index.mdx index af51b49c..1d155c88 100644 --- a/content/docs/analytics/index.mdx +++ b/content/docs/analytics/index.mdx @@ -55,7 +55,7 @@ The AI Copilot can read directly from cubes — ask questions like: - *"Why did East close 3 fewer deals than West last quarter?"* - *"Show me which products correlate with longer sales cycles."* -See the [Sales Copilot](/docs/ai-copilot/sales-copilot) for more. +See [Sales Skills](/docs/ai-copilot/sales-copilot) for more. ## Start here diff --git a/content/docs/analytics/index.zh-Hans.mdx b/content/docs/analytics/index.zh-Hans.mdx index cb9d25aa..673cdc00 100644 --- a/content/docs/analytics/index.zh-Hans.mdx +++ b/content/docs/analytics/index.zh-Hans.mdx @@ -55,7 +55,7 @@ AI Copilot 可以直接从多维数据集读取数据——可以提出如下问 - *"为什么上季度东区比西区少成交了 3 笔交易？"* - *"告诉我哪些产品与更长的销售周期相关。"* -更多内容请参阅 [Sales Copilot](/zh-Hans/docs/ai-copilot/sales-copilot)。 +更多内容请参阅 [销售技能](/zh-Hans/docs/ai-copilot/sales-copilot)。 ## 从这里开始 diff --git a/content/docs/analytics/index.zh-Hant.mdx b/content/docs/analytics/index.zh-Hant.mdx index 1138b6ba..adb82df9 100644 --- a/content/docs/analytics/index.zh-Hant.mdx +++ b/content/docs/analytics/index.zh-Hant.mdx @@ -55,7 +55,7 @@ AI Copilot 可以直接從多維資料集讀取資料——可以提出如下問 - *"為什麼上一季東區比西區少成交了 3 筆交易？"* - *"告訴我哪些產品與更長的銷售週期相關。"* -更多內容請參閱 [Sales Copilot](/zh-Hant/docs/ai-copilot/sales-copilot)。 +更多內容請參閱 [銷售技能](/zh-Hant/docs/ai-copilot/sales-copilot)。 ## 從這裡開始 diff --git a/content/docs/customization/ai-skills.mdx b/content/docs/customization/ai-skills.mdx index 34265944..9a7e64c7 100644 --- a/content/docs/customization/ai-skills.mdx +++ b/content/docs/customization/ai-skills.mdx @@ -1,11 +1,15 @@ --- title: AI Skills -description: Add Copilot skills and wire them into HotCRM agents. +description: Add AI skills and register them with the HotCRM stack. --- # AI Skills -AI skills live in `src/skills/` and are registered from `src/skills/index.ts`. Agents live in `src/agents/`. +AI skills live in `src/skills/` and are registered from `src/skills/index.ts`. + +HotCRM defines **no agents of its own** — there is no `src/agents/` directory. Skills +attach to the platform assistant (`ask`), which every ObjectStack environment already +provides. Registering a skill in `allSkills` is the whole wiring step. ## Add a skill @@ -24,27 +28,27 @@ account and contract records, summarize risk, and draft a concise }); ``` -Export it: +## Register it + +Export the skill and add it to `allSkills` — that array is what +`objectstack.config.ts` passes to `defineStack({ skills })`: ```ts // src/skills/index.ts export { RenewalPitchSkill } from './renewal_pitch.skill.js'; -``` -## Attach it to an agent +import { RenewalPitchSkill } from './renewal_pitch.skill.js'; -```ts -// src/agents/sales-copilot.agent.ts -skills: [ - 'live_data', - 'lead_qualification', - 'email_drafting', - 'revenue_forecasting', - 'customer_360', - 'renewal_pitch', -], +export const allSkills: Skill[] = [ + // …existing skills + RenewalPitchSkill, +]; ``` +To make the skill activate on a particular record instead of everywhere, declare a +`triggerConditions` entry on it — for example +`{ field: 'objectName', operator: 'eq', value: 'crm_contract' }`. + ## Verify ```bash diff --git a/content/docs/customization/ai-skills.zh-Hans.mdx b/content/docs/customization/ai-skills.zh-Hans.mdx index 7fa4b5ae..28a7a274 100644 --- a/content/docs/customization/ai-skills.zh-Hans.mdx +++ b/content/docs/customization/ai-skills.zh-Hans.mdx @@ -1,11 +1,15 @@ --- title: AI Skills -description: 新增 Copilot skills，并接入 HotCRM agents。 +description: 新增 AI skills，并注册到 HotCRM stack。 --- # AI Skills -AI skills 位于 `src/skills/`，并从 `src/skills/index.ts` 注册。Agents 位于 `src/agents/`。 +AI skills 位于 `src/skills/`，并从 `src/skills/index.ts` 注册。 + +HotCRM **不定义任何自己的 agent** —— 不存在 `src/agents/` 目录。Skills 附着在每个 +ObjectStack 环境已自带的平台助手（`ask`）之上。把 skill 注册进 `allSkills` 就是全部 +的接线工作。 ## 新增 skill @@ -24,27 +28,26 @@ account and contract records, summarize risk, and draft a concise }); ``` -导出： +## 注册 + +导出该 skill 并把它加入 `allSkills` —— 这个数组正是 `objectstack.config.ts` 传给 +`defineStack({ skills })` 的内容： ```ts // src/skills/index.ts export { RenewalPitchSkill } from './renewal_pitch.skill.js'; -``` -## 接入 agent +import { RenewalPitchSkill } from './renewal_pitch.skill.js'; -```ts -// src/agents/sales-copilot.agent.ts -skills: [ - 'live_data', - 'lead_qualification', - 'email_drafting', - 'revenue_forecasting', - 'customer_360', - 'renewal_pitch', -], +export const allSkills: Skill[] = [ + // …已有的 skills + RenewalPitchSkill, +]; ``` +若希望该 skill 只在特定记录上激活（而非处处可用），在它上面声明 `triggerConditions` +即可，例如 `{ field: 'objectName', operator: 'eq', value: 'crm_contract' }`。 + ## 验证 ```bash diff --git a/content/docs/customization/ai-skills.zh-Hant.mdx b/content/docs/customization/ai-skills.zh-Hant.mdx index 6eb89392..0e62bc9d 100644 --- a/content/docs/customization/ai-skills.zh-Hant.mdx +++ b/content/docs/customization/ai-skills.zh-Hant.mdx @@ -1,11 +1,15 @@ --- title: AI Skills -description: 新增 Copilot skills，並接入 HotCRM agents。 +description: 新增 AI skills，並註冊到 HotCRM stack。 --- # AI Skills -AI skills 位於 `src/skills/`，並從 `src/skills/index.ts` 註冊。Agents 位於 `src/agents/`。 +AI skills 位於 `src/skills/`，並從 `src/skills/index.ts` 註冊。 + +HotCRM **不定義任何自己的 agent** —— 不存在 `src/agents/` 目錄。Skills 附著在每個 +ObjectStack 環境已自帶的平台助手（`ask`）之上。把 skill 註冊進 `allSkills` 就是全部 +的接線工作。 ## 新增 skill @@ -24,27 +28,26 @@ account and contract records, summarize risk, and draft a concise }); ``` -匯出： +## 註冊 + +匯出該 skill 並把它加入 `allSkills` —— 這個陣列正是 `objectstack.config.ts` 傳給 +`defineStack({ skills })` 的內容： ```ts // src/skills/index.ts export { RenewalPitchSkill } from './renewal_pitch.skill.js'; -``` -## 接入 agent +import { RenewalPitchSkill } from './renewal_pitch.skill.js'; -```ts -// src/agents/sales-copilot.agent.ts -skills: [ - 'live_data', - 'lead_qualification', - 'email_drafting', - 'revenue_forecasting', - 'customer_360', - 'renewal_pitch', -], +export const allSkills: Skill[] = [ + // …既有的 skills + RenewalPitchSkill, +]; ``` +若希望該 skill 只在特定記錄上啟用（而非處處可用），在它上面宣告 `triggerConditions` +即可，例如 `{ field: 'objectName', operator: 'eq', value: 'crm_contract' }`。 + ## 驗證 ```bash diff --git a/content/docs/getting-started/quick-tour.mdx b/content/docs/getting-started/quick-tour.mdx index 84526786..a174d21d 100644 --- a/content/docs/getting-started/quick-tour.mdx +++ b/content/docs/getting-started/quick-tour.mdx @@ -48,7 +48,7 @@ A **lead** is someone who's expressed interest but hasn't been qualified yet. 1. Click **Sales → Leads → New**. 2. Fill in **Name**, **Company**, **Email**. 3. Save. The lead is automatically assigned to you. -4. Click **🎯 Qualify** on the lead detail page — the [Sales Copilot](/docs/ai-copilot/sales-copilot) will score them as Hot / Warm / Cold and suggest the next action. +4. Ask the assistant to *"qualify this lead"* on the lead detail page — the [Lead Qualification skill](/docs/ai-copilot/sales-copilot) scores them 0–100 on BANT and suggests the next action. 5. When ready, click **Convert** to turn the lead into an Account + Contact + Opportunity in one step. ➜ Learn more: [Leads](/docs/sales/leads) @@ -72,7 +72,7 @@ A **case** is a customer issue. 1. Cases arrive via email, web form, phone, chat, or portal. 2. New cases land in a queue — agents pick them up. -3. Click **🚦 Triage** on a new case — the [Service Copilot](/docs/ai-copilot/service-copilot) suggests priority, category, and the top 3 matching knowledge-base articles. +3. Ask the assistant to *"triage this case"* on a new case — the [Case Triage skill](/docs/ai-copilot/service-copilot) suggests priority, category, and matching knowledge-base articles. 4. The SLA clock starts — see the time-to-respond / time-to-resolve countdown on the case page. 5. Reply to the customer; close the case when resolved. diff --git a/content/docs/getting-started/quick-tour.zh-Hans.mdx b/content/docs/getting-started/quick-tour.zh-Hans.mdx index 31fbc766..25c67e29 100644 --- a/content/docs/getting-started/quick-tour.zh-Hans.mdx +++ b/content/docs/getting-started/quick-tour.zh-Hans.mdx @@ -48,7 +48,7 @@ description: HotCRM 的 5 分钟演练 —— 主页、你的第一条线索、 1. 点击 **Sales → Leads → New**。 2. 填写 **Name**、**Company**、**Email**。 3. 保存。线索会自动分配给你。 -4. 在线索详情页上点击 **🎯 Qualify** —— [Sales Copilot](/zh-Hans/docs/ai-copilot/sales-copilot) 会将其评分为 Hot / Warm / Cold 并建议下一步操作。 +4. 在线索详情页上请助手 *"判定此线索资格"* —— [线索资格判定技能](/zh-Hans/docs/ai-copilot/sales-copilot) 会按 BANT 给出 0–100 的评分并建议下一步操作。 5. 准备就绪后，点击 **Convert** 一步将线索转化为 Account + Contact + Opportunity。 ➜ 了解更多：[线索](/zh-Hans/docs/sales/leads) @@ -72,7 +72,7 @@ description: HotCRM 的 5 分钟演练 —— 主页、你的第一条线索、 1. 案例通过邮件、Web 表单、电话、聊天或门户到达。 2. 新案例进入队列 —— 坐席接手。 -3. 在新案例上点击 **🚦 Triage** —— [Service Copilot](/zh-Hans/docs/ai-copilot/service-copilot) 会建议优先级、类别以及最匹配的前 3 篇知识库文章。 +3. 在新工单上请助手 *"分流此工单"* —— [工单分流技能](/zh-Hans/docs/ai-copilot/service-copilot) 会建议优先级、分类以及匹配的知识库文章。 4. SLA 计时器开始 —— 在案例页面查看响应时间 / 解决时间倒计时。 5. 回复客户；解决后关闭案例。 diff --git a/content/docs/getting-started/quick-tour.zh-Hant.mdx b/content/docs/getting-started/quick-tour.zh-Hant.mdx index 4b460189..26948620 100644 --- a/content/docs/getting-started/quick-tour.zh-Hant.mdx +++ b/content/docs/getting-started/quick-tour.zh-Hant.mdx @@ -48,7 +48,7 @@ description: HotCRM 的 5 分鐘演練 —— 主頁、你的第一條線索、 1. 點擊 **Sales → Leads → New**。 2. 填寫 **Name**、**Company**、**Email**。 3. 儲存。線索會自動指派給你。 -4. 在線索詳情頁上點擊 **🎯 Qualify** —— [Sales Copilot](/zh-Hant/docs/ai-copilot/sales-copilot) 會將其評分為 Hot / Warm / Cold 並建議下一步操作。 +4. 在潛在客戶詳情頁上請助手 *「判定此潛在客戶資格」* —— [潛在客戶資格判定技能](/zh-Hant/docs/ai-copilot/sales-copilot) 會按 BANT 給出 0–100 的評分並建議下一步操作。 5. 準備就緒後，點擊 **Convert** 一步將線索轉換為 Account + Contact + Opportunity。 ➜ 了解更多：[線索](/zh-Hant/docs/sales/leads) @@ -72,7 +72,7 @@ description: HotCRM 的 5 分鐘演練 —— 主頁、你的第一條線索、 1. 案例透過郵件、Web 表單、電話、聊天或入口網站到達。 2. 新案例進入佇列 —— 專員接手。 -3. 在新案例上點擊 **🚦 Triage** —— [Service Copilot](/zh-Hant/docs/ai-copilot/service-copilot) 會建議優先順序、類別以及最匹配的前 3 篇知識庫文章。 +3. 在新工單上請助手 *「分流此工單」* —— [工單分流技能](/zh-Hant/docs/ai-copilot/service-copilot) 會建議優先順序、分類以及匹配的知識庫文章。 4. SLA 計時器開始 —— 在案例頁面查看回應時間 / 解決時間倒數計時。 5. 回覆客戶；解決後關閉案例。 diff --git a/content/docs/guides/email-and-calendar.mdx b/content/docs/guides/email-and-calendar.mdx index 90b2aab1..a6a58e20 100644 --- a/content/docs/guides/email-and-calendar.mdx +++ b/content/docs/guides/email-and-calendar.mdx @@ -51,7 +51,7 @@ Tracking events are stored on the email activity, the contact, and the originati ## AI-drafted emails -On any record, click **✍️ Draft Email** to have the [Sales Copilot](/docs/ai-copilot/sales-copilot) or [Service Copilot](/docs/ai-copilot/service-copilot) draft a contextual email: +On any record, ask the assistant to draft an email — the Email Drafting skill is shared by the [sales](/docs/ai-copilot/sales-copilot) and [service](/docs/ai-copilot/service-copilot) skill sets: 1. Pick a goal (*"discovery follow-up"*, *"renewal pitch"*, *"resolution"*). 2. Review the draft — edit, replace, regenerate. diff --git a/content/docs/guides/email-and-calendar.zh-Hans.mdx b/content/docs/guides/email-and-calendar.zh-Hans.mdx index 16c7bf99..6801836f 100644 --- a/content/docs/guides/email-and-calendar.zh-Hans.mdx +++ b/content/docs/guides/email-and-calendar.zh-Hans.mdx @@ -51,7 +51,7 @@ HotCRM 集成了 **Gmail**（Google Workspace）和 **Outlook**（Microsoft 365 ## AI 起草的邮件 -在任何记录上，点击 **✍️ 起草邮件**，让 [销售 Copilot](/zh-Hans/docs/ai-copilot/sales-copilot) 或 [服务 Copilot](/zh-Hans/docs/ai-copilot/service-copilot) 起草一封上下文相关的邮件： +在任何记录上，请助手起草邮件——邮件撰写技能由 [销售技能](/zh-Hans/docs/ai-copilot/sales-copilot) 和 [服务技能](/zh-Hans/docs/ai-copilot/service-copilot) 共用： 1. 选择一个目标（*"发现阶段跟进"*、*"续约推介"*、*"问题解决"*）。 2. 审阅草稿 —— 编辑、替换、重新生成。 diff --git a/content/docs/guides/email-and-calendar.zh-Hant.mdx b/content/docs/guides/email-and-calendar.zh-Hant.mdx index 01fc4d37..ba07aa70 100644 --- a/content/docs/guides/email-and-calendar.zh-Hant.mdx +++ b/content/docs/guides/email-and-calendar.zh-Hant.mdx @@ -51,7 +51,7 @@ HotCRM 整合了 **Gmail**（Google Workspace）和 **Outlook**（Microsoft 365 ## AI 起草的郵件 -在任何記錄上，點擊 **✍️ 起草郵件**，讓 [銷售 Copilot](/zh-Hant/docs/ai-copilot/sales-copilot) 或 [服務 Copilot](/zh-Hant/docs/ai-copilot/service-copilot) 起草一封情境相關的郵件： +在任何記錄上，請助手起草郵件——郵件撰寫技能由 [銷售技能](/zh-Hant/docs/ai-copilot/sales-copilot) 和 [服務技能](/zh-Hant/docs/ai-copilot/service-copilot) 共用： 1. 選擇一個目標（*「發現階段跟進」*、*「續約推介」*、*「問題解決」*）。 2. 審閱草稿 —— 編輯、替換、重新生成。 diff --git a/content/docs/reference/glossary.mdx b/content/docs/reference/glossary.mdx index 0f26cf4e..6355d99c 100644 --- a/content/docs/reference/glossary.mdx +++ b/content/docs/reference/glossary.mdx @@ -15,7 +15,7 @@ description: CRM and platform terms — alphabetised so you can stop bluffing in **Activity** — A task, event, call, or email logged against a record. -**Agent (AI)** — A composite AI assistant that bundles skills + knowledge bases. The Sales Copilot and Service Copilot are agents. +**Agent (AI)** — A composite AI assistant that bundles skills + knowledge bases. HotCRM defines no agents of its own: its six skills attach to the platform `ask` agent that every ObjectStack environment provides. **ARPU** *(Average Revenue Per User)* — Total revenue ÷ active users. diff --git a/content/docs/reference/glossary.zh-Hans.mdx b/content/docs/reference/glossary.zh-Hans.mdx index 36b60b36..b2df65e1 100644 --- a/content/docs/reference/glossary.zh-Hans.mdx +++ b/content/docs/reference/glossary.zh-Hans.mdx @@ -15,7 +15,7 @@ description: CRM 与平台术语 —— 按字母排序，让你在会议中不 **Activity（活动）** —— 针对某条记录记录的任务、事件、通话或邮件。 -**Agent (AI)（AI 代理）** —— 捆绑技能 + 知识库的复合型 AI 助手。Sales Copilot 和 Service Copilot 都是代理。 +**Agent (AI)（AI 代理）** —— 捆绑技能 + 知识库的复合型 AI 助手。HotCRM 不定义任何自己的代理：它的六项技能附着在每个 ObjectStack 环境自带的平台 `ask` 代理之上。 **ARPU** *(Average Revenue Per User，每用户平均收入)* —— 总收入 ÷ 活跃用户数。 diff --git a/content/docs/reference/glossary.zh-Hant.mdx b/content/docs/reference/glossary.zh-Hant.mdx index cbc805b2..7343325e 100644 --- a/content/docs/reference/glossary.zh-Hant.mdx +++ b/content/docs/reference/glossary.zh-Hant.mdx @@ -15,7 +15,7 @@ description: CRM 與平台術語 —— 按字母排序，讓你在會議中不 **Activity（活動）** —— 針對某筆記錄記錄的任務、事件、通話或郵件。 -**Agent (AI)（AI 代理）** —— 捆綁技能 + 知識庫的複合型 AI 助手。Sales Copilot 和 Service Copilot 都是代理。 +**Agent (AI)（AI 代理）** —— 捆綁技能 + 知識庫的複合型 AI 助手。HotCRM 不定義任何自己的代理：它的六項技能附著在每個 ObjectStack 環境自帶的平台 `ask` 代理之上。 **ARPU** *(Average Revenue Per User，每使用者平均收入)* —— 總收入 ÷ 活躍使用者數。 diff --git a/content/docs/sales/index.mdx b/content/docs/sales/index.mdx index 9404a53d..b45ce81d 100644 --- a/content/docs/sales/index.mdx +++ b/content/docs/sales/index.mdx @@ -42,9 +42,9 @@ You don't need to do these manually — HotCRM handles them in the background: - **Quote expiration** — quotes that pass their expiration date are auto-marked as expired every night. - **Discount approval** — opportunities over $500K are automatically routed to your sales manager and director for approval. -## The Sales Copilot +## Sales AI skills -The [Sales Copilot](/docs/ai-copilot/sales-copilot) is built in. When you open a lead, account or opportunity, it can: +The [sales skills](/docs/ai-copilot/sales-copilot) are built into the platform assistant. When you open a lead, account or opportunity, it can: - **Qualify a lead** using the BANT method (Budget, Authority, Need, Timeline) and give you a score. - **Draft outbound emails** personalised for the contact and grounded in the product catalog. diff --git a/content/docs/sales/index.zh-Hans.mdx b/content/docs/sales/index.zh-Hans.mdx index 969f7579..12c15c75 100644 --- a/content/docs/sales/index.zh-Hans.mdx +++ b/content/docs/sales/index.zh-Hans.mdx @@ -44,7 +44,7 @@ Lead ──► Account + Contact ──► Opportunity ──► Quote ## Sales Copilot -[Sales Copilot](/zh-Hans/docs/ai-copilot/sales-copilot) 是内置的。当你打开一条线索、客户或商机时，它可以： +[销售技能](/zh-Hans/docs/ai-copilot/sales-copilot) 已内置于平台助手。当你打开一条线索、客户或商机时，它可以： - 使用 BANT 方法（预算、决策权、需求、时间线）**审核线索资格**并给出评分。 - **起草外呼邮件**，针对联系人进行个性化，并以产品目录为依据。 diff --git a/content/docs/sales/index.zh-Hant.mdx b/content/docs/sales/index.zh-Hant.mdx index d811151d..284ee763 100644 --- a/content/docs/sales/index.zh-Hant.mdx +++ b/content/docs/sales/index.zh-Hant.mdx @@ -44,7 +44,7 @@ Lead ──► Account + Contact ──► Opportunity ──► Quote ## Sales Copilot -[Sales Copilot](/zh-Hant/docs/ai-copilot/sales-copilot) 是內建的。當你打開一筆潛在客戶、客戶或商機時，它可以： +[銷售技能](/zh-Hant/docs/ai-copilot/sales-copilot) 已內建於平台助手。當你打開一筆潛在客戶、客戶或商機時，它可以： - 使用 BANT 方法（預算、決策權、需求、時間線）**審核潛在客戶資格**並給出評分。 - **起草外撥郵件**，針對聯絡人進行個人化，並以產品目錄為依據。 diff --git a/content/docs/service/cases.mdx b/content/docs/service/cases.mdx index 1ca62392..83e759d7 100644 --- a/content/docs/service/cases.mdx +++ b/content/docs/service/cases.mdx @@ -148,9 +148,9 @@ You don't have to configure any of this — every CRM object ships with `trackHi > Tip — if you only want to see the discussion, use the filter dropdown at the top of the Activity tab; you can also subscribe to the case from there so any future post pings you in the bell. -## How the AI Copilot helps +## How the AI assistant helps -The [Service Copilot](/docs/ai-copilot/service-copilot) auto-activates on any case. Ask: +The [service skills](/docs/ai-copilot/service-copilot) auto-activate on any case. Ask: - *"Triage this case"* — Case Triage skill recommends a priority based on subject and description. - *"Suggest a resolution"* — searches the [Support Knowledge Base](/docs/service/knowledge-base) and drafts a customer reply. diff --git a/content/docs/service/cases.zh-Hans.mdx b/content/docs/service/cases.zh-Hans.mdx index c9ba730e..537b3e4c 100644 --- a/content/docs/service/cases.zh-Hans.mdx +++ b/content/docs/service/cases.zh-Hans.mdx @@ -150,7 +150,7 @@ Activity 标签页是工单上发生过什么的唯一可信来源。它将四 ## AI Copilot 如何提供帮助 -[Service Copilot](/zh-Hans/docs/ai-copilot/service-copilot) 会在任何工单上自动激活。你可以问： +[服务技能](/zh-Hans/docs/ai-copilot/service-copilot) 会在任何工单上自动激活。你可以问： - *"分流这个工单"*——工单分流技能根据主题和描述推荐优先级。 - *"建议一个解决方案"*——搜索[支持知识库](/zh-Hans/docs/service/knowledge-base)并起草客户回复。 diff --git a/content/docs/service/cases.zh-Hant.mdx b/content/docs/service/cases.zh-Hant.mdx index 93195803..917d591b 100644 --- a/content/docs/service/cases.zh-Hant.mdx +++ b/content/docs/service/cases.zh-Hant.mdx @@ -150,7 +150,7 @@ Activity 標籤頁是工單上發生過什麼的唯一可信來源。它將四 ## AI Copilot 如何提供幫助 -[Service Copilot](/zh-Hant/docs/ai-copilot/service-copilot) 會在任何工單上自動啟動。你可以問： +[服務技能](/zh-Hant/docs/ai-copilot/service-copilot) 會在任何工單上自動啟動。你可以問： - *"分流這個工單"*——工單分流技能根據主題和描述推薦優先順序。 - *"建議一個解決方案"*——搜尋[支援知識庫](/zh-Hant/docs/service/knowledge-base)並起草客戶回覆。 diff --git a/content/docs/service/index.mdx b/content/docs/service/index.mdx index d12015de..8f5a8ca7 100644 --- a/content/docs/service/index.mdx +++ b/content/docs/service/index.mdx @@ -40,9 +40,9 @@ New ──► In Progress ──► Waiting on Customer ──► Resolved ─ - **Flag SLA breaches** with a red banner once the SLA target passes. - **Block bad closes** — you can't mark a case Closed without a resolution written. -## The Service Copilot +## Service AI skills -The [Service Copilot](/docs/ai-copilot/service-copilot) is built into every case. Ask it: +The [service skills](/docs/ai-copilot/service-copilot) are built into every case. Ask the assistant: - *"Triage this case"* — assigns a priority based on subject, description and customer tier. - *"Suggest a resolution"* — searches the support knowledge base and drafts a customer reply. diff --git a/content/docs/service/index.zh-Hans.mdx b/content/docs/service/index.zh-Hans.mdx index 9a361eae..693e1bac 100644 --- a/content/docs/service/index.zh-Hans.mdx +++ b/content/docs/service/index.zh-Hans.mdx @@ -42,7 +42,7 @@ New ──► In Progress ──► Waiting on Customer ──► Resolved ─ ## Service Copilot -[Service Copilot](/zh-Hans/docs/ai-copilot/service-copilot) 内置于每个工单中。你可以问它： +[服务技能](/zh-Hans/docs/ai-copilot/service-copilot) 内置于每个工单中。你可以问助手： - *"分流这个工单"*——根据主题、描述和客户等级分配优先级。 - *"建议一个解决方案"*——搜索支持知识库并起草客户回复。 diff --git a/content/docs/service/index.zh-Hant.mdx b/content/docs/service/index.zh-Hant.mdx index 553e3318..aef27c6d 100644 --- a/content/docs/service/index.zh-Hant.mdx +++ b/content/docs/service/index.zh-Hant.mdx @@ -42,7 +42,7 @@ New ──► In Progress ──► Waiting on Customer ──► Resolved ─ ## Service Copilot -[Service Copilot](/zh-Hant/docs/ai-copilot/service-copilot) 內建於每個工單中。你可以問它： +[服務技能](/zh-Hant/docs/ai-copilot/service-copilot) 內建於每個工單中。你可以問助手： - *"分流這個工單"*——根據主題、描述和客戶等級分配優先順序。 - *"建議一個解決方案"*——搜尋支援知識庫並起草客戶回覆。 diff --git a/content/docs/whats-new.zh-Hans.mdx b/content/docs/whats-new.zh-Hans.mdx index 85c39ef8..1f3dcf1c 100644 --- a/content/docs/whats-new.zh-Hans.mdx +++ b/content/docs/whats-new.zh-Hans.mdx @@ -11,7 +11,7 @@ description: 近期发布、新能力，以及即将推出的内容。 ### ✨ 惊艳点 #1 —— 实时模式，实时 AI -在管理控制台中添加一个字段。十秒后，向 Sales Copilot 询问与它相关的问题。它已经知道了。无需重新训练、无需重启、无需重新部署 —— 平台在每个智能体回合都会重新读取元数据，而 Copilot 的 `describe_object` 工具一保存就会返回你的新字段。 +在管理控制台中添加一个字段。十秒后，向助手询问与它相关的问题。它已经知道了。无需重新训练、无需重启、无需重新部署 —— 平台在每个智能体回合都会重新读取元数据，而 Copilot 的 `describe_object` 工具一保存就会返回你的新字段。 用我们随附的脚本在 30 秒内试一试： diff --git a/content/docs/whats-new.zh-Hant.mdx b/content/docs/whats-new.zh-Hant.mdx index 0ba61f5b..50b5760c 100644 --- a/content/docs/whats-new.zh-Hant.mdx +++ b/content/docs/whats-new.zh-Hant.mdx @@ -11,7 +11,7 @@ description: 近期發行、新能力，以及即將推出的內容。 ### ✨ 驚艷點 #1 —— 即時結構描述，即時 AI -在管理主控台中新增一個欄位。十秒後，向 Sales Copilot 詢問與它相關的問題。它已經知道了。無需重新訓練、無需重新啟動、無需重新部署 —— 平台在每個智慧代理回合都會重新讀取中繼資料，而 Copilot 的 `describe_object` 工具一儲存就會傳回你的新欄位。 +在管理主控台中新增一個欄位。十秒後，向助手詢問與它相關的問題。它已經知道了。無需重新訓練、無需重新啟動、無需重新部署 —— 平台在每個智慧代理回合都會重新讀取中繼資料，而 Copilot 的 `describe_object` 工具一儲存就會傳回你的新欄位。 用我們隨附的指令稿在 30 秒內試一試： diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index d278596f..49b9b05c 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -12,10 +12,9 @@ flowchart TD Stack --> Objects["src/objects"] Stack --> Actions["src/actions"] Stack --> Flows["src/flows"] - Stack --> Agents["src/agents"] Stack --> Skills["src/skills"] Stack --> UI["src/apps, src/views, src/pages"] - Stack --> Analytics["src/dashboards, src/reports, src/cubes"] + Stack --> Analytics["src/datasets, src/dashboards, src/reports"] Stack --> Security["src/profiles, src/sharing"] Stack --> Data["src/data"] Stack --> Runtime["@objectstack/runtime"] @@ -31,11 +30,19 @@ The stack manifest defines: | --- | --- | | id | `app.objectstack.hotcrm` | | namespace | `crm` | -| version | `1.0.5` | +| version | `2.2.2` | | type | `app` | | name | `HotCRM` | +| engines.protocol | `^17.0.0-rc.1` | -Runtime capabilities are declared in `requires`: `ai`, `automation`, `triggers`, `analytics`, `auth`, `ui`, `approvals`, and `sharing`. +Runtime capabilities are declared in `requires`: `automation`, `triggers`, `analytics`, `auth`, `ui`, `approvals`, and `sharing`. + +`ai` is deliberately **not** in that list. ObjectStack 11.3.0 (ADR-0025 S2) moved the +AI runtime out of the open edition, and under ObjectStack 16 `requires: ['ai']` is +fail-fast — declaring it would hard-abort `objectstack start`/`dev` for this +open-edition app. The AI metadata is unaffected: the skills still validate, build into +the artifact, and run wherever a runtime provides the `ai` tier. See the comment in +[`objectstack.config.ts`](../objectstack.config.ts) for the full rationale. ## Metadata Areas @@ -48,7 +55,7 @@ Runtime capabilities are declared in `requires`: `ai`, `automation`, `triggers`, | AI skills | `src/skills/*.skill.ts` | `skills` | | Apps, views, pages | `src/apps/`, `src/views/`, `src/pages/` | `apps`, `views`, `pages` | | Analytics | `src/datasets/`, `src/dashboards/`, `src/reports/` | `datasets`, `dashboards`, `reports` | -| Security | `src/profiles/`, `src/sharing/` | `permissions`, `sharingRules`, `roles` | +| Security | `src/profiles/`, `src/sharing/` | `permissions`, `sharingRules`, `positions` | | i18n | `src/translations/` | `translations`, `i18n` | | Demo data | `src/data/` | `data` | @@ -149,11 +156,15 @@ answering record questions, because admins can change metadata over time. Security is assembled from: -- permission profiles in `src/profiles/` -- sharing rules in `src/sharing/` -- role hierarchy in `src/sharing/role-hierarchy.ts` +- 6 permission profiles in `src/profiles/` +- 9 sharing rules in `src/sharing/*.sharing.ts` +- 12 positions in `src/sharing/positions.ts` -The stack maps `RoleHierarchy.roles` into the ObjectStack `roles` field and registers sharing rules for accounts, opportunities, cases, and territory-style visibility. +The stack registers sharing rules for accounts, opportunities, cases, campaigns, and +territory-style visibility, and passes `CrmPositions` to `defineStack({ positions })`. +Per ADR-0090 D3 positions are flat capability-distribution groups — the v1 role +hierarchy's parent links are gone, because hierarchy belongs to the business-unit tree, +which this app does not model. ## Verification diff --git a/docs/archive/2026-02/SALESFORCE_FEATURE_COMPARISON.md b/docs/archive/2026-02/SALESFORCE_FEATURE_COMPARISON.md index b8340df6..05ddb03f 100644 --- a/docs/archive/2026-02/SALESFORCE_FEATURE_COMPARISON.md +++ b/docs/archive/2026-02/SALESFORCE_FEATURE_COMPARISON.md @@ -2,6 +2,27 @@ +# ⚠️ RETIRED ARCHITECTURE — DO NOT USE THIS DOCUMENT TO EVALUATE HotCRM + +> **This document describes a pre-2.x HotCRM that no longer exists.** It was written +> against a multi-package (`packages/*`) architecture of ~148 business objects, and it +> marks features as "✅ Implemented" — `sla_policy`, `queue`, `email_to_case`, +> `pricebook`, four industry verticals, ten connectors, a community portal — **none of +> which exist in the current tree**. Its headline claim of *~95% Salesforce feature +> parity* is therefore not a statement about the shipping product. +> +> **What HotCRM actually is today:** a single ObjectStack marketplace app built from a +> flat `src/{type}/` tree — **15 business objects**, 23 flows, 13 actions, 6 AI skills, +> 4 dashboards, 8 datasets, 6 permission profiles, 12 positions, 9 sharing rules, and +> 4 locale bundles. See the [README](../../../README.md) for the current product and +> [docs/ARCHITECTURE.md](../../ARCHITECTURE.md) for the current architecture. +> +> This file is kept **only as a historical record** of the direction the project took +> in February 2026 and later abandoned. Nothing below it is maintained, verified, or +> a commitment. + +--- + # HotCRM vs Salesforce: Deep Feature Comparison > **Version**: 3.0