> Source: https://clickhouse.github.io/loom/ja/ (Markdown: https://clickhouse.github.io/loom/ja/index.md)

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

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

# ClickHouse Loom ドキュメント

Loom は、AI エージェント向けのメモリ、ドキュメント、コードインデックスのサーバーで、データは ClickHouse に保存されます。ライブのメモリとナレッジの状態には、オプションとして [Postgres](https://clickhouse.github.io/loom/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. 検討する              | [概要](https://clickhouse.github.io/loom/ja/getting-started/overview/) → [Loom を評価する](https://clickhouse.github.io/loom/ja/getting-started/evaluate/)                                                                                                      |
| 2. インストールする      | [クイックスタート](https://clickhouse.github.io/loom/ja/getting-started/quickstart/) → [デプロイ](https://github.com/ClickHouse/loom/blob/main/docs/operations/deployment.md)                                                                                                      |
| 3. エージェントを接続する | [コーディングエージェントを接続する](https://clickhouse.github.io/loom/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) → [リポジトリ](https://clickhouse.github.io/loom/ja/features/code-index/repositories/) → [コードインデックスの運用](https://clickhouse.github.io/loom/ja/operations/code-index-operations/)                        |
| 7. 運用する              | [モニタリング](https://github.com/ClickHouse/loom/blob/main/docs/operations/monitoring.md) · [トラブルシューティング](https://clickhouse.github.io/loom/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 がそのニーズに対して何を行うか、どこから始めればよいかを説明します。
[エージェントメモリ](https://clickhouse.github.io/loom/ja/use-cases/agent-memory/) ·
[ドキュメント検索と RAG](https://clickhouse.github.io/loom/ja/use-cases/document-search/) ·
[コーディングエージェント向けコードインデックス](https://clickhouse.github.io/loom/ja/use-cases/code-intelligence/) ·
[言語別コードインデックス](https://clickhouse.github.io/loom/ja/use-cases/code-intelligence-by-language/) ·
[コードに紐づくメモリ](https://clickhouse.github.io/loom/ja/use-cases/memory-linked-to-code/) ·
[コーディングエージェントのモデルコスト](https://clickhouse.github.io/loom/ja/use-cases/coding-agent-cost/) ·
[複数エージェントでの共有コンテキスト](https://clickhouse.github.io/loom/ja/use-cases/multi-agent/) ·
[自律エージェント：想起、監査、消去](https://clickhouse.github.io/loom/ja/use-cases/autonomous-agents/) ·
[実行、トレース、PR 履歴](https://clickhouse.github.io/loom/ja/use-cases/runs-and-pr-history/) ·
[ClickHouse でのセルフホスト](https://clickhouse.github.io/loom/ja/use-cases/self-hosted-clickhouse/) ·
[すべてのユースケース](https://clickhouse.github.io/loom/ja/use-cases/)。

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

## 1. はじめに

- [概要](https://clickhouse.github.io/loom/ja/getting-started/overview/)：Loom とは何か、どのような場面に適しているか、前提条件。
- [含まれるもの](https://clickhouse.github.io/loom/ja/getting-started/whats-included/)：Loom の主な機能と、それぞれのページ。
- [クイックスタート](https://clickhouse.github.io/loom/ja/getting-started/quickstart/)：ローカルスタックを最初から最後まで構築する手順。
- [モデルと API キーの設定](https://github.com/ClickHouse/loom/blob/main/docs/getting-started/models-and-keys.md)：エージェントのサブスクリプション、サーバー LLM、埋め込み、単一プロバイダーの構成。
- [Loom を評価する](https://clickhouse.github.io/loom/ja/getting-started/evaluate/)：スモークテスト、ワークロード評価、再現可能な公開ベンチマーク。
- [コーディングエージェントを接続する](https://clickhouse.github.io/loom/ja/getting-started/connect-a-coding-agent/)：プラグインまたは MCP のエントリ。
- [コーディングエージェントで Loom をセットアップする](https://clickhouse.github.io/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 モード、プロキシ、イメージ、本番環境チェックリスト。
- [シングルサインオン](https://clickhouse.github.io/loom/ja/operations/sso/)：ダッシュボード、`loom login`、MCP クライアント向けの OIDC ID プロバイダー。
- [ダッシュボードを使わずに Loom を使う](https://clickhouse.github.io/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) ·
  [ランタイム設定](https://clickhouse.github.io/loom/ja/operations/runtime-settings/) ·
  [トラブルシューティング](https://clickhouse.github.io/loom/ja/operations/troubleshooting/) ·
  [コードインデックスの運用](https://clickhouse.github.io/loom/ja/operations/code-index-operations/) ·
  [N 個のレプリカの運用](https://clickhouse.github.io/loom/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](https://clickhouse.github.io/loom/ja/operations/clickhouse-cloud/)：両方のマネージドサービスに対応するチャート ·
  [名前空間を別の Loom にコピーする](https://github.com/ClickHouse/loom/blob/main/docs/operations/okf-sync.md) ·
  [使用状況をデータウェアハウスにエクスポートする](https://clickhouse.github.io/loom/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) ·
[エージェント向け指示](https://clickhouse.github.io/loom/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](https://clickhouse.github.io/loom/ja/features/integrations/cursor/) ·
[VS Code](https://clickhouse.github.io/loom/ja/features/integrations/vscode/) ·
[フレームワーク](https://github.com/ClickHouse/loom/blob/main/docs/features/integrations/frameworks.md) ·
[Grep シム](https://clickhouse.github.io/loom/ja/features/integrations/grep-shim/) ·
[Langfuse](https://clickhouse.github.io/loom/ja/features/integrations/langfuse/) ·
[ClickStack](https://clickhouse.github.io/loom/ja/features/integrations/clickstack/) ·
[OKF](https://clickhouse.github.io/loom/ja/features/integrations/okf/)

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

## 4. SDK と API

[リファレンス索引](https://clickhouse.github.io/loom/ja/reference/) · [HTTP API](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md) ·
[MCP](https://clickhouse.github.io/loom/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) · [環境変数](https://clickhouse.github.io/loom/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>

## ガイド

[エージェント連携](https://clickhouse.github.io/loom/ja/guides/agent-integration/) ·
[ヘッドレスボット](https://clickhouse.github.io/loom/ja/guides/headless-bots/) ·
[トークンとグラント](https://github.com/ClickHouse/loom/blob/main/docs/guides/tokens-and-grants.md) ·
[長時間実行のトレースと再開](https://clickhouse.github.io/loom/ja/guides/trace-and-resume/) ·
[名前空間の最適化](https://clickhouse.github.io/loom/ja/guides/optimize-namespace/) ·
[調査エージェントのメモリ](https://github.com/ClickHouse/loom/blob/main/docs/guides/investigation-agent-memory.md) ·
[抽出パイプライン](https://clickhouse.github.io/loom/ja/guides/extraction-pipeline/) ·
[パフォーマンスチューニング](https://github.com/ClickHouse/loom/blob/main/docs/guides/performance-tuning.md) · [デバッグ](https://clickhouse.github.io/loom/ja/guides/debugging/) ·
[Postgres から Loom にクエリする](https://clickhouse.github.io/loom/ja/guides/query-from-postgres/) ·
[Loom で教える](https://clickhouse.github.io/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) ·
  [ワーキングメモリとプロファイル](https://clickhouse.github.io/loom/ja/features/memory/working-memory-and-profiles/)
- オブザーバビリティ：[監査](https://clickhouse.github.io/loom/ja/features/observability/audit/) ·
  [コストと使用量](https://github.com/ClickHouse/loom/blob/main/docs/features/observability/cost-and-usage.md) ·
  [テレメトリ](https://clickhouse.github.io/loom/ja/features/observability/telemetry/)
- トラッカー：[概要](https://github.com/ClickHouse/loom/blob/main/docs/features/tracker/overview.md) ·
  [レコード契約](https://clickhouse.github.io/loom/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) ·
[リポジトリ](https://clickhouse.github.io/loom/ja/features/code-index/repositories/) ·
[鮮度](https://github.com/ClickHouse/loom/blob/main/docs/features/code-index/freshness.md) ·
[履歴と PR](https://clickhouse.github.io/loom/ja/features/code-index/history-and-prs/) ·
[オペレーション（API 操作）](https://github.com/ClickHouse/loom/blob/main/docs/features/code-index/operations.md) ·
[コードインデックス運用ランブック](https://clickhouse.github.io/loom/ja/operations/code-index-operations/)

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

## アーキテクチャ

[システム概要](https://github.com/ClickHouse/loom/blob/main/docs/architecture/system-overview.md) ·
[サーバーレイアウト](https://clickhouse.github.io/loom/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) ·
[ストレージオーソリティ（正のデータの保存先）](https://clickhouse.github.io/loom/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) ·
[コードインデックスのアーキテクチャ](https://clickhouse.github.io/loom/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>

## ベンチマーク

[概要](https://clickhouse.github.io/loom/ja/benchmarks/overview/) · [カバレッジ](https://clickhouse.github.io/loom/ja/benchmarks/coverage/) · [方法論](https://clickhouse.github.io/loom/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) · [ケースの追加](https://clickhouse.github.io/loom/ja/benchmarks/adding-a-case/) · [スキル評価](https://clickhouse.github.io/loom/ja/benchmarks/skill-eval/)

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

## 開発

コントリビューター向け：[リポジトリガイド](https://clickhouse.github.io/loom/ja/development/repository-guide/) ·
[ローカル開発](https://github.com/ClickHouse/loom/blob/main/docs/development/local-development.md) ·
[テスト](https://clickhouse.github.io/loom/ja/development/testing/) · [コード生成](https://clickhouse.github.io/loom/ja/development/code-generation/) ·
[マイグレーション](https://clickhouse.github.io/loom/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 の拡張](https://clickhouse.github.io/loom/ja/development/extending-loom/) ·
[オペレーションの追加](https://clickhouse.github.io/loom/ja/development/adding-an-operation/) ·
[ワーカーの追加](https://github.com/ClickHouse/loom/blob/main/docs/development/adding-a-worker.md) ·
[テーブルの追加](https://clickhouse.github.io/loom/ja/development/adding-a-table/) ·
[言語サポートの追加](https://clickhouse.github.io/loom/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>

## 関連ページ

[用語集](https://clickhouse.github.io/loom/ja/glossary/)：Loom の用語を一か所にまとめて定義しています。[よくある質問](https://clickhouse.github.io/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 つのファイルにまとめられています。
