Agent 上线别从搭沙箱开始——平台化基建该买就买

现场记录 · 腾讯云架构师城市沙龙·深圳 2026-07-18
分享：牛赞（腾讯云 EdgeOne 高级研发）·《开箱即用的 AI Agent 平台 - EdgeOne Makers Agents》
角色视角：老李 · 架构师 / 研发 Leader —— 研发 Harness 定规矩，运行时基建别每个业务重复造

封面：会说话不够，会动手还得有底座

胶水工程，别让业务团队买单。

前两场解决「纪律与编制」；这场解决「跑起来谁供沙箱、记忆、观测」。现场一刀：生产难点不在业务逻辑，在外围基础设施。 幻灯片标 30 万+ 开发者选择 Makers。

老李的定位：研发体系负责 Spec/Rule/验证权；Runtime / 沙箱 / Store / 观测 / 模型网关——高频、无差异、系统级的，优先平台化，好让业务方专注领域逻辑。

一、痛点：Demo 三天，上线两周在搓胶水

最耗人的往往不是 Prompt。

客服 Agent 常见路径：业务代码三天完，上线前卡在沙箱隔离、多轮记忆、trace、Key 轮换。这类能力符合平台化判据——高频、无差异化、系统级。

入口极简：单一 handler(context)，不绑死某一 SDK。框架可以吵；胶水道具不该每个业务线付一遍。

二、是什么：五大能力 + 两种目录

文件夹即架构决策。

小结：Web 与 Agent 同仓同域；契约锁在 context，不锁在某个框架品牌。

三、为什么用：四种场景，别拿错刀

POC 用平台，不等于全公司绑死。

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

四、架构：context 是平台契约

事实源只有一个，别偷读内存。

粘性路由省延迟，也带来并发与空闲回收——长对话要续期策略。无状态函数读持久化 Store，不共享会话内存。

这和研发侧「验证权在人」不冲突：平台提供可观测与隔离，业务可否上线仍由你们的门禁说了算。

五、安装：三条命令摸清水位

先跑通，再谈选型会。

npm i -g edgeone
edgeone makers create --template openai-agents-starter-node
edgeone makers dev
edgeone makers deploy

文档：Makers Agents。部署后自动获得 Runtime、路由、存储、可观测、模型能力。

六、实战：业务 handler 只写领域循环

基建交给平台，领域留给业务。

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 });
}

Leader 关注锁定点：store 格式、工具适配、路由配置、沙箱签名。迁出估算：业务 1–2 天，基建 1–2 周——所以 POC 期就要把 Store 读写封成模块。

七、洞见三条（买与建）

洞见 1：平台化判据——高频、无差异、系统级

研发自建第三套 Runtime 前，先算运维人年，再谈「自主可控」面子。

洞见 2：目录即架构，混写必糊边界

LLM 循环进 agents/，纯 IO 进无状态目录；以 Store 为唯一事实源。

洞见 3：零埋点观测是隐性胜负手

本地能跑、线上不可见——平台若已抹平，就别再半套自建。

八、总结与行动

规矩在研发，马力在平台，场景在业务。

方法论速查表

行动号召： 用 starter 跑通一次本地 trace，再开「自建还是上平台」的会。

现场印证问答

Q1：粘性与无状态怎么划？
LLM/沙箱走会话目录；查询走无状态；未落库状态别跨目录偷读。

Q2：多框架兼容的锁定代价？
框架层可搬，平台契约难搬。POC 期封装 Store。

九、金句提炼

十、概念与工具速查

十一、小结：模型之上的工程与架构

怎么理解这场。 这里的「模型之上」是运行时与平台契约：沙箱、会话存储、可观测、模型网关属于高频无差异基建，不该让每个业务线重复交税。架构上用 handler(context) 收口，用目录区分会话态与无状态，用 Store 做唯一事实源——框架可以换，平台边界要算清楚。研发定规矩与验证权，平台供马力，业务只写领域循环。

收获提炼。

1. 平台化判据：高频、无差异、系统级——先算运维人年再谈自建 Runtime。
2. 目录即架构：会话循环与无状态 IO 必须拆开。
3. 本地与线上同构的 trace，是 Agent 上线的隐性胜负手。
4. POC 期封装 Store/工具适配，降低「框架可搬、契约难搬」的锁定成本。

现场照片：images/3/raw/raw_*.png（原图全量嵌入正文）
文档：https://pages.edgeone.ai/zh/document/agents