常见问题
任务、会话、产物是什么关系？
用通俗方式解释 Poco 中任务、会话、运行和产物之间的关系。
使用 Poco 时，最容易混淆的几个词是：任务、会话、运行、产物。
它们不是同一个东西。理解这几个概念后，你会更容易看懂执行页，也更容易判断什么时候继续追问、什么时候新建任务。
一句话结论
任务是你要完成的目标，会话是承载这个目标的上下文，运行是一次具体执行，产物是执行后留下的可交付文件。
四个概念怎么理解
| 概念 | 通俗解释 | 例子 |
|---|---|---|
| 任务 | 你交给 Poco Agent 的目标。 | “帮我生成一份竞品分析报告”。 |
| 会话 | 围绕同一个目标持续协作的上下文空间。 | 这份竞品分析从初稿到补充图表都在同一会话里。 |
| 运行 | Agent 实际执行的一轮动作。 | 第一次提交是一轮运行，完成后继续追问又是一轮运行。 |
| 产物 | Agent 写入工作区、可以预览或下载的结果文件。 | report.md、dashboard.html、summary.xlsx。 |
一个完整例子
你创建任务：
请根据附件里的客户资料，生成一份客户拜访纪要和下一步行动计划。这时 Poco 会创建一个会话，并开始第一次运行。
第一次运行结束后，Agent 可能给出最终回复，并生成两个产物：
meeting-notes.mdaction-plan.md
如果你继续追问：
请把行动计划改成表格，并补充负责人和截止时间。这还是同一个会话，但会产生新的运行。新的运行会基于前面的上下文和已有文件继续修改产物。
什么时候继续同一个会话
适合继续同一个会话的情况：
- 目标没有变，只是补充细节。
- 需要基于已有产物继续修改。
- 需要让 Agent 解释刚才为什么这么做。
- 希望保留上下文，连续推进同一件事。
例如：
基于刚才的报告，再补一节风险提示。把刚才生成的 HTML 页面改成移动端更友好的布局。什么时候新建任务或新建会话
这些情况更适合新建：
- 目标已经变成另一件事。
- 之前的上下文有明显错误，继续会放大偏差。
- 需要换 Agent、换 Skills、换 MCP 或换环境变量配置。
- 需要处理另一个项目、另一个客户或另一个仓库。
- 原会话已经很长，历史上下文反而干扰判断。
例如，前一个会话是“生成客户报告”，现在变成“修复前端构建错误”，就应该新建任务。
产物和最终回复有什么区别
最终回复是聊天消息，适合总结、解释和给出下一步建议。
产物是文件，适合交付、复用、下载、分享和发布。
| 内容形态 | 适合用途 |
|---|---|
| 最终回复 | 快速阅读、确认结论、继续追问。 |
| Markdown 文件 | 报告、说明书、复盘、方案文档。 |
| HTML 文件 | 页面、原型、可视化展示、发布页。 |
| 表格文件 | 数据整理、清单、统计结果。 |
| 压缩包或多文件目录 | 完整项目、批量产物、可下载交付物。 |
如果你需要交给别人，建议让 Agent 生成文件，而不是只在聊天里输出正文。
示例：
请把最终结果保存为 `summary.md`，并额外生成一个适合分享的 `report.html`。为什么 Poco 要区分这些概念
因为团队任务不只是“聊完就结束”。
真实工作里通常还需要：
- 看执行过程。
- 复盘失败原因。
- 下载或分享文件。
- 在同一目标上继续迭代。
- 把稳定结果发布或沉淀成案例。
- 让管理员审计能力、成本和执行记录。
任务、会话、运行和产物拆开后，Poco 才能把这些事情管理清楚。