设计 Agent Harness 时如何划分模块?
题目
设计 Agent Harness 时如何划分模块?
参考答案
点击展开参考答案
- 我会按“控制面、执行面、数据面、治理面”划分,但先在模块化单体中实现;只有独立扩缩容、强隔离或不同 SLO 明确时再拆服务。
- Run/Session API 负责创建、查询、暂停、取消和恢复;Orchestrator/State Machine 推进状态;Planner/Scheduler 生成和调度 DAG,管理依赖、租户配额、预算和 deadline;Version Registry 固定代码、模型、Prompt、Tool 和 Policy 版本。
- Model Gateway 做能力感知路由、流式输出、限流和用量计量;Context Builder 从目标、状态、近期消息、Memory/RAG 与 Artifact 组装上下文;Tool Runtime 负责注册、Schema、参数校验、授权、幂等、重试和审计;Sandbox 隔离代码/浏览器执行;Verifier/Completion Gate 根据环境状态和证据判断完成。
- Checkpoint/Event Store 保存可恢复状态和 append-only 事件;Artifact Store 保存大文件和原始工具结果;Memory/RAG 保存可检索知识;Outbox/Event Stream 向 UI 推送带 sequence 的运行事件。
- 状态更新使用
run_id + state_version做乐观并发,Artifact 通过哈希和版本引用。 - Policy/Approval 拦截高风险动作并绑定精确参数;Credential Broker 注入短期最小权限凭证;Trace/Metric/Cost 统一可观测;Eval/Replay 负责轨迹回放和发布门禁;Admin 提供配额、审计、删除和 kill switch。
- 模型不能绕过 Tool Runtime;外部内容不能提升为系统指令;所有副作用先过策略且有幂等键;总 deadline、取消和预算逐层传播;状态转移先持久化再发事件;同一 run 绑定完整版本集合和根 trace;敏感信息不进入 Prompt、日志或 Artifact 明文。