SuitsDocs
시작하기

워크스페이스 오버뷰

워크스페이스의 모든 엔티티와 관계를 한눈에 파악하는 오버뷰 화면을 알아보세요.

워크스페이스 오버뷰란

워크스페이스 오버뷰는 워크스페이스에 존재하는 **모든 엔티티(워크플로우, 노드 타입, 데이터모델, 통계, 페이지)**와 그들 간의 관계를 한눈에 파악할 수 있는 전체 조감도입니다.

엔티티 수가 늘어나면 전체 구조를 파악하기 어려워집니다. 오버뷰는 이 문제를 해결하기 위해 모든 엔티티를 유형별 컬럼으로 정렬하고, 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)
우측 패널 - 노드 목록해당 서비스를 사용하는 워크플로우별 노드 목록, 전체 선택/개별 선택

사용 방법

  1. 좌측에서 사용할 Credential을 선택합니다
  2. 우측에서 적용할 노드를 체크합니다 (전체 선택 가능)
  3. 저장 버튼으로 선택한 Credential을 선택한 노드에 일괄 적용합니다

새로운 외부 서비스를 처음 연결할 때, 오버뷰에서 해당 노드 타입을 클릭하면 OAuth 연결부터 전체 워크플로우 적용까지 한 곳에서 처리할 수 있습니다.


호버 프리뷰

엔티티 카드에 마우스를 올리면 플로팅 프리뷰 팝업이 카드 위에 표시됩니다.

프리뷰에 표시되는 정보

정보설명
아이콘 + 이름엔티티의 아이콘과 전체 이름
타입 레이블워크플로우, 데이터모델, 페이지, 노드 타입, 통계
메타 정보상태, 참조 DM 수, 카테고리 등 타입별 부가 정보
Credential 상태노드 타입의 경우 인증 문제 메시지 표시
연결 요약연결된 엔티티 수와 연결 타입별 개수

에이전트 카드에는 호버 프리뷰가 표시되지 않으며, 연결선만 표시됩니다. 에이전트의 상세 정보는 클릭 시 나타나는 메시지 팝오버에서 확인할 수 있습니다.


데이터 Import 섹션

오버뷰 하단에 데이터 Import 섹션이 표시됩니다. 워크스페이스에서 사용 중인 외부 서비스 중 Import가 지원되는 서비스를 카드로 보여주며, Credential 연결 상태도 함께 표시합니다.

상태표시
연결됨초록색 도트
미확인노란색 도트
인증 오류빨간색 도트
인증 필요빨간색 도트

서비스 카드를 클릭하면 Import 다이얼로그가 열려 해당 서비스의 데이터를 워크스페이스로 가져올 수 있습니다. 각 카드의 닫기 버튼으로 불필요한 카드를 숨길 수 있으며, 이 설정은 로컬에 저장됩니다.


AI 에이전트 섹션

오버뷰 하단에 워크스페이스에 등록된 프로액티브 AI 에이전트 목록이 표시됩니다. 각 에이전트는 아바타, 뱃지, 이름, 역할과 함께 원형 카드로 표시됩니다.

에이전트 카드 기능

  • 마우스 오버 - 연결된 리소스(트리거 대상)와의 Canvas 연결선 표시 (보라색 점선)
  • 클릭 - 최근 분석 메시지를 보여주는 팝오버 표시
  • 설정 아이콘 - 에이전트 설정 다이얼로그 열기
  • 추가 버튼 - 새 커스텀 에이전트 생성

에이전트가 특정 데이터모델, 통계, 워크플로우를 트리거 필터로 지정한 경우, 마우스 오버 시 해당 리소스와의 연결선이 Canvas에 표시됩니다.

에이전트에 대한 자세한 내용은 프로액티브 AI 인사이트 문서를 참고하세요.


오버뷰 헤더

화면 상단에 워크스페이스 이름과 함께 전체 현황 정보가 표시됩니다.

정보설명
워크스페이스 이름현재 워크스페이스 이름
인증 필요 카운터Credential 문제가 있는 노드 타입 수 (빨간색 뱃지)
엔티티 수워크플로우 + 데이터모델 + 페이지 + 통계의 총 수
새로고침 버튼관계 데이터와 Credential 상태를 다시 불러옴

데이터 소스

오버뷰의 데이터는 여러 소스에서 실시간으로 수집됩니다.

데이터소스특성
페이지, 데이터모델, 워크플로우YDoc (Yjs)실시간 동기화, 엔티티 수 변경 시 관계도 자동 갱신
통계 정의React Query API캐싱 + 주기적 갱신
엔티티 간 관계workspace-relationships API1분 stale time, 엔티티 수 변경 시 자동 갱신, 윈도우 포커스 시 갱신
Credential 상태credentials API1분 stale time, 윈도우 포커스 시 갱신
프로액티브 에이전트proactive-agents APIReact Query 기반

다음 단계