Agent 沙箱集成的两种形态对比与选型
作者:问答酱2026.11.16 10:39浏览量:0简介:为准备自建 Agent 执行环境的架构师与开发者,对比"Harness 在外、Compute 在沙箱"与"决策与执行同箱"两类形态。本文从信任边界、隔离强度、状态与成本、攻击面及运维复杂度等维度拆解差异,给出场景化选型条件、迁移注意事项与分阶段落地建议。
agent-">Agent 沙箱集成的两种形态对比与选型
一、对比背景:Agent 为什么需要沙箱
大模型本身只能输出文本。要让 Agent 真正“干活”,还要让它调用工具、执行命令、读写文件、操作浏览器或桌面。这些动作一旦落在生产主机或开发者的本机上,就带来了不可信执行的问题:模型输出并不完全可控,其中可能混入提示词注入带来的指令、幻觉生成的参数或恶意内容。若执行环境与宿主环境处于同一权限域,一次误操作就可能波及凭证、源码和业务数据。
沙箱通过独立的权限域、文件系统视图和网络出口,限制不可信执行的影响范围。但对要自建执行环境的团队来说,真正的难点不是“用不用沙箱”,而是下面两个问题:
- 决策逻辑和不可信执行分别放在哪里:模型调用、工具路由、审批和会话状态属于决策侧;命令执行、文件读写、浏览器操作属于执行侧。两侧可以放在同一隔离边界内,也可以分处边界内外。
- 不同 Agent 场景需要什么样的执行环境与安全默认值:编码类、研究类、办公自动化类、浏览器操作类 Agent 对文件系统、网络出口、图形界面和会话持久化的要求差别很大,安全默认值也要随之调整。
本文对比的对象是业界常见的两类 Agent 与沙箱结合形态:
- 形态一:Harness 在外,Compute 在沙箱。 平台或应用持有会话与模型调用,经执行器或工具接口进入隔离环境执行。
- 形态二:决策与执行同箱。 决策循环与执行同处一个隔离环境,该环境往往同时作为记忆载体和计费单位。
两种形态都落在生产实践上,差别主要来自信任边界的划分方式。为便于理解,下文先统一术语,再逐维度对比差异。
二、基础概念:Harness、Compute 与 in / out / with sandbox
某主流模型平台在其 Agent 开发接口的官方文档中,把一个 Agent 系统拆成两层:
| 层 | 职责 | 常见部署位置 |
|---|---|---|
| Harness | 模型调用、工具路由、审批、会话状态、审计 | 模型平台、业务服务、IDE/CLI 本机进程 |
| Compute | 命令执行、文件读写、浏览器/桌面操作、挂载、快照 | 容器、轻量级虚拟机、浏览器会话、操作系统沙箱、自托管 runner |
业界也常用 “agent in / out / with sandbox” 来描述进程相对于隔离边界的位置:
- out:Agent 进程本身运行在沙箱之外;
- in:Agent 进程运行在沙箱之内;
- with:Agent 与沙箱搭配使用。
这一说法可以与上表对应,但单独使用时有一个局限:无法区分“只有执行进了沙箱”和“决策与执行同在一个箱子里”。这两种情况在“out”或“with”的笼统描述下看起来可能一样,但在信任边界、攻击面、状态管理和成本结构上差别显著。因此,本文更建议用“信任边界画在哪一层”来描述架构:决策侧归 Harness,执行侧归 Compute;形态二则是把这条边界整体外移,连同决策循环一起包进沙箱。
从生产实践看,常见做法是让 Harness 放在可信基础设施中,让 Compute 放在隔离环境里。两者同处一个沙箱,更多见于原型验证,或者“会话环境本身就是产品”的形态,例如面向个人用户的云端编码或研究工作会话。
三、相同点:目标一致,执行面高度重叠
抛开边界差异,两种形态在以下方面是共通的:
- 运行骨架相同。 都遵循“模型推理 → 工具调用 → 观察结果 → 再推理”的循环,并由模型平台提供推理能力。
- 执行面重叠。 都依赖容器、轻量级虚拟机、云桌面或浏览器会话承载文件读写、命令执行和浏览器操作。
- 安全目标一致。 都要控制凭证访问范围、限制网络出口、实现会话隔离,并保留可供追溯的审计记录。
- 都需要处理状态问题。 会话历史、工作目录、中间产物都要面对持久化、恢复与清理。
- 都绕不开一个“逃逸”问题。 不可信内容一旦进入上下文,执行环节就要防越权、防误操作、防数据外带。为此,二者都可以叠加二次确认、人工审批、危险命令识别或网络出口白名单等通用管控。
可以理解为:两种形态共用同一套执行与管控“零件”,分歧在于这些零件围绕哪条信任边界来组装。
四、核心差异:从信任边界到运维成本
4.1 信任边界与凭证归属
形态一把主密钥、连接器凭证和高风险操作的审批留在 Harness 侧。典型例子是云端会话读取本机已连接文件夹的场景:云端会话通过桌面端中继访问已授权目录,连接器令牌并不进入沙箱;受控的企业连接器出站时统一经过代理,高风险工具还可以做进程级隔离。沙箱里拿不到主密钥,即便整个执行环境被攻陷,攻击者也只能拿到沙箱内的东西。
形态二把推理与执行整体放进同一个边界。好处是边界数量少、链路直观,沙箱内部无需额外的跨边界通信。代价是沙箱内可能同时存在会话上下文、模型调用路径乃至部分凭证或代理凭据;一旦沙箱被突破,损失面不限于一次命令执行,还可能波及上下文数据与调用通道。
4.2 隔离强度与安全默认值
两种形态都可以达到容器级乃至轻量级虚拟机级的隔离强度,真正拉开差距的是默认值:
- 形态一的默认值由 Harness 统一制定:哪些工具走沙箱、哪些走可信通道、凭证如何按需下发,都在执行器层统一约束。
- 形态二的默认值更依赖沙箱自身配置,例如出网策略、文件系统挂载范围和生命周期。一些同箱形态会为云桌面式的运行环境额外配套出网管控组件。
同一业务场景落地时,默认值收紧的程度和能否被平台强制约束,往往比隔离机制本身更影响实际安全性。
4.3 状态持久化、记忆载体与计费粒度
这是两种形态最直观的差异。
在形态一中,会话状态、对话历史与审批记录属于 Harness,通常落在数据库或持久化存储中,生命周期与应用一致;沙箱更像“一次性工作区”,任务结束即可回收。策略上还可以进一步区分临时执行与持久环境:一次性的代码执行用即用即弃的沙箱,需要多轮交互的开发环境则复用长生命周期环境,二者按策略分别调度。
在形态二中,沙箱往往同时是记忆载体和计费单位。好处是上下文、文件与工具结果天然连续,不需要额外的同步机制;代价是会话成本与环境生命周期绑定,清理不当会留下“僵尸环境”,跨会话复用记忆时也需要额外设计持久化方案。
4.4 弹性、并发与资源开销
形态一的资源开销集中在执行侧,平台侧可多路复用:一个 Harness 可以同时挂载多个 Compute,任务级创建、任务结束即销毁,并发扩缩 mainly 作用于沙箱池。多租户共享控制面时,这种“控制面轻、执行面弹”的结构在容量规划上更可控。
形态二的每个会话都自带运行环境,计费与资源占用与会话数成正比。在会话数较少、单会话任务重的场景,例如编码类或研究型 Agent,开销可接受;在高并发、短交互的场景,空载与预热开销就会放大。
4.5 攻击面与旁路工具
形态一把大部分工具纳入执行器统一管控,但“没有进沙箱的部分”依然是攻击面,主要包括:
- 部分连接器或托管工具;
- 生命周期钩子(hooks);
- 直接操作宿主文件的文件工具;
- 运行在宿主上的图形界面操控。
如果这些旁路直接落在可信侧,它们就成了绕过隔离的捷径。因此形态一需要一份“工具归属清单”,明确每个工具是走沙箱还是走可信通道。
形态二的攻击面相对集中:沙箱内几乎包含全部执行能力,出网、文件与命令都受同一个边界约束,防护清单更短。代价是边界内的破坏半径更大,所以出网白名单、快照回滚和会话隔离需要做得更扎实。
4.6 延迟与链路长度
形态一的工具调用要跨一次边界:Harness 发起请求,经执行器进入沙箱,再返回结果。链路更长,但沙箱侧无需承载推理,冷启动可以延迟到真正需要执行时再发生。
形态二的决策与执行同在一个进程或一个环境内,链路上少一跳,首次工具调用时环境通常已经就绪。代价是会话开始即需要拉起完整环境,在高频短会话中,启动开销难以摊薄。
4.7 可观测性与审计
形态一的模型调用、审批与审计集中在 Harness,容易与统一日志与告警体系对接,审计口径一致。
形态二的执行日志产生于沙箱内部,需要额外的采集通道把日志外送到集中存储;如果沙箱被污染,本地日志的可信度也会下降。此外,沙箱实例与业务会话的关联关系、异常回收策略,都需要单独运维。
4.8 接入改造与迁移成本
形态一要求应用把工具调用抽象成执行器接口,按执行风险路由到沙箱或可信通道,并维护工具归属清单。一次性改造量较大,但后续替换沙箱实现时,只需改执行器后端。
形态二改造量小:把现有 Agent 循环整体放进沙箱镜像即可起步。但它的运行逻辑与会话环境强耦合,一旦要拆出可信 Harness、接入统一审计,或把执行能力复用到其他业务,就需要重新设计边界。
4.9 关键差异对比
| 对比维度 | 形态一:Harness 在外,Compute 在沙箱 | 形态二:决策与执行同箱 |
|---|---|---|
| 信任边界 | 决策侧可信,执行侧隔离 | 决策与执行同处隔离边界 |
| 凭证位置 | 主密钥、连接器凭证留在 Harness,按需下发 | 可能随会话进入沙箱,需额外收紧 |
| 隔离对象 | 不可信执行 | 整个 Agent 会话 |
| 攻击面 | 需管理沙箱外旁路工具、钩子、宿主文件工具与图形界面操控 | 集中在沙箱内部,需强化出网与回滚 |
| 状态载体 | 会话状态在 Harness,沙箱是一次性工作区 | 沙箱同时是记忆载体与计费单位 |
| 弹性与成本 | 控制面轻,执行面按任务伸缩,便于多租户 | 成本随会话数增长,需防僵尸环境 |
| 链路与延迟 | 多一跳边界通信,冷启动可延迟发生 | 链路短,会话启动即拉起环境 |
| 审计 | 集中在 Harness,易于对接统一日志与告警 | 需额外采集通道,本地日志可信度较低 |
| 改造与演进 | 初次改造成本高,沙箱后端可替换 | 起步快,拆分边界时改造量大 |
| 更适合 | 多租户平台、企业内 Agent、凭证与审批要求高的场景 | 编码、研究等长任务,会话环境本身即产品的形态 |
4.10 示意代码:两种形态的调用路径
形态一:决策留在可信侧,工具调用按风险路由。
# Harness(可信侧):持有会话状态、凭证与审批async def handle_turn(session, user_input):history = await session.load_history()plan = await model.chat(history, user_input, tools=TOOL_SCHEMA)if plan.kind == "final_answer":await session.append(plan.message)return plan.messagefor call in plan.tool_calls:if call.tool in {"bash", "read_file", "write_file"}:# 不可信执行进入沙箱,沙箱内拿不到主密钥result = await sandbox.run_tool(session.sandbox_id, call)elif call.tool in CONNECTOR_TOOLS:# 凭证仅在可信侧使用,出站经代理并受白名单约束result = await connector_proxy.invoke(call, credentials=session.credentials)elif call.requires_approval:result = await ask_human(session, call)else:result = await local_tool.invoke(call)history.append((call, result))return await handle_turn(session, "...") # 继续下一轮推理
形态二:会话创建即环境,Agent 循环运行在沙箱内。
# 会话创建:拉起隔离环境,循环与执行同处一箱box = await sandbox.create_session(image="agent-runtime", # 内含推理客户端与执行工具egress_policy=ALLOWLIST, # 出网白名单snapshot=ON, # 支持快照与回滚)await box.upload("agent_loop.py")result = await box.exec(["agent_loop", "--task", user_input])artifacts = await box.collect() # 产物与日志需要额外外送
两段代码的能力覆盖相同,区别只在于信任边界画在哪里。在百度智能云等主流云平台上,无论选择哪种形态,底层都可以基于容器服务、轻量级虚拟化实例、云桌面、对象存储、日志服务与监控告警等通用能力来承载,差异主要体现在架构设计本身。
五、典型场景选择
- 多租户 Agent 平台、企业内部助手:多租户、强审计、凭证管理要求高,优先考虑形态一。沙箱按任务创建,Harness 统一做权限与审计。
- 云端读取本机文件、受控企业系统连接:适合形态一配合桌面中继或进程级隔离的连接器,避免把连接凭证下发到执行环境。
- 编码类、研究类 Agent:交互周期长、上下文重、需要浏览器或图形界面,形态二更自然,沙箱即工作区与记忆载体。
- “会话环境即产品”的云桌面型产品:运行环境本身就是交付物,形态二与产品形态一致;同时要配合出网管控与快照策略,防止会话滥用。
- 原型验证与内部工具:可先用形态二快速跑通;若计划产品化并面向多租户,应尽早把决策侧拆出,避免后续边界拆分成本高。
六、选型建议
选型不宜做绝对判断,可按下面的条件逐项评估:
- 看租户与凭证:多租户且需要集中管理凭证、审批与审计时,形态一更贴合;单一租户、长周期任务为主时,形态二可以接受。
- 看工具分布:工具大多可通过执行器接口调用时,形态一的收益明显;若大量工具依赖宿主环境、图形界面或本机资源,需先评估旁路工具带来的风险。
- 看成本与并发:高并发短交互场景,形态一在资源弹性和成本控制上更有优势;低频长任务场景,形态二 simpler 直接。
- 看团队能力:具备平台化运维能力,可承担执行器抽象、沙箱池管理与日志集中采集的团队,更适合形态一;人力有限、需要快速交付时,可先采用形态二并在设计上预留拆分空间。
- 看合规要求:对审计完整性、数据不出域、会话留存周期有明确要求时,优先选择能把审计落在可信侧、并能集中采集执行日志的形态。
一个常见的折中做法是“分层隔离”:Harness 常驻可信侧,常规文件与命令执行进入沙箱;高风险工具(例如企业连接器、内部系统操作)再单独做进程级隔离或经代理出站。这样既保留形态一在凭证与审计上的优势,又避免把所有执行都塞进同一个边界带来的性能开销。
七、迁移与使用注意事项
- 工具归属先盘点再迁移:先列出全部工具,标注“必须进沙箱”“可在可信侧”“需人工审批”,再决定边界位置。这一步做得粗糙,迁移后仍会留下旁路缺口。
- 会话状态迁移要成对设计:从形态二迁向形态一时,会话历史需要落到外部存储,文件与中间产物要定义同步与清理策略;反向迁移时,则要评估把审计与审批一起搬入沙箱的可行性。
- 凭证与出网策略同步收紧:迁移期间新旧两套执行路径并存,凭证发放范围和出网白名单容易顾此失彼。建议按工具粒度逐步切换,并保留回退开关。
- 接口兼容与灰度:执行器接口、工具返回结构、超时与重试语义要统一;灰度期间用影子会话比对两种形态的执行结果,观察异常率与失败原因分布。
- 可观测性提前就位:接入统一日志、指标与告警后再放量,尤其要覆盖沙箱创建失败、执行超时、出网被拒、快照失败等常见异常。
- 生命周期与容量:定义沙箱最大存活时间、空闲回收与并发上限,避免环境堆积占用配额;为峰值预留缓冲容量,并对冷启动时间做基线测量。
- 成本与账单可归因:形态二需要按会话统计资源占用,形态一需要把执行开销回算到业务方,否则成本难以优化。
- 安全默认值不要只看隔离强度:隔离再强,出网全开、凭证全下发、日志不外送,风险依旧存在。把安全默认值写成配置基线,纳入发布检查,比临时加固更可靠。
八、总结
两种形态的差别,可以归结为一句话:信任边界画在决策侧,还是把整个 Agent 会话一起包进沙箱。形态一把 Harness 留在可信侧,凭证、审批与审计集中可控,执行面按需伸缩,适合多租户与强合规场景,代价是工具归属管理复杂、链路更长;形态二让决策与执行同处一箱,起步快、上下文连续,适合长任务与“环境即产品”的会话型场景,代价是破坏半径更大、成本随会话增长、审计需要额外通道。
选型时建议回到三个问题:谁持凭证、谁做审计、谁承担扩容。回答清楚这三点,再在通用云平台能力之上做具体实现,比追逐某一种“更先进”的形态更稳妥。

登录后可评论,请前往 登录 或 注册