프로액티브 AI 인사이트
사용자가 요청하지 않아도 AI가 자동으로 데이터를 분석하여 인사이트를 제공하는 프로액티브 에이전트를 알아보세요.
프로액티브 에이전트란
프로액티브 에이전트는 사용자가 요청하지 않아도 AI가 워크스페이스의 데이터를 자동으로 모니터링하고 분석하여 인사이트를 제공하는 시스템입니다.
일반적인 AI 대화가 "사용자 질문 → AI 응답"의 흐름이라면, 프로액티브 에이전트는 이벤트나 스케줄에 의해 자발적으로 분석을 수행하고, 유의미한 발견이 있을 때 알림으로 전달합니다.
동작 방식
- 트리거 발동 - 데이터 변경, 통계 실행, 스케줄 등의 이벤트 발생
- 에이전트 매칭 - 트리거 조건에 맞는 에이전트를 라우팅
- 자동 분석 - 에이전트가 도구를 사용하여 워크스페이스 데이터를 조회하고 분석
- 인사이트 생성 - 유의미한 발견을 구조화된 인사이트로 생성
- 알림 전달 - 관리자에게 알림으로 전달, AI 채팅 패널에도 표시
멀티 프로액티브 에이전트
하나의 워크스페이스에 여러 프로액티브 에이전트를 동시에 운영할 수 있습니다. 각 에이전트는 고유한 역할, 트리거 조건, 시스템 프롬프트, 도구 권한을 가지며, 독립적으로 분석을 수행합니다.
에이전트 구성 요소
| 구성 요소 | 설명 |
|---|---|
| 이름/역할 | 에이전트의 이름과 담당 역할 (예: "매출 분석", "재고 모니터링") |
| 아바타/뱃지 | 에이전트를 시각적으로 구분하는 아이콘 |
| 시스템 프롬프트 | 분석 방향, 중요도 기준, 응답 스타일 등을 지정하는 지침 |
| 트리거 | 에이전트가 분석을 시작하는 조건 (이벤트/스케줄) |
| 도구 권한 | 에이전트가 사용할 수 있는 도구 범위와 쓰기 권한 |
| 분석 모델 | 분석에 사용할 AI 모델 (Claude, Gemini, DeepSeek, Mistral) |
시스템 에이전트 vs 커스텀 에이전트
| 구분 | 시스템 에이전트 | 커스텀 에이전트 |
|---|---|---|
| 생성 | 워크스페이스당 1개 자동 생성 | 사용자가 직접 생성 |
| 이름 변경 | 불가 (Taylor 고정) | 자유롭게 변경 가능 |
| 삭제 | 불가 (비활성화만 가능) | 삭제 가능 |
| 기본 역할 | 워크스페이스 전반 인사이트 | 특정 영역 전문 분석 |
시스템 에이전트(Taylor)는 워크스페이스 전반을 모니터링합니다. 특정 데이터모델이나 워크플로우에 대한 전문적인 분석이 필요하다면, 해당 역할에 특화된 커스텀 에이전트를 추가하세요.
트리거 설정
프로액티브 에이전트는 이벤트 트리거와 스케줄 트리거 두 가지 방식으로 분석을 시작합니다.
이벤트 트리거
워크스페이스에서 특정 이벤트가 발생할 때 분석을 실행합니다.
| 트리거 타입 | 설명 | 필터링 |
|---|---|---|
| 데이터 변화 감지 | 데이터모델의 행 추가/수정/삭제 시 | 특정 데이터모델만 감시 가능 |
| 통계 실행 분석 | 통계 정의 실행 완료 시 결과 분석 | 특정 통계 정의만 감시 가능 |
| 지표 분석 | 워크스페이스 핵심 지표 변동 감지 | 특정 지표 선택 가능 |
| 사용량 모니터링 | 토큰 사용량, API 호출 추적 | - |
| 워크플로우 패턴 | 워크플로우 실행 패턴 이상 감지 | 특정 워크플로우만 감시 가능 |
이벤트 트리거는 같은 에이전트에 대해 최소 6시간 간격으로 실행됩니다. 이는 과도한 분석 실행과 알림 폭주를 방지하기 위한 쿨다운 메커니즘입니다.
각 이벤트 트리거에는 리소스 필터를 설정할 수 있습니다. 예를 들어, "데이터 변화 감지" 트리거에서 특정 데이터모델만 지정하면, 해당 데이터모델에 변경이 있을 때만 에이전트가 실행됩니다. 필터를 지정하지 않으면 모든 해당 이벤트에 반응합니다.
스케줄 트리거 (정기 분석)
설정된 시간에 자동으로 분석을 실행합니다.
| 설정 | 설명 |
|---|---|
| 주기 | 매일(daily), 매주(weekly) |
| 실행 시간 | 0-23시 (UTC 기준) |
| 요일 | 주간 스케줄 시 특정 요일 지정 (선택) |
스케줄 분석은 하루에 한 번만 실행됩니다. 이미 당일 분석이 완료된 에이전트는 같은 날 다시 실행되지 않습니다.
Cron 기반 자동 실행
프로액티브 에이전트의 스케줄 트리거는 Vercel Cron을 통해 매시간 실행되는 /api/cron/ai-insight 엔드포인트에서 처리됩니다.
실행 흐름
- 매시간 크론이 실행되어 활성 에이전트가 있는 모든 워크스페이스를 조회
- 각 워크스페이스의 에이전트 중 현재 시간(UTC)에 스케줄이 매칭되는 에이전트를 필터링
- 당일 이미 분석을 완료한 에이전트는 건너뜀
- 매칭된 에이전트별로 분석 요청을 Workflow Worker에 전송
- Workflow Worker에서 Agent Loop을 실행하여 인사이트를 생성하고 알림을 발송
시스템 에이전트의 기본 실행 시간은 워크스페이스 ID를 기반으로 자동 분산됩니다. 이를 통해 서버 부하를 고르게 분배합니다. 에이전트 설정에서 원하는 시간으로 변경할 수 있습니다.
AI 인사이트 알림
프로액티브 에이전트가 생성한 인사이트는 다음과 같은 방식으로 표시됩니다.
알림 채널
| 채널 | 표시 위치 | 설명 |
|---|---|---|
| 알림 센터 | 상단 알림 아이콘 | 일반 알림과 함께 표시, 에이전트별 아바타/뱃지 구분 |
| AI 인사이트 패널 | AI 채팅 상단 | 미읽은 인사이트를 카드 형태로 표시 |
| AI 채팅 메시지 | AI 대화 내 | AI 패널이 열려 있을 때 새 인사이트가 대화에 자동 추가 |
| 에이전트 팝오버 | 워크스페이스 오버뷰 | 에이전트 클릭 시 최근 메시지 팝오버 |
인사이트 카테고리
| 카테고리 | 아이콘 | 설명 |
|---|---|---|
| 데이터 인사이트 | 차트 아이콘 (파란색) | 데이터 변화, 이상치, 트렌드 분석 |
| 생산성 제안 | 전구 아이콘 (노란색) | 자동화 기회, 최적화 제안 |
심각도
각 인사이트에는 심각도가 지정됩니다.
| 심각도 | 의미 |
|---|---|
| info | 참고용 정보 |
| warning | 주의가 필요한 사항 |
| critical | 즉각 조치가 필요한 사항 |
설정 방법
워크스페이스 오버뷰에서 설정
- 워크스페이스 오버뷰 하단의 AI 에이전트 섹션을 확인합니다
- 기존 에이전트를 클릭하면 메시지 팝오버가 나타나며, 설정(톱니바퀴) 아이콘으로 설정 다이얼로그를 엽니다
- 추가 버튼으로 새 커스텀 에이전트를 생성할 수 있습니다
에이전트 설정 다이얼로그
설정 다이얼로그는 좌우 2단 레이아웃으로 구성됩니다.
좌측 - 설정 폼:
| 설정 항목 | 설명 |
|---|---|
| 이름/역할 | 에이전트 식별 정보 |
| 아바타/뱃지 | 이모지 선택으로 시각적 구분 |
| 활성화 | 비활성화 시 분석 중지 |
| 발동조건 | 이벤트 트리거와 스케줄 트리거 설정 |
| 쓰기 도구 허용 | 데이터 생성/수정/삭제 도구 사용 허용 여부 |
| 분석 모델 | AI 모델 선택 (Claude, Gemini, DeepSeek, Mistral) |
우측 - 프리뷰 + 프롬프트:
| 영역 | 설명 |
|---|---|
| 에이전트 프리뷰 | 설정 중인 아바타/이름/역할의 실시간 미리보기 |
| 시스템 프롬프트 | 에이전트의 분석 지침을 마크다운으로 작성 |
쓰기 도구를 허용하면 에이전트가 데이터를 생성, 수정, 삭제할 수 있습니다. 데이터 변경이 필요하지 않은 모니터링 에이전트에는 비활성화를 권장합니다.
도구 권한
에이전트가 분석에 사용할 수 있는 도구의 범위를 설정합니다.
| 모드 | 설명 |
|---|---|
| all | 허용된 전체 도구 사용 (기본값) |
| whitelist | 지정한 도구만 사용 |
| blacklist | 지정한 도구를 제외하고 사용 |
allowWrite 설정에 따라 읽기 전용 도구만 사용할지, 쓰기 도구까지 허용할지 결정됩니다. 검색, 시맨틱 검색 등 메타 도구는 모든 모드에서 항상 사용 가능합니다.
활용 예시
매출 모니터링 에이전트
이름: 매출 분석가
역할: 매출/재무 데이터 분석
트리거: 데이터 변화 감지 (매출 데이터모델 필터), 매일 오전 9시 정기 분석
시스템 프롬프트:
- 전일 대비 매출 20% 이상 증감 시 알림
- 주간 매출 트렌드 분석
- 이상 거래 패턴 감지워크플로우 건강 체크 에이전트
이름: 운영 감시자
역할: 워크플로우 실행 모니터링
트리거: 워크플로우 패턴 감지, 매일 오후 6시 정기 분석
시스템 프롬프트:
- 실패율 10% 이상 워크플로우 경고
- 장시간 미실행 워크플로우 확인
- 자동화 효율 개선 제안데이터 품질 에이전트
이름: 데이터 검수관
역할: 데이터 품질 모니터링
트리거: 데이터 변화 감지 (전체), 통계 실행 분석
시스템 프롬프트:
- 필수 필드 누락 건수 추적
- 중복 데이터 감지
- 데이터 정합성 확인
쓰기 도구: 비허용 (읽기 전용)