제대로 쓰이고 있을까?
⚠️ 컴플라이언스 주의
이 도구는 Copilot 대화 내용을 평문(원문 그대로)으로 읽습니다. eDiscovery, 내부 감사, 규제 대응 보존 등 법적·정책적 권한이 명확한 테넌트에서만 사용하세요. 도입 전 데이터 보호 영향 평가(DPIA)와 사내 데이터 취급 정책을 반드시 검토해야 합니다.
왜 필요할까요 — "우리 회사, Copilot으로 진짜 가치를 얻고 있나요?"
Copilot을 도입한 뒤 관리자에게 돌아오는 질문은 대체로 비슷합니다. 누가 얼마나 쓰는지, 어떤 앱(Teams·Word 등)에서 쓰는지, 그리고 산 라이선스가 놀고 있지는 않은지. CopilotWatchTower는 이런 질문에 감이 아니라 숫자와 근거로 답하기 위한 관리자용 도구입니다. 무거운 인프라 없이 관리자 PC에서 바로 실행되는, 가볍고 안전한 데스크톱 앱입니다.
설치부터 분석까지, 하나의 도구로 — 핵심 기능 5가지
무엇을, 어떤 기술로, 어떤 권한으로 수집하나요
수집 소스마다 사용하는 기술, 필요한 권한, 제약이 다릅니다. 앱의 데이터 수집 → 개요 화면에서 동일한 내용을 확인할 수 있습니다.
| 소스 | 기술 | 주요 수집 데이터 | 필요 권한 |
|---|---|---|---|
| 💬 대화 수집 (API) | Microsoft Graph(beta) · getAllEnterpriseInteractions · 앱 전용(client credentials) 토큰 | 프롬프트/응답 본문, 앱 출처(BizChat·Word·Teams·Excel·PowerPoint·Outlook·Loop 등), 첨부·링크·멘션 메타데이터, 원본 JSON | AiEnterpriseInteraction.Read.All · User.Read.All · Organization.Read.All |
| 🤝 대화 수집 (e-Discovery) | Purview eDiscovery(Graph) · 위임 인증 | 라이선스 미보유 사용자를 포함한 Copilot 대화 본문, 케이스·검색·내보내기 결과에서 복원한 메시지 | eDiscovery.ReadWrite.All(위임) · eDiscovery Manager 역할 |
| 🤖 대화 수집 (Teams) | Dataverse 자동 로그인(웹 자동화) · 트랜스크립트 테이블 | Copilot Studio 커스텀 에이전트의 Teams 대화 기록(트랜스크립트), 에이전트·환경별 대화 세션 | Dataverse System Administrator(환경별) · PPAC 자동 로그인 계정 |
| 🧩 에이전트 | Microsoft Graph Copilot 관리 API(에이전트 등록·카탈로그) + 감사 로그 | 에이전트 인벤토리(등록 정보·카탈로그 패키지), 정책 구성 신호, 감사 로그 기반 실사용 신호 | AgentRegistration.Read.All · CopilotPackages.Read.All · CopilotPolicySettings.Read |
| 🪙 Power Platform 크레딧 | Power Platform 관리 센터(PPAC) 자동 로그인 · 소비 보고서 다운로드 | Copilot Studio 메시지 소비, AI Builder 크레딧 소비, Power Platform 요청(API) 소비 | Power Platform Administrator · PPAC 자동 로그인 계정 |
| 🛡️ 감사 이벤트 | Graph security.auditLog.queries(비동기 Purview 통합 로그) + Entra 감사/로그인 | 차단·거부 등 보안 이벤트, 민감 자료 접근 기록, 접근·정책 관련 감사 이벤트 | AuditLog.Read.All · AuditLogsQuery.Read.All · Purview/Exchange roleManagement |
| 📈 공식 사용량 | Microsoft Graph Reports API(Copilot 사용 CSV) | 공식 M365 Copilot 사용 보고서 스냅샷, 기간별(D7/D30/D90/D180) 사용 집계 | Reports.Read.All · ReportSettings.ReadWrite.All |
실제 화면 미리보기
대시보드 — 전체 사용 현황을 한눈에
활성 사용자, 총 스레드·메시지·프롬프트, 의미 있는 상호작용, 라이선스 미활성 사용자 등 핵심 지표(KPI)와 함께 최근 30일 사용 추이 그래프, 상위 사용자 TOP 5를 보여줍니다.
사용 인사이트 — 사용자·날짜·앱별 상세 분석
기간·사용자·앱 단위로 Copilot 활동을 필터링해 분석합니다. 날짜별 스레드·메시지 추이, 앱별 메시지 분포, 사용자별 요약 표를 제공합니다.
대화 탐색 — 실제 대화 기록 확인
Graph API로 수집한 운영 대화 기록을 제목·본문으로 검색하고, 사용자·앱으로 필터링해 개별 대화의 전체 내용을 확인합니다. 관련 감사 이벤트와 함께 Markdown 등으로 내보낼 수 있습니다.
지금 시작하기
Releases 페이지에서 CopilotWatchTower-x.y.z-setup.zip을 내려받아 압축을 풀고, 설치 배치 파일을 관리자 권한으로 실행하면 됩니다.
개발자라면 — 소스에서 바로 실행
Python 3.11+ 가상 환경에서 편집 가능(editable) 모드로 설치하면 바로 실행할 수 있습니다.
```powershell # 1. Python 3.11+ 가상 환경 생성 py -3.11 -m venv .venv .\.venv\Scripts\Activate.ps1 # 2. 개발 의존성 포함 편집 가능 설치 pip install -e ".[dev]" # 3. 실행 copilot-watchtower ```