Commit 8bf1fe0f by luoqi

docs(站点): 工具那节前移到提示词之后,补设计思路 + 21 个工具逐条列出

按产品要求:位置移到 §3(提示词之后),补上**工具设计的思路**,并把工具**全部列出来**。

**设计思路(从代码里的判定提炼,不是新造):**
  🔴 **能靠结构解决的, 不靠叮嘱。** 模型会说出 `cold_3y` `implant` 这类内部码,
    主管看到不认识的词第一反应是系统坏了。最初在提示词里写两页「 不许说码」——
    **拦不住**,因为它调工具时必须拿码当参数,回话自然带出来。
    真解法是**返回值里就给中文** ⇒ 它手里有话可说,就不会去说码。
    「能让它说不出来的,就别写成不许说」——提示词里的禁令只拦得住预想到的那些。

**工具描述怎么写(四问,例子全取自真实描述):**
  它答什么问题 / ️ 哪里容易误读 /  什么时候不该用它 / 配套的那个工具是谁
  两条硬边界:返回值**只给事实不给成品句子**(否则模型照抄,内部指令原样贴进主管对话框 ——
  踩过);中文标签只有一处真源, 不在工具层另立一套。

**全部工具**:两种人都有 9 个、只有主管 12 个,逐条一句话说清干什么。
️ 数字是从代码数出来的,不是抄旧文:MCP 通用 8 + render_artifact = 客服 9;
  MCP 全部 14 + 本地 7 = 主管 21。与文档原有的 21/9 一致。

后续章节顺延(三者分工→四 / 引导→五)。MDX 编译通过。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
parent 44d4cfc6
...@@ -251,7 +251,70 @@ flowchart TD ...@@ -251,7 +251,70 @@ flowchart TD
--- ---
## 三、三者分工 ## 三、它手上的工具
工具是助手唯一能做事的通道。**没有对应工具的事,它做不了,也不会假装做了。**
### 设计思路:能靠结构解决的,⛔ 不靠叮嘱
模型会说出 `cold_3y`、`implant` 这种内部取值码,而主管看到不认识的词,第一反应是**系统坏了**。
最初的对策是在提示词里写两页「⛔ 不许说出取值码」—— **拦不住**。因为模型调工具时**必须**拿这些码当参数,回话时自然就带出来了。
真正的解法是**在返回值里就给它现成的中文**:既回显它传进来的条件,又把桶名换成中文。**它手里有话可说,就不会去说码。**
<Callout type="info">这是这套工具设计反复用的那条判据:**能让它「说不出来」的,就别写成「不许说」。** 提示词里的禁令只拦得住你预想到的那些;把码换成中文是结构上的 —— 它想说也说不出来。</Callout>
### 工具描述怎么写
工具描述是模型**决定调不调**时唯一能看的东西,所以它要答四件事:
| 要答的 | 例子(取自真实描述) |
|---|---|
| **它答什么问题** | 「召回工作台:列出待跟进的召回计划…回答『现在该联系谁 / 今日推荐』」 |
| **⚠️ 哪里容易误读** | 「这一层是 PAC **推断**出来的,⛔ 不是原始记录 —— 原始记录见 `get_facts`」 |
| **⛔ 什么时候不该用它** | 「能不能做**不用问它**:做得了的事,对应的工具就在你手上;做不了的,那个工具压根不会出现」 |
| **配套的那个工具是谁** | 「他问『今天有多少人要跟』时先用它给摘要,再用 `list_recall_queue` 取明细」 |
两条硬边界:**返回值只给事实、⛔ 不给成品句子**(否则模型照抄,内部指令会原样贴进主管的对话框 —— 踩过);**中文标签只有一处真源**,⛔ 不在工具层另立一套(两份必然漂)。
### 全部工具
<Callout type="info">**两个人拿到的清单不一样** —— 不是靠提示词叮嘱它"别看别人的",是那些工具**根本没发给它**。</Callout>
**两种人都有(9 个)**
| 工具 | 干什么 |
|---|---|
| 我是谁 | 当前登录人是谁、能管哪几家诊所 |
| 找患者 | 按姓名 / 手机 / 患者号模糊找,先拿到人再谈别的 |
| 患者全貌 | 一次拉全:画像要点 + 近期事实 + 当前召回计划 |
| 患者画像 | 全量画像 —— ⚠️ 这是 PAC **推断**的 |
| 患者事实 | 真实发生过的事(诊断 / 治疗 / 预约 / 收费)—— ⛔ 不含推断 |
| 这次为什么召回他 | 当前召回计划:什么场景、什么原因、优先级 |
| 召回池名单 | 现在该联系谁,按优先级排 |
| 召回池概览 | 总量 + 优先级分档 + 病种分布 |
| 画出来 | 成批的条目、一张画像、一份报表 —— 适合看不适合读的,渲染成图 |
**只有主管有(另 12 个)**
| | 工具 | 干什么 |
|---|---|---|
| **选人** | 看人手 | 在岗客服名册 + 每人手上压着多少 |
| | 看这批人构成 | 各画像维度各多少人 —— 切之前先看,免得切完只剩三个 |
| **出方案** | 出一版方案 | 挑人 · 排客服 · 算引导节点,**一次算完** |
| | 看当前确认单 | 他在卡片上动过手之后,助手看不见 —— 得查 |
| | 改确认单 | 移出谁 · 改派给谁 · 改时效 · 设福利 |
| | 摆确认单 / 摆引导 | 决定它们落在正文的哪一句之后(两个工具) |
| **追踪** | 我分过哪几批 | 批次列表 |
| | 某批怎么样了 | 处理率 · 退回原因 · 通话成效 · 逐条纪要 |
| | 这个人为什么分给了他 | 单条追溯 |
| **收回** | 撤销 | 限时收回整批 |
| **取做法** | 取一份做法 | 次要业务线的干法,要用时自己取(见 §2) |
---
## 四、三者分工
```mermaid ```mermaid
flowchart LR flowchart LR
...@@ -276,7 +339,7 @@ flowchart LR ...@@ -276,7 +339,7 @@ flowchart LR
--- ---
## 、要他定的事,做成按钮 ## 、要他定的事,做成按钮
程序算出「这一版还有什么没定」,**摆成按钮**,不让主管打字。 程序算出「这一版还有什么没定」,**摆成按钮**,不让主管打字。
...@@ -314,22 +377,6 @@ flowchart LR ...@@ -314,22 +377,6 @@ flowchart LR
--- ---
## 五、它手上的工具
工具是助手唯一能做事的通道。**没有对应工具的事,它做不了,也不会假装做了。**
<Callout type="info">**两个人拿到的清单不一样** —— 不是靠提示词叮嘱它"别看别人的",是那些工具**根本没发给它**。</Callout>
| | 两种人都有 | 只有主管有 |
|---|---|---|
| **查** | 我是谁 · 查患者 · 看召回池 | 看人手 · 看这批人构成 · 看当前确认单 |
| **做** | —— | 出方案 · 改确认单 · 决定确认单和选项出现在哪一句之后 · 撤销 |
| **追** | —— | 我分过哪几批 · 某批怎么样了 · 这个人为什么分给了他 |
主管 21 个,客服 9 个。
---
## 六、红线 ## 六、红线
| ⛔ 绝不 | 为什么 | | ⛔ 绝不 | 为什么 |
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment