会话执行
看懂任务执行页,并在关键节点与 Agent 协作。
会话是 Poco 追踪任务上下文的基本单位。一次会话里可以有多次运行:第一次提交是一次运行,完成后继续追问又会创建新的运行。系统会保证同一会话内不会同时执行多个活跃运行,避免上下文和工作区互相覆盖。
会话页不是只看最终回复的地方。重要任务要同时看消息、Todo、工具调用、时间线、文件变化和人工确认卡片。
会话页怎么看
| 区域 | 说明 |
|---|---|
| 消息区 | 展示你和 Agent 的对话,以及执行过程中的说明 |
| 状态栏 | 展示排队、运行、完成、失败、停止,以及当前能力配置 |
| Todo | 展示 Poco Agent 当前拆解出的步骤 |
| 时间线 | 展示预备阶段、状态变化、工具调用、用量、错误等关键事件 |
| 电脑面板 | 查看浏览器或执行环境的实时画面与回放 |
| 产物面板 | 查看文件变化、预览结果和下载文件 |
常见状态
| 状态 | 含义 | 你可以做什么 |
|---|---|---|
| 等待中 | 任务已创建,等待调度或准备运行环境 | 等待,或检查调度服务是否正常 |
| 运行中 | Poco Agent 已开始执行 | 观察 Todo、工具调用和文件变化 |
| 已完成 | 本次运行正常结束 | 检查最终回复和产物 |
| 失败 | 执行中出现错误 | 查看最后一条错误、工具日志和时间线 |
| 已停止 | 用户手动停止,或系统取消执行 | 总结已完成内容,再决定继续或新建会话 |
任务从创建到运行前,会经历环境、Skills、MCP、插件、Subagents、附件等准备阶段。准备阶段耗时取决于能力数量、附件大小和容器启动速度。长时间停留在等待中时,优先检查调度服务、执行服务、对象存储和能力配置。
执行页主要通过实时事件刷新。网络断开或事件短暂延迟时,页面会在终态后再次拉取会话数据做校准。因此任务完成后,状态、用量、文件清单可能会分批更新。
人工确认
Poco Agent 在关键节点可能请求你确认,常见有两类:
| 类型 | 你需要做什么 |
|---|---|
| 计划审批 | 判断计划是否合理,批准后 Agent 才继续执行 |
| 用户问答 | 回答 Agent 对需求、权限、业务规则或选项的提问 |
计划审批建议重点看:
- 是否覆盖你的目标。
- 是否修改了不该修改的范围。
- 验证方式是否足够。
- 是否有明显过度设计。
如果计划不合理,直接拒绝并说明调整方向。
用户问答通常有倒计时。超时后,Poco Agent 可能按默认判断继续、放弃当前动作或结束运行。看到问答卡片时,尽量一次性回答完整,避免只回答其中一半。
继续追问
任务完成后,可以继续在同一会话中追问,例如:
很好。请基于刚才生成的文档,再补一节“常见故障排查”,保持同样风格。适合继续追问的场景:
- 结果基本正确,只需要补充或调整。
- 希望基于已有产物继续迭代。
- 需要解释刚才的执行过程。
不适合继续追问的场景:
- 初始目标已经完全改变。
- 前面上下文有误,继续会放大偏差。
- 需要全新的仓库、浏览器、MCP、Skills、插件或 Agent 配置。
场景 Agent 会话的能力配置通常是锁定的。如果你需要临时换能力,优先从新任务入口重新发起一次对话,或回到 Agent 配置中调整后再发起任务。
停止与分叉
停止任务适合用于:
- Agent 明显走错方向。
- 执行范围超出预期。
- 任务成本过高或耗时过长。
- 你发现输入需求有严重错误。
停止后,系统会尽量保存已产生的消息、工具记录和文件变化。停止不是撤销,已经写入工作区的文件仍需要你检查。
分叉会话适合保留当前上下文,同时尝试另一条路线。例如一个方案生成后,你想让 Poco Agent 用另一种技术栈再做一版。分叉后的会话首次执行完成后可以继续分叉,形成多级且相互独立的探索路径。
系统不会为每一级分支重复复制全部历史消息。读取分支时,会沿直接父会话逐级解析,并按每一级创建分支时的消息位置裁剪出完整可见历史。工作区只复制直接父分支的一份快照;当前分支产生自己的文件后,后续分叉直接以当前分支为来源。
分享与创建副本
空闲会话可以从消息区标题栏生成需要登录后访问的分享链接。访问者可以只读查看源对话的最新消息、工具记录和已同步产物;点击 从此对话继续 后,系统才会固定当前快照,并在访问者账号下创建独立的根会话。
副本会尽力复制对话历史、工作区产物和文件能力,但不会复制 MCP 鉴权、仓库凭证或用户凭证。源对话运行期间仍可查看分享内容,但不能创建副本。
完整操作步骤、复制范围和安全边界,请阅读 分享与继续探索。
排查失败
任务失败时,按下面顺序看:
- 最后一条错误消息。
- 失败前的工具调用。
- 是否缺少环境变量、凭证、仓库权限或浏览器登录态。
- 任务输入是否过于模糊。
- 是否需要人工确认但超时未回答。
- 相关 MCP 或 Skill 是否启动失败。
- 附件是否过大、路径是否不符合预期。
示例追问:
请基于刚才失败的日志,说明失败原因、已完成的步骤和下一次重试前需要我补充什么。如果失败原因是缺少环境变量,先到环境变量页面补充,再重新发起运行。不要把密钥直接写进会话消息。
如果失败原因是浏览器登录态失效,先在远程浏览器重新登录,再重试需要网页访问的任务。
使用技巧
- 不要只看最终回复,重要任务要检查工具调用和文件变化。
- 看到 Agent 偏离目标时尽早纠正,越早干预成本越低。
- 计划审批不是形式,要认真确认修改范围和验证方式。
- 失败会话也有价值,可让 Agent 总结失败原因后再新建任务重试。
- 同一会话适合连续迭代同一目标,不适合长期混用多个主题。
- 文件产物完成后,等待工作区导出状态变为 ready,再下载、分享或发布。