> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickHouse Cloud에서 ClickHouse Assistant chat 사용하기

> ClickHouse Cloud 콘솔에서 AI Chat 기능을 활성화하고 사용하는 방법 안내

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

> 이 가이드는 ClickHouse Cloud Console에서 AI Chat 기능을 활성화하고 사용하는 방법을 설명합니다.

<Steps>
  <Step>
    ## 사전 요구 사항

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

  <Step>
    ## AI Chat 패널 열기

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

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/pp61YI9DMmfgXVsV/images/use-cases/AI_ML/AIChat/1_open_chat.webp?fit=max&auto=format&n=pp61YI9DMmfgXVsV&q=85&s=e6ca411fde8f85af29eca3344f32a12b" alt="AI Chat 플라이아웃 열기" size="md" width="1762" height="1364" data-path="images/use-cases/AI_ML/AIChat/1_open_chat.webp" />
  </Step>

  <Step>
    ## 데이터 사용 동의 수락(최초 실행 시)

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

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/pp61YI9DMmfgXVsV/images/use-cases/AI_ML/AIChat/2_consent.webp?fit=max&auto=format&n=pp61YI9DMmfgXVsV&q=85&s=2c23641e5b4fe3f2d9074efde2ae33c0" alt="동의 대화 상자" size="md" width="1342" height="922" data-path="images/use-cases/AI_ML/AIChat/2_consent.webp" />
  </Step>

  <Step>
    ## 채팅 모드 선택

    AI Chat는 현재 다음 모드를 지원합니다:

    * **Agent**: 스키마와 메타데이터를 바탕으로 여러 단계에 걸쳐 추론합니다(서비스가 활성 상태여야 합니다).
    * **Docs AI (Ask)**: 공식 ClickHouse 문서와 모범 사례 참고 자료를 기반으로 한 집중형 질의응답입니다.

    전환하려면 플라이아웃 왼쪽 하단의 모드 셀렉터를 사용합니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/pp61YI9DMmfgXVsV/images/use-cases/AI_ML/AIChat/3_modes.webp?fit=max&auto=format&n=pp61YI9DMmfgXVsV&q=85&s=485fa9c515b763c1d6adaa0b78fb6afa" alt="모드 선택" size="sm" width="584" height="262" data-path="images/use-cases/AI_ML/AIChat/3_modes.webp" />
  </Step>

  <Step>
    ## 메시지 작성 및 전송

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

  <Step>
    ## "Agent"의 thinking 단계 이해

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

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/pp61YI9DMmfgXVsV/images/use-cases/AI_ML/AIChat/4_thinking.webp?fit=max&auto=format&n=pp61YI9DMmfgXVsV&q=85&s=a10b67c236ec7336d14db8856e3c93a5" alt="Thinking 단계" size="md" width="1702" height="1180" data-path="images/use-cases/AI_ML/AIChat/4_thinking.webp" />
  </Step>

  <Step>
    ## 새 채팅 시작

    "New Chat" 버튼을 클릭하면 컨텍스트를 지우고 새 세션을 시작할 수 있습니다.
  </Step>

  <Step>
    ## 채팅 이력 보기

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

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/pp61YI9DMmfgXVsV/images/use-cases/AI_ML/AIChat/5_history.webp?fit=max&auto=format&n=pp61YI9DMmfgXVsV&q=85&s=719ce94c7f0d417926a83123c6de2ede" alt="채팅 이력 목록" size="md" width="1754" height="634" data-path="images/use-cases/AI_ML/AIChat/5_history.webp" />
  </Step>

  <Step>
    ## 생성된 SQL 사용

    어시스턴트가 SQL을 반환하면:

    * 정확성을 검토합니다.
    * "Open in editor"를 클릭하여 쿼리를 새 SQL 탭에 불러옵니다.
    * Console에서 수정하고 실행합니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/pp61YI9DMmfgXVsV/images/use-cases/AI_ML/AIChat/6_result_actions.webp?fit=max&auto=format&n=pp61YI9DMmfgXVsV&q=85&s=4447b965b50964525834b3e541558098" alt="결과 작업" size="md" width="1746" height="1362" data-path="images/use-cases/AI_ML/AIChat/6_result_actions.webp" />

    <Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/pp61YI9DMmfgXVsV/images/use-cases/AI_ML/AIChat/7_open_in_editor.webp?fit=max&auto=format&n=pp61YI9DMmfgXVsV&q=85&s=13ef1fc0eb3148a656d03af17c1a0131" alt="생성된 쿼리를 편집기에서 열기" size="md" width="1662" height="284" data-path="images/use-cases/AI_ML/AIChat/7_open_in_editor.webp" />
  </Step>

  <Step>
    ## 응답 중지 또는 중단

    응답이 너무 오래 걸리거나 엉뚱한 방향으로 진행되는 경우:

    1. "Stop" 버튼을 클릭합니다(처리 중에 표시됨).
    2. 메시지가 중단된 것으로 표시되며, 프롬프트를 다듬어 다시 보낼 수 있습니다.
  </Step>

  <Step>
    ## 키보드 단축키

    | 작업         | 단축키                  |
    | ---------- | -------------------- |
    | AI Chat 열기 | `⌘ + '` / `Ctrl + '` |
    | 메시지 전송     | `Enter`              |
    | 새 줄        | `Shift + Enter`      |
  </Step>
</Steps>