워크스페이스 오버뷰
워크스페이스의 모든 엔티티와 관계를 한눈에 파악하는 오버뷰 화면을 알아보세요.
워크스페이스 오버뷰란
워크스페이스 오버뷰는 워크스페이스에 존재하는 **모든 엔티티(워크플로우, 노드 타입, 데이터모델, 통계, 페이지)**와 그들 간의 관계를 한눈에 파악할 수 있는 전체 조감도입니다.
엔티티 수가 늘어나면 전체 구조를 파악하기 어려워집니다. 오버뷰는 이 문제를 해결하기 위해 모든 엔티티를 유형별 컬럼으로 정렬하고, Canvas 위에 관계 연결선을 그려 시각적으로 보여줍니다.
5컬럼 엔티티 오버뷰
오버뷰는 5개의 컬럼으로 구성되어 워크스페이스의 엔티티를 유형별로 분류합니다.
| 컬럼 | 엔티티 | 크기 | 설명 |
|---|---|---|---|
| 워크플로우 | 자동화 워크플로우 | 넓음 | 활성/초안 상태 표시, 참조 데이터모델 수 |
| 노드 타입 | 사용된 워크플로우 노드 | 좁음 | 카테고리별 그룹핑, 사용 횟수 표시 |
| 데이터모델 | 데이터 테이블 | 넓음 | 아이콘, 연결 수 표시 |
| 통계 | 통계 정의 | 좁음 | 실행 모드 표시 |
| 페이지 | 문서 페이지 | 넓음 | 아이콘, 연결 수 표시 |
엔티티 총 수가 10개 미만인 경우 콤팩트 레이아웃(3컬럼)이 적용되며, 노드 타입과 통계 컬럼이 숨겨집니다.
컬럼 정렬
각 컬럼의 제목을 클릭하면 정렬 모드가 순환됩니다.
| 정렬 모드 | 설명 |
|---|---|
| 기본 정렬 | 연결 수 기준 내림차순 (관계가 많은 엔티티가 상단) |
| 이름 오름차순 | 가나다순 |
| 이름 내림차순 | 역순 |
| 순서 (페이지만) | 페이지 트리 순서대로 |
Canvas 연결선
카드에 마우스를 올리면 해당 엔티티와 연결된 모든 엔티티가 Canvas 연결선으로 시각화됩니다. 연결된 엔티티는 하이라이트되고, 관련 없는 엔티티는 흐려집니다.
| 연결 타입 | 의미 | 선 스타일 |
|---|---|---|
| embed | 페이지에 데이터모델이 임베드됨 | 실선 |
| relation | 데이터모델 간 관계 속성 연결 | 점선 |
| automation | 워크플로우가 데이터모델을 참조 | 짧은 점선 |
| integration | 워크플로우가 노드 타입을 사용 | 가는 실선 |
| invocation | 워크플로우 간 호출 관계 | 짧은 점선 |
| source | 통계가 페이지/데이터모델을 소스로 사용 | 중간 점선 |
| agent | 프로액티브 에이전트의 트리거 대상 | 보라색 점선 |
엔티티 카드
각 엔티티는 카드 형태로 표시되며, 타입별로 고유한 색상 코딩이 적용됩니다.
| 타입 | 색상 | 추가 정보 |
|---|---|---|
| 워크플로우 | 주황색 | 활성 상태 도트 (초록: 활성, 노란: 초안) |
| 노드 타입 | 보라색 | 사용 중인 워크플로우 수, Credential 상태 |
| 데이터모델 | 남색 | 연결된 엔티티 수 |
| 통계 | 청록색 | 실행 모드 |
| 페이지 | 보라색 | 연결된 엔티티 수 |
카드 상호작용
- 마우스 오버 - Canvas 연결선 표시 + 호버 프리뷰 팝업
- 클릭 - 해당 엔티티로 이동 (데스크톱 앱: 새 탭, 웹: 새 창)
- 노드 타입 클릭 - Credential이 필요한 노드라면 Credential 연결 모달 표시
Credential 상태 인디케이터
워크플로우에서 사용하는 외부 서비스(Google, Slack, OpenAI 등)의 인증 상태를 노드 타입 카드에서 바로 확인할 수 있습니다.
| 상태 | 표시 | 의미 |
|---|---|---|
| valid | 표시 없음 | 정상 연결됨 |
| untested | 노란색 글로우 | Credential은 있지만 검증되지 않음 |
| missing | 빨간색 글로우 | Credential이 등록되지 않음 |
| invalid | 빨간색 글로우 | 인증 실패, 재연결 필요 |
오버뷰 헤더 우측에는 인증 필요 카운터가 표시되어, 문제가 있는 노드 타입의 수를 한눈에 확인할 수 있습니다.
Credential 문제가 있는 노드 타입이 포함된 워크플로우는 정상적으로 실행되지 않을 수 있습니다. 빨간색 글로우가 보이면 해당 카드를 클릭하여 Credential을 연결하세요.
Credential 일괄 연결 모달
노드 타입 카드를 클릭하면 해당 서비스의 Credential 연결 관리 모달이 열립니다. 이 모달에서 여러 워크플로우에 걸쳐 사용되는 동일 서비스의 Credential을 한 번에 관리할 수 있습니다.
모달 구성
| 영역 | 설명 |
|---|---|
| 좌측 패널 - 저장된 연결 | 워크스페이스에 등록된 Credential 목록, 새 연결 추가 (OAuth 또는 API Key) |
| 우측 패널 - 노드 목록 | 해당 서비스를 사용하는 워크플로우별 노드 목록, 전체 선택/개별 선택 |
사용 방법
- 좌측에서 사용할 Credential을 선택합니다
- 우측에서 적용할 노드를 체크합니다 (전체 선택 가능)
- 저장 버튼으로 선택한 Credential을 선택한 노드에 일괄 적용합니다
새로운 외부 서비스를 처음 연결할 때, 오버뷰에서 해당 노드 타입을 클릭하면 OAuth 연결부터 전체 워크플로우 적용까지 한 곳에서 처리할 수 있습니다.
호버 프리뷰
엔티티 카드에 마우스를 올리면 플로팅 프리뷰 팝업이 카드 위에 표시됩니다.
프리뷰에 표시되는 정보
| 정보 | 설명 |
|---|---|
| 아이콘 + 이름 | 엔티티의 아이콘과 전체 이름 |
| 타입 레이블 | 워크플로우, 데이터모델, 페이지, 노드 타입, 통계 |
| 메타 정보 | 상태, 참조 DM 수, 카테고리 등 타입별 부가 정보 |
| Credential 상태 | 노드 타입의 경우 인증 문제 메시지 표시 |
| 연결 요약 | 연결된 엔티티 수와 연결 타입별 개수 |
에이전트 카드에는 호버 프리뷰가 표시되지 않으며, 연결선만 표시됩니다. 에이전트의 상세 정보는 클릭 시 나타나는 메시지 팝오버에서 확인할 수 있습니다.
데이터 Import 섹션
오버뷰 하단에 데이터 Import 섹션이 표시됩니다. 워크스페이스에서 사용 중인 외부 서비스 중 Import가 지원되는 서비스를 카드로 보여주며, Credential 연결 상태도 함께 표시합니다.
| 상태 | 표시 |
|---|---|
| 연결됨 | 초록색 도트 |
| 미확인 | 노란색 도트 |
| 인증 오류 | 빨간색 도트 |
| 인증 필요 | 빨간색 도트 |
서비스 카드를 클릭하면 Import 다이얼로그가 열려 해당 서비스의 데이터를 워크스페이스로 가져올 수 있습니다. 각 카드의 닫기 버튼으로 불필요한 카드를 숨길 수 있으며, 이 설정은 로컬에 저장됩니다.
AI 에이전트 섹션
오버뷰 하단에 워크스페이스에 등록된 프로액티브 AI 에이전트 목록이 표시됩니다. 각 에이전트는 아바타, 뱃지, 이름, 역할과 함께 원형 카드로 표시됩니다.
에이전트 카드 기능
- 마우스 오버 - 연결된 리소스(트리거 대상)와의 Canvas 연결선 표시 (보라색 점선)
- 클릭 - 최근 분석 메시지를 보여주는 팝오버 표시
- 설정 아이콘 - 에이전트 설정 다이얼로그 열기
- 추가 버튼 - 새 커스텀 에이전트 생성
에이전트가 특정 데이터모델, 통계, 워크플로우를 트리거 필터로 지정한 경우, 마우스 오버 시 해당 리소스와의 연결선이 Canvas에 표시됩니다.
에이전트에 대한 자세한 내용은 프로액티브 AI 인사이트 문서를 참고하세요.
오버뷰 헤더
화면 상단에 워크스페이스 이름과 함께 전체 현황 정보가 표시됩니다.
| 정보 | 설명 |
|---|---|
| 워크스페이스 이름 | 현재 워크스페이스 이름 |
| 인증 필요 카운터 | Credential 문제가 있는 노드 타입 수 (빨간색 뱃지) |
| 엔티티 수 | 워크플로우 + 데이터모델 + 페이지 + 통계의 총 수 |
| 새로고침 버튼 | 관계 데이터와 Credential 상태를 다시 불러옴 |
데이터 소스
오버뷰의 데이터는 여러 소스에서 실시간으로 수집됩니다.
| 데이터 | 소스 | 특성 |
|---|---|---|
| 페이지, 데이터모델, 워크플로우 | YDoc (Yjs) | 실시간 동기화, 엔티티 수 변경 시 관계도 자동 갱신 |
| 통계 정의 | React Query API | 캐싱 + 주기적 갱신 |
| 엔티티 간 관계 | workspace-relationships API | 1분 stale time, 엔티티 수 변경 시 자동 갱신, 윈도우 포커스 시 갱신 |
| Credential 상태 | credentials API | 1분 stale time, 윈도우 포커스 시 갱신 |
| 프로액티브 에이전트 | proactive-agents API | React Query 기반 |
다음 단계
- 워크스페이스 설정 - 팀에 맞게 워크스페이스 설정하기
- 프로액티브 AI 인사이트 - AI 에이전트 자동 분석
- Taylor AI - AI와 함께 업무 효율 높이기