从开启这个专栏以来如果您每篇不落现在的您已经不知不觉学会了这么多内容了———Agent搭建、工具调用、任务编排、权限管控、持久化记忆、分布式状态存储。这些功能确实学会了也全做完了但跟敢上线之间还隔着一条生命线——这也是我们本期专栏要讲的内容在讲之前说一说背景即为啥讲这块内容我见过大量Agent项目卡在发布前夜缺少完整可观测能力线上出了事故根本定位不到是哪一步调用出错没有优雅关停机制版本发版时正在执行的任务直接中断丢失缺少灰度发布一旦全量上线问题瞬间扩散直接引发线上雪崩。本期内容就是把前面所有专栏的技术能力按照生产标准整合为一套开箱即用的上线模板同时整理出七项上线自检清单把发布风险提前堵死。生产四件套组装生产四件套组装HarnessAgent agent HarnessAgent.builder() .name(prod-agent) .model(dashscope:qwen-plus) // ① 分布式状态D6多副本共享状态文件系统 .distributedStore(RedisDistributedStore.fromJedis(jedis)) .filesystem(new RemoteFilesystemSpec() .isolationScope(IsolationScope.USER) .anonymousUserId(_default)) // ② 可观测全链路 Trace模型/工具/子Agent调用 .middlewares(new OtelTracingMiddleware(my-agent-service, prod)) // ③ 记忆压缩大结果卸载D5 .compaction(CompactionConfig.builder() .triggerMessages(50).keepMessages(20).build()) .toolResultEviction(ToolResultEvictionConfig.defaults()) // ③ 权限 DEFAULT危险操作必须人审D4 .permissionContext(PermissionContextState.builder() .mode(PermissionMode.DEFAULT).build()) // ④ 平滑关停停机先把进行中任务收尾不丢状态 .build(); GracefulShutdownManager shutdownManager GracefulShutdownManager.builder() .timeoutSeconds(30).build(); shutdownManager.register(agent);上线前七道检查——请逐条打勾RuntimeContext 必带 userIdsessionId防串话缺一个就废状态已外部化Redis/MySQL 分布式存储不是本地文件多副本下本地文件必炸IsolationScope 选对生产用 USER 或 SESSION记住改了不迁移旧数据上线前定死权限 DEFAULT 人审删除/退款/发消息类危险操作必须人审或 DENY远程文件系统禁 java.nio.Files必须走agent.getWorkspaceManager()tools.json 白名单未列出的内置工具不暴露给模型很多人漏掉这条等于把后门开着灰度上线先小流量Otel 盯 P50/P99异常即回滚。自定义中间件是生产里绕不开的能力——比如记录每次 Agent 调用耗时接 Prometheusstatic class TimingMiddleware extends MiddlewareBase { Override public MonoMiddlewareResult onAgent(MiddlewareContext context) { long start System.currentTimeMillis(); return context.getNext().apply(context) .doOnNext(r - System.out.println( [Timing] (System.currentTimeMillis() - start) ms)); } }我的观点Agent 项目和传统后端最大的区别是不确定性——模型输出不可穷举所以能不能上线的标准不是功能做完而是出事了能不能发现、能不能止损。可观测、人审、白名单、灰度全是围绕这个核心。把七道检查背下来你就是团队里那个敢对上线负责的人。面试话术模板“我基于 AgentScope 完成 Agent 生产落地RedisDistributedStore RemoteFilesystemSpec 实现多副本共享状态与用户级文件隔离OtelTracingMiddleware 接入全链路可观测PermissionMode.DEFAULT 强制危险操作人审GracefulShutdownManager 保障停机不丢任务沉淀上线前七道检查清单串话/状态/隔离/权限/文件系统/工具白名单/灰度。” 落地资源推荐跑AgentScope的多Agent应用更吃服务器资源建议使用云服务器能大大减少我们做其他事的精力提高学习代码的专注力和学习AI的效率免除后顾之忧新用户首年特惠专属渠道https://www.aliyun.com/daily-act/ecs/activity_selection?userCodefzoabro9无需求忽略。领取完整工程找到图片上的水印即Java-AI工程师然后在练练打字打出【AgentScope】即可下期预告当然不只有这一个中间件——OtelTracingMiddleware它不过是冰山一角所以下期我们讲给Agent加限流、降级、动态提示词中间件体系 模型降级后端看了都说对