AIPA-120 · P2 作品集

Agent 架构 Lab

三个驱动现代 AI Agent 平台的核心架构装置，在浏览器里用真实的纯 TS 逻辑驱动的交互式教学模拟： Durable Execution（运行步骤 → 注入崩溃 → 从 checkpoint 断点续跑）、语义缓存（输入查询 → 精确/语义命中或未命中 → 命中率曲线）、 MCP 工具注册（注册工具 → 发现 → 调用，看 JSON-RPC 报文）。三个面板都用 src/agent/* 下已通过单元测试的真实装置逻辑驱动，确定性、可离线、可截图复现。

⚠️ 教学模拟说明：checkpoint 只在内存里（真持久化需后端 durable store + thread_id）；语义相似度用 token 重叠 (Jaccard) 近似余弦（真实系统用 embedding + 向量库）； MCP 只复刻进程内协议形状（JSON-RPC + tools/list + tools/call + schema 校验），不含 HTTP transport / OAuth。重在演示「语义正确性」而非生产持久化。

LangGraph 式 checkpointing：运行步骤 → 注入崩溃 → 从最近 checkpoint 断点续跑，幂等重放保证结果不变。

StateGraph 状态机（5 步 durable 工作流）

每步成功后落 checkpoint（绿）。注入崩溃（红）后，从最近 checkpoint 断点续跑（青）。

debit

扣款从付款方账户扣减（整数分，幂等置位）

→

fx-lock

锁汇率锁定换汇报价，避免滑点

→

route

路由代理行选定代理行并发送报文

→

credit

入账收款方账户入账

→

notify

通知回执双方完成通知

durable store 最近 checkpoint：v2 · completedSteps=2 · last=fx-lock

崩溃命中 step #2 (算后未落盘)

「算后未落盘」语义：step #2 的 reducer 已算出新 state，但 checkpoint 尚未写入即崩溃 → 恢复后必须重做该步。因 reducer 幂等，重放不会双扣/双记账。

reducer 执行序列（at-least-once 重放）

debitfx-lockroute