스키마와 시맨틱

AI는 테이블 이름과 칼럼 이름만으로 데이터를 짐작합니다. 스키마 설명과 시맨틱을 써 두면 AI가 조회 전에 읽고 그 기준을 따릅니다.

스키마: 테이블과 칼럼 설명링크 복사

스키마 메뉴에서 커넥터별로 테이블과 칼럼 설명을 작성합니다. 원본 데이터베이스는 바뀌지 않습니다.

1. 설명을 수정하고 초안으로 저장합니다.
2. 변경 내용을 검토하고 게시합니다.

게시한 설명만 AI에 전달됩니다. 이전 버전은 모두 보존됩니다. Google Analytics와 Airbridge는 원본이 필드 정의를 제공하므로 스키마를 읽기 전용 사전으로 보여 줍니다.

시맨틱: 업무 규칙과 지표 정의링크 복사

시맨틱은 이름이 있는 Markdown 문서입니다. 매출을 어떤 기준으로 집계하는지, 어떤 이벤트를 전환으로 보는지, 보고 시간대는 무엇인지 같은 내용을 적습니다. 커넥터 여러 개를 하나의 시맨틱에 연결할 수 있습니다.

1. 시맨틱 메뉴에서 만들기를 누릅니다.
2. 이름을 정하고 연결할 커넥터를 고릅니다.
3. 본문을 작성해 초안으로 저장합니다.
4. 상세 화면에서 내용을 확인하고 게시합니다.

버전링크 복사

• 저장할 때마다 새 초안 버전이 생기고, 게시 중인 버전은 그대로 유지됩니다.
• 게시해야 사용자와 AI에 반영됩니다.
• 이전 버전으로 되돌리면 그 내용으로 새 초안을 만듭니다. 버전을 덮어쓰거나 지우지 않습니다.
• 연결 커넥터를 바꾸면 새 초안이 생깁니다. 게시하기 전까지는 기존 연결과 권한 조건이 유지됩니다.

조회와의 관계링크 복사

여러 커넥터를 연결해도 원본끼리 합쳐 조회하지는 않습니다. 조회는 커넥터마다 따로 실행되고, 시맨틱은 그 결과를 함께 해석하는 기준이 됩니다. AI가 시맨틱을 적용해 조회하면 감사 기록에 적용한 문서와 버전이 남습니다.