대화형 어시스턴트
대화형 어시스턴트는 D.Hub 어디에서든 접근할 수 있는 AI 사이드 패널 채팅입니다. 현재 페이지의 컨텍스트를 자동으로 인식하고, @멘션으로 데이터셋/컬렉션/코드/파이프라인을 참조하여 질문할 수 있습니다.
대화형 어시스턴트는 플랫폼 전반에 대한 AI 대화를 제공하며, Knowledge Chat은 특정 Knowledge에 수집된 문서 기반의 RAG 대화를 제공합니다. 두 기능은 같은 dhub2-agent 백엔드를 사용하지만 라우팅 컨텍스트와 데이터 소스가 다릅니다.
| 구분 | 대화형 어시스턴트 | Knowledge Chat |
|---|---|---|
| 접근 위치 | 모든 페이지 (사이드 패널) | Knowledge 상세 > Chat 탭 |
| 백엔드 | dhub2-agent (자동 라우팅) | dhub2-agent + Knowledge RAG |
| 데이터 소스 | 플랫폼 메타데이터 (스키마, 관계 등) | 수집된 문서 청크 (RAG) |
| @멘션 | Dataset, Collection, Code, Pipeline | 지원하지 않음 (소스 필터 사용) |
| 시각화 | 차트, 지도, 그래프 노드 | 인용(Citation) |
사이드 패널 열기
대화형 어시스턴트는 D.Hub의 모든 페이지에서 접근할 수 있습니다.
- 화면 우측의 AI 아이콘을 클릭하여 사이드 패널을 열거나 닫습니다
- 패널 너비는 레이아웃에 의해 자동 조절됩니다
- 패널은 현재 작업 화면과 나란히 표시되어 작업 흐름을 방해하지 않습니다
자동 라우팅 — AgentSelector 제거 (ADR-0050)
사이드 패널에는 에이전트 선택 드롭다운이 없습니다. 사용자는 대화 표면 하나만 보며, 백엔드의 컨텍스트 라우팅이 적절한 배포 에이전트를 자동 선택합니다.
라우팅에 사용되는 컨텍스트는 다음과 같습니다.
- 현재 페이지의 도메인(컬렉션·온톨로지·파이프라인·지식 등)
- 사용자의 입력 키워드와 @멘션 자원
- 활성 컬렉션 / 폴더
- 사용자 권한 (자동 라우팅도 권한이 없는 에이전트는 후보에서 제외)
복잡한 작업에서는 응답 상단에 어떤 에이전트가 응답하고 있는지 가 작은 라벨로 노출되어 사용자가 라우팅 결과를 확인할 수 있습니다. 별도 페이지 형식의 대화는 /agents/:agentId/chat에서 계속 사용할 수 있으며, 거기서 마지막에 선택한 에이전트는 localStorage에 보존됩니다(다음 방문에 자동 복원).
JWT 릴레이 (ADR-0053)
포털의 OIDC JWT가 dhub2-agent로 그대로 릴레이되어, 에이전트는 사용자의 권한 컨텍스트로 도구/자원에 접근합니다. 사용자에게는 별도 로그인이 보이지 않지만, 백엔드 권한 검증은 동일하게 수행됩니다.
HITL 승인 카드
자동 라우팅된 에이전트가 도구를 호출할 때, 해당 도구가 "승인 필요"로 설정되어 있으면 대화 중간에 승인 요청 카드가 표시됩니다. 승인 / 거부 / 입력 수정을 선택해 도구 호출을 제어할 수 있습니다(ADR-0035 참조). 동일한 메커니즘이 파이프라인의 HITL 노드와도 통합되어 있습니다.
컨텍스트 인식
대화형 어시스턴트는 현재 보고 있는 페이지를 자동으로 감지하여 관련 주제의 대화를 제공합니다.
| 페이지 | 컨텍스트 | 제안 질문 예시 |
|---|---|---|
| 홈 | 전체 시스템 개요 | "현재 시스템 상태를 요약해줘" |
| 온톨로지 | 엔티티, 관계, 그래프 | "이 온톨로지의 주요 엔티티 관계를 설명해줘" |
| 컬렉션 | 데이터셋, 접근 제어 | "이 컬렉션의 데이터셋 스키마를 분석해줘" |
| 파이프라인 | 워크플로우, 변환, 스케줄링 | "이 파이프라인의 데이터 흐름을 설명해줘" |
| 기타 | 일반 Data Hub 기능 | "D.Hub에서 할 수 있는 작업을 알려줘" |
패널을 열면 현재 컨텍스트에 맞는 추천 질문이 자동으로 표시됩니다. 추천 질문을 클릭하면 바로 대화가 시작됩니다.
AI 추천 생성 버튼을 클릭하면 현재 페이지 컨텍스트에 기반한 맞춤 질문을 AI가 생성해 줍니다.
@멘션으로 리소스 참조
대화 입력 시 @ 문자를 입력하면 플랫폼 리소스를 검색하고 선택할 수 있는 멘션 팝업이 표시됩니다.
참조 가능한 리소스 유형
| 유형 | 아이콘 | 설명 |
|---|---|---|
| Collection | 폴더 | 컬렉션 메타데이터 (이름, 별칭, 태그, 설명) |
| Dataset | 데이터베이스 | 데이터셋 메타데이터 및 스키마 정보 |
| Code | 코드 | 코드 아티팩트 (이름, 언어, 그룹) |
| Pipeline | 네트워크 | 파이프라인 메타데이터 (이름, 별칭, 그룹) |
사용 방법
- 입력창에서
@를 입력하면 멘션 팝업이 나타납니다 - 리소스 이름을 입력하여 검색합니다
- 원하는 리소스를 클릭하거나
Enter로 선택합니다 - 여러 리소스를 동시에 참조할 수 있습니다 (Space로 토글, Enter로 확정)
또는 입력창 왼쪽의 + 버튼을 클릭하여 리소스 선택 팝오버를 열 수 있습니다. 이 방식은 타입별로 그룹화된 전체 목록에서 탐색하기 편리합니다.
선택된 리소스는 입력창 위에 태그로 표시되며, 태그의 X 버튼으로 개별 제거가 가능합니다.
데이터셋을 @멘션하면 AI가 해당 데이터셋의 스키마를 자동으로 참조하여 더 정확한 답변을 제공합니다. 예: "@sales_data 이 데이터셋에서 월별 매출을 집계하는 SQL 쿼리를 작성해줘"
시각화 렌더링
대화형 어시스턴트는 AI 응답에 포함된 시각화 지시를 자동으로 렌더링합니다.
지원 시각화 유형
| 유형 | 설명 |
|---|---|
| Bar Chart | 카테고리별 값 비교 (수직 막대 차트) |
| Line Chart | 시계열 추이 (영역 그래프 포함) |
| Pie Chart | 구성 비율 (파이/도넛 차트) |
| Map View | 위치 데이터의 지도 시각화 (위도/경도 마커) |
| Graph Node | 온톨로지 그래프 탐색기의 노드 참조 하이라이트 |
온톨로지 페이지에서 대화 중 AI가 언급한 엔티티/노드는 자동으로 감지되어, 응답 하단에 노드 참조 패널로 표시됩니다. 노드를 클릭하면 Graph Explorer에서 해당 노드가 포커싱됩니다. 이 기능은 Graph Explorer가 열려 있을 때만 동작합니다.
대화 관리
- 각 대화에 응답 시간이 표시되어 AI 성능을 모니터링할 수 있습니다
- 중지 버튼으로 생성 중인 응답을 취소할 수 있습니다
- 대화 이력은 패널이 열려 있는 동안 유지됩니다
Thinking Indicator
AI가 응답을 생성하는 동안 4단계 진행 상태가 표시됩니다:
- 생각 중 (Thinking)
- 데이터베이스 검색 중 (Searching Database)
- 결과 처리 중 (Processing Results)
- 응답 생성 중 (Generating Response)
다음 단계
- AI 코드 생성 및 인라인 편집 - 파이프라인 코드 에디터의 AI 기능
- Knowledge AI 채팅 - RAG 기반 문서 질의 AI 채팅