<a id="clickhouse-loom-documentation"></a>

# ClickHouse Loom ドキュメント

<!-- i18n: source=docs/index.md blob=8be60892b839f6ffb2e7ba732e3f70bad9178f68 model=claude-sonnet-5-5 -->
> このページは[英語の原文](https://github.com/ClickHouse/loom/blob/main/docs/index.md)の機械翻訳です。内容は英語の原文が優先されます。
> Machine-translated from the [English page](https://github.com/ClickHouse/loom/blob/main/docs/index.md), which is authoritative.


Loom は、AI エージェント向けのメモリ、ドキュメント、コードインデックスのサーバーで、データは ClickHouse に保存されます。ライブのメモリとナレッジの状態には、オプションとして [Postgres](/ja/architecture/storage-authority#why-two-stores) も使えます。エージェントと人は、MCP、HTTP、Python および TypeScript の SDK、ダッシュボードから Loom を利用できます。このページでは、すべてのページを読む順に一覧にしています。

![ダッシュボードのライブラリ：返金ルールの検索に対して、引用付きの該当箇所が返された画面](https://github.com/ClickHouse/loom/raw/main/docs/assets/screenshots/document-search.webp)

<video src="https://github.com/ClickHouse/loom/raw/main/docs/assets/screenshots/clip-assistant-answer.webm" controls autoplay loop muted playsinline width="100%" aria-label="Ask AI answering a question about refunds, with its numbered sources checked against Loom"><a href="https://github.com/ClickHouse/loom/blob/main/docs/assets/screenshots/clip-assistant-answer.webm">Ask AI が確認済みの出典付きで回答する様子（クリップ）</a></video>

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

## はじめに

| ステップ                 | 読むページ                                                                                                                                                                                |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1. 検討する              | [概要](/ja/getting-started/overview) → [Loom を評価する](/ja/getting-started/evaluate)                                                                                                      |
| 2. インストールする      | [クイックスタート](/ja/getting-started/quickstart) → [デプロイ](https://github.com/ClickHouse/loom/blob/main/docs/operations/deployment.md)                                                                                                      |
| 3. エージェントを接続する | [コーディングエージェントを接続する](/ja/getting-started/connect-a-coding-agent) → [インテグレーション](https://github.com/ClickHouse/loom/blob/main/docs/features/integrations/index.md)                                                                      |
| 4. SDK と API            | [最初のエージェント](https://github.com/ClickHouse/loom/blob/main/docs/getting-started/first-agent.md) → [Python SDK](https://github.com/ClickHouse/loom/blob/main/docs/reference/python-sdk.md) / [HTTP API](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md)                                                            |
| 5. 名前空間とアクセス    | [ID と名前空間](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md) → [トークンとグラント](https://github.com/ClickHouse/loom/blob/main/docs/guides/tokens-and-grants.md)                                                                     |
| 6. コードインデックス    | [コードインデックス](https://github.com/ClickHouse/loom/blob/main/docs/features/code-index/overview.md) → [リポジトリ](/ja/features/code-index/repositories) → [コードインデックスの運用](/ja/operations/code-index-operations)                        |
| 7. 運用する              | [モニタリング](https://github.com/ClickHouse/loom/blob/main/docs/operations/monitoring.md) · [トラブルシューティング](/ja/operations/troubleshooting) · [アップグレード](https://github.com/ClickHouse/loom/blob/main/docs/operations/upgrades.md) · [バックアップとリカバリ](https://github.com/ClickHouse/loom/blob/main/docs/operations/backup-and-recovery.md) |

<a id="use-cases"></a>

## ユースケース

ニーズごとに 1 ページを用意しています。各ページでは、Loom がそのニーズに対して何を行うか、どこから始めればよいかを説明します。
[エージェントメモリ](/ja/use-cases/agent-memory) ·
[ドキュメント検索と RAG](/ja/use-cases/document-search) ·
[コーディングエージェント向けコードインデックス](/ja/use-cases/code-intelligence) ·
[言語別コードインデックス](/ja/use-cases/code-intelligence-by-language) ·
[コードに紐づくメモリ](/ja/use-cases/memory-linked-to-code) ·
[コーディングエージェントのモデルコスト](/ja/use-cases/coding-agent-cost) ·
[複数エージェントでの共有コンテキスト](/ja/use-cases/multi-agent) ·
[自律エージェント：想起、監査、消去](/ja/use-cases/autonomous-agents) ·
[実行、トレース、PR 履歴](/ja/use-cases/runs-and-pr-history) ·
[ClickHouse でのセルフホスト](/ja/use-cases/self-hosted-clickhouse) ·
[すべてのユースケース](/ja/use-cases)。

<a id="1-getting-started"></a>

## 1. はじめに

- [概要](/ja/getting-started/overview)：Loom とは何か、どのような場面に適しているか、前提条件。
- [含まれるもの](/ja/getting-started/whats-included)：Loom の主な機能と、それぞれのページ。
- [クイックスタート](/ja/getting-started/quickstart)：ローカルスタックを最初から最後まで構築する手順。
- [モデルと API キーの設定](https://github.com/ClickHouse/loom/blob/main/docs/getting-started/models-and-keys.md)：エージェントのサブスクリプション、サーバー LLM、埋め込み、単一プロバイダーの構成。
- [Loom を評価する](/ja/getting-started/evaluate)：スモークテスト、ワークロード評価、再現可能な公開ベンチマーク。
- [コーディングエージェントを接続する](/ja/getting-started/connect-a-coding-agent)：プラグインまたは MCP のエントリ。
- [コーディングエージェントで Loom をセットアップする](/ja/getting-started/agent-setup)：固定バージョンのリリースをインストールして動作を確認するエージェント向けで、決まった形式のレポートを出力します。
- [最初のエージェント](https://github.com/ClickHouse/loom/blob/main/docs/getting-started/first-agent.md)：SDK のチュートリアル。

<a id="2-install-and-run-the-server"></a>

## 2. サーバーのインストールと実行

- [デプロイ](https://github.com/ClickHouse/loom/blob/main/docs/operations/deployment.md)：構成、環境、プロバイダー、ID モード、プロキシ、イメージ、本番環境チェックリスト。
- [シングルサインオン](/ja/operations/sso)：ダッシュボード、`loom login`、MCP クライアント向けの OIDC ID プロバイダー。
- [ダッシュボードを使わずに Loom を使う](/ja/guides/without-the-dashboard)：ダッシュボードの各ビューに対応する `loom login`、`loom call`、SDK の呼び出し。
- [アップグレード](https://github.com/ClickHouse/loom/blob/main/docs/operations/upgrades.md) · [サポート対象バージョン](https://github.com/ClickHouse/loom/blob/main/docs/operations/supported-versions.md) ·
  [バックアップとリカバリ](https://github.com/ClickHouse/loom/blob/main/docs/operations/backup-and-recovery.md) ·
  [モニタリング](https://github.com/ClickHouse/loom/blob/main/docs/operations/monitoring.md) · [メンテナンス](https://github.com/ClickHouse/loom/blob/main/docs/operations/maintenance.md) ·
  [ランタイム設定](/ja/operations/runtime-settings) ·
  [トラブルシューティング](/ja/operations/troubleshooting) ·
  [コードインデックスの運用](/ja/operations/code-index-operations) ·
  [N 個のレプリカの運用](/ja/operations/replicas)：1 つの URL の背後にある同一の Loom ·
  [Postgres](https://github.com/ClickHouse/loom/blob/main/docs/operations/postgres.md)：Postgres のメモリオーソリティ ·
  [Kubernetes](https://github.com/ClickHouse/loom/blob/main/docs/operations/kubernetes.md)：EKS と kind のオーバーレイを備えた Helm チャート ·
  [ClickHouse Cloud と Managed Postgres](/ja/operations/clickhouse-cloud)：両方のマネージドサービスに対応するチャート ·
  [名前空間を別の Loom にコピーする](https://github.com/ClickHouse/loom/blob/main/docs/operations/okf-sync.md) ·
  [使用状況をデータウェアハウスにエクスポートする](/ja/operations/analytics-export)

<a id="3-connect-agents"></a>

## 3. エージェントを接続する

[連携](https://github.com/ClickHouse/loom/blob/main/docs/features/integrations/index.md) ·
[MCP クライアント](https://github.com/ClickHouse/loom/blob/main/docs/features/integrations/mcp-clients.md) ·
[エージェント向け指示](/ja/features/integrations/agent-instructions) ·
[Claude Code](https://github.com/ClickHouse/loom/blob/main/docs/features/integrations/claude-code.md) ·
[Codex](https://github.com/ClickHouse/loom/blob/main/docs/features/integrations/codex.md) · [Cursor](/ja/features/integrations/cursor) ·
[VS Code](/ja/features/integrations/vscode) ·
[フレームワーク](https://github.com/ClickHouse/loom/blob/main/docs/features/integrations/frameworks.md) ·
[Grep シム](/ja/features/integrations/grep-shim) ·
[Langfuse](/ja/features/integrations/langfuse) ·
[ClickStack](/ja/features/integrations/clickstack) ·
[OKF](/ja/features/integrations/okf)

<a id="4-sdk-and-api"></a>

## 4. SDK と API

[リファレンス索引](/ja/reference) · [HTTP API](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md) ·
[MCP](/ja/reference/mcp) · [Python SDK](https://github.com/ClickHouse/loom/blob/main/docs/reference/python-sdk.md) ·
[TypeScript SDK](https://github.com/ClickHouse/loom/blob/main/docs/reference/typescript-sdk.md) · [環境変数](/ja/reference/environment) ·
[API オペレーション](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) · [設定](https://github.com/ClickHouse/loom/blob/main/docs/reference/configuration.md) ·
[ワーカー](https://github.com/ClickHouse/loom/blob/main/docs/reference/workers.md) · [CLI](https://github.com/ClickHouse/loom/blob/main/docs/reference/cli.md) · [エラー](https://github.com/ClickHouse/loom/blob/main/docs/reference/errors.md) ·
[ステータス](https://github.com/ClickHouse/loom/blob/main/docs/reference/status.md) · [スキーマ](https://github.com/ClickHouse/loom/blob/main/docs/reference/schema.md) ·
[エクストラクタ契約](https://github.com/ClickHouse/loom/blob/main/docs/reference/extractor-contract.md)。オペレーションとフィールドはリリース間で変更されます。サーバーが読み取らなくなったフィールドをクライアントがどのように認識するかについては、[未知のフィールドと削除されたフィールド](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#unknown-and-removed-fields)を参照してください。

<a id="5-namespaces-access-and-the-memory-model"></a>

## 5. 名前空間、アクセス、メモリモデル

- [アイデンティティと名前空間](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md)：タプル、ロール、グラント、読み取りスコープ。
- [メモリ](https://github.com/ClickHouse/loom/blob/main/docs/concepts/memory.md)：行、書き込みの判定方法、時間、履歴、来歴。
- [検索とランキング](https://github.com/ClickHouse/loom/blob/main/docs/concepts/retrieval-and-ranking.md)：レッグ、フュージョン、アブステイン、キャリブレーション。

<a id="guides"></a>

## ガイド

[エージェント連携](/ja/guides/agent-integration) ·
[ヘッドレスボット](/ja/guides/headless-bots) ·
[トークンとグラント](https://github.com/ClickHouse/loom/blob/main/docs/guides/tokens-and-grants.md) ·
[長時間実行のトレースと再開](/ja/guides/trace-and-resume) ·
[名前空間の最適化](/ja/guides/optimize-namespace) ·
[調査エージェントのメモリ](https://github.com/ClickHouse/loom/blob/main/docs/guides/investigation-agent-memory.md) ·
[抽出パイプライン](/ja/guides/extraction-pipeline) ·
[パフォーマンスチューニング](https://github.com/ClickHouse/loom/blob/main/docs/guides/performance-tuning.md) · [デバッグ](/ja/guides/debugging) ·
[Postgres から Loom にクエリする](/ja/guides/query-from-postgres) ·
[Loom で教える](/ja/guides/teaching)

<a id="features"></a>

## 機能

- プレーン：[名前空間と共有](https://github.com/ClickHouse/loom/blob/main/docs/features/namespaces-and-sharing.md) ·
  [統合検索](https://github.com/ClickHouse/loom/blob/main/docs/features/unified-search.md) · [ナレッジ](https://github.com/ClickHouse/loom/blob/main/docs/features/knowledge.md) ·
  [エンティティグラフ](https://github.com/ClickHouse/loom/blob/main/docs/features/entity-graph.md) ·
  [会話とセッション](https://github.com/ClickHouse/loom/blob/main/docs/features/conversations-and-sessions.md) ·
  [実行](https://github.com/ClickHouse/loom/blob/main/docs/features/runs.md) · [タスクと意思決定](https://github.com/ClickHouse/loom/blob/main/docs/features/tasks-and-decisions.md) ·
  [ダッシュボード](https://github.com/ClickHouse/loom/blob/main/docs/features/dashboard.md)
- メモリ：[書き込み](https://github.com/ClickHouse/loom/blob/main/docs/features/memory/writing.md) ·
  [検索と質問](https://github.com/ClickHouse/loom/blob/main/docs/features/memory/search-and-ask.md) ·
  [競合と拒否](https://github.com/ClickHouse/loom/blob/main/docs/features/memory/conflicts-and-refusal.md) ·
  [抽出](https://github.com/ClickHouse/loom/blob/main/docs/features/memory/extraction.md) ·
  [履歴と来歴](https://github.com/ClickHouse/loom/blob/main/docs/features/memory/history-and-provenance.md) ·
  [保持と消去](https://github.com/ClickHouse/loom/blob/main/docs/features/memory/retention-and-erasure.md) ·
  [手順と学習内容](https://github.com/ClickHouse/loom/blob/main/docs/features/memory/procedures-and-learnings.md) ·
  [ワーキングメモリとプロファイル](/ja/features/memory/working-memory-and-profiles)
- オブザーバビリティ：[監査](/ja/features/observability/audit) ·
  [コストと使用量](https://github.com/ClickHouse/loom/blob/main/docs/features/observability/cost-and-usage.md) ·
  [テレメトリ](/ja/features/observability/telemetry)
- トラッカー：[概要](https://github.com/ClickHouse/loom/blob/main/docs/features/tracker/overview.md) ·
  [レコード契約](/ja/features/tracker/record-contract)

<a id="6-code-index"></a>

## 6. コードインデックス

[概要](https://github.com/ClickHouse/loom/blob/main/docs/features/code-index/overview.md) ·
[リポジトリ](/ja/features/code-index/repositories) ·
[鮮度](https://github.com/ClickHouse/loom/blob/main/docs/features/code-index/freshness.md) ·
[履歴と PR](/ja/features/code-index/history-and-prs) ·
[オペレーション（API 操作）](https://github.com/ClickHouse/loom/blob/main/docs/features/code-index/operations.md) ·
[コードインデックス運用ランブック](/ja/operations/code-index-operations)

<a id="architecture"></a>

## アーキテクチャ

[システム概要](https://github.com/ClickHouse/loom/blob/main/docs/architecture/system-overview.md) ·
[サーバーレイアウト](/ja/architecture/server-layout) ·
[ClickHouse](https://github.com/ClickHouse/loom/blob/main/docs/architecture/clickhouse.md) ·
[メモリアーキテクチャ](https://github.com/ClickHouse/loom/blob/main/docs/architecture/memory-architecture.md) ·
[ストレージオーソリティ（正のデータの保存先）](/ja/architecture/storage-authority) ·
[セル](https://github.com/ClickHouse/loom/blob/main/docs/architecture/cells.md) ·
[ストレージレイアウト](https://github.com/ClickHouse/loom/blob/main/docs/architecture/storage-layout.md) ·
[コードインデックスのアーキテクチャ](/ja/architecture/code-index-architecture) ·
[ドキュメント抽出](https://github.com/ClickHouse/loom/blob/main/docs/architecture/document-extraction.md) ·
[ドキュメントソース](https://github.com/ClickHouse/loom/blob/main/docs/architecture/document-sources.md) ·
[LLM と埋め込み](https://github.com/ClickHouse/loom/blob/main/docs/architecture/llm-architecture.md) ·
[セキュリティ](https://github.com/ClickHouse/loom/blob/main/docs/architecture/security.md) ·
[アシスタントの設計](https://github.com/ClickHouse/loom/blob/main/docs/architecture/assistant.md) ·
[障害と復旧](https://github.com/ClickHouse/loom/blob/main/docs/architecture/failure-and-recovery.md) ·
[ローリングアップグレード](https://github.com/ClickHouse/loom/blob/main/docs/architecture/rolling-upgrades.md)

<a id="benchmarks"></a>

## ベンチマーク

[概要](/ja/benchmarks/overview) · [カバレッジ](/ja/benchmarks/coverage) · [方法論](/ja/benchmarks/methodology) · [実行方法](https://github.com/ClickHouse/loom/blob/main/docs/benchmarks/running.md) · [結果](https://github.com/ClickHouse/loom/blob/main/docs/benchmarks/results.md) · [ケースの追加](/ja/benchmarks/adding-a-case) · [スキル評価](/ja/benchmarks/skill-eval)

<a id="development"></a>

## 開発

コントリビューター向け：[リポジトリガイド](/ja/development/repository-guide) ·
[ローカル開発](https://github.com/ClickHouse/loom/blob/main/docs/development/local-development.md) ·
[テスト](/ja/development/testing) · [コード生成](/ja/development/code-generation) ·
[マイグレーション](/ja/development/migrations) ·
[リリースプロセス](https://github.com/ClickHouse/loom/blob/main/docs/development/release-process.md) ·
[ドキュメントスタイル](https://github.com/ClickHouse/loom/blob/main/docs/development/documentation-style.md) ·
[キュレーションループの設計](https://github.com/ClickHouse/loom/blob/main/docs/development/curation-loop-design.md) ·
[Loom の拡張](/ja/development/extending-loom) ·
[オペレーションの追加](/ja/development/adding-an-operation) ·
[ワーカーの追加](https://github.com/ClickHouse/loom/blob/main/docs/development/adding-a-worker.md) ·
[テーブルの追加](/ja/development/adding-a-table) ·
[言語サポートの追加](/ja/development/adding-language-support) ·
[ダッシュボードの設計](https://github.com/ClickHouse/loom/blob/main/docs/development/dashboard-design.md)。
プルリクエストのワークフローについては [CONTRIBUTING.md](https://github.com/ClickHouse/loom/blob/main/CONTRIBUTING.md) を参照してください。

<a id="also"></a>

## 関連ページ

[用語集](/ja/glossary)：Loom の用語を一か所にまとめて定義しています。[よくある質問](/ja/faq)：最初に出てくる質問に、それぞれ一段落で答えます。[`llms.txt`](https://github.com/ClickHouse/loom/blob/main/llms.txt)：エージェント向けに生成されたドキュメントの索引です。[`llms-full.txt`](https://clickhouse.github.io/loom/llms-full.txt) には、Loom とは何か、どう始めるかを説明するページが 1 つのファイルにまとめられています。
