<a id="self-hosted-agent-memory-on-clickhouse"></a>

# ClickHouse 기반 셀프 호스팅 에이전트 메모리

<!-- i18n: source=docs/use-cases/self-hosted-clickhouse.md blob=347e84ca2fb7bc0a85662a875e99064979582695 model=claude-sonnet-5-5 -->
> 이 페이지는 [영어 원문](https://github.com/ClickHouse/loom/blob/main/docs/use-cases/self-hosted-clickhouse.md)을 기계 번역한 것이며, 영어 원문이 기준입니다.
> Machine-translated from the [English page](https://github.com/ClickHouse/loom/blob/main/docs/use-cases/self-hosted-clickhouse.md), which is authoritative.


Loom은 Docker 또는 Helm 차트를 이용한 Kubernetes 환경에서 사용자의 인프라 위에서 실행되며, 에이전트 메모리, 문서, 대화, 코드 인덱스를 ClickHouse의 테이블로 저장합니다. 배포 환경에서는 최초 부팅 시 라이브 메모리와 지식 상태용으로 Postgres를 선택할 수 있습니다. 데이터는 사용자의 저장소에만 저장되며(사용자가 구성한 호스팅 모델 제공자와 트레이스 싱크는 자신이 처리하는 데이터를 수신합니다), 에이전트가 알고 있는 내용은 SQL로 조회할 수 있습니다.

<a id="what-you-get"></a>

## 제공 기능

- **Docker 또는 Kubernetes.** 한 줄 설치 프로그램이 로컬 스택을 시작하며, Helm 차트는 하나의 URL 뒤에서 동일한 레플리카 N개를 실행합니다. [배포](https://github.com/ClickHouse/loom/blob/main/docs/operations/deployment.md) ·
  [Kubernetes](https://github.com/ClickHouse/loom/blob/main/docs/operations/kubernetes.md) · [레플리카 N개 실행](https://github.com/ClickHouse/loom/blob/main/docs/operations/replicas.md)
- **ClickHouse OSS 또는 ClickHouse Cloud.** [ClickHouse 선택하기](https://github.com/ClickHouse/loom/blob/main/docs/operations/deployment.md#choosing-the-clickhouse) ·
  [ClickHouse Cloud와 Managed Postgres](https://github.com/ClickHouse/loom/blob/main/docs/operations/clickhouse-cloud.md)
- **벡터, 텍스트, 감사를 위한 단일 저장소.** 기본 ClickHouse 오소리티에서는 벡터, 어휘, 그래프 검색과 필터, 감사, 삭제가 하나의 데이터베이스 안에서 SQL로 처리됩니다.
  [저장소 오소리티](https://github.com/ClickHouse/loom/blob/main/docs/architecture/storage-authority.md)
- **멀티 유저.** 조직, 네임스페이스, 역할, 토큰, 싱글 사인온을 지원합니다.
  [ID와 네임스페이스](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md) ·
  [싱글 사인온](https://github.com/ClickHouse/loom/blob/main/docs/operations/sso.md)
- **로컬 모델.** 릴리스된 스택은 번들로 포함된 로컬 모델로 CPU에서 임베딩을 수행하며, 임베딩 제공자는 사용자가 운영하는 OpenAI 호환 엔드포인트도 받을 수 있습니다.
  [모델과 API 키](https://github.com/ClickHouse/loom/blob/main/docs/getting-started/models-and-keys.md)

<a id="measured"></a>

## 측정 결과

키당 버전이 2.4개이고 3072차원 임베딩(행당 벡터 2개)을 가진 메모리의 합성 부하를 적용했을 때, ClickHouse에서 키당 약 13.6 KB가 사용되었으며 거의 전부가 임베딩 행이었습니다. 더 작은 임베더는 더 적게 사용하며, 행 수가 적은 파트는 병합되기 전까지 행당 다소 더 많은 공간을 차지합니다.
[대규모 메모리](https://github.com/ClickHouse/loom/blob/main/docs/benchmarks/results.md#memory-at-scale)

<a id="start"></a>

## 시작하기

[빠른 시작](/ko/getting-started/quickstart) · [사전 요구 사항](https://github.com/ClickHouse/loom/blob/main/docs/getting-started/overview.md#prerequisites) ·
[업그레이드](https://github.com/ClickHouse/loom/blob/main/docs/operations/upgrades.md) · [백업 및 복구](https://github.com/ClickHouse/loom/blob/main/docs/operations/backup-and-recovery.md)
