Prime Agent

项目概述

Prime Agent 是一款面向通用与长时间任务的开源编码与研究智能体。它围绕两个核心抽象构建：

• 递归语言模型（RLM）：将上下文视作变量（prompt-as-a-variable），把递归子智能体等工具当作函数调用（程序化工具/子智能体调用），运行在持久化的 REPL 环境中。
• 持续性 Harness（Continual Harness）：将补充提示、记忆、技能描述以及可复用的子智能体规范存储为持久化状态，Prime Agent 可基于证据进行小幅、可回滚的更新。

Prime Agent 将持久化的 Python 控制环境与持久化的 Harness 状态结合，使有效的工作上下文和可复用的操作模式能够跨越单次对话窗口存活下来。

核心特性

• 一切皆可编程：内置持久化 IPython 作为模型工具；文件操作、Shell 命令、工具调用、子智能体与上下文管理全部通过代码完成。
• 内置子智能体：rlm(...) 可生成真实的子智能体用于并行或后台任务，并以程序化方式返回结果。
• Harness 可自我优化：/refine 命令会审视当前轨迹，并对补充 Harness 状态应用基于证据的小幅改动。它不会重写不可变的基础系统提示，且每次更新都有快照支持回滚。
• 技能可执行：技能是可导入的 Python 包，内置技能创建器可将重复工作流封装为项目级或个人级技能。
• 后台会话：守护进程支撑的智能体在终端断开后仍可持续运行，并可在之后重连。
• 智能体直接通信：运行中的智能体可直接交换消息并相互编排，无需经由用户中转。
• 长任务持续推进：自动压缩、持久化目标、心跳机制、定时调度、自主模式以及保留的子智能体，使进度在多轮和跨终端会话中得以保持。

安装与快速上手

在 macOS 或 Linux 上安装最新稳定版：

# 下载安装脚本并自动验证 SHA-256 校验和、注册 prime-agent 命令
curl -fsSL https://app.primeintellect.ai/prime-agent/install.sh | sh

在目标项目目录下启动智能体：

cd /path/to/project
prime-agent

首次启动后执行 /login 选择订阅或 API Key 提供商。Prime Agent 会在当前目录工作，可执行命令并修改文件；建议使用可丢弃的克隆、干净工作树或可恢复的检查点。

常用命令

prime-agent agents               # 浏览运行中、空闲及已保存的会话
prime-agent attach <agent>       # 重新连接到正在运行的会话
prime-agent --resume [path|id]  # 浏览会话或直接恢复
prime-agent status               # 查看后台服务状态
prime-agent doctor [--fix]       # 检查或修复后台服务
prime-agent update [--force]     # 更新 Prime Agent
prime-agent shutdown [--force]   # 停止所有智能体、worker 和后台服务

长时任务支持能力

• 持续性 Harness：/refine 可将聚焦且可审查的经验沉淀为补充提示、记忆、可复用技能描述或子智能体规范，并记录每次精炼历史。
• 智能体间直接通信：运行中的智能体与保留子智能体可相互发现、交换消息并引导活跃任务。
• 守护进程支撑的连续性：活跃会话、IPython 状态、定时任务与子智能体在终端分离后依然运行，可随时重连。
• 心跳与定时调度：/heartbeat、rlm_heartbeat 和 prime-agent schedule 可周期性或在指定时间重新进入会话。
• 持久化目标：/goal 让目标及其进度在多轮之间保持激活，直至完成、暂停或清除。
• 有界自主模式：/autonomous 在配置的轮次、Token 与时间预算内持续运行，可配合用户自定义的质量门；门通过仅代表该门验证项通过，触及预算上限并不意味着任务成功。

文档导航

• 快速上手：安装、认证与首次会话
• 用法与 CLI 参考：命令、会话、自主限制与输出模式
• 长时与后台智能体：分离与重连、目标、心跳与定时调度
• RLM 编程模型：持久化 IPython、子智能体、技能与信任模型
• JSON 模式与 RPC 模式：无头自动化与集成
• 技能：安装与创建可复用能力
• 提供商配置：订阅与 API Key 提供商
• 架构概览：守护进程、worker、kernel 与持久化边界
• 开发指南：从源码构建与运行

许可协议

Prime Agent 完全开源，基于 MIT License 发布。