버전 안내​

• 문서 버전은 v1.0.1로 유지됩니다. 새 버전 태그나 문서 스냅샷을 만들지 않았습니다.
• v1.0.1의 한국어·영어 문서를 current 개발 문서와 같은 내용으로 갱신했습니다. 기존 v1.0.1 주소와 링크는 그대로 사용할 수 있습니다.
• 이번 변경은 현재 제공 중인 권한 동작과 공개 API 사용법을 더 정확하게 설명하는 문서 업데이트입니다. 새로운 제품 기능이나 API 버전을 배포한 것은 아닙니다.

사용 권한 설명 통합​

공유 권한에 사용 권한(use) 전용 섹션을 추가했습니다. 커넥터·시크릿 문서와 서비스 계정 안내에 흩어져 있던 조건을 한곳에서 확인할 수 있습니다.

• 역할과 사용 권한 구분: 소유자·편집자·뷰어는 리소스의 조회·편집 범위를 정합니다. 사용 권한은 저장된 연결 정보나 시크릿 값을 실행 중에 사용하도록 허용합니다. 편집자나 뷰어 역할만으로 사용 권한이 자동 부여되지는 않습니다.
• 허용 범위 명시: 커넥터는 저장된 연결 정보와 자격 증명으로 연결을 실행합니다. 시크릿은 데이터 연결이나 도구가 저장된 값을 참조하게 합니다. 사용 권한만으로 목록을 조회하거나 설정과 비밀 값을 확인할 수는 없습니다.
• 컬렉션 전제 조건: 컬렉션 범위의 커넥터·시크릿을 사용하려면 대상이 상위 컬렉션의 소유자이거나 사용 권한을 가지고 있어야 합니다. 권한을 부여하는 사용자가 컬렉션 권한도 관리할 수 있으면 포털이 상위 컬렉션 사용 권한을 먼저 추가합니다.
• 부여·회수 동작: 리소스 소유자 또는 관리자가 커넥터·시크릿 편집 화면에서 사용자·그룹·서비스 계정을 검색해 사용 권한을 부여하거나 회수합니다. 모든 사용자에는 공개 사용 권한을 부여하지 않습니다.
• 서로 독립적인 권한: 사용 권한을 회수해도 소유자·편집자·뷰어 역할은 바뀌지 않습니다. 일반 역할을 변경해도 직접 부여한 사용 권한은 함께 회수되지 않습니다.

권한을 실제로 부여하는 화면과 절차는 데이터 연결 설정과 시크릿에서 확인할 수 있습니다.

외부 시스템에서 데이터 조회하기​

관리자 가이드에 외부 데이터 조회를 추가했습니다. 서비스 계정으로 D.Hub 데이터를 파일이나 외부 데이터베이스에 반영할 때 필요한 준비, API 호출, 증분 처리와 운영 조건을 단계별로 설명합니다.

• 서비스 계정 준비: 외부 연동 전용 서비스 계정을 만들고 액세스 토큰을 발급한 뒤 대상 데이터셋 또는 컬렉션에 뷰어 역할을 부여합니다.
• 조회 API 선택: Get Table로 전체 데이터나 제한된 행을 CSV·JSON·Parquet·Arrow 형식으로 받습니다. Query Table로 필요한 컬럼과 행을 ClickHouse SELECT 문으로 조회합니다.
• 실행 예제: cURL과 Python에서 Bearer 토큰을 사용해 데이터를 내려받거나 SQL 조회 결과를 받는 예제를 제공합니다. 데이터셋 ID와 쿼리 가이드의 데이터베이스·테이블 이름을 일치시키는 방법도 안내합니다.
• 주기적 반영 설계: 수정 시각과 안정적인 ID를 워터마크로 저장하고, 외부 데이터베이스에는 upsert 방식으로 반영합니다. 커밋 성공 뒤 워터마크를 갱신하고, 실패 시 같은 범위를 다시 처리할 수 있도록 재시도·중복 처리 기준을 설명합니다.
• 제한 사항 명시: 조회 API는 D.Hub가 변경 이벤트를 외부로 밀어내는 실시간 복제나 CDC 기능이 아닙니다. 공통 변경 커서와 삭제 이벤트를 제공하지 않으므로 필요하면 삭제 상태 컬럼이나 주기적인 전체 대조를 사용합니다.
• 오류와 토큰 운영: 401, 403, 404, SQL 오류와 응답 지연의 확인 항목을 정리했습니다. 토큰은 소스 코드와 로그에 남기지 않고, 새 토큰의 호출 성공을 확인한 뒤 이전 토큰을 폐기하도록 안내합니다.

서비스 계정의 생성, 토큰 발급·교체·폐기와 리소스 권한 부여는 서비스 계정에서 확인할 수 있습니다.

v1.0.1 한국어·영어 문서 동기화​

• 한국어 문서: current의 사용자 매뉴얼 91개, 생성된 API 참조와 사이드바 구성을 v1.0.1에 반영했습니다. 관리자 가이드의 외부 데이터 조회도 같은 탐색 구조에 포함했습니다.
• 영어 문서: 한국어 매뉴얼과 대응하는 영어 사용자 문서 91개를 같은 구조로 맞췄습니다. 사용 권한과 외부 데이터 조회 설명을 영어로 추가하고 관련 링크와 화면 이름을 갱신했습니다.
• API 참조: current에서 생성된 전체 공개 API 문서를 v1.0.1 한국어·영어 문서에 반영했습니다. 영어 문서의 API 분류와 탐색 라벨은 기존 번역을 유지했습니다.
• 주소 유지: 문서 버전을 추가하지 않았으므로 최신 문서 주소와 v1.0.1 링크 구조는 바뀌지 않습니다.

관련 설명 정정​

사용 권한을 단순 조회 권한과 혼동하지 않도록 다음 문서의 표현과 연결 경로를 함께 정리했습니다.

• 에이전트: 에이전트 만들기·배포·쿼리 템플릿에서 연결과 시크릿을 실행할 때 필요한 사용 권한을 구분했습니다.
• D.Hub 어시스턴트와 지식: 채팅에서 자산을 조회하는 권한과 실행 중 연결·비밀 값을 사용하는 권한을 나누어 설명했습니다.
• 데이터 연결과 시크릿: 목록에서 메타데이터를 보는 권한, 설정을 편집하는 권한, 저장된 값을 사용하는 권한의 차이를 명확히 했습니다.
• LLM 모델과 서비스 계정: 모델 설정 조회와 실행 권한을 구분하고, 서비스 계정의 리소스 역할과 커넥터·시크릿 사용 권한을 각각 어디에서 부여하는지 안내했습니다.
• 관리자·개발자 가이드 연결: 관리자 개요와 API 인증 문서에서 외부 데이터 조회 절차로 바로 이동할 수 있도록 링크를 추가했습니다.

이번 변경의 핵심은 버전을 올리는 것이 아니라, v1.0.1에서 확인해야 할 현재 동작과 사용 절차를 한국어·영어 문서에 동일하게 제공하는 것입니다.

화면과 동작 설명 현행화​

• 주요 기능 안내 정정: 컬렉션 · 대시보드 · 파이프라인 · 온톨로지 · 지식 · 에이전트 · 설정 등 여러 영역의 메뉴, 입력 항목, 권한, 실행 결과를 현재 화면과 동작에 맞췄습니다.
• 실제 제품 화면 추가: 온톨로지 빌더, 파이프라인 편집기, 지식, 데이터 연결, 설정, 에이전트, 모델, 보고서의 실제 화면을 추가했습니다. 계정과 운영 식별자는 제외하거나 가려서 안전하게 확인할 수 있습니다.
• 작업 결과와 제한 명확화: 일괄 작업의 부분 실패, 자산별 버전 이력, 파이프라인 연결 규칙, 정책 조회 권한처럼 작업 전에 알아야 할 조건을 관련 절차에 함께 안내합니다.

관리자 · 에이전트 가이드 보강​

• 관리자 작업 안내 확대: OIDC 클라이언트, 서비스 계정과 액세스 토큰, 분류 라벨, 어시스턴트 모델의 등록·관리 절차를 관리자 가이드에서 확인할 수 있습니다.
• 자연어 자산 계획 안내: D.Hub 어시스턴트와 AI 에이전트가 자연어 요청을 자산 계획으로 제안하고, 사용자가 내용을 검토·승인한 뒤 적용하는 흐름을 추가했습니다. 지원 자산, 승인 대기, 부분 실패와 건너뜀 조건도 함께 설명합니다.
• 에이전트 구성과 실행 설명 확대: 도구·액터, 시맨틱 자산, 가져오기, 배포, 실행 분석, 다른 에이전트 위임과 워크플로우 설정을 실제 화면 기준으로 보강했습니다.

문서 탐색 개선​

• 검색 중심 첫 화면: 문서 첫 화면에서 검색을 바로 시작하고, 사용 중인 운영체제에 맞는 검색 단축키를 확인할 수 있습니다.
• 메뉴와 제목 정리: 사이드바 메뉴와 본문 제목을 실제 제품의 짧은 메뉴명에 맞추고, 검색 결과에는 작업 목적을 알 수 있는 제목이 표시되도록 정리했습니다.
• API 참조 정비: 공개 API 계약을 기준으로 요청·응답 설명과 탐색 구조를 정리하고, 사용자에게 필요하지 않은 내부 구현 정보는 제외했습니다.

v1.0.1과 영문 매뉴얼​

• v1.0.1 문서 제공: 최신 사용자 매뉴얼을 v1.0.1 스냅샷으로 제공하고, 이전 버전에서 남아 있던 불필요한 문서 항목을 정리했습니다.
• 영문 매뉴얼 동기화: v1.0.1 영문 매뉴얼의 본문, 화면 이름, 링크와 스크린샷을 한국어 원문 구조에 맞춰 업데이트했습니다.

각 기능의 자세한 사용법은 상단 메뉴와 좌측 사이드바의 해당 영역 문서에서 확인할 수 있습니다.

용어 · 표현 다듬기​

• 사용자 관점 용어 정리: 컬렉션 · 파이프라인 · 지식 · D.Hub 어시스턴트 · 에이전트 · 정책 · 최근 항목 · 설정 등 여러 영역에서 개발자 관점의 표현을 사용자가 이해하기 쉬운 말로 다듬었습니다.
• 온톨로지 섹션 한글 표기: 온톨로지 영역의 섹션 · 기능 이름을 한글로 표기하고, 더 이상 제공되지 않는 화면에 대한 설명을 정리했습니다.
• 표기 오류 수정: 괄호 뒤에 조사가 붙어 굵게 표시되지 않던 표현을 바로잡았습니다.

스크린샷 최신화​

• 현재 화면 · 한국어 UI 반영: 대시보드 · 위젯 관리 · 컬렉션 · 파이프라인 · 지식 · 정책 · 최근 항목 · 설정, 그리고 에이전트 목록 · 에이전트 빌더 영역의 스크린샷을 현재 화면과 한국어 UI에 맞게 다시 캡처해 교체했습니다.

예제 학습 정리​

• 실습 예제를 학습 센터로 일원화: 문서 안에 있던 실습 예제를 D.Hub 학습 센터의 실습 과정으로 옮겼습니다. 상단 예제 학습 메뉴와 본문 안내 링크가 학습 센터로 연결됩니다.

각 기능의 자세한 사용법은 좌측 사이드바의 해당 영역 문서에서 확인할 수 있습니다.

컬렉션 · 데이터셋​

• 데이터 타입 안내 정정: 데이터셋에서 사용할 수 있는 데이터 타입 목록을 실제 지원 항목에 맞게 정리했습니다.
• 버전 비교 범위 명확화: 버전 간 비교(Diff)는 코드 리소스에서 제공된다는 점을 분명히 했습니다.
• 자원 작업 메뉴 정정: 트리에서 자원을 우클릭했을 때와 목록 표에서 제공되는 작업을 화면대로 구분해 안내합니다.

파이프라인 · 커넥터​

• 파이프라인 편집기 안내 정정: 좌측 패널 이름과 노드 구성, 온톨로지 추가 방법을 실제 화면에 맞췄습니다.
• 스케줄 옵션 정정: 반복 실행 프리셋(매분 · 매시간 · 매일 · 매주 · 매월) 표기를 화면과 통일했습니다.
• 커넥터 템플릿 이름 정정: 내장 템플릿을 화면에 표시되는 이름(데이터 허브 · 온톨로지 저장소 · 그래프 저장소)으로 안내합니다.

대시보드 · 홈​

• 목록 화면 정정: 대시보드 목록의 검색·필터(전체 / 내 대시보드 / 공유됨) 구성을 화면대로 설명합니다.
• 설정 항목 보강: 대시보드 설정에서 다룰 수 있는 항목을 보완했습니다.

D.Hub 어시스턴트 · 에이전트​

• 자동 연결 안내 정정: 질문에 맞는 어시스턴트가 어떻게 선택되는지 실제 동작에 맞게 다듬었습니다.
• 액터(Actor) 설명 정정: 액터가 어떤 구성 요소인지(승인 단계를 둘 수 있는 실행 단위)를 정확히 설명합니다.

이해하기 쉬운 설명​

• 차트·권한 등 화면 용어와 매뉴얼 표현을 통일하고, 이해를 방해하던 내부 용어를 사용자 친화적인 표현으로 다듬었습니다.

이 밖에도 커넥터 · 정책 · 최근 항목 · 설정 · 개발자 가이드 · 기술 참조 영역의 문서를 최신 화면에 맞게 업데이트했습니다. 각 기능의 자세한 사용법은 좌측 사이드바의 해당 영역 문서에서 확인할 수 있습니다.

컬렉션​

• 컬렉션 트리 개편: 데이터셋 · 파이프라인 · 대시보드 · 지식 · 에이전트 · 온톨로지 6종 자원을 트리에서 바로 탐색할 수 있습니다.
• 폴더 페이지: 폴더를 하나의 페이지처럼 열어 하위 자원을 모아볼 수 있습니다.
• 보기 범위 전환: 전체 / 내 자원 / 최근 세 가지 범위로 목록을 좁힐 수 있습니다.

대시보드​

• 신규 위젯 3종: 분산형(Scatter) · 마크다운(Markdown) · 외부 임베드(External Embed) 위젯을 추가했습니다.
• 데이터 범위 자동 적용: 상단 날짜 범위 설정이 위젯 쿼리에 자동으로 반영됩니다.
• 권한 기반 공유: 대시보드를 권한 설정으로 안전하게 공유할 수 있습니다.

파이프라인​

• 사람 검토(HITL) 노드: 워크플로 중간에 사람이 직접 확인·승인하는 단계를 넣을 수 있습니다.
• 엔티티 · 관계 입출력: 온톨로지 엔티티와 관계를 파이프라인 입출력으로 다룰 수 있습니다.

온톨로지​

• 식별 키 · 표시 컬럼 · 데이터 탭: 엔티티 정의와 적재된 데이터 확인을 위한 새 구성 요소를 문서화했습니다.

AI 에이전트​

• 자동 라우팅: 질문에 가장 적합한 에이전트로 자동 연결됩니다.

각 기능의 자세한 사용법은 좌측 사이드바의 해당 영역 문서에서 확인할 수 있습니다.