前面我们有:
SessionManager
RunManager
现在不要把它们删掉。
数据库出现以后,正确关系是:
SessionManager
↓
Store
RunManager
↓
Store
Manager 继续负责:
生命周期
业务规则
状态转换
Store 负责:
SQL
写入
读取
事务
为什么不能让 AgentService 直接写 SQL?
比如:
@app.post("/runs")
def create_run():
conn.execute(...)
一开始能用。
后面 SQL 会散落在:
Route
Service
RunManager
SessionManager
维护非常痛苦。
RunManager 使用 Store
可以这样:
import uuid
from datetime import datetime, timezone
def utc_now() -> str:
return datetime.now(
timezone.utc
).isoformat()
class RunManager:
def __init__(
self,
store,
):
self.store = store
def create_run(
self,
session_id: str,
) -> str:
run_id = (
"run_"
+ uuid.uuid4().hex[:12]
)
self.store.create_run(
run_id=run_id,
session_id=session_id,
status="ready",
)
return run_id
def start_run(
self,
run_id: str,
) -> None:
self.store.update_run(
run_id,
status="running",
start_time=utc_now(),
)
def complete_run(
self,
run_id: str,
answer: str,
) -> None:
self.store.update_run(
run_id,
status="completed",
end_time=utc_now(),
answer=answer,
)
def fail_run(
self,
run_id: str,
error_type: str,
message: str,
) -> None:
self.store.update_run(
run_id,
status="failed",
end_time=utc_now(),
error={
"type": error_type,
"message": message,
},
)
这里 RunManager 完全不知道:
SQLite SQL 是什么
它只知道:
store.create_run
store.update_run
以后换 MySQL,非常容易。
SessionManager 也同理
create_session
append_message
close_session
restore_session
内部通过 Store。
为什么这叫依赖倒置?
业务层依赖的是,“我需要一个能保存 Run 的东西。”
而不是,“我必须使用 sqlite3。”
这就是接口抽象的价值。
把这个边界再向前推一步,就是让业务层依赖 Store Protocol,而不是依赖 SQLite。只要不同存储实现遵守同一套 create_run()、append_message()、log_event() 等接口,上层流程就可以基本保持不变。
![图片[1]-小节四:把 SQLiteStore 接回 SessionManager 和 RunManager——Manager 管生命周期,Store 管数据落盘-大赛人网](https://www.dsrw.com/wp-content/uploads/2026/11/image-1639.png)
这也是为什么本节虽然先用 SQLite,却不能让 SQLite 细节渗透到整个业务层。今天可以是 SQLiteStore,以后换成 PostgresStore,变化应该尽量限制在存储实现和装配位置。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END
















请登录后查看评论内容