데이터 소스 커넥터

데이터 소스 커넥터 (Data Source Connectors)

합성 골든스를 생성하려면 먼저 외부 데이터 소스를 연결해야 해요. 각 커넥터는 소스 플랫폼의 자격 증명을 요구하죠. 이 페이지에서는 지원되는 모든 소스 유형의 설정 과정을 하나씩 안내할게요.

출처: 문서

본문

개요

합성 골든스를 생성하기 전에 Project Settings > Data Sources에서 데이터 소스를 연결해야 해요. 각 커넥터는 소스 플랫폼의 자격 증명을 요구해요. 이 페이지에서는 지원되는 모든 소스 유형의 설정을 안내해요.

Google Drive

자격 증명 설정

Google Cloud 프로젝트 만들기

Google Cloud Console로 이동해 프로젝트를 만들거나 기존 프로젝트를 사용해요.

Google Drive API 활성화

APIs & Services > Library로 이동해 "Google Drive API"를 검색하고 Enable을 클릭해요.

서비스 계정 만들기

IAM & Admin > Service Accounts > Create Service Account로 이동해 이름을 정하고 생성 마법사를 마무리해요.

JSON 키 다운로드

방금 만든 서비스 계정을 클릭하고 Keys 탭으로 이동한 뒤 Add Key > Create new key > JSON을 선택해요. 파일이 머신에 다운로드돼요. 모양은 다음과 같아요:

{
  "type": "service_account",
  "project_id": "my-project",
  "private_key_id": "abc123",
  "private_key": "[REDACTED PRIVATE KEY]\n",
  "client_email": "[email protected]",
  "client_id": "123456789",
  ...
}

데이터 준비

Google Drive에 폴더 만들기

Google Drive에 새 폴더를 만들고 폴더 URL을 복사해요. 모양은 다음과 같아요:

https://drive.google.com/drive/folders/1ABcDeFgHiJkLmNoPqRsTuVwXyZ

서비스 계정과 폴더 공유

폴더를 우클릭하고 Share를 선택한 뒤, 다운로드한 JSON 키 파일의 client_email(예: [email protected])을 추가해요. Viewer 접근 권한을 부여해요.

파일 추가

의미 있는 텍스트 콘텐츠가 있는 .txt, .pdf, .docx 파일을 폴더에 넣어요. 각 파일은 최소 몇 단락은 포함해야 청킹 과정에서 골든스 생성에 충분한 컨텍스트가 생겨요.

Confident AI에서 연결하기

데이터 소스 추가

Project Settings > Data Sources > Add로 이동해 입력해요:

필드	값
Name	설명적인 이름 (예: "My Google Drive")
Type	Google Drive
Service Account JSON	다운로드한 JSON 키의 전체 내용을 붙여넣어요
Folder URL	이전 단계의 Google Drive 폴더 URL

생성 설정 만들기

Datasets > Automations > Generate from Data Source > Add generation config로 이동해 설정해요:

필드	값
Name	이 설정의 이름
Data Source	만든 데이터 소스를 선택
Max Goldens Per Context	청크당 골든스 수 (예: 2)

생성하기

Generate를 클릭해 합성 골든스 생성 과정을 시작해요.

Slack

자격 증명 설정

Slack 앱 만들기

Slack API > Create New App > From scratch로 이동해 이름을 정하고 워크스페이스를 선택해요.

봇 토큰 스코프 추가

OAuth & Permissions > Bot Token Scopes로 이동해 다음 스코프를 추가해요:

Scope	용도
`channels:history`	채널에서 메시지 읽기
`channels:read`	사용 가능한 채널 목록
`users:read`	사용자 이름 해석 (선택)

워크스페이스에 설치

Install to Workspace를 클릭하고 Bot User OAuth Token(xoxb-...로 시작)을 복사해요.

채널에 봇 초대

Slack에서 포함하려는 각 채널로 이동해 /invite @YourBotName을 입력해 봇에 접근 권한을 줘요.

Confident AI에서 연결하기

데이터 소스 추가

Project Settings > Data Sources > Add로 이동해 입력해요:

필드	값
Name	설명적인 이름 (예: "My Slack")
Type	Slack
Bot Token	Bot User OAuth Token (예: `xoxb-1234...`)

생성 설정 만들고 생성하기

이 데이터 소스를 가리키는 생성 설정을 만든 뒤 Generate를 클릭해요.

기대할 수 있는 것

메시지는 channel_messages 스트림에서 읽혀요
각 문서의 텍스트는 모든 메시지가 시간순으로 이어진 것이에요
메시지가 매우 적은 채널은 빈 문서를 만들 수 있는데, 이는 자동으로 필터링돼요

Notion

자격 증명 설정

Notion 통합 만들기

Notion Integrations > New integration으로 이동해 이름을 정하고 워크스페이스를 선택해요.

통합 토큰 복사

Internal Integration Token(secret_...로 시작)을 복사해요.

통합에 페이지 연결

포함하려는 각 Notion 페이지에서 ... 메뉴 > Connections > 내 통합 찾기 > Connect를 클릭해요.

통합은 명시적으로 공유된 페이지에만 접근할 수 있어요. 통합에 연결되지 않은 페이지는 포함되지 않아요.

Confident AI에서 연결하기

데이터 소스 추가

Project Settings > Data Sources > Add로 이동해 입력해요:

필드	값
Name	설명적인 이름 (예: "My Notion")
Type	Notion
Integration Token	Notion 통합 토큰 (`secret_...`)

생성 설정 만들고 생성하기

이 데이터 소스를 가리키는 생성 설정을 만든 뒤 Generate를 클릭해요.

기대할 수 있는 것

페이지는 제목을 제공하고, 블록은 실제 텍스트 콘텐츠를 제공해요
문서는 페이지별로 조합돼요: 제목 + 모든 블록 텍스트 연결
이미지나 임베드만 있고 텍스트 콘텐츠가 없는 페이지는 필터링돼요

SharePoint

자격 증명 설정

Azure에서 앱 등록

Azure Portal > Azure Active Directory > App registrations > New registration으로 이동해요. Application (client) ID와 Directory (tenant) ID를 기록해두세요.

클라이언트 시크릿 만들기

Certificates & Secrets > New client secret으로 이동해요. Value(시크릿 ID가 아니라)를 복사해요.

API 권한 추가

API Permissions > Add a permission > Microsoft Graph > Application permissions로 이동해 추가해요:

권한	용도
`Sites.Read.All`	SharePoint 사이트 콘텐츠 읽기
`Files.Read.All`	조직 전체의 파일 읽기

Grant admin consent를 클릭해요 (Azure AD 관리자 필요).

Confident AI에서 연결하기

데이터 소스 추가

Project Settings > Data Sources > Add로 이동해 입력해요:

필드	값
Name	설명적인 이름 (예: "My SharePoint")
Type	SharePoint
Tenant ID	Azure의 Directory (tenant) ID
Client ID	Azure의 Application (client) ID
Client Secret	복사한 클라이언트 시크릿 값

생성 설정 만들고 생성하기

이 데이터 소스를 가리키는 생성 설정을 만든 뒤 Generate를 클릭해요.

데이터 소스 커넥터