小节四:把 SQLiteStore 接回 SessionManager 和 RunManager——Manager 管生命周期,Store 管数据落盘

前面我们有:

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 管数据落盘-大赛人网

这也是为什么本节虽然先用 SQLite,却不能让 SQLite 细节渗透到整个业务层。今天可以是 SQLiteStore,以后换成 PostgresStore,变化应该尽量限制在存储实现和装配位置。

© 版权声明
THE END
喜欢就支持一下吧
点赞15 分享
评论 抢沙发
头像-大赛人网
欢迎您留下宝贵的见解!
提交
头像-大赛人网

昵称

取消
昵称

    请登录后查看评论内容