# AI 知识库 · 领域概念确认表(请 PM 填写)

## 这份表是干什么的

VISTA Link 的 AI 能力需要一份"领域概念说明",告诉大模型每个业务概念**是什么**、**能得出什么结论**、以及**绝不能得出什么结论**。

**重点是第三项。** 这类错误不会报错,只会给出看起来完全合理的错误答案——比如把销售的展示动作写成客户兴趣、把两种不同来源的访问记录加在一起算总数。业务上一眼能看出不对,但模型看不出来,必须写死告诉它。

## 怎么填

每个概念填 4 栏:

| 栏位 | 说明 |
|---|---|
| **定义** | 业务上它是什么 |
| **能说明什么** | 允许由它得出的结论 |
| **不能说明什么** | **禁止的推断**——最重要,也最容易漏 |
| **来源** | 硬性规定 / 目前惯例(方便日后改动追溯) |

不确定的直接写"不确定",比猜一个更有价值。

## 优先级

- **A 组(1-3)**:本期硬门槛,填不出来 AI 能力不能上线
- **B 组(4-6)**:本期尽量拿到

---

# A 组 · 必须确认

## 1. 统计指标口径 `marketing_statistics`

> 模型不会自己算数,但会**解释**这些数字。口径不清,解释就是错的。

| 问题 | 填写 |
|---|---|
| 「访问次数」精确定义 | |
| 「访问人数」精确定义 | |
| 「停留时长」精确定义(从哪到哪、后台挂着算不算) | |
| 去重规则:同一客户一天打开 5 次,算几次? | |
| 统计周期与时区 | |
| 数据延迟:实时还是 T+1? | |
| 哪些指标是业务承认的正式口径? | |
| **哪些数字禁止模型自己算**(必须用接口返回值) | |
| **这些数字不能说明什么** | |

## 2. 跨项目红线 `session_context`

| 问题 | 填写 |
|---|---|
| 一个「项目」包含哪些东西 | |
| 客户能不能跨项目使用? | |
| 素材能不能跨项目使用? | |
| 页面能不能跨项目使用? | |
| 统计数据能不能跨项目合并? | |
| 一个销售能同时属于多个项目吗? | |
| 切换项目后,还能看到上一个项目的数据吗? | |
| 以上哪些是硬性禁止,哪些只是目前没人这么干? | |

## 3. 三种访问记录(复核 + 补充)

> 已有一版文档,请确认是否属实,并补充最后两问。

现有描述:

| 记录 | 谁产生 | 说明什么 | 不能说明什么 |
|---|---|---|---|
| 现场讲解 | 销售在售楼处操作,客户在场 | 销售**展示过**哪些内容 | 客户是否感兴趣、是否认可 |
| 普通预览 | 销售自己查看页面 | 页面被打开过 | 与客户行为无关 |
| 客户自主访问 | 客户自己打开分享链接 | 客户**实际浏览**了什么 | 浏览多不等于想买 |

现有硬规则:

- 营销统计**只统计客户自主访问**,不含现场讲解
- 同一回答里同时用到现场讲解和客户自主访问时,必须分开列出并标明来源
- 讲解时长/次数**不能**解释成客户兴趣

| 问题 | 填写 |
|---|---|
| 上面的定义和硬规则是否属实?有出入的请改 | |
| 除这三种外,还有第四种访问记录吗? | |
| `content_viewers`(内容观看者)返回的是哪一种记录? | |
| 观看者里有匿名访问吗?能不能认定成某个具体客户? | |

---

# B 组 · 尽量同期确认

## 4. 分享链接归因 `share_link_get` / `share_link_visits`

> 这直接决定"这次访问是谁产生的"能不能说得准。

| 问题 | 填写 |
|---|---|
| 一个页面一个链接,还是**每个客户一个链接**? | |
| 链接有有效期吗?过期后访问记录怎么算? | |
| 链接有访问次数上限或密码吗? | |
| 客户把链接转发给别人,这些访问算在原客户头上吗? | |
| 同一客户从不同设备打开,能识别成同一人吗? | |
| **访问记录不能说明什么** | |
| 现有规则「取得访问地址 ≠ 已发送给客户」是否属实? | |

## 5. 待跟进与最近活跃 `customer_tracking_*`

| 问题 | 填写 |
|---|---|
| 「待跟进客户」的判定规则(多久没动算待跟进?) | |
| 「最近活跃」怎么算?时间窗口多长? | |
| 有效现场讲解算不算「活跃」? | |
| 什么叫「有效」现场讲解?(时长门槛?) | |
| 客户有状态吗?(新/跟进中/已成交/流失)各自含义 | |
| **跟进记录不能说明什么** | |

## 6. 失效判定与页面状态 `page_validate`

| 问题 | 填写 |
|---|---|
| 页面有哪些状态?(草稿/已发布/已下线/失效…) | |
| 各状态下能做什么、不能做什么 | |
| 素材下线后,引用它的页面算失效吗? | |
| 失效是系统自动判定还是人工标记? | |
| 已失效的页面还能发给客户吗? | |
| 素材有哪些状态?下线和删除的区别 | |
| 素材的内部预览地址能不能发给客户?(现有文档说不能) | |

---

# 附:一句话确认项

| 问题 | 填写 |
|---|---|
| 销售/主管/管理员能看到的数据范围有区别吗?接口是否已按角色管控? | |
| 除已列出的以外,还有哪些「绝不允许的推断」? | |
| 有没有合规或法律层面的红线(个人信息、购买力推断等)? | |