Snowflake Semantic Studio 활용 방법, 에이전트 오류 지표 수정

예전에는 화면 네 개를 오가야 했어요

원문에 따르면 에이전트 오류 하나를 고치려면 먼저 모니터링에서 request ID를 확인하고, 에이전트 트레이스로 어떤 도구가 원인인지 좁혔어요. 그다음 생성된 SQL을 직접 쓸 쿼리와 비교했고, Snowsight의 다른 섹션에 있는 Semantic View 편집기를 열었습니다. 이 편집기는 어떤 에이전트 오류를 고치는 중인지 맥락이 없어서 파일 맨 위에서 열렸어요. 가설을 검증하려면 워크시트에서 에이전트가 만들었을 쿼리를 손으로 써야 했고, 다시 편집기, 에이전트, 모니터링 순으로 돌아와 확인했습니다. 내부 텔레메트리상 에이전트 빌더의 절반 이상이 Semantic View UI와 에이전트 관리 UI를 왔다 갔다 했고, 빌더들이 힘들다고 꼽은 것도 편집 자체가 아니라 이 연결 작업이었다고 해요.

이번 출시로 달라진 점

Semantic Studio는 Semantic View를 Workspaces로 가져왔고, 편집기 옆 패널에서 CoCo가 함께 돌아갑니다. 탭 이동은 페이지 로드가 아니라서 정의, 평가, 평가 결과를 오가는 속도가 훨씬 빠르다고 해요.

세션은 여전히 모니터링의 request ID에서 시작해요. 이 ID를 CoCo에 주면 에이전트 설정, 실행된 쿼리, 로그를 함께 보고 어떤 지표가 왜 그 숫자를 만들었는지 자연어로 알려 줍니다. 이어서 Semantic View 수정을 요청하면 수정안이 diff로 제시되고, 수락하거나 거절하면 돼요. 시각 편집기와 YAML 편집은 항상 동기화됩니다. 정의 옆에 그 정의가 만드는 데이터가 있으니, 식을 읽고 결과를 상상하는 대신 CoCo에 반환값을 물어서 확인할 수도 있어요.

git 워크플로로 배포하기

Workspaces에서 Semantic View는 팀이 소유한 저장소의 파일이에요. 덮어쓰는 라이브 객체가 아니라 승격하는 버전이 됩니다. 수정한 뷰에 평가 세트를 먼저 돌리면 예전에 잘 되던 질문이 여전히 잘 되는지 확인할 수 있어요. 변경은 pull request로 나가고, 다른 사람이 diff와 수정 이유를 읽습니다. CI는 머지 시점에 평가를 돌릴 수 있어요. 배포는 바뀔 내용을 정확히 보여 주고 확인을 기다리며, 파일 하나로 개발, 스테이징, 프로덕션을 따로 가리킬 수 있습니다. 변경 이력에는 작성자와 사유가 남고 롤백도 됩니다.

실무 적용 체크리스트

• 에이전트 오답 제보를 받으면 모니터링의 request ID부터 확보해 CoCo에 넘기세요
• 수정안은 diff로 받아 반영 전에 평가 세트를 먼저 돌려 기존 질문이 깨지지 않는지 확인하세요
• Semantic View를 저장소에 두고 pull request 리뷰와 CI 평가 실행을 팀 규칙으로 만드세요
• 개발, 스테이징, 프로덕션 배포와 롤백 절차를 문서로 정해 두세요
• 한 줄 수정이 모든 에이전트와 BI 도구에 한꺼번에 영향을 주는 구조라서 평가 세트를 꾸준히 키워 두는 편이 안전해요

자주 묻는 질문

Snowflake Semantic Studio란 무엇인가요?

Semantic View를 작성하고 고치는 전용 IDE예요. Workspaces 안에서 SQL, 노트북, dbt 프로젝트와 같은 공간에서 쓰고, CoCo와 git 버전 관리가 통합되어 있습니다.

AI 에이전트가 틀린 답을 냈을 때 원인은 어떻게 찾나요?

모니터링에서 얻은 request ID를 CoCo에 주면 됩니다. CoCo가 에이전트 설정, 실행된 쿼리, 로그를 함께 보고 어떤 지표가 왜 그 숫자를 만들었는지 자연어로 설명해 줘요. 이어서 수정을 요청하면 diff로 받습니다.

Semantic View 변경은 어떻게 배포하나요?

일반 코드와 같은 방식이에요. pull request로 올려 리뷰하고, 머지 시 CI에서 평가를 돌릴 수 있습니다. 배포 단계에서 바뀔 내용을 확인한 뒤 진행하고, 필요하면 롤백합니다.

dbt와는 어떤 관계인가요?

원문에서는 Workspaces에 이미 있는 SQL, 노트북, dbt 프로젝트 옆에 Semantic View 작성이 들어왔다고만 밝혀요. dbt 프로젝트와 같은 작업 공간에서 지표 정의를 함께 다룰 수 있다는 의미입니다.