TOJI TOJI
시스템 아키텍처

AI-Agent 프로젝트 관리

전문가 에이전트가 채팅으로 협업하고 · 티켓을 처리하며 · 지식으로 학습합니다

에이전트 사이클
오피스
Chat
→
Knowledge / HR / Meeting
→
Brain
RAG →
Answer
↓
Ticket
→
PM
→
Assigned
→
Report
→
Chat

상황 신규 입사자가 채팅으로 사내 계정·복리후생·팀 규칙을 한꺼번에 묻는다.

시나리오 HR·Knowledge 에이전트가 Brain에서 정책·온보딩 문서·FAQ를 찾아 스레드에서 답을 정리하고, 필요 시 티켓으로 남겨 담당 배정과 리포트에 반영한 뒤 채팅에 요약과 링크를 남긴다.

개발
Chat
→
Triage
→
Ticket
→
Dev
→
PR
↓
QA
→
Merge
→
Docs
ingest →
Brain

상황 개발자가 채팅에서 로그인 세션이 가끔 끊긴다고 알린다.

시나리오 에이전트가 대화를 티켓으로 옮기고 수정 PR을 올린 뒤 리뷰·QA·머지까지 진행한다. 변경 요약을 문서에 남기고 수집 파이프라인이 이를 Brain에 넣어, 이후 비슷한 질문에 과거 이슈와 결정이 근거로 붙는다.

왜 Brain인가?
Brain 없음
Agent → Core → ✕

"프로젝트, spec, 과거 의사결정에 대한 맥락이 없습니다."

Brain 사용
Agent → Core → Brain → ✓

"spec v2.3 기준으로 ticket #142는 2025-03-12에 합의된 auth migration 때문에 블로킹되어 있습니다."

3계층 검색

Vector(의미 유사도) + Graph(관계 탐색) + SQL(구조적 계층) — 단순히 비슷한 텍스트를 찾는 수준이 아닙니다.

구조 인식 청킹

문서를 계층(섹션 → 단락 → 문장)으로 파싱하고, RAG는 청크와 상위 맥락을 함께 반환해 에이전트 프롬프트를 더 풍부하고 정확하게 만듭니다.

안정적 지식

안정적인 entity ID 기반 멱등 수집 — 문서를 다시 처리해도 중복이나 지식 드리프트(knowledge drift)가 생기지 않습니다.

자기 성장

매 사이클이 피드백됩니다: 병합된 PR, 회의 요약, 의사결정이 수집되며 Brain은 루프마다 더 똑똑해집니다.

아키텍처
인터페이스
Relay Chat · Group / DM
→
Core LLM · Reasoning
→
Tracker Tickets · Tasks
Lens Dashboard (opt)
↕
에이전트
Dev
Triage intent → ticket
Dev code · PR
QA test · bug
Security scan · CVE
Docs ingest · summary
Office
PM roadmap · priority
Knowledge search · RAG
HR onboard · policy
Report digest · status
Meeting notes → tickets
↕
기반 계층
Brain Ingest · RAG
Guardian Auth · SSO
Infra K8s · IaC · Vault
구성 요소
Relay 채팅 인터페이스 — 그룹 및 DM. 사용자가 에이전트에 진입하는 지점입니다.
Core LLM 추론 계층. 의도를 해석하고, 응답을 생성하며, 다음 행동을 결정합니다.
Tracker 티켓·태스크 엔진. 모든 작업과 할당의 단일 진실 공급원(SSOT)입니다.
Brain 지식 엔진. Ingest 파이프라인이 문서를 수집하고, RAG가 에이전트에 관련 맥락을 검색합니다.
Guardian SSO 및 정체성(identity). 인증과 관계 기반 접근 제어(ReBAC)를 관리합니다.
Infra 인프라 오케스트레이션 — 컨테이너 플랫폼, IaC, 시크릿 관리.
Lens (opt) 대시보드 및 뷰어. 프로젝트·메트릭 개요를 위한 선택적 시각 인터페이스입니다.
인프라 스택
Docker 소(5인이하)
  • Docker Compose
  • Traefik (reverse proxy)
  • Vault (secrets)
  • cert-manager · Let's Encrypt
  • GitHub Actions (CI/CD)
  • GHCR (registry)
Kubernetes 중(100인이하) · ★ 권장
  • Kubernetes (kubeadm)
  • OpenTofu (IaC)
  • Vault + Agent Injector
  • Traefik (Ingress)
  • cert-manager (TLS)
  • CSI Storage (SSD · HDD)
  • Calico (CNI)
  • GHCR · GitHub Actions
  • Prometheus · Loki · Grafana
OpenStack 대규모(다중서버)
  • All K8s tier items
  • Nova · Neutron · Keystone
  • Cinder (iSCSI block storage)
  • Octavia (LB · Amphora)
  • OpenStack CCM + Cinder CSI
  • kolla-ansible (deploy)
  • Glance (image registry)
데이터 계층 — 모든 규모 공통
필수 PostgreSQL Qdrant · Vector TypeDB · Graph
권장 Redis Loki · Grafana
Workflow (opt) Temporal n8n Airflow ···
Stream (opt) Redpanda Kafka ···
필수 권장 선택