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. 運用する | モニタリング · トラブルシューティング · アップグレード · バックアップとリカバリ |
ユースケース
ニーズごとに 1 ページを用意しています。各ページでは、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 個のレプリカの運用:1 つの 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 · 環境変数 · API オペレーション · 設定 · ワーカー · CLI · エラー · ステータス · スキーマ · エクストラクタ契約。オペレーションとフィールドはリリース間で変更されます。サーバーが読み取らなくなったフィールドをクライアントがどのように認識するかについては、未知のフィールドと削除されたフィールドを参照してください。
5. 名前空間、アクセス、メモリモデル
- アイデンティティと名前空間:タプル、ロール、グラント、読み取りスコープ。
- メモリ:行、書き込みの判定方法、時間、履歴、来歴。
- 検索とランキング:レッグ、フュージョン、アブステイン、キャリブレーション。
ガイド
エージェント連携 · ヘッドレスボット · トークンとグラント · 長時間実行のトレースと再開 · 名前空間の最適化 · 調査エージェントのメモリ · 抽出パイプライン · パフォーマンスチューニング · デバッグ · Postgres から Loom にクエリする · Loom で教える
機能
- プレーン:名前空間と共有 · 統合検索 · ナレッジ · エンティティグラフ · 会話とセッション · 実行 · タスクと意思決定 · ダッシュボード
- メモリ:書き込み · 検索と質問 · 競合と拒否 · 抽出 · 履歴と来歴 · 保持と消去 · 手順と学習内容 · ワーキングメモリとプロファイル
- オブザーバビリティ:監査 · コストと使用量 · テレメトリ
- トラッカー:概要 · レコード契約
6. コードインデックス
概要 · リポジトリ · 鮮度 · 履歴と PR · オペレーション(API 操作) · コードインデックス運用ランブック
アーキテクチャ
システム概要 · サーバーレイアウト · ClickHouse · メモリアーキテクチャ · ストレージオーソリティ(正のデータの保存先) · セル · ストレージレイアウト · コードインデックスのアーキテクチャ · ドキュメント抽出 · ドキュメントソース · LLM と埋め込み · セキュリティ · アシスタントの設計 · 障害と復旧 · ローリングアップグレード
ベンチマーク
概要 · カバレッジ · 方法論 · 実行方法 · 結果 · ケースの追加 · スキル評価
開発
コントリビューター向け:リポジトリガイド · ローカル開発 · テスト · コード生成 · マイグレーション · リリースプロセス · ドキュメントスタイル · キュレーションループの設計 · Loom の拡張 · オペレーションの追加 · ワーカーの追加 · テーブルの追加 · 言語サポートの追加 · ダッシュボードの設計。 プルリクエストのワークフローについては CONTRIBUTING.md を参照してください。
関連ページ
用語集:Loom の用語を一か所にまとめて定義しています。よくある質問:最初に出てくる質問に、それぞれ一段落で答えます。llms.txt:エージェント向けに生成されたドキュメントの索引です。llms-full.txt には、Loom とは何か、どう始めるかを説明するページが 1 つのファイルにまとめられています。