Poco 使用手册
快速开始

Agent 工作台

理解场景 Agent、新任务入口和临时对话的使用边界。

Poco 支持多种任务入口。选对入口,比每次手动堆能力更重要。

场景 Agent 适合把团队反复使用的工作方式固定下来;新任务入口适合临时探索;临时对话适合轻量问答。这里的“新任务”指左侧导航中的入口,不是泛指创建一条任务记录。三者不是高低级关系,而是使用边界不同。

三种常用入口

入口定位适合任务
Agent 工作台固定场景、固定能力、团队复用代码审查、周报、数据分析、运营报告
新任务不绑定场景,手动选择能力临时需求、探索性任务、一次性分析
临时对话不保存历史的普通问答快速解释、短文本改写、一次性问答

场景 Agent

场景 Agent 是预配置的工作入口,通常包含:

  • 名称和说明。
  • 默认指令。
  • MCP 服务。
  • Skills。
  • 浏览器能力。
  • 提问示例。
  • 是否参考记忆。

创建会话时,Agent 的配置会固化为本次会话和运行的配置快照。这样做的好处是结果可追踪:后续即使你修改了 Agent,新旧会话也能解释当时用了哪些能力。

示例:

Agent:代码审查助手
默认指令:优先找运行时风险、边界条件、缺失测试和安全问题。
能力配置:GitHub MCP + 代码审查 Skill
提问示例:请审查这个 PR 的高风险问题。

适合沉淀为 Agent 的任务:

  • 每周或每天都会做。
  • 需要固定输出格式。
  • 需要固定工具或数据源。
  • 多个成员会重复使用。

不适合沉淀为 Agent 的任务:

  • 只执行一次的临时需求。
  • 每次输入材料和能力都完全不同。
  • 还没跑通流程,规则尚不稳定。
  • 只是一个很短的提示词模板。

Agent 配置锁定

场景 Agent 的会话通常不支持在执行页动态增删能力。原因是 Agent 代表固定工作方式,如果运行过程中随意换能力,会让团队复用和问题排查变得困难。

如果需要临时试能力,有三种做法:

  1. 使用新任务入口重新发起一次对话。
  2. 修改 Agent 配置后,再从 Agent 工作台发起新任务。
  3. 在当前会话中只继续做不依赖新能力的追问。

Agent 的默认指令会优先影响任务风格。用户提问可以补充本次任务目标,但不建议长期用用户提问去抵消 Agent 默认指令。如果经常需要抵消,说明 Agent 本身该调整。

分享与导入 Agent

在 Agent 工作台的 Agent 操作菜单中选择 分享,可以生成需要登录后访问的链接。访问者可以预览默认指令、提问示例和能力配置,再导入到自己的 Agent 工作台。

链接保存生成时的配置快照,不包含环境变量密钥、历史会话、定时任务或任务产物。同名能力存在配置冲突时,导入者可以复用自己的能力或覆盖账号级安装配置。

完整操作步骤、冲突处理和安全边界,请阅读 分享与继续探索

新任务

新任务入口适合“这次需要什么就选什么”。你可以按会话选择 MCP、Skills、插件和浏览器能力。

适合从新任务入口发起的任务:

  • 临时分析一个文件。
  • 临时检查某个页面。
  • 临时调用一个外部工具。
  • 还不确定是否值得沉淀成 Agent。

如果从新任务入口发起的同类任务被重复使用三次以上,建议改造成场景 Agent。

新任务入口的优势是灵活,但也更依赖用户自己判断能力组合。建议一次只启用必要能力,跑通后再逐步增加。

临时对话

临时对话不会保存到历史记录,也不具备完整 Agent 执行能力。它适合轻量问答,例如:

把这段公告改得更清楚一点。

不要在临时对话中处理需要长期追踪、产物沉淀或工具调用的任务。

Agent 与 Subagent 的区别

很多用户会把场景 Agent 和 Subagent 混淆。可以这样理解:

类型面向谁作用
场景 Agent面向用户的任务入口固定一类工作方式和默认能力
Subagent面向执行过程的辅助角色帮 Poco Agent 处理某个子问题

例如“代码审查助手”是场景 Agent;它在执行时调用“测试分析子角色”或“前端审查子角色”,这些才是 Subagents。

如果需要创建和选择子代理,可以继续阅读 子代理

创建 Agent 的建议

创建 Agent 时,建议先写清楚四项:

  1. 它服务什么场景。
  2. 它默认怎么工作。
  3. 它需要哪些能力。
  4. 它应该输出什么格式。

示例默认指令:

你是团队周报助手。请基于用户提供的材料,输出结构化周报。
要求:
1. 先总结本周进展。
2. 再列出风险与阻塞。
3. 最后给出下周计划。
语言简洁,不写空泛评价。

提问示例不要写成展示文案,要写真实用户会问的问题。例如:

请审查这个 PR,优先找可能导致线上异常的问题。
请基于今天的客服反馈生成一份管理层摘要。
请检查这份活动页,重点看移动端布局和按钮文案。

使用技巧

  • 场景稳定就用 Agent 工作台,场景不稳定就用新任务入口。
  • Agent 的默认指令越清楚,团队输出越一致。
  • 提问示例要写真实问题,不要写泛泛的“帮我分析一下”。
  • 能力不要贪多,只给 Agent 必需的 MCP 和 Skills。
  • 临时对话适合快问快答,不适合正式任务。
  • Agent 绑定的定时任务会依赖该 Agent,删除或停用前先确认没有任务仍在使用。
  • 如果 Agent 输出总是跑偏,优先改默认指令,而不是每次在提问里补很多限制。

On this page