HezaoHezao / poirot

장기 메모리를 갖춘 딥 리서치 에이전트 커널

📚 문서: 영어 · 간체중문 · 일본어

ReAct 루프 · 컨텍스트 거버넌스 · 5계층 메모리 · 다중 에이전트 오케스트레이션 · 스킬 자기 진화 · 샌드박스 격리

---

개요

Poirot는 에이전트의 구조가 어떻게 설계되는지에 관심 있는 사람들을 위해 구축된 딥 리서치 에이전트 커널입니다. 기능 목록을 쫓기보다는, Poirot는 ReAct 핵심 루프에서 컨텍스트 엔지니어링 거버넌스, 5계층 장기 메모리 시스템에서 공유 샌드박스 격리를 통한 다중 에이전트 오케스트레이션, 샌드박스 경로 강제화에서 3계층 스킬 자기 진화 시스템에 이르기까지, 깔끔하고 독립적이며 평가 가능한 기반을 구축합니다.

모든 모듈은 독립적으로 설계되고, 독립적으로 테스트되며, 독립적으로 검증 가능합니다. 2400+ 테스트가 모든 계층을 보호합니다.

---

핵심 모듈

🧠 ReAct 리서치 커널

하나의 LeaderAgent가 리서치 루프를 오케스트레이션합니다. LangGraph는 외부 플로우 오케스트레이션(prepare → leader_agent → finalize)을 담당하며, 21개의 미들웨어가 모든 라이프사이클 훅에 교차됩니다: before/after_agent, before/after_model, wrap_tool_call.

획기적: 미들웨어는 일급 시민입니다 — 메모리 호출, 스킬 주입, 샌드박스 라이프사이클, 통합, 도구 호출 페어링, 헬프 요청, 컨텍스트 거버넌스가 모두 플러그 가능하며 에이전트 루프에 내장되어 있지 않습니다. app → agents 의존성은 엄격히 단방향입니다.

📐 컨텍스트 엔지니어링 거버

---

🌐 본 텍스트는 빠른 이해를 돕기 위한 요약 번역본입니다. 정확한 기술 정보 및 전체 코드는 GitHub 원문에서 확인하실 수 있습니다.