ClickHouse · locadex-agent · May 20, 2026 · May 21, 2026 · May 21, 2026 · May 21, 2026
@@ -119,6 +119,7 @@ Please note: no additional experimental features are allowed to be enabled in Cl
 | [join_to_sort_maximum_table_rows](/operations/settings/settings#join_to_sort_maximum_table_rows) | `10000` |
 | [allow_experimental_join_right_table_sorting](/operations/settings/settings#allow_experimental_join_right_table_sorting) | `0` |
 | [allow_experimental_json_lazy_type_hints](/operations/settings/settings#allow_experimental_json_lazy_type_hints) | `0` |
+| [allow_experimental_text_index_lazy_apply](/operations/settings/settings#allow_experimental_text_index_lazy_apply) | `0` |
 | [allow_experimental_window_view](/operations/settings/settings#allow_experimental_window_view) | `0` |
 | [window_view_clean_interval](/operations/settings/settings#window_view_clean_interval) | `60` |
 | [window_view_heartbeat_interval](/operations/settings/settings#window_view_heartbeat_interval) | `15` |

@@ -63,7 +63,7 @@ keywords: ['cloud guides', 'documentation', 'how-to', 'cloud features', 'tutoria
 | [Managing AWS service limits and quotas](/cloud/reference/byoc/aws-service-limits) | AWS service quotas to verify before BYOC onboarding, how to request increases, and what to monitor as services scale |
 | [Migrating from CMEK v1 to v2](/cloud/security/cmek-migration) | Migration instructions to move from legacy CMEK to version 2 |
 | [Multi tenancy](/cloud/bestpractices/multi-tenancy) | Best practices to implement multi tenancy |
-| [Optimizing ClickHouse Assistant agent conversations with a semantic layer](/use-cases/AI_ML/AIChat/semantic-layer) | Guide to using AGENTS.md to provide custom business logic and data-specific instructions to the ClickHouse Assistant chat agent |
+| [Optimizing ClickHouse Assistant conversations with a semantic layer](/use-cases/AI_ML/AIChat/semantic-layer) | Guide to using AGENTS.md to provide custom business logic and data-specific instructions to the ClickHouse Assistant chat agent |
 | [Overview](/cloud/reference/byoc/overview) | Deploy ClickHouse on your own cloud infrastructure |
 | [PCI onboarding](/cloud/security/compliance/pci-onboarding) | Learn more about how to onboard to PCI compliant services |
 | [Query API endpoints](/cloud/get-started/query-endpoints) | Easily spin up REST API endpoints from your saved queries |

@@ -120,6 +120,7 @@ ClickHouse はオープンソースであるため、ClickHouse の従業員だ
 | [join&#95;to&#95;sort&#95;maximum&#95;table&#95;rows](/operations/settings/settings#join_to_sort_maximum_table_rows)                                                                                                                | `10000`                 |
 | [allow&#95;experimental&#95;join&#95;right&#95;table&#95;sorting](/operations/settings/settings#allow_experimental_join_right_table_sorting)                                                                                        | `0`                     |
 | [allow&#95;experimental&#95;json&#95;lazy&#95;type&#95;hints](/operations/settings/settings#allow_experimental_json_lazy_type_hints)                                                                                                | `0`                     |
+| [allow&#95;experimental&#95;text&#95;index&#95;lazy&#95;apply](/operations/settings/settings#allow_experimental_text_index_lazy_apply)                                                                                              | `0`                     |
 | [allow&#95;experimental&#95;window&#95;view](/operations/settings/settings#allow_experimental_window_view)                                                                                                                          | `0`                     |
 | [window&#95;view&#95;clean&#95;interval](/operations/settings/settings#window_view_clean_interval)                                                                                                                                  | `60`                    |
 | [window&#95;view&#95;heartbeat&#95;interval](/operations/settings/settings#window_view_heartbeat_interval)                                                                                                                          | `15`                    |

@@ -191,7 +191,7 @@ SETTINGS distributed_ddl_task_timeout=0
 
 * **1レプリカのプライマリサービス** 現在、デフォルトの動作では、セカンダリサービスは1レプリカでも構いませんが、プライマリサービスは少なくとも2レプリカ必要です。
   単一レプリカのプライマリサービスを有効にするには、サポートにお問い合わせください。この動作は2026年第2四半期にデフォルトで有効になる予定です。
-* **プライマリサービスのアイドル化**: 以前は、デフォルトではプライマリサービスを自動アイドル化できませんでした。2026年5月時点では、プライマリサービスの自動アイドル化はデフォルトで有効になっています。リリースの一環として、既存のサービスでもこの機能を利用でき、リリース後に作成された新しいサービスではデフォルトで有効になります。 
+* **プライマリサービスのアイドル化**: プライマリサービスの自動アイドル化はデフォルトで有効になっています。
 
 ## 料金 \{#pricing\}
 

@@ -1,7 +1,8 @@
 ---
-sidebar_label: 'ClickHouse Assistant エージェント'
+sidebar_label: 'ClickHouse Assistant'
+sidebar_position: 2
 slug: /cloud/features/ai-ml/ask-ai
-title: 'Cloud の ClickHouse Assistant エージェント'
+title: 'Cloud の ClickHouse Assistant'
 description: 'ClickHouse Cloud における ClickHouse Assistant chat 機能の説明'
 doc_type: 'reference'
 ---

@@ -0,0 +1,10 @@
+{
+  "collapsed": true,
+  "collapsible": true,
+  "label": "ClickHouse Agents",
+  "link": {
+    "id": "cloud/features/AI_ML/agents/index",
+    "type": "doc"
+  },
+  "position": 1
+}
@@ -0,0 +1,10 @@
+{
+  "collapsed": true,
+  "collapsible": true,
+  "label": "エージェントビルダー",
+  "link": {
+    "id": "cloud/features/AI_ML/agents/builder/index",
+    "type": "ドキュメント"
+  },
+  "position": 3
+}
@@ -0,0 +1,51 @@
+---
+sidebar_label: 'コードインタープリター'
+sidebar_position: 2
+slug: /cloud/features/ai-ml/agents/builder/code-interpreter
+title: 'コードインタープリター'
+description: 'ClickHouse Agentsにおけるサンドボックス化されたコード実行'
+keywords: ['AI', 'ClickHouse Cloud', 'agents', 'コードインタープリター', 'サンドボックス', 'python']
+doc_type: 'reference'
+---
+
+import BetaBadge from '@theme/badges/BetaBadge';
+
+<BetaBadge />
+
+コードインタープリターを使うと、エージェントは管理されたサンドボックス環境でコードを実行できます。計算、データ変換、フォーマット変換、プロットの作成など、自然言語よりもコードで処理するほうが適した作業に使用してください。
+
+## 有効にする \{#enable-it\}
+
+Agent Builder の capabilities セクションで **コードインタープリター** を有効にし、保存します。コードを実行するタイミングは、ユーザーのリクエストとエージェントへの指示に基づいてエージェントが判断します。
+
+## サポートされている言語 \{#supported-languages\}
+
+サンドボックスは、2 つの汎用ランタイムといくつかのシェルユーティリティを備えた Unix 環境です。
+
+* **Python 3** — データ処理ではこれがデフォルトです。
+* **Node.js (JavaScript)** — エージェントが作業に JS を使いたい場合に使用します。
+* **Bash** と **sh** — コマンドの連結や簡単な I/O に使うシェルスクリプトです。
+* **AWK** と **sed** — 行指向のテキスト処理向けです。
+* **bc** — 任意精度の計算に使用します。
+
+データのパース、変換、計算を伴う処理では、まず Python を使ってください。シェルツールは、ワンライナーで明確な利点がある作業に限って使用してください。
+
+## ファイル \{#files\}
+
+ユーザーは会話にファイルをアップロードできます。コードインタープリターは、サンドボックスの作業ディレクトリ内にあるそれらのファイルにアクセスできます。コードは出力ファイル (CSV、プロット、アーカイブ) を書き出すこともでき、それらはダウンロード可能な添付ファイルとして会話に表示されます。
+
+## サンドボックスの分離 \{#sandbox-isolation\}
+
+各実行は、ネットワークアクセスも永続ストレージもない、一時的なサンドボックスで実行されます。セッション間で状態は共有されません。つまり、エージェントが明示的に再読み込みしない限り、ある実行で使用した変数やファイルは次の実行には引き継がれません。
+
+プランごとのリソース制限 (メモリ、実行あたりのファイル数、月間リクエスト quotas) が適用されます。error と stderr は、stdout とあわせて会話内に表示されます。
+
+## 使用する場面 \{#when-to-use-it\}
+
+* ユーザーがアップロードした CSV または JSON を解析する。
+* 要約統計を計算したり、簡単なシミュレーションを実行したりする。
+* フォーマット間で変換する (Parquet、JSON、CSV) 。
+* クエリ結果からプロットを生成する。
+* 決定論的な計算のほうが LLM の推論より適している場合全般。
+
+モデルが直接回答できるタスクには使用しないでください。コード実行は遅延を増やし、クォータを消費します。
@@ -0,0 +1,32 @@
+---
+sidebar_label: '画像生成'
+sidebar_position: 4
+slug: /cloud/features/ai-ml/agents/builder/image-generation
+title: '画像生成'
+description: 'ClickHouse Agents 内で画像を生成・編集'
+keywords: ['AI', 'ClickHouse Cloud', 'エージェント', '画像生成', 'DALL-E', 'Flux', 'Stable Diffusion']
+doc_type: 'reference'
+---
+
+import BetaBadge from '@theme/badges/BetaBadge';
+
+<BetaBadge />
+
+画像生成では、エージェントはテキストのプロンプトから新しい画像を生成したり、ユーザーがアップロードした画像を編集したりできます。エージェントは、要求内容と利用可能なコンテキストに応じて、生成と編集のどちらを行うかを選択します。
+
+## 有効にする \{#enable-it\}
+
+Agent Builder の capabilities セクションで、画像生成ツールを有効にします。一部のエージェントは複数の画像プロバイダー (たとえば DALL-E や Flux) を利用できます。この場合、適切なプロバイダーはエージェントが選択しますが、指示で制限することもできます。
+
+## 生成 \{#generation\}
+
+ユーザーが画像を求めると、エージェントはプロンプトを指定して生成ツールを呼び出し、生成された画像をインラインで返します。エージェントはその画像への参照をコンテキスト内に保持するため、同じ会話の中でその画像を説明したり再利用したりできます。
+
+## 編集 \{#editing\}
+
+ユーザーが画像をアップロードし、色の変更、オブジェクトの追加、構図の拡張といった修正を依頼すると、エージェントはツールの編集用バリアントを呼び出します。出力では、該当する領域が置き換えられるか、要求に応じて元の画像が拡張されます。
+
+## 注記 \{#notes\}
+
+* 生成された画像が、別途ビジョン解析に自動的に渡されることはありません。エージェントに画像を*解釈*させる必要がある場合は、ユーザーがアップロードした画像で [vision](/cloud/features/ai-ml/agents/builder/vision) を使用してください。
+* プロバイダーのコンテンツポリシーが適用されます。プロバイダーのポリシーに違反するプロンプトを使用した場合、画像ではなくエラーが返されます。
@@ -0,0 +1,43 @@
+---
+sidebar_label: '概要'
+slug: /cloud/features/ai-ml/agents/builder
+title: 'Agent Builder'
+description: 'Agent BuilderでClickHouse Agentsを作成・設定'
+keywords: ['AI', 'ClickHouse Cloud', 'agents', 'Agent Builder', 'ツール', '手順']
+doc_type: 'reference'
+---
+
+import BetaBadge from '@theme/badges/BetaBadge';
+
+<BetaBadge />
+
+Agent Builder は、エージェントを作成および設定する場所です。Cloudコンソールのサイドパネルとして開きます。
+
+パネルは 3 つのセクションで構成されています。
+
+* 上部の **Identity** — 名前、説明、アバター、instructions フィールド (システムプロンプト) 。
+* 中央の **モデル設定** — provider、model、生成パラメーター。
+* 下部の **Capabilities** — アタッチするツール、MCPサーバー、Skills、サブエージェント。
+
+保存はフッターのボタンから行います。編集内容は次の会話から有効になり、進行中の実行は中断されません。
+
+## Identity \{#identity\}
+
+instructionsフィールドは、エージェントのシステムプロンプトです。役割、回答すべき質問の種類、従うべきルールを記述してください。エージェントがClickHouse serviceをクエリする場合は、スキーマの規約、算出メトリクス、用語を具体的に記述してください。モデルが独力でビジネス上の定義を推測することはできません。
+
+## 基本設定 \{#core-configuration\}
+
+* [モデル パラメータ](/cloud/features/ai-ml/agents/builder/model-parameters) — モデルを選択し、生成パラメータを調整します。設定は名前付きプリセットとして保存でき、再利用できます。
+
+## 組み込みツール \{#built-in-tools\}
+
+* [Code interpreter](/cloud/features/ai-ml/agents/builder/code-interpreter) — サンドボックス内でのコード実行。
+* [Web search](/cloud/features/ai-ml/agents/builder/web-search) — 公開Webのルックアップ。
+* [Image generation](/cloud/features/ai-ml/agents/builder/image-generation) — テキストから画像を生成。
+* [Vision](/cloud/features/ai-ml/agents/builder/vision) — 画像入力に対応。
+
+## 拡張性 \{#extensibility\}
+
+* [MCPサーバー](/cloud/features/ai-ml/agents/builder/mcp-servers) — サードパーティ製のMCPサーバーをエージェントに追加します。
+* [Skills](/cloud/features/ai-ml/agents/builder/skills) — 再利用可能な指示パック。
+* [サブエージェント](/cloud/features/ai-ml/agents/builder/subagents) — 子エージェントに作業を委任します。
@@ -0,0 +1,39 @@
+---
+sidebar_label: 'MCPサーバー'
+sidebar_position: 8
+slug: /cloud/features/ai-ml/agents/builder/mcp-servers
+title: 'MCPサーバー'
+description: 'ClickHouse Agentにサードパーティ製MCPサーバーを接続する'
+keywords: ['AI', 'ClickHouse Cloud', 'エージェント', 'MCP', 'Model Context Protocol']
+doc_type: 'reference'
+---
+
+import BetaBadge from '@theme/badges/BetaBadge';
+
+<BetaBadge />
+
+Model Context Protocol (MCP) は、AIモデルにツールやデータソースを公開するためのオープン標準です。MCPサーバーをClickHouse Agentに接続すると、そのサーバーが公開するあらゆる機能にAgentからアクセスできるようになります。たとえば、課題追跡システム、オブザーバビリティバックエンド、内部API、サードパーティのSaaS、またはMCPエンドポイントを備えたその他あらゆるものです。
+
+## MCPサーバーを追加する \{#attach-an-mcp-server\}
+
+Agent Builder で **MCPサーバー** セクションを開き、**Add server** をクリックします。サーバーの URL と認証設定を入力し、そのサーバーのツールのうち、このエージェントで使用するものを選択して、エージェントを保存します。
+
+1 つのエージェントに複数のサーバーを追加できます。エージェントが呼び出した各ツールは会話内に記録されるため、ユーザーはエージェントが何を行ったかを確認できます。
+
+## トランスポート \{#transport\}
+
+ClickHouse Agents は、実運用に対応した MCP トランスポートである Streamable HTTP を使用します。接続するサーバーは、ClickHouse Cloud から HTTP(S) 経由で到達可能である必要があります。
+
+## 認証 \{#authentication\}
+
+MCPサーバーでは認証情報が必要になる場合があります。ClickHouse Agents は次をサポートしています。
+
+* **Bearer tokens** とその他の静的ヘッダー — サーバーの設定時に指定する固定値です。
+* **OAuth 2.0** — 対話型フローです。サーバー上のツールをあなた (またはアクセス権を持つ任意のユーザー) が初めて呼び出すと、ブラウザーでサインインウィンドウが開き、トークンは自動的に管理・更新されます。
+* **ユーザーごとの認証情報** — サーバー設定内の変数が、呼び出し元ユーザーのプロファイルの値で置き換えられるため、各ユーザーは共有のサービスアカウントではなく、自分自身のIDで認証されます。
+
+ユーザーが指定した認証情報は暗号化して保存され、入力したユーザーに紐づけられます。あるユーザーの認証情報が、別のユーザーのエージェント実行から見えることはありません。
+
+## 制限 \{#limits\}
+
+1回のエージェント実行で参照できる個別のMCPサーバーターゲットは最大50件、1リクエストあたりの展開後のツール設定は最大100件です。これを超える場合は、[サブエージェント](/cloud/features/ai-ml/agents/builder/subagents)を使って分割してください。