> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/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 콘솔에서 AI Chat 기능을 사용 설정하고 사용하는 방법을 설명합니다.

<Steps>
  <Step title="사전 요구 사항" id="prerequisites">
    1. AI 기능이 활성화된 ClickHouse Cloud 조직에 대한 액세스 권한이 있어야 합니다(사용할 수 없는 경우 조직 관리자 또는 지원팀에 문의하십시오).
  </Step>

  <Step title="AI Chat 패널 열기" id="open-panel">
    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/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/1_open_chat.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=99adfce6ae6ec1ea4e895688ebcb96f2" alt="AI Chat 플라이아웃 열기" size="md" width="1762" height="1364" data-path="images/use-cases/AI_ML/AIChat/1_open_chat.webp" />
  </Step>

  <Step title="데이터 사용 동의 수락(최초 실행 시)" id="consent">
    1. 처음 사용할 때 데이터 처리 방식과 타사 LLM 서브프로세서에 대한 설명이 포함된 동의 대화상자가 표시됩니다.
    2. 계속하려면 내용을 검토한 뒤 동의하십시오. 거부하면 패널이 열리지 않습니다.

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

  <Step title="채팅 모드 선택" id="modes">
    AI Chat는 현재 다음 모드를 지원합니다:

    * **Agent**: schema와 metadata를 기반으로 여러 단계를 거쳐 추론합니다(서비스가 실행 중이어야 함).
    * **Docs AI (Ask)**: 공식 ClickHouse 문서와 모범 사례 참고 자료를 기반으로 질문에 답합니다.

    전환하려면 플라이아웃 왼쪽 하단의 모드 셀렉터를 사용하십시오.

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

  <Step title="메시지 작성 및 전송" id="compose">
    1. 질문을 입력합니다(예: “사용자별 일일 이벤트를 집계하는 materialized view 생성”).
    2. <kbd>Enter</kbd>를 눌러 전송합니다(줄바꿈은 <kbd>Shift</kbd> + <kbd>Enter</kbd>를 사용).
    3. 모델이 처리 중일 때는 “Stop”을 클릭하여 중단할 수 있습니다.
  </Step>

  <Step title="“Agent” thinking 단계 이해" id="thinking-steps">
    Agent 모드에서는 펼쳐서 볼 수 있는 중간 “thinking” 단계 또는 계획 단계를 볼 수 있습니다. 이를 통해 어시스턴트가 답변을 구성하는 과정을 확인할 수 있습니다. 필요에 따라 접거나 펼치십시오.

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

  <Step title="새 채팅 시작" id="new-chats">
    “New Chat” 버튼을 클릭하여 기존 맥락을 지우고 새 세션을 시작합니다.
  </Step>

  <Step title="채팅 이력 보기" id="history">
    1. 아래 섹션에 최근 채팅이 표시됩니다.
    2. 이전 채팅을 선택하여 해당 메시지를 불러옵니다.
    3. 휴지통 아이콘을 사용하여 대화를 삭제합니다.

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

  <Step title="생성된 SQL 작업" id="sql-actions">
    어시스턴트가 SQL을 반환하면 다음을 수행하십시오:

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

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/6_result_actions.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=409c86a0ec90d48221a6dfdffcb7945f" 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/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/7_open_in_editor.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=ff40fb5f4aea3697dda1db999622d341" alt="생성된 쿼리를 editor에서 열기" size="md" width="1662" height="284" data-path="images/use-cases/AI_ML/AIChat/7_open_in_editor.webp" />
  </Step>

  <Step title="응답 중지 또는 중단" id="interrupt">
    응답이 너무 오래 걸리거나 의도와 다른 방향으로 흘러가는 경우:

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

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