> ## 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의 Assistant

> ClickHouse Cloud 콘솔에서 Assistant를 알아보고, 활성화하고, 사용하는 방법

Assistant를 사용하면 자연어로 ClickHouse Cloud 서비스의 데이터를 분석할 수 있습니다. 활성 탭, 저장된 쿼리, 스키마(schema), 대시보드 등의 맥락을 바탕으로 쿼리, 시각화 및 요약을 생성할 수 있습니다.

Assistant에는 ClickHouse 문서를 기반으로 질문에 답하는 Docs AI 모드도 포함되어 있습니다. 이 가이드를 따라 Assistant를 활성화하고 ClickHouse Cloud 콘솔에서 두 모드를 모두 사용하십시오.

**1. 사전 요구 사항**

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

**2. AI Chat 패널 열기**

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

![AI Chat 플라이아웃 열기](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/1_open_chat.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=ad98d16b98abcc8875a9fef907045155)

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

1. 처음 사용할 때 데이터 처리 방식과 타사 LLM 서브프로세서에 대한 설명이 포함된 동의 대화상자가 표시됩니다.
2. 계속하려면 내용을 검토한 뒤 동의하십시오. 거부하면 패널이 열리지 않습니다.

![동의 대화상자](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/2_consent.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=ff56a1b3e6b5407ff95c4e1e89df7b9a)

**4. 채팅 모드 선택**

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

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

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

![모드 선택](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/3_modes.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=e695326686cbf96050905e3f1eb42a1e)

**5. 메시지 작성 및 전송**

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

**6. “Agent” thinking 단계 이해**

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

![Thinking 단계](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/4_thinking.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=23a1a324e86591f69328228de6c7c08d)

**7. 새 채팅 시작**

“New Chat” 버튼을 클릭하여 기존 맥락을 지우고 새 세션을 시작합니다.

**8. 채팅 이력 보기**

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

![채팅 이력 목록](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/5_history.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=9b3c8d9265e906889c3ddd18d6d29485)

**9. 생성된 SQL 작업**

어시스턴트가 SQL을 반환하면 다음을 수행하십시오:

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

![결과 작업](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/6_result_actions.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=1ca9b4c9c987b0dc3fd2c7b0c6d205c6)

![생성된 쿼리를 editor에서 열기](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/7_open_in_editor.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=148eb60e6217aeea2c091ed40fc5e364)

**10. 응답 중지 또는 중단**

응답이 너무 오래 걸리거나 의도와 다른 방향으로 흘러가는 경우:

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

**11. 키보드 단축키**

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