2a96f4c6f9
后端： 1.阶段 6 agent / memory 服务化收口 - 新增 cmd/agent 独立进程入口，承载 agent zrpc server、agent outbox relay / consumer 和运行时依赖初始化 - 补齐 services/agent/rpc 的 Chat stream 与 conversation meta/list/timeline、schedule-preview、context-stats、schedule-state unary RPC - 新增 gateway/client/agent 与 shared/contracts/agent，将 /api/v1/agent chat 和非 chat 门面切到 agent zrpc - 收缩 gateway 本地 AgentService 装配，双 RPC 开关开启时不再初始化本地 agent 编排、LLM、RAG 和 memory reader fallback - 将 backend/memory 物理迁入 services/memory，私有实现收入 internal，保留 module/model/observe 作为 memory 服务门面 - 调整 memory outbox、memory reader 和 agent 记忆渲染链路的 import 与服务边界，cmd/memory 独占 memory worker / consumer - 关闭 gateway 侧 agent outbox worker 所有权，agent relay / consumer 由 cmd/agent 独占，gateway 仅保留 HTTP/SSE 门面与迁移期开关回退 - 更新阶段 6 文档，记录 agent / memory 当前切流点、smoke 结果，以及 backend/client 与 gateway/shared 的目录收口口径
72 lines
2.7 KiB
Go
72 lines
2.7 KiB
Go
package model
|
||
|
||
// RelationType 常量描述一条新 fact 与一条旧记忆之间的关系。
|
||
//
|
||
// 四种关系：
|
||
// 1. duplicate — 完全重复，新 fact 没有新信息，旧记忆无需变动；
|
||
// 2. update — 新 fact 是对旧记忆的修正、补充或更精确表述，需要合并更新；
|
||
// 3. conflict — 新 fact 与旧记忆矛盾，旧记忆已过时，应删旧增新；
|
||
// 4. unrelated — 两者说的是不同的事情，互不影响。
|
||
const (
|
||
RelationDuplicate = "duplicate"
|
||
RelationUpdate = "update"
|
||
RelationConflict = "conflict"
|
||
RelationUnrelated = "unrelated"
|
||
)
|
||
|
||
// CandidateSnapshot 是喂给 LLM 的旧记忆候选快照。
|
||
//
|
||
// 职责边界：
|
||
// 1. 只承载 LLM 做关系判断所需的最小信息；
|
||
// 2. MemoryID 是真实 memory_id，LLM 不可见，仅供汇总决策时使用；
|
||
// 3. Score 是向量召回的相似度分数，用于多条 update 时选最优候选。
|
||
type CandidateSnapshot struct {
|
||
MemoryID int64
|
||
Title string
|
||
Content string
|
||
MemoryType string
|
||
Score float64 // Milvus 相似度分数（0 表示来自 Hash 查询）
|
||
}
|
||
|
||
// ComparisonResult 是单次"新 fact vs 一条旧记忆"的 LLM 输出。
|
||
//
|
||
// 职责边界：
|
||
// 1. 只描述 LLM 对一对比较的结果，不包含最终决策动作；
|
||
// 2. UpdatedContent/UpdatedTitle 仅在 relation=update 时有意义；
|
||
// 3. Reason 写审计日志用，便于后续复盘 LLM 判断依据。
|
||
type ComparisonResult struct {
|
||
MemoryID int64 // 被比较的旧记忆 ID
|
||
Relation string // duplicate / update / conflict / unrelated
|
||
UpdatedContent string // 仅 relation=update 时有意义：合并后的新内容
|
||
UpdatedTitle string // 仅 relation=update 时有意义：合并后的新标题
|
||
Reason string // 判断理由（写审计日志用）
|
||
}
|
||
|
||
// FinalDecision 是汇总后的最终动作。
|
||
//
|
||
// 说明：
|
||
// 1. 由确定性代码产出，不是 LLM 产出；
|
||
// 2. Action 取值复用 status.go 中已定义的 DecisionActionAdd/Update/Delete/None 常量；
|
||
// 3. TargetID 在 UPDATE/DELETE 时指向旧记忆 ID，ADD/NONE 时为 0。
|
||
type FinalDecision struct {
|
||
Action string // ADD / UPDATE / DELETE / NONE
|
||
TargetID int64 // UPDATE/DELETE 时指向旧记忆 ID
|
||
Title string // UPDATE 时的新标题
|
||
Content string // UPDATE 时的新内容
|
||
Reason string // 汇总理由
|
||
}
|
||
|
||
// UpdateContentFields 是 UPDATE 动作需要更新的字段集合。
|
||
//
|
||
// 说明：
|
||
// 1. 只包含 UPDATE 动作实际需要修改的字段，避免全量覆盖；
|
||
// 2. NormalizedContent/ContentHash 由调用方重新计算，保证一致性。
|
||
type UpdateContentFields struct {
|
||
Title string
|
||
Content string
|
||
NormalizedContent string
|
||
ContentHash string
|
||
Confidence float64
|
||
Importance float64
|
||
}
|