이 문서는 앞선 Ontology 문서를 실행 순서로 정리한 체크리스트입니다. 함께 보면 좋은 문서:
우선순위 체크리스트
Genie의 검색 결과와 SQL 정확도를 높이려면 아래 순서로 컨텍스트를 정비합니다. 각 항목에 “왜 좋아지는가”를 한 줄로 덧붙였습니다. 근거는 Genie best practices와 Unity Catalog 비즈니스 시맨틱 문서입니다.항목별 근거
1. 핵심 KPI를 certified Metric View로
Metric view는 metrics·dimensions·aggregation을 미리 정의하므로 Genie Agents에 특히 효과적입니다. 표준 정의를 certify해 두면 Genie가 검증된 지표를 재사용합니다. 자세한 방법은 Metric View로 지표 표준화를 보세요.2. Domains·Pages로 권위 컨텍스트
Domain은 관련 자산 범위를 좁히고, Page는 비즈니스 개념을 authoritative source로 정의합니다. 방법은 Domain과 Pages로 컨텍스트 구조화에 정리했습니다.3. 컬럼 description·synonyms
Genie는 Unity Catalog 컬럼 이름과 description으로 응답을 생성합니다. 품질 좋은 description과 synonyms는 Genie가 컬럼을 더 잘 이해하고, 관련 질문에 그 컬럼을 고르며, 더 정확한 SQL을 쓰도록 돕습니다.4. 복잡 질의에 example SQL
해석이 어렵거나 여러 단계로 나뉘거나 복합적인 질문에는 완성된 example SQL 쿼리를 제공합니다. Genie가 따라 쓸 정답 형태를 갖게 됩니다.5. 비즈니스 시맨틱은 SQL expression으로
지표와 필터 같은 비즈니스 시맨틱은 SQL expression으로 정의합니다. SQL expression과 예시로 해결되지 않을 때만 텍스트 instruction을 최후 수단으로 씁니다.6. certified 우선·deprecated 회피
certification은 조직이 보증한 자산으로 Genie를 유도합니다. deprecated 신호는 낡은 자산을 피하게 합니다.7. 측정·반복
실제 질의 결과와 사용자 피드백을 보고 synonyms와 정의를 계속 다듬습니다. Ontology는 한 번 만들고 끝내는 것이 아니라 반복해서 개선하는 대상입니다.큐레이션 실무 흐름
위 체크리스트를 Genie Agent에서 실제로 적용하는 흐름입니다. 근거는 Genie Agent 설정 문서입니다.- 데이터 소스 선택 (최대 30개 테이블·뷰) — 하나의 Genie Agent는 최대 30개 테이블/뷰를 대상으로 합니다. 범위를 넓게 잡기보다, 한 도메인의 핵심 자산으로 좁히는 편이 검색 정확도에 유리합니다.
- Genie Code의 자동 컨텍스트 제안 검토 — Agent 생성 시 Genie Code가 데이터를 읽어 테이블 설명과 example query 같은 컨텍스트를 자동 제안합니다. Review Suggested Queries 대화상자에서 제안된 쿼리를 수락/거절해 SQL 컨텍스트를 채웁니다. 자동 제안을 그대로 두지 말고, 잘못된 예시는 걸러내세요.
- example SQL·instructions·knowledge store 추가 — 공유 전에 example SQL 쿼리, instructions, knowledge store 설정을 더해 응답 정확도를 높입니다.
- Agent 컨텍스트를 Metric View로 export — Genie Agent에 구성한 데이터·시맨틱 컨텍스트를 Metric View로 export할 수 있습니다. Agent에서 다듬은 정의를 조직 표준 지표로 승격해 재사용하는 경로입니다.
- 반복 — Genie Agent는 테스트와 실제 사용을 보며 반복 개선하는 것을 전제로 합니다.