Infra AI IT 팀 운영 매뉴얼

자체 호스팅 스택을 운영하는 전문 AI 에이전트 팀.

ageniusailabs.com/runbooks/personal-ai-infrastructure의 운영 매뉴얼에 대한 보조 저장소입니다.

이것은 무엇인가요

이미 운영하고 있는 인프라(오버레이 메시, 시크릿 볼트, 컴퓨팅 기판, 공개 엣지, LAN, 원격 측정, 워크플로우 런타임)를 작동시키는 하나의 Linux 박스에서 사설 AI 에이전트 팀으로 나아가는 실용적인 가이드입니다.

최종적으로 얻게 될 것은 다음과 같습니다:

• 사용자가 통제하는 사설 P2P 메시
• 디스크에 .env 파일이 없는 머신 ID 기반 시크릿
• 모든 도메인에서 불변(Idempotent) 읽기 경로
• 팀이 수행하는 모든 변경 사항을 기록하는 중앙 집중식, 추가 전용 저널
• 문서와 사양의 무결성을 유지하는 주간 드리프트 스윕 및 프롬프트 무결성/주입 방지 장치
• 사용자의 일상적인 사용을 통해 더 똑똑해지는 11개의 전문 에이전트(8개 인프라 + 3개 사이버 피어, 그리고 라우팅 래퍼)를 의도에 따라 배포하는 것들

아키텍처는 한 페이지에:

하나의 에이전트를 열한 개로 분할하는 이유

모놀리식(Monolithic) 에이전트는 요청마다 전체 컨텍스트를 로드합니다. DNS 조회를 위한 400줄짜리 사양은 토큰을 낭비하고, 지연 시간을 증가시키며, 추론 능력을 저하시킵니다. 전문가는 각각 80~150줄이며, 의도에 따라 배포됩니다. 이 분할은 성급한 최적화가 아니라, 에이전트를 매일 사용하게 되면 비용 계산상 유일하게 작동하는 방식입니다.

이 저장소를 읽는 방법

이 순서대로 여세요:

1. sections/00-prerequisites.md — 작동하기 전에 필요한 것들
2. sections/07-the-agent.md — 메커니즘 이전에 이야기
3. 그 다음 01 → 06을 따라 기반 구조(substrate)를 구축합니다.
4. 그다음 08 → 13을 통해 분할하고, 메모리를 추가하며, 저널을 추가하고, 드리프트 스윕(drift sweep)을 실행하고, 가드레일(guardrails)을 설정하며, 안티패턴(anti-patterns)을 피합니다.

비용 분석 부록 및 예시 구성은 examples/에서 확인할 수 있습니다.

리포지토리 맵 (Repo map)

.
├── README.md                    # 여기에 있습니다
├── diagrams/
...

가정된 스택 (Stack assumed)

이 실행 매뉴얼(runbook)은 특정 공급업체에 종속된 비밀 레시피가 아닌 패턴을 가르칩니다. 참고 스택은 다음과 같습니다:

영수증 (Receipts)

프로덕션에서 3개월이 지났습니다. 하이퍼바이저 노드 4개, 컨테이너 18개, VM 1개. 크론(cron)으로 주간 커널 업데이트가 이루어집니다. 수동으로 진행한 유일한 단계는 각 호스트에 Proxmox를 로딩하는 것이었습니다. 에이전트 팀은 클러스터, 네트워킹, 시크릿, 배포, 강화(hardening), 그리고 커널 크론 자체까지 처리했습니다.

상태 (Status)

라이선스 (License)

MIT — 사용하고, 포크하고, 적응시키세요. 시간이 절약된다면 링크하기.

작성자 (Author)

Michael Frostbutter — ageniusailabs.com · LinkedIn