Sentinel — 자율 시스템 상태 가디언

Sentinel은 클라우드 네이티브 환경을 위한 멀티 에이전트 인프라 모니터링 플랫폼입니다. 실시간으로 이상 징후를 조사할 뿐만 아니라 운영 원격 측정(operational telemetry)에 대한 플랫폼의 자연어 인터페이스 역할을 하여 관리자가 SQL을 작성하지 않고도 인프라 상태를 질의할 수 있게 해줍니다.

네 개의 전문화된 에이전트(Monitor, Diagnostician, Remediation, Data Intelligence)는 LangGraph 상태 머신을 통해 협업하며, 전적으로 단일 표준화된 MCP 게이트웨이를 통해 조정됩니다.

아키텍처

핵심 워크플로는 순환형 LangGraph 상태 머신입니다. Monitor가 이상 징후를 감지하고, Diagnostician이 RAG 지식 베이스를 사용하여 가능성 있는 근본 원인을 판단하며, Remediation이 (안전 가드레일을 준수하여) 적절한 수정을 시도하고, Verify가 수정이 효과가 있었는지 확인합니다. 검증에 실패하면 그래프는 구성 가능한 재시도 한도까지 Diagnostician으로 다시 루프백됩니다.

모든 에이전트는 MCP(Model Context Protocol) 게이트웨이를 통해서만 시스템과 상호 작용합니다. 어떤 에이전트도 데이터베이스, 로그, 지식 베이스에 직접 접근하지 않습니다. 이를 통해 모든 도구 호출을 감사 가능하게 유지하고 단일 인터페이스 뒤에서 교체할 수 있게 합니다.

Related MCP server: dagster-mcp

기능

• 4개의 CrewAI 에이전트 — 각각 역할에 필요한 MCP 도구로만 범위가 제한됨

• RAG 기반 진단 — 운영 런북 모음에 대해 Sentence-Transformers 임베딩과 FAISS 유사도 검색을 사용

• 자연어-SQL 인터페이스 — 인프라 원격 측정 데이터베이스에 대한 자연어-SQL 인터페이스로, 범위를 벗어난 질문에는 정상적으로 대체 동작

• 안전 가드레일 — 시스템이 심각한 부하를 받을 때 위험도가 높은 수정 명령(예: 서비스 재시작)을 차단. 이론상으로만이 아니라 실제 조건에서 올바르게 차단되는지 검증됨

• 자가 치유 재시도 루프: 실패한 검증은 자동으로 진단으로 다시 라우팅되어 조용히 실패하지 않음

• 전체 관찰 가능성 — 모든 NL2SQL 호출에 대한 LangSmith 추적

기술 스택

설정

python -m venv venv
venv\Scripts\activate          # Windows
pip install -r requirements.txt

다음 내용으로 .env 파일을 생성하세요: GROQ_API_KEY=your_key LANGCHAIN_TRACING_V2=true LANGCHAIN_API_KEY=your_langsmith_key LANGCHAIN_PROJECT=sentinel-agent-system

데모 실행

python demo.py

이 명령은 샘플 서버에 대해 전체 파이프라인을 실행하며, Monitor → Diagnose → Remediate → Verify로 진행되는 각 에이전트의 추론을 출력합니다. 첫 번째 시도에서 검증에 실패할 경우 재시도 루프의 실시간 데모도 포함됩니다.

인도물 참고 사항

사후 분석 보고서(Post-Mortem Report), LangSmith NL2SQL 추적 스크린샷, 워크플로 다이어그램은 과제 지침에 따라 별도로 제출되었습니다.