01 结论先行

EdgeOne Makers · 模型之上,基建该买就买

会说话不够
会动手还得有底座

口播生产难点不在业务逻辑,在外围基础设施——胶水工程别让业务团队买单。

前两场立「纪律与编制」;这场解决 Runtime / 沙箱 / Store / 观测 / 模型网关 谁供。
研发定规矩与验证权,高频无差异基建优先平台化。

30 万+ 开发者选择 Makers 牛赞 · EdgeOne 高级研发 老李 · 架构师 / 研发 Leader
顶:业务只写领域循环
中:handler(context) 收口
底:五层运行时基建
落:买建先算账
下一页先给听课地图:Why → What → How → Do
02 听课地图

全场叙事 · 先给路线,再进细节

按一条线听:胶水税 → 五层能力 → context 契约 → 买建行动

口播别当四章目录——这是讲解顺序,后一步只服务前一步的问题。

1

Why 胶水税

情境:前两场立纪律。
冲突:Demo 三天,上线两周搓胶水。
判据:高频 / 无差异 / 系统级。

2

What 五层 + 目录

单一 handler(context)。
五大能力边界。
agents/ vs cloud-functions/。

3

How context 契约

四种场景选刀。
Store 唯一事实源。
粘性与无状态划分。

4

Do 买建行动

三条命令摸水位。
三层分工 + 防锁定。
starter 跑通本地 trace。

先从 Why 开始:Runtime / 沙箱 / Store / 观测 / 网关——谁供?
03 ① Why · 情境

为什么 · 前两场立纪律,这场补运行时

Harness 定了规矩:跑起来谁供五层基建?

口播先对齐分工——研发管 Spec/Rule/验证权;Runtime 以下高频无差异的,别每个业务线重复造。

① 第一场Harness 纪律
→
② 第二场编制与本体
→
③ 第三场运行时基建
→
④ 动作平台化优先
支撑 A · 五层清单

外围基建,不是业务逻辑

  • Runtime — 托管 Agent 循环与路由
  • Sandbox — 隔离执行浏览器/代码/Shell
  • Store — 多轮记忆与跨副本持久化
  • OTel — 零埋点可观测,本地线上同构
  • 模型网关 — 统一鉴权、限流、切厂商
支撑 B · 老李定位

规矩在研发,马力在平台

业务可否上线仍由你们的门禁说了算;平台提供可观测与隔离,验证权不外包。

分工清楚了——下一页看冲突:Demo 很快,上线为什么卡在胶水?
04 ① Why · 冲突

为什么 · 最耗人的往往不是 Prompt

Demo 三天,上线两周:在搓胶水

口播客服 Agent 典型路径——业务代码三天完,上线前卡在沙箱隔离、多轮记忆、trace、Key 轮换。

① 业务领域逻辑 3 天
→
② 上线前沙箱 / 记忆 / trace
→
③ 结果胶水 2 周
平台化判据含义现场例子
高频每个 Agent 都要用会话存储、模型调用、工具 trace
无差异化不构成业务竞争力沙箱隔离、Key 轮换、路由
系统级影响稳定性与合规观测、审计、配额、扩缩
Why 结束:胶水税该平台交。下一页直接给答案——单一入口。
05 ② What · 答案

是什么 · 入口极简,框架可以吵

不绑 SDK:单一 handler(context)

口播答案就这一行——业务只写领域循环,基建从 context 拿,不锁在某个框架品牌。

① 先讲反面

每业务线自建五层 → 胶水税

  • Runtime 第三套前先算运维人年
  • 沙箱、Store、OTel 各写一遍
  • 框架选型吵完,基建还没齐
② 再讲正面

handler(context) → 只写领域

  • Web 与 Agent 同仓同域
  • 契约锁在 context,不锁框架
  • 模型走网关,副作用走 tools/sandbox
业务逻辑领域循环
→
单一入口handler(context)
→
平台供Runtime · Sandbox · Store
→
平台供OTel · 模型网关
有了入口——下一页划清边界:五层能力各管什么。
06 ② What · 边界

是什么 · 五层基建,手脑分离

平台交什么:Runtime / Sandbox / Store / OTel / 网关

口播从上往下念五层——Runtime 编排,Sandbox 执行,状态外置 Store,观测零埋点,模型走统一网关。

能力要点Leader 关注点
托管 Runtime手脑分离:编排 vs 执行;状态外置会话路由、超时、扩缩
沙箱工具平台工具 vs 自选沙箱;生命周期绑会话 ID隔离级别、副作用边界
对话 Store分布式持久化;跨副本;多框架适配消息格式、迁出成本
可观测 OTel零埋点 trace;本地与线上同构模型调用与工具链 span 可见
内置模型网关统一协议;环境变量切厂商鉴权、限流、审计
五层齐了——下一页看机制:两种目录,边界写进文件夹。
07 ② What · 机制

是什么 · 文件夹即架构决策

目录即架构:agents/ 粘性 vs cloud-functions/ 无状态

口播LLM 循环进会话目录,纯 IO 进无状态目录——混写必糊边界,Store 是唯一事实源。

①

agents/

Session 模式 · 会话粘性。
LLM 循环、长任务、沙箱。
同一 conversation_id 打同一实例。

②

cloud-functions/

Request 模式 · 无状态。
查询、Webhook、短 API。
读持久化 Store,不共享会话内存。

小结

Web 与 Agent 同仓同域;契约锁 context,不锁框架品牌

禁 跨目录偷读内存
源 Store = 唯一事实源
粘 长对话要续期与空闲回收
态 无状态函数不共享会话态
What 收束:五层 + 两目录。下一页进 How——四种场景怎么选刀。
08 ③ How · 场景

怎么选 · POC 用平台,不等于全公司绑死

四种场景,别拿错刀

口播从左到右念四种落地路径——Leader 决策看验证速度与存量架构,不是一刀切绑平台。

1

新建 SaaS Agent

模板 + 三条命令。
最快验证业务价值。

2

已有网站接入

加 AI 层。
不掀存量架构。

3

建站平台基座

多租户 / OpenAPI。
对内平台能力复用。

4

企业内落地

SSO / 审计 / 授权。
与研发门禁对齐。

边界提醒

已有重 K8s 且强合规私有化的,先边缘侧试——别一上来赌迁出。

场景选好了——下一页打开 context 契约:事实源只有一个。
09 ③ How · 契约

怎么编 · context 是平台契约

事实源只有一个:Store,别偷读内存

口播按 context 六件套往下讲——request、env、store、tools、sandbox、tracer;粘性与无状态各走各的目录。

契约context
→
入参request
→
密钥env
→
事实源store
→
副作用tools · sandbox
→
观测tracer
划分走哪规则
粘性agents/ · LLM / 沙箱同 conversation_id 复用实例;长对话要续期
无状态cloud-functions/ · 查询 / Webhook读 Store,不共享会话内存
验证权研发门禁平台供观测与隔离;业务可否上线你们说了算
How 收束。下一页进 Do:三条命令 + handler 长什么样。
10 ④ Do · 摸水位

怎么落 · 先跑通,再谈选型会

三条命令 + handler:15 分钟首条多轮对话

口播按顺序念命令——create 脚手架、dev 本地 trace、deploy 拿 Runtime/路由/存储/观测/模型。

1

create

edgeone makers create --template openai-agents-starter-node

2

dev

edgeone makers dev — 本地与线上同构 trace

3

deploy

edgeone makers deploy — 自动获得五层基建

export default async function handler(context) { const { request, store, tools, sandbox, tracer, env } = context; const span = tracer.startSpan('agent-turn'); const history = await store.getMessages(); // 领域逻辑:模型走网关,副作用走 tools/sandbox await store.addMessage(/* response */); span.end(); return Response.json({ ok: true }); }
命令会了——下一页给三层分工与防锁定清单。
11 ④ Do · 分工

怎么落 · 规矩在研发,马力在平台,场景在业务

三层分工 + 防锁定:POC 期就封装 Store

口播框架可搬,平台契约难搬——迁出估算:业务 1–2 天,基建 1–2 周;锁定点在 store 格式、工具适配、路由、沙箱签名。

①

纪律与验证权

研发 Leader。
规则真源、门禁、案例账。

②

运行时基建

平台(可外购)。
Runtime / 沙箱 / Store / 观测 / 网关。

③

领域逻辑

业务团队。
handler 内业务循环。

防锁定动作验收
Store 读写封成独立模块迁出路径可写
工具适配薄封装业务不直接依赖平台细节
POC 期对照自建成本运维人年账算得清
分工与防锁定齐了——最后一页:洞见三条 + 唯一行动。
12 收束回顶

带走 · 洞见三条 → 唯一 CTA

买建先算账:基建该买就买

口播先复述三条洞见,再留一个行动号召——别开会空谈,先跑通本地 trace。

① 平台化判据 = 高频 × 无差异 × 系统级
② 目录即架构:agents/ 粘性 vs cloud-functions/ 无状态
③ 零埋点 OTel = 本地线上同构 trace · 隐性胜负手
1

选型

五层对照自建成本

2

脚手架

create → dev

3

架构

目录拆分清晰

4

观测

完整 trace 可见

5

防锁定

Store 薄封装

用 starter 跑通一次本地 trace,再开「自建还是上平台」的会。