Files
Partner/doc/design/first-encounter-module.md

8.0 KiB
Raw Blame History

First Encounter Module / 初见模块设计草案

背景

Partner 当前已经不是“不能跑”的项目,但用户面对一个新的 agent 时,仍然会有明显的启动成本。

这个启动成本不完全来自工程状态,而来自互动预期的不确定:

  • 不知道该怎么和它说话;
  • 不知道它知道什么、不知道什么;
  • 不知道它会不会误解用户;
  • 不知道它能不能被纠正;
  • 不知道纠正之后会不会真正改变后续行为。

因此Partner 需要一个“初见模块”。

它解决的不是程序启动问题,而是关系和预期建立问题。

定位

初见模块不应该只是 InitModule

InitModule 更像加载配置、初始化资源、检查运行状态;而初见模块面对的是用户第一次或重新面对 Partner 时的交互问题。

因此,代码层可以命名为:

FirstEncounterModule

产品/概念层称为:

初见模块

它的职责是:

在新用户、长时间未使用、上下文断裂、版本升级,或用户主动询问“你现在知道我什么”时,组织一次清醒、温和、可校准的开场。

与 Impression 模块的关系

初见模块应当依托 Impression但不属于 ImpressionCore。

边界如下:

ImpressionCore
  负责存储、召回、更新关于用户、agent 自身、关系契约、项目上下文等印象。

FirstEncounterModule
  负责判断是否进入初见/重逢模式,并将召回的印象组织成本轮对话可用的 EncounterFrame。

EncounterState
  负责记录初见流程是否已经完成,以及哪些环节已经向用户公开。

也就是说:

Impression 负责“我对你有什么印象”。 FirstEncounterModule 负责“第一次见面时,我该如何使用这些印象”。

不应把开场策略、纠错协议、对话引导逻辑直接塞进 ImpressionCore否则记忆模块会被迫承担表达和流程控制职责。

触发场景

初见模块可以在以下场景触发:

  • 新用户第一次进入;
  • 当前 session 没有足够上下文;
  • 长时间未使用后重新进入;
  • Partner 发生较大版本升级;
  • Impression 召回结果置信度较低;
  • 用户主动询问:
    • “你知道我什么?”
    • “你现在能做什么?”
    • “我该怎么和你说话?”
    • “你是不是还记得之前的事?”
  • 系统检测到当前对话存在明显预期不稳定,例如用户多次纠正 agent 的语气、事实或任务边界。

核心流程

推荐流程:

User Input
  ↓
InteractionHub
  ↓
EncounterDetector
  ↓
ImpressionRecaller
  ↓
FirstEncounterModule
  ↓
EncounterFrame
  ↓
PromptContributor / AppendPrompt
  ↓
CoreModel Reply
  ↓
ImpressionUpdater

其中:

  1. EncounterDetector 判断是否需要进入初见/重逢模式;
  2. ImpressionRecaller 召回相关印象;
  3. FirstEncounterModule 将召回结果整理成 EncounterFrame
  4. PromptContributor 将 EncounterFrame 注入模型上下文;
  5. 对话结束后,ImpressionUpdater 根据用户反馈更新印象。

EncounterFrame

EncounterFrame 是初见模块的核心输出。它不是长期记忆,而是本轮对话使用的临时认知框架。

示例结构:

data class EncounterFrame(
    val mode: EncounterMode,
    val knownAboutUser: List<ImpressionProjection>,
    val knownAboutSelf: List<ImpressionProjection>,
    val knownAboutRelationship: List<ImpressionProjection>,
    val uncertainty: List<String>,
    val correctionProtocol: CorrectionProtocol,
    val openingStrategy: OpeningStrategy
)

其中:

  • mode:当前是初见、重逢、版本升级后再介绍,还是用户主动询问;
  • knownAboutUser:关于用户的可靠印象;
  • knownAboutSelfPartner 对自身能力和边界的描述;
  • knownAboutRelationship:关于互动方式、纠错方式、语气偏好等印象;
  • uncertainty:当前不能确定的部分;
  • correctionProtocol:用户如何纠正 Partner
  • openingStrategy:本次开场应采用的表达策略。

Impression Subject 建议

为了支持初见模块Impression 可以支持一些特殊 subject

user
agent_self
relationship_contract
interaction_preference
project_context

例如:

user:
- 用户偏好技术回答直接,不喜欢客服腔。
- 用户面对陌生 agent 时会在意互动预期是否稳定。
- 用户更容易接受从一个小切口开始推进。

agent_self:
- Partner 当前不是完全成熟的 agent。
- Partner 应公开自己的已知、未知和不确定。
- Partner 不应该在缺少依据时假装熟悉用户。

relationship_contract:
- 用户可以直接纠正 Partner。
- Partner 需要区分事实错误、语气偏差、理解偏差和任务边界偏差。
- 纠正应作为后续 impression 更新的重要信号。

初见开场策略

初见模块不应一上来问很多问题,也不应假装已经充分了解用户。

更合适的开场结构是:

我现在对你还没有足够稳定的了解。

我会先说明:
- 我目前知道什么;
- 我不知道什么;
- 你可以怎么纠正我;
- 我会如何处理这些纠正。

接下来我们可以从一个很小的任务开始。

在 prompt 中可组织为:

你正在与用户进行初见/重逢式对话。

你目前可靠知道:
- 用户希望技术讨论直接、少废话;
- 用户对陌生 agent 的互动预期尚未建立;
- 用户不喜欢 agent 在缺少依据时假装熟悉。

你应该主动说明:
- 你知道什么;
- 你不知道什么;
- 用户可以如何纠正你;
- 你会如何处理纠正。

不要一次性问很多问题。
不要假装亲近。
先从一个很小的任务或对话入口开始。

EncounterState

初见模块需要少量流程状态,但这些状态不一定属于 Impression。

示例:

data class EncounterState(
    val hasIntroducedSelf: Boolean,
    val hasShownKnownUnknown: Boolean,
    val hasExplainedCorrectionProtocol: Boolean,
    val firstEncounterCompleted: Boolean,
    val lastEncounterVersion: String?
)

这些状态表示流程是否完成,而不是关于用户的长期印象。

真正应该进入 Impression 的,是对用户、关系、互动方式的理解,例如:

用户面对新的 agent 时,会担心互动预期不稳定。
用户希望 agent 明确边界,而不是一上来装熟。
用户能接受通过纠正来校准 agent。

最小实现方案

第一版可以很轻,不需要完整工程化。

建议步骤:

  1. 新增 FirstEncounterPromptContributor
  2. 新增 EncounterDetector,先用简单规则判断是否触发;
  3. ImpressionRecaller 召回 useragent_selfrelationship_contractinteraction_preferenceproject_context 相关印象;
  4. 生成一个简化版 EncounterFrame
  5. 将 EncounterFrame 注入 AppendPrompt
  6. 用户纠正后,将纠正内容作为 evidence 交给 ImpressionUpdater。

第一版不需要复杂策略模型,规则足够:

新 session + 低熟悉度 → 初见模式
长时间未使用 + 有历史 impression → 重逢模式
用户主动询问已知/未知 → 自我公开模式
多次纠正 → 关系校准模式

不做什么

初见模块第一版不做以下内容:

  • 不做完整 onboarding 表单;
  • 不一次性询问大量偏好;
  • 不把用户画像写死;
  • 不假装已经理解用户;
  • 不替代 ImpressionCore
  • 不直接负责长期记忆写入;
  • 不在每轮对话中重复自我介绍。

它只负责在关系尚未稳定时,提供一个清醒、可纠正、可继续的开场。

价值

初见模块的价值不只是“第一次使用体验更好”。

它实际上补上了 Partner 作为 agent 的一个关键能力:

在上下文断裂、长期未见、版本变化或记忆不确定时,仍然能让用户知道该如何继续与它相处。

这使 Partner 不只是一个能运行的程序,而是一个能够建立互动预期、暴露不确定性、接受校准,并逐步形成稳定关系的 agent。