용어 사전
D.Hub의 한국어 화면과 사용자 문서에서 반복해서 사용하는 용어를 정리합니다. 화면에 표시되는 한국어 명칭을 표제어로 사용하고, 구분에 도움이 되는 경우에만 영문이나 약어를 함께 표시합니다.
핵심 자산과 데이터
| 용어 | 설명 |
|---|---|
| 별칭 | 시스템 식별용 이름과 별도로 지정하는 표시 이름입니다. 별칭이 있으면 트리·목록·검색 결과에 별칭이 먼저 표시됩니다. |
| 컬렉션 | 데이터셋·소스·뷰·코드·파이프라인·지식·대시보드·에이전트처럼 함께 사용하는 자산을 묶는 작업 범위입니다. |
| 컬렉션 항목 | 컬렉션이나 폴더에 포함된 데이터셋·소스·뷰·코드·파이프라인·지식·대시보드·에이전트를 가리킵니다. |
| 데이터 연결 | 외부 데이터베이스·파일 저장소·API에 접속할 때 사용하는 연결 설정입니다. 기술 문맥에서는 Connector라고도 부릅니다. |
| 벡터 DB(Vector DB) | 텍스트나 이미지의 임베딩 벡터를 저장하고 유사도 검색에 사용하는 데이터베이스입니다. D.Hub의 데이터 연결에서는 Qdrant 같은 외부 벡터 DB의 접속 정보를 등록합니다. |
| 시크릿 | 비밀번호·API 키·액세스 키처럼 다시 노출하면 안 되는 인증 값을 별도로 보관하는 리소스입니다. 데이터 연결과 도구에서는 저장된 시크릿의 참조를 사용합니다. |
| 배치 파이프라인 | 사용자가 직접 실행하거나 저장한 일정에 따라 실행하는 파이프라인입니다. 파일 적재, 정기 집계, 대량 변환에 사용합니다. |
| 이벤트 파이프라인 | 등록한 이벤트가 들어오면 실행하는 파이프라인입니다. 실시간 수집과 이벤트 후속 처리에 사용합니다. |
| 파이프라인 노드 | 데이터 입력·변환·필터링·출력처럼 파이프라인에서 한 가지 처리를 수행하는 단계입니다. 노드를 연결해 데이터 흐름을 구성합니다. |
| 데이터 버전 | 데이터셋의 데이터를 커밋할 때 생성되는 스냅샷입니다. 특정 버전의 샘플을 미리 보거나 CSV·Parquet 파일로 내려받습니다. |
| 메타데이터 버전 | 데이터셋의 별칭·유형·설명·태그·옵션·스키마 변경을 기록한 버전입니다. 메타데이터 복원은 이 정보만 되돌리며 테이블 데이터는 롤백하지 않습니다. |
| 버전 기록 | 데이터셋·코드·파이프라인·지식·대시보드·에이전트·도구·시맨틱 리소스·연결·온톨로지의 변경 이력을 확인하는 기능입니다. 미리보기·복원·다운로드처럼 사용할 수 있는 작업은 자산 유형에 따라 다릅니다. |
| 매니페스트 | 컬렉션 시나리오나 공유 리소스를 가져올 때 자산의 메타데이터와 구성을 전달하는 JSON 정의 파일입니다. |
| 대시보드 | 데이터셋이나 질의 결과를 차트·표·지도 같은 위젯으로 표시하는 애플리케이션입니다. |
| 날짜 범위 선택기(DRS) | 대시보드의 조회 기간을 지정하는 컨트롤입니다. 위젯에 별도 시간 범위를 지정하지 않으면 선택한 범위를 위젯 질의에 적용합니다. |
| 보고서 | 데이터를 바탕으로 문서형 결과를 생성하고 관리하는 애플리케이션입니다. 보고서 생성에 사용하는 조직 공용 모델은 어시스턴트 모델에서 지정합니다. |
온톨로지
| 용어 | 설명 |
|---|---|
| 엔티티 타입 | 고객·제품·센서 같은 업무 대상의 구조를 정의합니다. 속성, 식별 키와 표시 컬럼을 설정하며 그래프에서는 같은 유형의 인스턴스가 노드로 표시됩니다. |
| 관계 타입 | 두 엔티티 타입 사이의 연결 구조와 방향을 정의합니다. 그래프에서는 해당 유형의 관계 인스턴스가 두 노드를 잇는 선으로 표시됩니다. |
| 엔티티·관계 인스턴스 | 엔티티 타입과 관계 타입의 스키마에 맞춰 적재된 실제 데이터 행입니다. 타입은 구조를 정의하고 인스턴스는 그 구조에 들어간 값을 나타냅니다. |
| 식별 키 | 엔티티나 관계 인스턴스를 고유하게 구분하는 컬럼입니다. 파이프라인에서 엔티티·관계를 입출력으로 사용하려면 지정해야 합니다. |
| 표시 컬럼 | 엔티티나 관계 인스턴스를 화면에서 대표할 값을 담은 컬럼입니다. 한 스키마에 하나만 지정합니다. |
에이전트와 시맨틱 레이어
| 용어 | 설명 |
|---|---|
| D.Hub 어시스턴트 | 제품 화면에서 질문하고 기능 사용을 도움받는 D.Hub 기본 어시스턴트입니다. 조직의 활성 어시스턴트 모델을 사용하며, 사용자가 만든 에이전트와는 독립된 기능입니다. |
| 에이전트 | LLM, 도구, 액터, 프롬프트와 시맨틱 리소스를 조합해 요청을 처리하는 자산입니다. AI 에이전트 또는 워크플로우 모드로 만들며 생성 후에는 모드를 바꿀 수 없습니다. |
| 도구 | 에이전트가 작업 중에 호출하는 기능입니다. Python 코드를 실행하거나 다른 에이전트를 호출하도록 구성합니다. |
| 액터 | 에이전트가 호출하는 Python 함수형 실행 단위입니다. 액터의 확인 정책에서 실행 전 사람 승인을 받을지 정합니다. |
| 프롬프트 | 에이전트에 적용할 시스템 지시문과 변수를 저장해 여러 에이전트에서 재사용하는 자산입니다. |
| 시맨틱 레이어 | 자연어 질문을 데이터 질의로 바꾸는 데 필요한 시맨틱 테이블·값 사전·질의 템플릿을 함께 관리하는 영역입니다. |
| 시맨틱 테이블 | 자연어 질의에 사용할 테이블과 컬럼의 의미, 관계를 정의하는 시맨틱 리소스입니다. 에이전트에 등록한 시맨틱 테이블이 데이터 질의 범위가 됩니다. |
| 값 사전 | 같은 값을 가리키는 여러 표기를 하나의 정규값으로 연결하는 사전입니다. 예를 들어 서울시와 서울특별시를 같은 값으로 연결합니다. |
| 질의 템플릿 | 반복해서 사용하는 질문 패턴, 슬롯, 대상 시맨틱 테이블과 질의를 저장하는 리소스입니다. 비슷한 질문에 검증한 질의를 다시 사용할 때 씁니다. |
| 사람 승인(HITL) | 액터의 확인 정책을 확인으로 설정했을 때 실행 전에 승인 요청 카드를 표시하는 방식입니다. 사용자는 승인 또는 거부를 선택합니다. 워크플로우 에이전트의 사용자 입력 노드는 값을 입력받는 별도 기능입니다. |
지식과 검색
| 용어 | 설명 |
|---|---|
| 지식 관리 | 문서를 수집해 검색하고 AI 채팅의 근거로 사용하는 영역입니다. 문서를 파싱·청킹·인덱싱한 뒤 문서, 채팅, 검색, 설정, 공유 및 권한 탭에서 관리합니다. |
| 청크 | 지식에 추가한 문서를 검색에 사용할 크기로 나눈 텍스트 조각입니다. 문서 형식과 목적에 맞춰 청킹 전략과 크기를 선택합니다. |
| 임베딩 | 텍스트의 의미를 비교할 수 있도록 수치 벡터로 변환한 표현입니다. 시맨틱 검색을 활성화할 때 임베딩 모델을 선택합니다. |
| 키워드 검색 | 입력한 단어나 정확한 용어가 포함된 문서 조각을 찾는 검색 방식입니다. |
| 시맨틱 검색 | 검색어와 의미가 비슷한 문서 조각을 찾는 검색 방식입니다. |
| 하이브리드 검색 | 키워드 검색과 시맨틱 검색 결과를 함께 사용하는 방식입니다. 내부 검색 알고리즘이 아니라 화면에 표시되는 검색 방식과 결과를 기준으로 선택합니다. |
| RAG | 질문과 관련된 문서를 검색해 LLM 답변의 근거로 제공하는 방식입니다. 지식의 채팅에서는 답변과 함께 인용된 원문을 확인합니다. |
| LLM | Large Language Model의 약어로, 입력한 텍스트를 바탕으로 답변이나 코드를 생성하는 언어 모델입니다. D.Hub에서는 모델의 사용 위치에 따라 LLM 모델과 어시스턴트 모델을 구분합니다. |
| LLM 모델 | 에이전트, 워크플로우 에이전트, 지식 AI 채팅에서 개별적으로 선택해 사용하는 모델 리소스입니다. 컬렉션 범위 또는 전체 공용 범위로 등록합니다. |
| 어시스턴트 모델 | D.Hub 어시스턴트, AI 코드 생성·편집, 보고서 생성이 함께 사용하는 조직 공용 모델입니다. 관리자가 활성 모델 하나를 지정합니다. |
| 모델 서빙 | 학습·추론용 ML 모델을 배포해 서비스 요청에서 사용할 수 있게 하는 기능입니다. 대화형 모델을 등록하는 LLM 모델과는 다른 화면입니다. |
계정과 접근 제어
| 용어 | 설명 |
|---|---|
| 사용자 유형 | 계정이 접근할 수 있는 관리 기능의 범위를 정하는 관리자, 매니저, 사용자 구분입니다. 개별 자산의 접근 수준을 정하는 공유 역할과는 다릅니다. |
| 공유 역할 | 컬렉션이나 자산에서 사용자·그룹이 수행할 수 있는 작업을 정하는 소유자, 편집자, 뷰어 역할입니다. 컬렉션 역할은 하위 자산에 상속됩니다. |
| 서비스 계정 | 사람이 로그인하지 않는 자동화용 계정입니다. CI·파이프라인·외부 연동에서 사용할 액세스 토큰을 발급해 D.Hub API를 호출합니다. |
| OIDC 클라이언트 | 외부 시스템이나 SSO 애플리케이션이 D.Hub 토큰을 발급받을 때 사용하는 등록 정보입니다. 사용자 로그인 위임과 서버 간 호출에 사용합니다. |
| 분류 라벨 | 민감한 리소스에 적용하는 접근 제한 라벨입니다. 해당 라벨의 접근 인가를 보유한 사용자·그룹만 리소스를 열 수 있습니다. |
다음 단계
- 핵심 개념 — D.Hub 구성 요소의 관계를 이해합니다.
- 빠른 시작 CSV 대시보드 — 샘플 데이터를 올리고 대시보드에서 결과를 확인합니다.
- API 개요 — REST API 레퍼런스를 확인합니다.