Day 034｜做一个最小 Agent 面板：用户需要看见进度和结果

系列100 天系统学习 AI Agent 开发当前阶段LangChain 与 LangGraph 工程化今日目标Agent UI 要展示任务状态、已调用工具、需要用户确认的动作和最终输出。1. 先给结论进入「LangChain 与 LangGraph 工程化」之后我明显感觉 Agent 开发不只是 Prompt 技巧了。Agent UI 要展示任务状态、已调用工具、需要用户确认的动作和最终输出。 这件事越早建模后面流程越不容易散。2. 从工程视角看状态把任务进度、用户上下文、工具结果和错误信息显式保存。节点每个节点只处理一个清晰步骤便于调试和替换。路由用条件边或规则决定下一步关键路径不要完全交给模型猜。3. 动手清单今天的主任务是画一个页面草图输入区、事件流、审批按钮、结果区、错误提示。我会按这个节奏做先画状态再写节点最后补路由条件。完成主题任务画一个页面草图输入区、事件流、审批按钮、结果区、错误提示。检查每个节点的输入、输出、失败处理和是否需要 checkpoint。4. 最小可交付物今天可以留下一个最小状态图先把流程跑顺是否用户输入解析任务状态是否完整调用工具或生成结果追问补充信息记录状态和输出5. 避坑笔记我把「做一个最小 Agent 面板」当成一次小型技术评审来看。不是看文章写得顺不顺而是看它能不能经得起追问。追问今天的回答读者能带走什么读者看完能把一个长任务拆成可恢复的工作流我留下了什么证据一个状态图、节点表或 checkpoint 草案哪个地方最容易翻车Agent 不是普通聊天框。长任务、审批和失败恢复需要专门的交互设计。下一步怎么接把今天的状态模型接到评测、审批或持久化里面试官会追问Agent UI 最重要的不是聊天框那是什么是让用户看见“现在发生什么、下一步会发生什么、我还能控制什么”。最小面板应显示阶段、证据引用、工具事件、待审批动作、取消入口和可理解错误而不是播放一段假的思考动画。高风险动作必须用 diff 或结构化预览呈现。例如发送邮件前显示收件人、主题、正文摘要和附件修改数据库前显示目标记录与字段变化。用户批准的是具体动作版本不是抽象的“继续”。我会做一次断网测试页面刷新后用 run_id 恢复任务已完成事件不重复待审批动作仍可处理。能通过这条测试UI 才真正连接了后台状态而不是把流式文本暂存在浏览器。今日检查清单检查标题里是否有明确技术词做一个最小 Agent 面板检查正文有没有围绕这个任务展开画一个页面草图输入区、事件流、审批按钮、结果区、错误提示。检查风险提醒是否具体到动作Agent 不是普通聊天框。长任务、审批和失败恢复需要专门的交互设计。给每个节点写清输入、输出、失败时去哪标出哪一步需要 checkpoint 或人工确认写一句“我明天会怎么继续”