Open Agents 待办清单功能：如何实时追踪 AI 任务进度

Open Agents 待办清单功能如何实时追踪 AI 任务进度【免费下载链接】open-agentsAn open source template for building cloud agents.项目地址: https://gitcode.com/GitHub_Trending/op/open-agentsOpen Agents 是一个用于构建云端 AI 智能体Cloud Agents的开源模板其内置的**待办清单Todo List**功能让 AI 在处理复杂任务时自动拆解步骤、实时更新状态帮助你像看进度条一样追踪 AI 任务进度。本文带你快速看懂这套AI 任务跟踪机制何时生成清单、三种状态代表什么、以及在界面上哪里能看到它。什么是 Open Agents 的待办清单功能当你让 AI 执行一个多步骤任务比如重构这个模块并跑通测试AI 不会闷头就干——它会先调用内置的todo_write工具把任务拆成一份结构化的待办清单然后边干活边更新清单。每个待办项包含三个字段对应三种状态状态含义界面表现pending尚未开始虚线圆圈in_progress正在处理同一时刻只有一个实心圆圈 箭头completed已完成带对勾的圆圈 划线文字 待办项的数据结构定义在 packages/agent/types.tstodo_write工具的完整实现位于 packages/agent/tools/todo.ts。AI 何时会创建待办清单AI 并不是对每个任务都列清单它的判断规则很清晰规则写在 packages/agent/system-prompt.ts 的系统提示词中✅ 会创建清单的场景任务包含 3 个或以上的独立步骤你一次性给了多条要求或一个需求清单涉及多个文件的改动❌ 不会创建清单的场景单文件的小修改、简单问答一步就能完成的琐事同时系统提示词强制要求 AI开始某个任务前先把它标记为in_progress完成后立即标记completed而不是攒一批再更新且同一时间只能有一个任务处于进行中——这正是你能实时看到进度的原因。在聊天界面哪里能看到待办清单待办清单在界面上出现在两个位置分别负责过程回放和实时总览1. 聊天流中的工具卡片AI 每次更新清单时聊天区会插入一张可展开的待办卡片标题会智能显示当前状态例如3 tasks updated · 1/4 done或All tasks completed。展开后可看到每一条待办的最新状态。渲染逻辑见 apps/web/components/tool-call/renderers/todo-renderer.tsx。2. 底部固定的待办面板Pinned Todo Panel这是追踪进度的核心它会从整段对话中提取最新一次的完整清单固定在聊天窗口底部显示已完成数/总数 Tasks的进度计数器比如2/5 Tasks。面板支持折叠——折叠后只显示进度和当前正在处理的任务名。关键逻辑只在有活儿在干时显示清单为空、全部完成、或还没开始动手时面板会自动隐藏忽略正在流式输出中的清单片段只有 AI 提交完整更新后才会刷新避免面板来回抖动面板与清单提取的实现位于 apps/web/components/pinned-todo-panel.tsx并挂载在会话聊天主界面 apps/web/app/sessions/[sessionId]/chats/[chatId]/session-chat-content.tsx 中。三步看懂 AI 任务进度看计数器面板头部的1/5 Tasks直接告诉你完成了多少这是最快的进度总览看高亮项实心圆 箭头的那条是 AI 此刻正在做的事虚线圆是排队等待的任务看划线项带对勾划线的任务代表已收尾AI 不会回头重做它们当面板彻底消失时通常意味着任务已全部完成或任务太简单无需清单——这本身就是AI 干完了的信号。相关源码导读想深入了解实现细节可以从这几个模块入手待办工具定义packages/agent/tools/todo.ts数据模型状态枚举与字段packages/agent/types.tsAI 使用清单的规则系统提示词packages/agent/system-prompt.ts固定面板与清单提取逻辑apps/web/components/pinned-todo-panel.tsx聊天流内待办卡片渲染apps/web/components/tool-call/renderers/todo-renderer.tsx小结Open Agents 的待办清单功能解决了一个新手最关心的问题AI 到底干到哪一步了通过todo_write工具、单一进行中任务的约束规则以及底部固定面板的实时计数器你可以像盯进度条一样追踪 AI 任务进度——清单一消失活儿就干完了。【免费下载链接】open-agentsAn open source template for building cloud agents.项目地址: https://gitcode.com/GitHub_Trending/op/open-agents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考