COMKEY Private LLM 연동

## 이 연동으로 얻는 것 사내 지식베이스에 쌓인 문서를 AI 에이전트가 참조합니다. - 업무일지 · 회의록 · 보고서 · VOC · 결재 문서 검색 - 문서 원문 조회 - 구성원 정보 조회 - 사내 문서 통계 즉 "우리 회사가 지난달에 무슨 논의를 했는지"를 데이터 지표와 함께 물어볼 수 있습니다. ## 사전 준비물 | 항목 | 비고 | |---|---| | **API 주소** | COMKEY 백엔드 주소 | | **웹 주소** | 원문 보기 링크에 사용 (선택) | | **서비스 계정 이메일** | ⚠️ 개인 계정이 아닌 전용 계정 | | **비밀번호** | | | 서비스 계정의 **역할(role)** | **열람 범위를 결정** — 아래 참조 | ## ⚠️ 가장 중요한 결정 — 서비스 계정 역할 **서비스 계정에 어떤 역할을 주느냐가 모닝인사이트로 흘러오는 문서 범위를 결정합니다.** COMKEY 는 문서 분류별로 접근을 제어합니다. | 문서 분류 | 열람 조건 | 서비스 계정 역할이 이것이면 | |---|---|---| | 일반 | 전원 | 역할 없어도 열람 | | 리더 | 리더 · 임원 | **`leader`** 부여 시 열람 | | 경영 `[경영]` | 임원 | **`executive`** 부여 시 열람 | ### 권장 시작값 — `leader` 대부분의 업무 문서는 일반·리더 분류입니다. `[경영]` 문서까지 필요해지면 나중에 역할만 올리면 됩니다. ### `executive` 를 줄 때 주의할 점 `executive` 를 부여하면 `[경영]` 분류 문서까지 조회됩니다. 이때, - 모닝인사이트를 쓰는 **모든 사용자가 그 문서 내용을 질문으로 얻을 수 있게 됩니다** - COMKEY 감사 로그에는 **개인이 아니라 "서비스 계정" 이름으로** 열람 기록이 남습니다. 누가 실제로 조회했는지는 모닝인사이트 쪽 로그를 확인해야 합니다 > 경영 문서를 노출할지는 **권한 정책 결정**입니다. 편의로 올리지 마세요. ### 검색은 이미 안전합니다 문서 **검색** 기능은 설계상 경영·민감 문서를 제외합니다. 역할은 **목록 조회와 단건 조회**에만 적용됩니다. ## 연동 절차 1. **설정 → 데이터 연동** 탭 2. **COMKEY-PrivateLLM** 카드 클릭 3. 입력: - API 주소 (백엔드) - 웹 주소 (원문 보기 링크용, 선택) - 서비스 계정 이메일 - 비밀번호 4. **연결 테스트** 로 확인 5. **저장** ## 확인 방법 1. 연결 테스트가 통과하는지 2. **COMKEY** 화면에서 문서 목록이 나오는지 3. AI 에이전트에 사내 문서를 물어봅니다 (예: "지난달 회의록에서 결정된 사항 정리해줘") 4. 답변에 나온 문서가 실제 존재하고 **분류 범위가 의도한 대로인지** ## 자주 나는 오류 | 증상 | 원인 | 대응 | |---|---|---| | 연결 테스트 실패 | API 주소 오류 | 백엔드 주소·포트 확인 | | 연결 테스트 실패 | 서비스 계정 비밀번호 변경 | 새 비밀번호로 재등록 | | 연결 테스트 실패 | 사내망에서만 접근 가능한 주소 | 네트워크 경로 확인 | | 문서 목록이 비어 있다 | 서비스 계정에 역할 미부여 | COMKEY 에서 `leader` 부여 | | 특정 문서만 안 보인다 | 그 문서 분류가 역할 범위 밖 | 의도한 동작인지 먼저 판단 | | 원문 링크가 안 열린다 | 웹 주소 미입력 또는 오류 | 웹 주소 확인 | | 갑자기 끊김 | 서비스 계정 비밀번호 정책 변경 | 재등록 | ## 운영 팁 - **개인 계정을 쓰지 마세요.** 담당자 퇴사 시 연동이 끊기고, 감사 로그가 그 사람 이름으로 남습니다 - 서비스 계정의 **비밀번호 만료 정책**을 확인하세요. 만료되면 조용히 끊깁니다 - 역할을 올리기 전에 **어떤 문서가 새로 노출되는지** 확인하세요 - COMKEY 서버 주소가 바뀌면 설정에서 API 주소만 교체하면 됩니다 ## 제약 - 서비스 계정 역할이 곧 열람 범위입니다. 모닝인사이트 쪽 사용자별 문서 필터는 없습니다 - 경영 문서 열람 기록은 COMKEY 쪽에 서비스 계정 이름으로 남습니다 - 사내망 접근이 필요한 환경에서는 네트워크 경로가 선행 조건입니다 ## 관련 문서 - [AI 제공자와 API 키](/news/guide/agent-providers) - [AI 에이전트 시작하기](/news/guide/agent-start) - [자격증명 보관과 보안](/news/guide/integration-security)