메인 콘텐츠로 건너뛰기
이 가이드는 ClickHouse Cloud Console에서 AI Chat 기능을 활성화하고 사용하는 방법을 설명합니다.
1

​
사전 요구 사항

  1. AI 기능이 활성화된 ClickHouse Cloud 조직에 대한 액세스 권한이 있어야 합니다(사용할 수 없으면 조직 관리자 또는 지원팀에 문의하십시오).
2

​
AI Chat 패널 열기

  1. ClickHouse Cloud 서비스로 이동합니다.
  2. 왼쪽 사이드바에서 “ClickHouse Assistant”라고 표시된 반짝이 아이콘을 클릭합니다.
  3. (단축키) ⌘ + ’ (macOS) 또는 Ctrl + ’ (Linux/Windows)를 눌러 패널 열기/닫기를 전환합니다.
3

​
데이터 사용 동의 수락(최초 실행 시)

  1. 처음 사용할 때 데이터 처리 방식과 제3자 LLM 하위 처리업체를 설명하는 동의 대화 상자가 표시됩니다.
  2. 계속하려면 내용을 검토하고 동의하십시오. 거부하면 패널이 열리지 않습니다.
4

​
채팅 모드 선택

AI Chat는 현재 다음 모드를 지원합니다:
  • Agent: 스키마와 메타데이터를 바탕으로 여러 단계에 걸쳐 추론합니다(서비스가 활성 상태여야 합니다).
  • Docs AI (Ask): 공식 ClickHouse 문서와 모범 사례 참고 자료를 기반으로 한 집중형 질의응답입니다.
전환하려면 플라이아웃 왼쪽 하단의 모드 셀렉터를 사용합니다.
5

​
메시지 작성 및 전송

  1. 질문을 입력합니다(예: “사용자별 일일 이벤트를 집계하는 materialized view를 생성해 주세요”).
  2. 전송하려면 Enter를 누릅니다(줄바꿈하려면 Shift + Enter를 사용).
  3. 모델이 처리 중일 때는 “Stop”을 클릭하여 중단할 수 있습니다.
6

​
”Agent”의 thinking 단계 이해

Agent 모드에서는 확장 가능한 중간 “thinking” 단계 또는 계획 단계를 볼 수 있습니다. 이를 통해 어시스턴트가 답변을 구성하는 방식을 투명하게 확인할 수 있습니다. 필요에 따라 접거나 펼치십시오.
7

​
새 채팅 시작

“New Chat” 버튼을 클릭하면 컨텍스트를 지우고 새 세션을 시작할 수 있습니다.
8

​
채팅 이력 보기

  1. 아래쪽 섹션에 최근 채팅이 표시됩니다.
  2. 이전 채팅을 선택하여 해당 메시지를 불러옵니다.
  3. 휴지통 아이콘을 사용해 대화를 삭제합니다.
9

​
생성된 SQL 사용

어시스턴트가 SQL을 반환하면:
  • 정확성을 검토합니다.
  • “Open in editor”를 클릭하여 쿼리를 새 SQL 탭에 불러옵니다.
  • Console에서 수정하고 실행합니다.
10

​
응답 중지 또는 중단

응답이 너무 오래 걸리거나 엉뚱한 방향으로 진행되는 경우:
  1. “Stop” 버튼을 클릭합니다(처리 중에 표시됨).
  2. 메시지가 중단된 것으로 표시되며, 프롬프트를 다듬어 다시 보낼 수 있습니다.
11

​
키보드 단축키

마지막 수정일 2026년 6월 25일