能力配置

能力配置决定 Poco Agent 能做什么、能访问什么、能怎样交付结果。它不是越多越好，而是越贴近任务越好。

每次运行开始前，系统会根据会话或 Agent 的配置快照装配能力：解析 MCP、下载 Skills、展开插件、写入 Subagents 和 Slash Commands、准备附件与浏览器登录态。运行开始后再修改能力，通常不会影响已经在执行的这一轮。

能力类型

Skills

Skills 适合把稳定方法沉淀下来，让 Poco Agent 按统一流程工作。例如：

使用代码审查 Skill：
1. 先找高风险 Bug。
2. 再检查测试缺口。
3. 最后给出简短变更建议。

使用建议：

• 通用方法写成 Skill。
• 项目专属规则写进项目文档或 Agent 默认指令。
• 不要为一次性任务创建 Skill。
• Skill 名称要稳定、清晰，方便团队成员在任务里识别。
• 修改 Skill 后，重新发起的运行才会使用新内容。

MCP 服务

MCP 用于把外部能力接入 Poco Agent，例如代码托管、数据库、浏览器、知识库和内部系统。

启用 MCP 前先确认：

1. 服务地址可访问。
2. 鉴权信息已配置。
3. 当前用户有使用权限。
4. 任务确实需要该外部工具。

示例：

任务：分析 GitHub 仓库最近 7 天的 PR 风险
能力：GitHub MCP + 代码审查 Skill
环境变量：GITHUB_TOKEN

常见问题：

• MCP 启动失败：优先检查环境变量、网络、命令路径和服务权限。
• MCP 工具太多：只选择本次任务真正需要的服务，减少干扰。
• 浏览器相关 MCP 重复：开启浏览器能力时，系统会注入内置浏览器链路，通常不需要再手动选择另一个浏览器 MCP。

插件

插件适合封装一组团队自定义工具或命令。它比单个 Skill 更偏工具扩展，适合需要分发成包、包含多个命令或多个文件的能力。

使用建议：

• 插件用于稳定工具集，不用于临时提示词。
• 上传前确认插件结构完整，并包含插件清单文件。
• 插件可能改变 Poco Agent 的可用命令，建议先在测试任务中验证。
• 场景 Agent 默认不配置插件；需要插件时更适合新任务入口或定时任务。

Subagents

Subagents 是执行过程中的专门角色，不等同于场景 Agent。场景 Agent 是用户发起任务的入口，Subagent 是 Poco Agent 在复杂任务中可调用的辅助角色。

适合使用 Subagents 的场景：

• 同一任务里有明显不同专业视角，例如前端审查、测试分析、文档校对。
• 希望把复杂任务拆成相对独立的分析单元。
• 需要减少主会话上下文里的细节噪音。

不适合使用 Subagents 的场景：

• 任务很短，单轮回答即可完成。
• 子任务之间高度耦合，需要频繁互相等待。
• 只是想固定输出格式，这类需求更适合 Skill 或 Agent 默认指令。

创建步骤和业务示例见 子代理。

环境变量

环境变量用于保存密钥和配置。敏感变量不会在前端明文展示，更新时需要重新输入值。

常见写法：

GITHUB_TOKEN：访问 GitHub API
OPENAI_API_KEY：访问模型服务
INTERNAL_API_BASE_URL：内部系统地址

使用建议：

• 密钥类变量开启敏感标记。
• 变量名保持清晰，不要使用 TOKEN1 这类含义不明的名称。
• 系统模板只定义变量名和用途，个人变量保存自己的值。
• 不要把密钥直接写进任务消息。
• 如果 MCP 配置使用 ${VAR} 这类占位符，运行前必须确保当前用户已经保存对应变量。

记忆

记忆用于让 Poco Agent 跨会话参考用户偏好、项目习惯和高价值结论。它是一组按用户隔离的长期事实，不是聊天记录备份，也不是独立知识图谱。

建议写入记忆的内容：

• 常用报告格式。
• 团队命名习惯。
• 长期项目背景。
• 用户偏好的输出语言和结构。

不建议写入记忆的内容：

• 短期临时数据。
• 密钥、Token、个人隐私。
• 还未确认正确的猜测。

“保存记忆”控制任务完成后的自动候选和 Agent 的显式新增、更新、遗忘能力；“参考记忆”只控制普通对话是否自动检索并注入相关事实。关闭自动参考后，Agent 仍可通过 search_user_memory 主动查询；关闭保存不会删除已有数据，用户仍可在记忆管理页纠正或清理历史记忆。

自动候选只在任务完成后提交：用户请求与助手确认结果会按真实角色交给 Mem0，前后保护层负责凭据与技术噪声，长期价值由 Mem0 的持久记忆规则判断。更新和遗忘必须使用检索得到的真实记忆 ID；遗忘会同步物理清理主记忆、主题关联和对应变更轨迹。定时和夜间任务会强制关闭自动记忆注入、相关提示与记忆保存，不受用户开关影响，避免无人值守任务被旧上下文带偏或污染长期记忆。

当前记忆管理页展示概览、变化趋势、来源、主题热区、长期记忆列表、相关记忆和变更轨迹。主题来自主记忆的实体索引，不是第二套图数据；当前版本不再依赖 Neo4j。

详细边界和使用方法见 记忆功能会记住什么？，技术实现见 长期记忆架构。

通知配置

通知用于在任务完成、失败或定时任务运行后提醒用户。建议在这些场景开启：

• 夜间执行任务。
• 定时巡检任务。
• 长时间运行任务。
• 失败需要及时处理的任务。

如果没有任何已启用渠道，定时任务中的通知开关不会产生实际投递。

通知和 WebHook 不同：通知面向用户本人或团队渠道，WebHook 面向外部系统事件集成。如果你要触发外部流程，使用 WebHook；如果只是提醒人处理，使用通知。

能力组合示例

代码审查：

网页检查：

周期报告：

使用技巧

• 能力不是越多越好，越少越可控。
• 固定组合沉淀到场景 Agent，不要每次手动选择。
• 外部工具失败时，先检查环境变量和权限。
• 涉及敏感数据的 MCP 要限制使用范围。
• 定期清理不再使用的 API Key、变量和插件。
• 运行已经开始后，如果发现能力选错，停止后重新发起更可靠。
• Agent 绑定会话的能力配置通常不可动态修改，临时实验用新任务入口更合适。