문서 • Verifiers • PRIME-RL • pi-mono

Prime Agent는 범용 및 장기 실행 작업을 위한 오픈 소스 (open-source) 코딩 및 연구 에이전트입니다. 이 에이전트는 두 가지 핵심 추상화(abstraction)를 중심으로 설계되었습니다:

• **재귀적 언어 모델 (Recursive Language Model, RLM)**은 컨텍스트를 변수(prompt-as-a-variable)로 취급하며, 재귀적 서브 에이전트(subagent)와 같은 도구를 지속적인 REPL 내부의 함수 호출(programmatic tool /sub-agent calling)로 취급합니다.
• **지속적 하네스 (Continual Harness)**는 보충 프롬프트, 메모리, 기술 설명 및 재사용 가능한 서브 에이전트 사양을 내구성이 있는 상태(durable state)로 저장하며, Prime Agent는 기본적으로 세션 로컬에서 증거에 기반한 작은 업데이트를 통해 이를 개선할 수 있습니다.

Prime Agent는 지속적인 Python 제어 환경과 내구성이 있는 하네스 상태를 결합하여, 유용한 작업 컨텍스트와 재사용 가능한 운영 패턴이 단일 채팅 창의 수명을 넘어 유지될 수 있도록 합니다.

모든 것이 프로그래밍 방식입니다: 지속적인 IPython은 내장된 모델 도구이며, 파일 작업, 셸 명령, 도구 사용, 서브 에이전트 및 컨텍스트 관리는 코드를 통해 이루어집니다.
서브 에이전트가 내장되어 있습니다: rlm(...)은 병렬 또는 백그라운드 작업을 위한 실제 자식 에이전트를 생성하고 그 결과를 프로그래밍 방식으로 반환합니다.
하네스는 개선될 수 있습니다: /refine은 현재 궤적(trajectory)을 검토하고 보충 하네스 상태에 증거에 기반한 작은 업데이트를 적용할 수 있습니다. 이는 불변의 기본 시스템 프롬프트를 절대 다시 쓰지 않으며, 기록된 스냅샷은 롤백(rollback)을 지원합니다.
기술은 실행 가능합니다: 기술은 임포트 가능한 Python 패키지이며, 내장된 기술 생성기(skill creator)는 반복되는 워크플로우를 프로젝트 또는 개인 기술로 변환할 수 있습니다.
세션은 백그라운드에서 실행됩니다: 데몬(daemon) 기반 에이전트는 터미널 연결이 끊겨도 계속 실행되며 나중에 다시 연결할 수 있습니다.
에이전트 간 직접 통신: 실행 중인 에이전트는 모든 것을 사용자를 거치지 않고도 메시지를 교환하고 서로를 오케스트레이션(orchestrate)할 수 있습니다.
장기 작업이 계속 진행됩니다: 자동 압축(compaction), 지속적인 목표, 하트비트(heartbeats), 스케줄, 자율 모드 및 유지된 서브 에이전트는 턴(turn)과 터미널 세션 전반에 걸쳐 진행 상황을 보존합니다.

macOS 또는 Linux에 최신 안정화 버전(stable release)을 설치하세요:

curl -fsSL https://app.primeintellect.ai/prime-agent/install.sh | sh

설치 프로그램은 버전이 지정된 릴리스(release)를 다운로드하고, SHA-256 체크섬(checksum)을 검증하며, prime-agent 명령어를 설치하고, 에이전트가 사용하는 IPython 런타임(runtime)을 준비할 수 있습니다.

에이전트가 작업하기를 원하는 저장소(repository) 또는 디렉토리에서 Prime Agent를 시작하세요:

cd /path/to/project
prime-agent

처음 실행할 때, /login을 실행하여 구독(subscription) 또는 API 키 제공업체를 선택하세요. Prime Agent는 현재 디렉토리에서 작동하며, 해당 위치에서 명령어를 실행하고 파일을 수정할 수 있습니다. 검사 및 복구가 가능한 일회용 클론(disposable clone), 깨끗한 워크트리(clean worktree) 또는 다른 체크포인트(checkpoint)를 사용하세요.

경고

Prime Agent는 사용자의 권한으로 모델이 생성한 Python 및 프로젝트 명령어를 실행합니다. 워커(worker) 및 커널(kernel) 프로세스는 라이프사이클 격리(lifecycle isolation)와 복구 기능을 향상시키지만, 보안 샌드박스(security sandbox)는 아닙니다. 변경 사항을 검토하고 신뢰할 수 있는 저장소, 지침, 스킬(skills) 및 확장 기능(extensions)만 사용하세요. 신뢰할 수 없는 코드나 지침은 외부 샌드박스 또는 제한된 환경에서 실행하십시오.

유용한 명령어:

prime-agent agents # 실행 중, 유휴(idle) 및 저장된 세션 탐색
prime-agent attach <agent> # 실행 중인 세션에 다시 연결
prime-agent --resume <path|id> # 저장된 세션 재개
...

Prime Agent는 장기 실행 작업, 특히 연구에서의 평가(evaluations)를 위해 구축되었습니다. 이러한 기능들은 TUI에서 사용 가능하며, 자율적으로 실행될 때도 사용할 수 있습니다.

지속적 하네스 (Continual Harness): /refine

기록된 개선 이력과 함께 보충 프롬프트(supplemental prompts), 메모리(memories), 재사용 가능한 기술 설명(reusable skill descriptions) 또는 서브에이전트 사양(subagent specifications)으로서 집중되고 검토 가능한 교훈을 지속할 수 있습니다. 이는 새로운 실행 가능한 기술(executable skills)을 패키징하고 검토하는 것을 대체하지 않습니다.

에이전트 간 직접 통신 (Direct agent-to-agent communication): 실행 중인 에이전트와 유지된 서브에이전트가 서로를 발견하고, 메시지를 교환하며, 활성 작업을 유도할 수 있습니다.

데몬 기반 연속성 (Daemon-backed continuity): 터미널이 분리(detach)되어도 활성 세션, IPython 상태, 스케줄 및 서브에이전트가 계속 실행되며 나중에 다시 연결(reattach)할 수 있습니다.

하트비트 및 스케줄 (Heartbeats and schedules): /heartbeat, rlm_heartbeat, prime-agent schedule을 통해 주기적으로 또는 특정 시간에 세션에 다시 진입할 수 있습니다.

지속적 목표 (Persistent goals): /goal은 목표와 그 진행 상황을 완료, 일시 중지 또는 삭제될 때까지 턴(turn) 전반에 걸쳐 활성 상태로 유지합니다.

제한된 자율 모드 (Bounded autonomous mode): /autonomous는 구성된 턴(turn), 토큰(token) 및 시간 예산 내에서 계속 실행되며 사용자 정의 품질 게이트(quality gates)를 실행할 수 있습니다. 통과된 게이트는 해당 게이트가 검증하는 항목만 확인합니다. 제한에 도달했다고 해서 작업이 성공했음을 의미하지는 않습니다.

• Quickstart — 설치, 인증 및 첫 세션 실행
• Usage and CLI reference — 명령어, 세션, 자율 제한 및 출력 모드
• Long-running and background agents — 분리 및 재연결, 목표, 하트비트 및 스케줄
• RLM programming model — 지속적 IPython, 서브에이전트, 기술 및 신뢰 모델
• JSON mode and RPC mode — 헤드리스(headless) 자동화 및 통합
• Skills — 재사용 가능한 기능 설치 및 생성
• Provider setup — 구독 및 API 키 제공자 설정
• Architecture overview — 데몬(daemon), 워커(worker), 커널(kernel) 및 지속성 경계 개요
• Development — 소스에서 빌드 및 실행

우리의 에이전트와 TUI는 pi를 기반으로 구축되었습니다. 귀중한 작업을 수행해 주신 pi의 저자들에게 감사드립니다.

Prime Agent는 완전한 오픈 소스이며 MIT 라이선스 하에 배포됩니다.