主动式代理(免费版)
将AI代理从被动等待任务转变为主动预判需求并持续自我改进的架构。多数代理只会等待,这个架构让代理预判需求、主动行动、并随时间变得更好.
输入格式
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | 主动式代理(免费版)处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
核心能力
1. 六大支柱架构
- 记忆架构:跨会话上下文持久化,避免重复错误
- 安全加固:技能安装策略、外部代理网络、上下文泄露防护
- 自愈:检测并修复自身故障,无需人工介入
- 验证前报告(VBR):报告前验证实现,不只验证意图
- 对齐系统:ADL反漂移限制与VFM价值优先修改
- 主动惊喜:超越任务预期,提供额外价值
2. WAL协议(写前日志)
扫描每条消息,在响应前写入状态:
- 用户陈述偏好 → 写入记忆 → 再响应
- 用户做决策 → 写入记忆 → 再响应
- 用户给截止日期 → 写入记忆 → 再响应
- 用户纠正你 → 写入记忆 → 再响应
- 原因:若先响应再崩溃/压缩,上下文丢失;WAL保证持久性
3. 工作缓冲区协议
维护工作缓冲区暂存中间状态:
- 格式:当前任务、关键上下文、待办动作、近期决策
- 在响应前更新缓冲区,确保中断可恢复
- 缓冲区作为代理的"短期记忆",区别于长期记忆
4. 压缩恢复
上下文被压缩后自动恢复关键信息:
- 恢复步骤:检测压缩发生 → 读取工作缓冲区 → 重建关键上下文 → 验证一致性
- 防止压缩导致的项目状态丢失
- 从工作缓冲区与长期记忆双源重建
输出格式
完成响应以Markdown格式返回,包含任务状态(成功/失败)、解析摘要和具体输出数据。失败时返回错误码和错误信息,便于定位问题。- 验证返回数据的完整性和格式正确性
- 参考
输出格式的配置文档进行参数调优
快速开始
- 确认运行环境满足依赖说明中的要求
- 在AI Agent对话中调用本技能,提供必要的输入参数
- 检查输出结果,根据需要进行后续处理
详细的输入输出格式请参考下方章节说明。
适用场景
| 场景 | 输入 | 输出 |
|---|---|---|
| 上下文持久化 | 用户偏好/决策 | WAL写入记忆+响应 |
| 压缩恢复 | 检测到压缩 | 从缓冲区重建上下文 |
| 自我改进 | 行为偏差检测 | ADL护栏触发+VFM评估 |
不适用于:需要100%确定性的关键决策、无LLM环境的纯规则系统、完全自主无人工监督的生产环境.
使用流程
- 配置记忆架构:工作缓冲区、长期记忆、统一搜索
- 启用WAL协议:确保响应前写入状态
- 配置心跳系统:确定触发频率与检查清单
- 设置安全加固:技能安装策略、上下文泄露防护
- 启用自我改进护栏:ADL反漂移、VFM价值优先
结果验证: 任务完成后,查看输出确认状态。成功时返回摘要和数据;失败时根据错误信息排查,参考恢复章节获取修复步骤.
示例
示例:WAL协议执行
用户: "这个项目用 Tailwind,不用原生 CSS"
# ...
代理(内部):
1. 写入工作缓冲区: "Decision: Use Tailwind, not vanilla CSS"
2. 写入长期记忆: 偏好记录
3. 然后响应: "明白,用 Tailwind..."
错误处理
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 上下文压缩后信息丢失 | 未启用WAL或工作缓冲区 | 启用WAL协议,确保响应前写入;压缩后从缓冲区恢复 |
| 自主cron过度活跃 | 无护栏约束 | 关键任务改用提示cron,自主cron配ADL护栏与频率限制 |
| 意图与实现不符 | 只验证意图未验证实现 | 执行VBR协议:报告前运行验证命令并确认输出 |
| 工具迁移后引用失效 | 旧API端点或工具名变更 | 执行工具迁移清单:搜索引用、查找替代、更新调用、验证 |
常见问题
Q1: WAL协议为何要在响应前写入?
A: 若先响应再崩溃或压缩,上下文丢失。WAL(写前日志)保证持久性:用户陈述偏好/决策/截止日期/纠正时,先写入工作缓冲区与长期记忆再响应,即使中途断电也能恢复.
Q2: ADL反漂移限制如何工作?
A: ADL(Anti-Drift Limits)监控代理行为是否偏离原始任务。当检测到范围扩展(如"修复bug"变成"重写模块"),暂停并向用户确认。这防止代理自主扩大范围导致不可控修改.
Q3: VFM价值优先修改如何评估?
A: VFM(Value-First Modification)要求任何自我修改必须可证明带来价值。修改前评估预期收益,修改后验证实际效果,无收益则回滚。避免为改而改的无效修改.
已知限制
- 需要LLM支持,无LLM环境无法运行
- 自主行为需配护栏,完全自主无监督有风险
- 记忆架构依赖持久化存储,无存储环境仅能用会话内缓冲
依赖说明
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
依赖项
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
API Key 配置
需要配置对应API Key,详见上文环境配置章节
可用性分类
- 分类: MD+EXEC()
API Key配置方式:
export API_KEY=${API_KEY:?请设置环境变量}
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
升级提示
本免费版提供基础功能。升级到完整版 proactive-agent 获取全部能力和高级特性.
评论
加载中…