b1eb6bedf9
后端： 1.新建conv/schedule_persist.go：ScheduleState Diff 持久化，事务内逐变更写库，支持 place/move/unplace 三种操作（当前 event source） 2.新建conv/schedule_provider.go：ScheduleState 加载适配，从 DB 合并 existing events + pending task items 3.新建dao/agent_state_store_adapter.go：Redis 状态快照存取适配，实现 AgentStateStore 接口 4.新建service/agentsvc/agent_newagent.go：newAgent service 集成层，串联 LLM 客户端、ScheduleProvider、SchedulePersistor 和 ChunkEmitter 5.更新node/execute.go：接入 SchedulePersistor（写操作确认后持久化）、完善 confirm resume 路径（PendingConfirmTool 恢复分支）、correction 机制增加连续失败计数上限 6.更新api/agent.go + cmd/start.go：接入 newAgent service，完成 API 层路由注册 7.新建node/execute_confirm_flow_test.go + llm_tool_orchestration_test.go：确认回路 7 个测试 + 端到端排课 5 个测试全部通过 8.新建newAgent/ARCHITECTURE.md + ROADMAP.md：全链路架构文档和缺口分析 9.代码审查整理：提取 prompt/base.go（通用 buildStageMessages 等5个辅助）、tools/args.go（参数解析辅助）；write_tools 尾部辅助移入 write_helpers；修复 queryRangeSpecific sb.Reset() 逻辑缺陷和 Unplace guest Duration 未恢复；ScheduleStateProvider/SchedulePersistor 归入 state_store.go；emitter 内部 Build*Text 函数降级为私有 前端：无 仓库：无
68 lines
2.8 KiB
Go
68 lines
2.8 KiB
Go
package model
|
||
|
||
import (
|
||
"context"
|
||
|
||
newagenttools "github.com/LoveLosita/smartflow/backend/newAgent/tools"
|
||
)
|
||
|
||
// AgentStateSnapshot 是需要持久化的 agent 运行态最小快照。
|
||
//
|
||
// 设计说明：
|
||
// 1. 只保存恢复执行所需的 RuntimeState 和 ConversationContext；
|
||
// 2. 不保存 Request（每轮请求级，天然不跨连接）；
|
||
// 3. 不保存 Deps（依赖注入，每次由 Service 层重建）；
|
||
// 4. 不保存 ToolSchemas（每次请求由 Service 层重新注入）。
|
||
type AgentStateSnapshot struct {
|
||
RuntimeState *AgentRuntimeState `json:"runtime_state"`
|
||
ConversationContext *ConversationContext `json:"conversation_context"`
|
||
}
|
||
|
||
// AgentStateStore 定义 agent 状态持久化的最小接口。
|
||
//
|
||
// 职责边界：
|
||
// 1. 只负责"存 / 取 / 删"三个原子操作；
|
||
// 2. 不负责序列化细节（由实现层决定 JSON / protobuf）；
|
||
// 3. 不负责业务级状态校验，校验仍在 node / graph 层完成。
|
||
//
|
||
// 实现层：
|
||
// 1. dao/cache.go 上的 CacheDAO 隐式实现该接口（Go duck typing）；
|
||
// 2. newAgent 包不直接 import dao，由 Service 层在组装 Deps 时注入。
|
||
type AgentStateStore interface {
|
||
// Save 序列化并保存一份 agent 状态快照。
|
||
//
|
||
// 语义：
|
||
// 1. 同一 conversationID 被覆盖写入，保证 Redis 里始终只有最新快照；
|
||
// 2. 实现层应设 TTL，避免已完成的任务快照永不清理。
|
||
Save(ctx context.Context, conversationID string, snapshot *AgentStateSnapshot) error
|
||
|
||
// Load 读取并反序列化 agent 状态快照。
|
||
//
|
||
// 返回值语义：
|
||
// 1. (snapshot, true, nil)：命中快照，正常返回；
|
||
// 2. (nil, false, nil)：未命中，不是错误，调用方应走新建对话路径；
|
||
// 3. (nil, false, error)：真正的存储层错误。
|
||
Load(ctx context.Context, conversationID string) (*AgentStateSnapshot, bool, error)
|
||
|
||
// Delete 删除指定会话的 agent 状态快照。
|
||
//
|
||
// 语义：
|
||
// 1. 删除是幂等的，key 不存在也视为成功；
|
||
// 2. 典型调用时机：Deliver 节点任务完成后清理。
|
||
Delete(ctx context.Context, conversationID string) error
|
||
}
|
||
|
||
// ScheduleStateProvider 定义加载 ScheduleState 的接口。
|
||
// 由 DAO 层或 Service 层实现，注入到 AgentGraphDeps 中。
|
||
// 使用接口而非具体 DAO 类型，避免 model → dao 的循环依赖。
|
||
type ScheduleStateProvider interface {
|
||
LoadScheduleState(ctx context.Context, userID int) (*newagenttools.ScheduleState, error)
|
||
}
|
||
|
||
// SchedulePersistor 定义持久化 ScheduleState 变更的接口。
|
||
// 由 Service 层或 DAO 层实现，注入到 AgentGraphDeps 中。
|
||
// 使用接口而非具体 DAO 类型，避免 model → dao 的循环依赖。
|
||
type SchedulePersistor interface {
|
||
PersistScheduleChanges(ctx context.Context, original, modified *newagenttools.ScheduleState, userID int) error
|
||
}
|