Poco 使用手册
快速开始

会话执行

看懂任务执行页,并在关键节点与 Agent 协作。

会话是 Poco 追踪任务上下文的基本单位。一次会话里可以有多次运行:第一次提交是一次运行,完成后继续追问又会创建新的运行。系统会保证同一会话内不会同时执行多个活跃运行,避免上下文和工作区互相覆盖。

会话页不是只看最终回复的地方。重要任务要同时看消息、Todo、工具调用、时间线、文件变化和人工确认卡片。

会话页怎么看

区域说明
消息区展示你和 Agent 的对话,以及执行过程中的说明
状态栏展示排队、运行、完成、失败、停止,以及当前能力配置
Todo展示 Poco Agent 当前拆解出的步骤
时间线展示预备阶段、状态变化、工具调用、用量、错误等关键事件
电脑面板查看浏览器或执行环境的实时画面与回放
产物面板查看文件变化、预览结果和下载文件

常见状态

状态含义你可以做什么
等待中任务已创建,等待调度或准备运行环境等待,或检查调度服务是否正常
运行中Poco Agent 已开始执行观察 Todo、工具调用和文件变化
已完成本次运行正常结束检查最终回复和产物
失败执行中出现错误查看最后一条错误、工具日志和时间线
已停止用户手动停止,或系统取消执行总结已完成内容,再决定继续或新建会话

任务从创建到运行前,会经历环境、Skills、MCP、插件、Subagents、附件等准备阶段。准备阶段耗时取决于能力数量、附件大小和容器启动速度。长时间停留在等待中时,优先检查调度服务、执行服务、对象存储和能力配置。

执行页主要通过实时事件刷新。网络断开或事件短暂延迟时,页面会在终态后再次拉取会话数据做校准。因此任务完成后,状态、用量、文件清单可能会分批更新。

人工确认

Poco Agent 在关键节点可能请求你确认,常见有两类:

类型你需要做什么
计划审批判断计划是否合理,批准后 Agent 才继续执行
用户问答回答 Agent 对需求、权限、业务规则或选项的提问

计划审批建议重点看:

  1. 是否覆盖你的目标。
  2. 是否修改了不该修改的范围。
  3. 验证方式是否足够。
  4. 是否有明显过度设计。

如果计划不合理,直接拒绝并说明调整方向。

用户问答通常有倒计时。超时后,Poco Agent 可能按默认判断继续、放弃当前动作或结束运行。看到问答卡片时,尽量一次性回答完整,避免只回答其中一半。

继续追问

任务完成后,可以继续在同一会话中追问,例如:

很好。请基于刚才生成的文档,再补一节“常见故障排查”,保持同样风格。

适合继续追问的场景:

  • 结果基本正确,只需要补充或调整。
  • 希望基于已有产物继续迭代。
  • 需要解释刚才的执行过程。

不适合继续追问的场景:

  • 初始目标已经完全改变。
  • 前面上下文有误,继续会放大偏差。
  • 需要全新的仓库、浏览器、MCP、Skills、插件或 Agent 配置。

场景 Agent 会话的能力配置通常是锁定的。如果你需要临时换能力,优先从新任务入口重新发起一次对话,或回到 Agent 配置中调整后再发起任务。

停止与分叉

停止任务适合用于:

  • Agent 明显走错方向。
  • 执行范围超出预期。
  • 任务成本过高或耗时过长。
  • 你发现输入需求有严重错误。

停止后,系统会尽量保存已产生的消息、工具记录和文件变化。停止不是撤销,已经写入工作区的文件仍需要你检查。

分叉会话适合保留当前上下文,同时尝试另一条路线。例如一个方案生成后,你想让 Poco Agent 用另一种技术栈再做一版。分叉后的会话首次执行完成后可以继续分叉,形成多级且相互独立的探索路径。

系统不会为每一级分支重复复制全部历史消息。读取分支时,会沿直接父会话逐级解析,并按每一级创建分支时的消息位置裁剪出完整可见历史。工作区只复制直接父分支的一份快照;当前分支产生自己的文件后,后续分叉直接以当前分支为来源。

分享与创建副本

空闲会话可以从消息区标题栏生成需要登录后访问的分享链接。访问者可以只读查看源对话的最新消息、工具记录和已同步产物;点击 从此对话继续 后,系统才会固定当前快照,并在访问者账号下创建独立的根会话。

副本会尽力复制对话历史、工作区产物和文件能力,但不会复制 MCP 鉴权、仓库凭证或用户凭证。源对话运行期间仍可查看分享内容,但不能创建副本。

完整操作步骤、复制范围和安全边界,请阅读 分享与继续探索

排查失败

任务失败时,按下面顺序看:

  1. 最后一条错误消息。
  2. 失败前的工具调用。
  3. 是否缺少环境变量、凭证、仓库权限或浏览器登录态。
  4. 任务输入是否过于模糊。
  5. 是否需要人工确认但超时未回答。
  6. 相关 MCP 或 Skill 是否启动失败。
  7. 附件是否过大、路径是否不符合预期。

示例追问:

请基于刚才失败的日志,说明失败原因、已完成的步骤和下一次重试前需要我补充什么。

如果失败原因是缺少环境变量,先到环境变量页面补充,再重新发起运行。不要把密钥直接写进会话消息。

如果失败原因是浏览器登录态失效,先在远程浏览器重新登录,再重试需要网页访问的任务。

使用技巧

  • 不要只看最终回复,重要任务要检查工具调用和文件变化。
  • 看到 Agent 偏离目标时尽早纠正,越早干预成本越低。
  • 计划审批不是形式,要认真确认修改范围和验证方式。
  • 失败会话也有价值,可让 Agent 总结失败原因后再新建任务重试。
  • 同一会话适合连续迭代同一目标,不适合长期混用多个主题。
  • 文件产物完成后,等待工作区导出状态变为 ready,再下载、分享或发布。

On this page