> ## 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 Agents의 대화, 북마크, 고정된 대화, 포크, 키보드 단축키 및 채팅 공유

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>;
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>베타</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                베타 기능. 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        자세히 보기.
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

ClickHouse Agents의 채팅 화면에서는 대화, 브랜치, 공유를 처리합니다.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/chat.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=40b793ab5116b74db09a7e7d949c43ab" alt="왼쪽 탐색, 에이전트 아이덴티티 헤더, 메시지 컴포저를 보여주는 ClickHouse Agent 채팅 화면" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/chat/chat.webp" />

<div id="conversations">
  ## 대화
</div>

왼쪽 탐색 메뉴에서 컴포즈 아이콘을 클릭해 새 대화를 시작합니다.
대화 창 왼쪽 상단의 Agent 셀렉터 대화상자에서 사용할 에이전트를 선택하십시오. 기본적으로 **ClickHouse Agent**가 선택되어 있습니다.
이제 컴포저에 메시지를 입력한 뒤 전송을 누르면 됩니다. 각 대화는 사이드바 이력에 저장되며, 나중에 다시 열거나 이름을 바꾸거나 삭제할 수 있습니다.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/conversation.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=e2136c5ef501977addd78dc876ec4506" alt="왼쪽 탐색 메뉴에서 컴포즈 아이콘이 강조 표시된 채팅 화면, 저장된 Top 10 Tables Ranked 대화가 보이는 Chats 이력 사이드바, 그리고 예시 질문이 입력된 컴포저" size="lg" width="3838" height="1934" data-path="images/cloud/agent-builder/chat/conversation.webp" />

모든 메시지는 해당 위치에서 바로 수정할 수 있으며, 에이전트는 대화 이력의 그 지점부터 응답을 다시 생성합니다.
메시지를 다시 보내지 않고도 에이전트의 마지막 응답만 다시 생성할 수도 있습니다.

<div id="bookmarks">
  ## 북마크
</div>

메시지 하나 또는 전체 대화를 북마크해 두면 나중에 빠르게 다시 찾을 수 있습니다. 북마크는 사용자에게만 표시되며, 대화 이름을 변경해도 그대로 유지됩니다.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/bookmark.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=4dcc2c1f6ca113239ee66fd92d4249af" alt="북마크 아이콘이 강조 표시되고 「Add Bookmarks」 툴팁이 표시된 채팅 헤더" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/chat/bookmark.webp" />

<div id="pinned-conversations">
  ## 고정된 대화
</div>

대화를 고정하면 사이드바 맨 위에 표시되어, 아래에 있는 날짜별 이력과 구분됩니다. 사이드바에서 해당 대화의 옵션 메뉴(점 3개 아이콘)를 열고 **Pin**을 선택하세요. 고정된 대화는 **Today**, **Yesterday** 및 그보다 이전 그룹 위의 **Pinned** 섹션에 모입니다.

고정을 해제하려면 같은 메뉴를 열고 **Unpin**을 선택하세요.

<div id="forking">
  ## 포킹
</div>

포킹은 특정 메시지에서 분기된 새 대화를 만듭니다. 원래 스레드를 방해하지 않고 다른 경로를 탐색할 때 사용할 수 있습니다.
사용할 수 있는 포크 모드는 3가지입니다.

* **표시된 메시지만** - 포크된 메시지까지의 직접 경로만 복사할 수 있습니다.
* **관련 분기 포함** - 기본 경로와 기존 분기를 함께 복사할 수 있습니다.
* **여기까지 모두 포함** - 포크된 메시지까지의 모든 내용을 복사할 수 있습니다.

포크된 대화는 서로 독립적이므로 변경 사항이 원본에 다시 동기화되지는 않습니다.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/fork.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=625c66f6474f782c4f9c7bd7621501b3" alt="3가지 포크 모드 아이콘, Start fork here 및 Remember 체크박스, 그리고 아래의 메시지 작업 도구 모음을 보여 주는 포크 옵션 선택 대화상자" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/chat/fork.webp" />

<div id="sharing-chats">
  ## 채팅 공유
</div>

어떤 대화든 공유 가능한 링크를 생성해 팀원에게 보내거나 참고용으로 저장할 수 있습니다. 수신자는 아티팩트와 표시된 분기를 포함한 읽기 전용 보기를 볼 수 있습니다. 링크는 언제든지 공유 대시보드에서 철회할 수 있습니다.

기존 메시지를 수정하면 공유 보기에도 반영되지만, 링크를 생성한 후에 추가된 메시지는 표시되지 않습니다.

공유 링크를 보는 누구나 **Continue this chat**를 클릭해 자신의 계정에서 해당 대화를 이어갈 수 있습니다. 그러면 보고 있는 분기를 포함한 대화가 새로운 비공개 대화로 이력에 복사되며, 원래 대화는 그대로 유지됩니다.

대화를 공유하려면 사이드바에서 해당 대화의 메뉴를 열고 **Share**를 선택하세요:

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/share.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=b17141a695c412b3e6257f636fdc4ef3" alt="사이드바의 대화 메뉴에 Share, Rename, Duplicate, Archive, Delete 옵션이 표시된 모습" size="lg" width="3838" height="1934" data-path="images/cloud/agent-builder/chat/share.webp" />

그런 다음 공유 대화상자에서 **Create link**를 클릭하세요:

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat/share-modal.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=58d6f829ef37ec6b5f29788431b9b080" alt="채팅 공유 링크 대화상자에 Create link 버튼과 공유 후 추가된 메시지 및 이름은 비공개로 유지된다는 안내가 표시된 모습" size="md" width="1098" height="424" data-path="images/cloud/agent-builder/chat/share-modal.webp" />

<div id="keyboard-shortcuts">
  ## 키보드 단축키
</div>

`Cmd+Shift+/`(Windows 및 Linux에서는 `Ctrl+Shift+/`)를 사용하거나 계정 메뉴의 **Help** → **Keyboard shortcuts**에서 키보드 단축키 참고를 여십시오. 모든 단축키는 사용자 지정할 수 있습니다. 대화상자에서 행을 클릭해 새 키 조합을 지정하고, **Reset all to defaults**를 사용해 기본값으로 되돌리십시오.

기본 단축키는 다음과 같습니다.

| 동작              | macOS                 | Windows 및 Linux        |
| --------------- | --------------------- | ---------------------- |
| 키보드 단축키 표시      | `Cmd+Shift+/`         | `Ctrl+Shift+/`         |
| 새 채팅            | `Cmd+Shift+O`         | `Ctrl+Shift+O`         |
| 채팅 입력창으로 포커스 이동 | `Shift+Esc`           | `Shift+Esc`            |
| 파일 업로드          | `Cmd+Shift+U`         | `Ctrl+Shift+U`         |
| 마지막 응답 복사       | `Cmd+Shift+;`         | `Ctrl+Shift+;`         |
| 메시지 전송          | `Cmd+Enter`           | `Ctrl+Enter`           |
| 사이드바 표시 전환      | `Cmd+Shift+S`         | `Ctrl+Shift+S`         |
| 모델 선택기 열기       | `Cmd+Shift+M`         | `Ctrl+Shift+M`         |
| 검색으로 포커스 이동     | `Cmd+/`               | `Ctrl+/`               |
| 설정 열기           | `Cmd+Shift+,`         | `Ctrl+Shift+,`         |
| 대화 북마크          | `Cmd+Shift+B`         | `Ctrl+Shift+B`         |
| 생성 중지           | `Cmd+Shift+X`         | `Ctrl+Shift+X`         |
| 응답 다시 생성        | `Cmd+Shift+E`         | `Ctrl+Shift+E`         |
| 마지막 메시지 편집      | `Cmd+Shift+I`         | `Ctrl+Shift+I`         |
| 응답 이어서 생성       | `Cmd+Shift+C`         | `Ctrl+Shift+C`         |
| 마지막 코드 블록 복사    | `Cmd+Shift+K`         | `Ctrl+Shift+K`         |
| 맨 위로 스크롤        | `Cmd+Shift+Up`        | `Ctrl+Shift+Up`        |
| 맨 아래로 스크롤       | `Cmd+Shift+Down`      | `Ctrl+Shift+Down`      |
| 대화 보관           | `Cmd+Shift+L`         | `Ctrl+Shift+L`         |
| 대화 삭제           | `Cmd+Shift+Backspace` | `Ctrl+Shift+Backspace` |

또한 agents, prompts, files, bookmarks 같은 패널을 여는 단축키를 직접 지정할 수도 있습니다. 이들에는 기본 키가 없습니다.
