ClickHouse Loom 문서
ClickHouse Loom 문서
이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. Machine-translated from the English page, which is authoritative.
Loom은 AI 에이전트를 위한 메모리, 문서 및 코드 인덱스 서버로, ClickHouse에 데이터를 저장하며, 실시간 메모리와 지식 상태를 위해 Postgres를 선택적으로 사용할 수 있습니다. 에이전트와 사용자는 MCP, HTTP, Python 및 TypeScript SDK, 그리고 대시보드를 통해 Loom에 접근합니다. 이 페이지는 모든 페이지를 읽는 순서대로 나열합니다.

시작하기
| 단계 | 읽을 문서 |
|---|---|
| 1. 결정 | 개요 → Loom 평가하기 |
| 2. 설치 | 빠른 시작 → 배포 |
| 3. 에이전트 연결 | 코딩 에이전트 연결하기 → 통합 |
| 4. SDK 및 API | 첫 번째 에이전트 → Python SDK / HTTP API |
| 5. 네임스페이스 및 접근 | ID와 네임스페이스 → 토큰과 권한 |
| 6. 코드 인덱스 | 코드 인덱스 → 리포지토리 → 코드 인덱스 운영 |
| 7. 운영 | 모니터링 · 문제 해결 · 업그레이드 · 백업 및 복구 |
사용 사례
필요별로 한 페이지씩 구성했으며, 각 페이지에서 Loom이 해당 필요에 무엇을 해주는지와 어디서 시작하면 되는지를 설명합니다: 에이전트 메모리 · 문서 검색과 RAG · 코딩 에이전트를 위한 코드 인덱스 · 언어별 코드 인덱스 · 코드와 연결된 메모리 · 코딩 에이전트 모델 비용 · 멀티 에이전트 공유 컨텍스트 · 자율 에이전트: 회상, 감사, 삭제 · 실행, 트레이스, PR 이력 · ClickHouse 셀프 호스팅 · 모든 사용 사례.
1. 시작하기
- 개요: Loom이 무엇인지, 어떤 경우에 적합한지, 사전 요구 사항.
- 포함된 기능: Loom의 주요 기능과 각 기능의 페이지.
- 빠른 시작: 로컬 스택을 처음부터 끝까지 구성하는 방법.
- 모델 및 API 키 구성: 에이전트 구독, 서버 LLM, 임베딩, 단일 공급자 구성.
- Loom 평가: 스모크 테스트, 워크로드 평가, 재현 가능한 공개 벤치마크.
- 코딩 에이전트 연결: 플러그인 또는 MCP 진입점.
- 코딩 에이전트로 Loom 설정: 고정된 릴리스를 설치하고 동작을 검증하는 에이전트를 위한 문서이며, 정해진 형식의 보고서를 포함합니다.
- 첫 번째 에이전트: SDK 튜토리얼.
2. 서버 설치 및 실행
- 배포: 구성 형태, 환경, 프로바이더, ID 모드, 프록시, 이미지, 프로덕션 체크리스트.
- 싱글 사인온: 대시보드,
loom login, MCP 클라이언트를 위한 OIDC ID 프로바이더. - 대시보드 없이 Loom 사용하기: 모든 대시보드 보기에 대응하는
loom login,loom call및 SDK 호출. - 업그레이드 · 지원 버전 · 백업 및 복구 · 모니터링 · 유지 관리 · 런타임 설정 · 문제 해결 · 코드 인덱스 운영 · N개 레플리카 실행: 하나의 URL 뒤에 있는 동일한 Loom들 · Postgres: Postgres 메모리 권한 저장소 · Kubernetes: EKS 및 kind 오버레이가 포함된 Helm 차트 · ClickHouse Cloud 및 Managed Postgres: 두 관리형 서비스 위에서 동작하는 차트 · 네임스페이스를 다른 Loom으로 복사하기 · 사용량을 데이터 웨어하우스로 내보내기
3. 에이전트 연결
통합 · MCP 클라이언트 · 에이전트 지침 · Claude Code · Codex · Cursor · VS Code · 프레임워크 · Grep 셤 · Langfuse · ClickStack · OKF
4. SDK와 API
참조 색인 · HTTP API · MCP · Python SDK · TypeScript SDK · 환경 변수 · 호출 가능한 연산(op) · 구성 · 워커 · CLI · 오류 · 상태 · 스키마 · 추출기 계약. 연산과 필드는 릴리스마다 바뀔 수 있습니다. 알 수 없는 필드와 제거된 필드에서는 서버가 더 이상 읽지 않는 필드를 클라이언트가 어떻게 받게 되는지 설명합니다.
5. 네임스페이스, 접근 권한, 메모리 모델
- 아이덴티티와 네임스페이스: 튜플, 역할, 권한 부여(grant), 읽기 범위.
- 메모리: 행(row), 쓰기를 판단하는 방식, 시간, 이력, 출처(provenance).
- 검색과 랭킹: 레그(leg), 융합(fusion), 응답 보류(abstain), 보정(calibration).
가이드
에이전트 연동 · 헤드리스 봇 · 토큰과 권한 부여 · 긴 실행 추적 및 재개 · 네임스페이스 최적화 · 조사 에이전트 메모리 · 추출 파이프라인 · 성능 튜닝 · 디버깅 · Postgres에서 Loom 쿼리하기 · Loom으로 가르치기
기능
- 플레인: 네임스페이스와 공유 · 통합 검색 · 지식 · 엔티티 그래프 · 대화와 세션 · 실행 · 태스크와 의사결정 · 대시보드
- 메모리: 쓰기 · 검색과 질문 · 충돌과 거부 · 추출 · 이력과 출처 · 보존과 삭제 · 절차와 학습 내용 · 워킹 메모리와 프로필
- 관측성: 감사 · 비용과 사용량 · 텔레메트리
- 트래커: 개요 · 레코드 계약
6. 코드 인덱스
개요 · 리포지토리 · 최신성 · 기록과 PR · 호출 가능한 오퍼레이션(op) · 코드 인덱스 운영 런북
아키텍처
시스템 개요 · 서버 레이아웃 · ClickHouse · 메모리 아키텍처 · 기준 스토리지 백엔드 · 셀 · 스토리지 레이아웃 · 코드 인덱스 아키텍처 · 문서 추출 · 문서 소스 · LLM 및 임베딩 · 보안 · 어시스턴트 설계 · 장애 및 복구 · 롤링 업그레이드
벤치마크
개요 · 커버리지 · 방법론 · 실행 · 결과 · 케이스 추가 · 스킬 평가
개발
기여자를 위한 문서: 저장소 가이드 · 로컬 개발 · 테스트 · 코드 생성 · 마이그레이션 · 릴리스 절차 · 문서 스타일 · 큐레이션 루프 설계 · Loom 확장 · 오퍼레이션 추가 · 워커 추가 · 테이블 추가 · 언어 지원 추가 · 대시보드 설계. CONTRIBUTING.md에서 풀 리퀘스트 워크플로를 다룹니다.
함께 보기
용어집: Loom의 용어를 한곳에 정리했습니다. 자주 묻는 질문: 가장 먼저 나오는 질문과 한 단락짜리 답변입니다. llms.txt: 에이전트를 위해 생성한 문서 색인입니다. llms-full.txt에는 Loom이 무엇인지, 어떻게 시작하는지를 설명하는 페이지가 하나의 파일에 담겨 있습니다.