원문 캡처 · github.com
원문 캡처 · github.com

Agent Notifications는 AI 에이전트가 작업하는 동안 CI 결과, 백그라운드 작업 상태, 다른 에이전트의 메시지를 다음 모델 요청에 전달하는 실험용 런타임 확장이다. 상태를 확인하는 도구 호출 없이 업데이트를 받을 수 있으며, 현재 Pi 확장 기능을 제공한다.

예를 들어 에이전트가 다른 파일을 수정하는 동안 CI가 실행되면, 반복해서 상태를 묻고 기다리는 대신 실패 결과가 다음 요청에 포함된다. 요구사항이 바뀌는 상황을 다룬 초기 파일럿에서는 업데이트를 받은 그룹이 코드 수정을 마치는 데 20.5초, 폴링 그룹은 32.3초가 걸렸다. 다만 업데이트 하나에 대한 관찰 결과이며, 알림 그룹의 실험은 완료 전에 중단됐다. 파일럿 근거

설치와 사용

Node.js 24 이상과 설정된 Pi 설치 환경이 필요하다. Pi 0.99.2에서 테스트했다. 저장소 체크아웃 디렉터리에서 확장을 실행한다.

sh
PI_NOTIFY_PORT=8765 pi -e ./src/pi-extension.ts

다른 터미널에서 업데이트를 보낸다.

sh
curl -X POST http://127.0.0.1:8765/notify \
 -H 'Content-Type: application/json' \
 -d '{"source":"CI","message":"CI: auth.test.ts failed."}'

Pi가 대기 상태라면 “What update did you receive?”라고 물어볼 수 있다. 다음 요청에 알림이 포함된다. 빠른 시작 안내와 전체 설정 안내를 제공한다.

CI 예제를 실행하려면 새 데모 프로젝트를 시작한다.

sh
node demo/ci.mjs launch

Pi의 작업과 CI 작업자가 자동으로 시작된다. Pi가 영수증 서식 도구를 만드는 동안 작업자는 실제 배송 테스트를 실행하고 실패 결과를 전달한다. 데모 절차에 따라 체험할 수 있다. 대기열 지연은 시뮬레이션한 것으로, 이 예제는 전달과 대응을 보여줄 뿐 속도 벤치마크는 아니다. 현재 한계도 확인할 수 있다.

작동 방식과 측정 결과

  • 스크립트, MCP 브리지 또는 다른 에이전트가 POST /notify로 업데이트를 보낸다.
  • 런타임은 업데이트를 세션에 저장하고 다음 모델 요청에 넣는다.
  • 에이전트는 처리한 업데이트를 지울 수 있으며, 기록에는 계속 남는다.

업데이트는 일반적인 에이전트 작업 흐름을 따른다. 대기 중인 에이전트를 깨우거나 실행 중인 호출을 중단하지 않는다. 명세를 공개했다.

프로젝트는 에이전트가 패키지 카탈로그와 대시보드가 있는 MCP 서버를 만드는 동안 알림 방식과 적응형 폴링을 비교했다. 두 방식 모두 시뮬레이션한 CI 대기 시간 이후 고정된 소스 스냅샷을 대상으로 실제 테스트를 실행하는 동안 코딩을 이어갔다.

  • 카탈로그 CI 결과가 모델에 도달하기까지 걸린 시간은 적응형 폴링보다 94.6% 줄었다.
  • 카탈로그 작업의 모델 요청 수는 10% 줄었다.
  • Notes MCP와 대시보드 작업의 수동 CI 상태 확인은 50% 줄었다.

수치는 작업별로 완료되고 정답을 낸 5개 쌍의 중앙값 감소율이다. 총 20회 실행은 모두 독립적인 승인 검사와 필수 CI를 통과했으며, 각각 약 4~7분 걸렸다. 전달 지연은 동일한 초기 CI 결과가 공개된 시점부터 그 결과가 포함된 첫 모델 요청까지의 시간으로 측정했다.

가장 분명한 효과는 CI 결과를 더 일찍 확인할 수 있다는 점이었다. 전체 완료 시간은 일관된 개선을 보이지 않았다. 쌍별 중앙값 변화는 Catalog에서 −3.1%, Notes에서 +1.6%였다. 누적 토큰 사용량은 각각 44.8%, 40.1% 증가했으며, 요청 사이에 캐시된 입력을 다시 읽은 양도 포함했다. 표본이 적은 탐색적 실험이므로 버그 수정 속도 향상, 비용 절감 또는 일반적인 생산성 향상을 입증하지는 않는다.

알림 기록은 이후 모델 요청에도 포함돼 토큰 사용량에 영향을 준다. 실험은 업데이트당 고정 오버헤드를 따로 측정하지 않았다. 토큰 산정, 전체 결과, 방법과 근거를 확인할 수 있다.

현재 Pi에서 사용할 수 있다. Codex, DeepSeek, oh-my-pi용 어댑터와 관련성 필터링, 더 긴 벤치마크는 향후 계획이다. 로드맵과 사용 사례, 연구 이야기, 전체 벤치마크, 인터랙티브 보고서를 공개했다. 라이선스는 MIT이며, 저작권 표기는 © 2026 Gabry848다.