CogentAI 운영 가이드

OPENMARU CogentAI 를 설치한 뒤 붙이고 운영하는 사람을 위한 문서입니다. 위젯을 내부 웹사이트에 붙이는 방법, 어떤 MCP 도구가 연결되어 있는지, 무엇을 막고 무엇을 허용할지, 문서 검색(RAG)에 무엇을 넣을지를 다룹니다.

제품을 화면에서 쓰는 방법은 OPENMARU CogentAI 사용자 가이드에 있습니다.

이 매뉴얼의 구성

장	내용	상태
1. 구성 요소	채팅 화면 · API 서버 · 문서 검색 · 가드레일 · MCP · 모델의 관계	예정
2. 위젯을 내부 사이트에 붙이기	스크립트 삽입 · 설정값 · 인증 · 도메인 허용 · 문제 해결	예정
3. 관리 화면	업무명 별칭 · MCP 도구 키워드 · 가이드 질문 · 사용 이력	예정
4. MCP 도구 연동	어떤 서버가 있고 무엇을 언제 고르는가	예정
5. 가드레일	입력·출력 필터링 3단계 · 정책 설정 · 차단 기록	예정
6. 문서 검색 (RAG)	문서 수집 · 임베딩 · 검색 품질 확인 · 사전 관리	예정

장을 순서대로 채우고 있습니다. 완성된 장은 왼쪽 목차에 나타납니다.

연결되는 MCP 도구

4장에서 자세히 다룰 예정이며, 지금 붙어 있는 서버는 다음과 같습니다.

서버	무엇을 하나	언제 쓰이나
Database	스키마 조회 · 쿼리 실행 · 실행 계획 분석	데이터베이스에 대해 물을 때
Forecast	예측 · 이상치 탐지 · 상관 분석	지표의 앞날이나 이상을 물을 때
Chart	분석 결과 시각화	답을 그림으로 받을 때
kubectl	클러스터 상태 조회	쿠버네티스 운영을 물을 때
Jenkins	빌드 실행 · 결과 조회	파이프라인을 다룰 때
APM · Observ	성능 지표 · 관측 데이터 조회	애플리케이션 상태를 물을 때

관련 문서

• OPENMARU COP 사용자 매뉴얼 — 콘솔에서 AI 버튼이 있는 화면
• OPENMARU Observability 공통 차트 가이드 — 차트에서 AI 분석 실행
• OPENMARU APM T3. AI로 원인 분석하기 — SQL · 스레드 덤프 진단