Prime Agent:自我提升的 RLM 代理文档 • 验证器 • PRIME - RL • pi - mono
Prime Agent 是一个用于常规和长期运行工作的开源编码与研究代理。它围绕两个核心抽象概念设计:递归语言模型(Recursive Language Model,RLM)将上下文视为变量(即“提示即变量”),并将递归子代理等工具当作持久 REPL 内的函数调用(程序化工具/子代理调用)。持续工具包(Continual Harness)将补充提示、记忆、技能描述和可复用的子代理规范存储为持久状态,Prime Agent 可以通过基于证据的小更新来完善这些状态,默认情况下这些更新仅在当前会话内生效。
Prime Agent 将持久的 Python 控制环境与持久的工具包状态相结合,这样有用的工作上下文和可复用的操作模式就能在单个聊天窗口关闭后依然保留。一切操作都是程序化的:内置的持久 IPython 是模型工具;文件操作、shell 命令、工具使用、子代理和上下文管理都通过代码实现。子代理是内置的:`rlm(...)` 可以生成真正的子代理用于并行或后台工作,并以程序化方式返回结果。工具包可以改进:`/refine` 会审查当前轨迹,并可以对补充的工具包状态应用基于证据的小更新。它永远不会重写不可变的基础系统提示,并且记录的快照支持回滚操作。技能是可执行的:技能以可导入的 Python 包形式存在,内置的技能创建器可以将重复的工作流程转化为项目或个人技能。会话可以在后台运行:由守护进程支持的代理在终端断开连接后仍会继续运行,之后还能重新连接。代理之间可以直接通信:运行中的代理可以相互交换消息并协调工作,无需将所有操作都通过用户进行中转。长任务可以持续推进:自动压缩、持久目标、心跳机制、调度、自主模式和保留的子代理可以在不同回合和终端会话之间保存进度。
快速开始
安装
在 macOS 或 Linux 上安装最新的稳定版本:
curl -fsSL https://app.primeintellect.ai/prime - agent/install.sh | sh
安装程序会下载一个带版本号的发行版,验证其 SHA - 256 校验和,安装 `prime - agent` 命令,并可以准备代理使用的 IPython 运行时环境。
启动
在你希望 Prime Agent 工作的仓库或目录中启动它:
cd /path/to/project
prime - agent
首次启动时,运行 `/login` 来选择订阅或 API 密钥提供商。Prime Agent 在当前目录下工作,可以运行命令并修改该目录下的文件。建议使用一次性克隆、干净的工作树或其他可检查和恢复的检查点。
注意事项
Prime Agent 会使用你的用户权限执行模型生成的 Python 和项目命令。它的工作进程和内核进程改善了生命周期隔离和恢复能力,但它们并非安全沙箱。请审查更改内容,仅使用受信任的仓库、指令、技能和扩展。在外部沙箱或受限环境中运行不可信的代码或指令。
常用命令
- `prime - agent agents`:浏览正在运行、空闲和已保存的会话。
- `prime - agent attach`:重新连接到正在运行的会话。
- `prime - agent --resume`:恢复已保存的会话。
- `prime - agent status`:检查后台服务状态。
- `prime - agent doctor [--fix]`:检查或修复后台服务。
- `prime - agent update [--force]`:更新 Prime Agent。
- `prime - agent shutdown [--force]`:停止所有代理、工作进程和后台服务。
为长期工作而构建
Prime Agent 专为长期工作而设计,尤其适用于研究评估。这些功能在 TUI 中可用,并且在自主运行时也能使用。
- 持续工具包:`/refine` 可以将有针对性、可审查的经验教训作为补充提示、记忆、可复用的技能描述或子代理规范持久化保存,并记录完善历史。它不会替代对新可执行技能的打包和审查。
- 代理间直接通信:运行中的代理和保留的子代理可以相互发现、交换消息并引导当前工作。
- 守护进程支持的连续性:活动会话、IPython 状态、调度和子代理在终端断开连接后仍会继续运行,之后可以重新连接。
- 心跳机制和调度:`/heartbeat`、`rlm_heartbeat` 和 `prime - agent schedule` 可以定期或在特定时间重新进入会话。
- 持久目标:`/goal` 可以保持一个目标及其进度的活跃状态,直到目标完成、暂停或清除。
- 有界自主模式:`/autonomous` 可以在配置的回合、令牌和时间预算内继续运行,并可以运行用户定义的质量检查。通过检查点仅验证该检查点所验证的内容;达到限制并不意味着任务成功。
文档
- 快速入门:安装、认证并运行第一个会话。
- 使用方法和 CLI 参考:命令、会话、自主限制和输出模式。
- 长期运行和后台代理:断开和重新连接、目标、心跳机制和调度。
- RLM 编程模型:持久 IPython、子代理、技能和信任模型。
- JSON 模式和 RPC 模式:无头自动化和集成。
- 技能:安装和创建可复用的功能。
- 提供商设置:订阅和 API 密钥提供商。
- 架构概述:守护进程、工作进程、内核和持久化边界。
- 开发:从源代码构建和运行。
致谢
我们的代理和 TUI 基于 pi 构建。感谢 pi 的作者们所做的宝贵工作。
许可证
Prime Agent 是完全开源的,遵循 MIT 许可证发布。
读者若想获取更多关于 Prime Agent 的内容,可查看相关资料。