From 24f9693e3db5fe89ca7d76a56ee10f533624de69 Mon Sep 17 00:00:00 2001 From: Shaun Struwig <41984034+Blargian@users.noreply.github.com> Date: Tue, 30 Dec 2025 11:31:44 +0100 Subject: [PATCH 1/5] AI/ML updates --- .../features/09_AI_ML/AI_chat_overview.md | 19 ++++++++++++++++ docs/cloud/features/09_AI_ML/_category_.json | 5 +++++ docs/cloud/features/09_AI_ML/index.md | 18 +++++++++++++++ .../features/09_AI_ML/remote_mcp_overview.md | 22 +++++++++++++++++++ .../features/{09_support.md => 10_support.md} | 0 .../cloud/guides/AI_ML/AIChat/_category_.json | 5 +++++ .../AIChat/customizing-semantic-layer.md} | 5 ++--- .../guides/AI_ML/AIChat/using_AI_chat.md} | 6 ++--- docs/cloud/guides/AI_ML/_category_.json | 5 +++++ .../guides/AI_ML/remote_mcp.md} | 2 +- docs/use-cases/AI_ML/MCP/index.md | 3 ++- 11 files changed, 82 insertions(+), 8 deletions(-) create mode 100644 docs/cloud/features/09_AI_ML/AI_chat_overview.md create mode 100644 docs/cloud/features/09_AI_ML/_category_.json create mode 100644 docs/cloud/features/09_AI_ML/index.md create mode 100644 docs/cloud/features/09_AI_ML/remote_mcp_overview.md rename docs/cloud/features/{09_support.md => 10_support.md} (100%) create mode 100644 docs/cloud/guides/AI_ML/AIChat/_category_.json rename docs/{use-cases/AI_ML/AIChat/semantic-layer.md => cloud/guides/AI_ML/AIChat/customizing-semantic-layer.md} (98%) rename docs/{use-cases/AI_ML/AIChat/index.md => cloud/guides/AI_ML/AIChat/using_AI_chat.md} (96%) create mode 100644 docs/cloud/guides/AI_ML/_category_.json rename docs/{use-cases/AI_ML/MCP/01_remote_mcp.md => cloud/guides/AI_ML/remote_mcp.md} (98%) diff --git a/docs/cloud/features/09_AI_ML/AI_chat_overview.md b/docs/cloud/features/09_AI_ML/AI_chat_overview.md new file mode 100644 index 00000000000..0ce0f90166d --- /dev/null +++ b/docs/cloud/features/09_AI_ML/AI_chat_overview.md @@ -0,0 +1,19 @@ +--- +sidebar_label: 'Ask AI agent' +slug: /cloud/features/ai-ml/ask-ai +title: 'Ask AI agent in Cloud' +description: 'Description of the Ask AI chat functionality in ClickHouse Cloud' +doc_type: 'reference' +--- + +# Ask AI agent in Cloud + +The “Ask AI” agent is a turn-key experience that allows users to trigger complex analysis tasks on top of the data hosted in their ClickHouse Cloud service. +Instead of writing SQL or navigating dashboards, users can describe what they are looking for in natural language. +The assistant responds with generated queries, visualizations, or summaries, and can incorporate context like active tabs, saved queries, schema details, and dashboards to improve accuracy. +It’s designed to work as an embedded assistant, helping users move quickly from questions to insights, and from prompts to working dashboards or APIs. + +The experience also embeds a "Docs AI" sub-agent that can be used to ask specific questions about the ClickHouse documentation straight from the console. +Instead of searching through hundreds of pages, users can ask direct questions like "How do I configure materialized views?" or "What's the difference between ReplacingMergeTree and AggregatingMergeTree?" and receive precise answers with relevant code examples and links to source documentation. + +See the [guides](/use-cases/AI_ML/AIChat) section for more details. \ No newline at end of file diff --git a/docs/cloud/features/09_AI_ML/_category_.json b/docs/cloud/features/09_AI_ML/_category_.json new file mode 100644 index 00000000000..ee20a4e9fab --- /dev/null +++ b/docs/cloud/features/09_AI_ML/_category_.json @@ -0,0 +1,5 @@ +{ + "label": "AI/ML", + "collapsible": true, + "collapsed": true +} \ No newline at end of file diff --git a/docs/cloud/features/09_AI_ML/index.md b/docs/cloud/features/09_AI_ML/index.md new file mode 100644 index 00000000000..d285789c5e0 --- /dev/null +++ b/docs/cloud/features/09_AI_ML/index.md @@ -0,0 +1,18 @@ +--- +sidebar_label: 'Overview' +slug: /cloud/features/ai-ml +title: 'AI/ML features in Cloud' +description: 'Overview of what AI/ML features are offered in ClickHouse Cloud' +doc_type: 'reference' +--- + +# AI/ML in ClickHouse Cloud + +Traditional analytics workflows often involve multiple handoffs between data engineers writing queries, analysts building dashboards, and business users interpreting results. +Each step introduces latency measured in hours or days. +ClickHouse Cloud offers the following agentic capabilities to collapse that timeline to seconds or minutes, +making it possible for a product manager to ask "What's driving the spike in churn last week?" and immediately receive not just the answer, but the underlying query, a visualization, and potential next questions to explore. + +- [Ask AI agent](/cloud/features/ai-ml/ask-ai) +- [Remote MCP server](/cloud/features/ai-ml/remote-mcp) + diff --git a/docs/cloud/features/09_AI_ML/remote_mcp_overview.md b/docs/cloud/features/09_AI_ML/remote_mcp_overview.md new file mode 100644 index 00000000000..f9a0ae8b616 --- /dev/null +++ b/docs/cloud/features/09_AI_ML/remote_mcp_overview.md @@ -0,0 +1,22 @@ +--- +sidebar_label: 'Remote MCP server' +slug: /cloud/features/ai-ml/remote-mcp +title: 'Remote MCP in Cloud' +description: 'Description of the remote MCP functionality in ClickHouse Cloud' +doc_type: 'reference' +--- + +# Remote MCP server in Cloud + +Not all users interact with ClickHouse through the Cloud console. +For example, many developers work directly from their preferred code editors, CLI agents, or connect to the database via custom setups, while others rely on general-purpose AI assistants such as Anthropic Claude for most of their explorations. +These users, and the agentic workloads acting on their behalf, need a way to securely access and query ClickHouse Cloud without complex setups or custom infrastructure. + +The remote MCP server capability in ClickHouse Cloud addresses this by exposing a standard interface that external agents can use to retrieve analytical context. +MCP, or Model Context Protocol, is a standard for structured data access by AI applications powered by LLMs. +With this integration, external agents can list databases and tables, inspect schemas, and run scoped, read-only SELECT queries. +Authentication is handled via OAuth, and the server is fully managed on ClickHouse Cloud, so no setup or maintenance is required. + +This makes it easier for agentic tools to plug into ClickHouse and retrieve the data they need, whether for analysis, summarization, code generation, or exploration. + +See the [guides](/use-cases/AI/MCP/remote_mcp) section for more details. \ No newline at end of file diff --git a/docs/cloud/features/09_support.md b/docs/cloud/features/10_support.md similarity index 100% rename from docs/cloud/features/09_support.md rename to docs/cloud/features/10_support.md diff --git a/docs/cloud/guides/AI_ML/AIChat/_category_.json b/docs/cloud/guides/AI_ML/AIChat/_category_.json new file mode 100644 index 00000000000..2adfcdd640a --- /dev/null +++ b/docs/cloud/guides/AI_ML/AIChat/_category_.json @@ -0,0 +1,5 @@ +{ + "label": "Ask AI", + "collapsible": true, + "collapsed": true +} \ No newline at end of file diff --git a/docs/use-cases/AI_ML/AIChat/semantic-layer.md b/docs/cloud/guides/AI_ML/AIChat/customizing-semantic-layer.md similarity index 98% rename from docs/use-cases/AI_ML/AIChat/semantic-layer.md rename to docs/cloud/guides/AI_ML/AIChat/customizing-semantic-layer.md index 0a6db6401ad..4d908f7e0ba 100644 --- a/docs/use-cases/AI_ML/AIChat/semantic-layer.md +++ b/docs/cloud/guides/AI_ML/AIChat/customizing-semantic-layer.md @@ -1,17 +1,16 @@ --- slug: /use-cases/AI_ML/AIChat/semantic-layer -sidebar_label: 'Semantic layer' +sidebar_label: 'Customizing Ask AI chat with a semantic layer' title: 'Optimizing Ask AI Agent Conversations with a Semantic Layer' pagination_prev: null pagination_next: null description: 'Guide to using AGENTS.md to provide custom business logic and data-specific instructions to the Ask AI chat agent' keywords: ['AI', 'ClickHouse Cloud', 'Agent', 'AGENTS.md', 'Semantic Layer', 'Custom Instructions', 'System Prompt'] show_related_blogs: true -sidebar_position: 1 doc_type: 'guide' --- -# Customizing Ask AI chat with a semantic layer +# Customize Ask AI chat with a semantic layer The Ask AI chat agent can be customized to understand your specific business logic, data structures, and domain knowledge through **AGENTS.md**—a special saved query that acts as a semantic layer over the agent's system prompt. diff --git a/docs/use-cases/AI_ML/AIChat/index.md b/docs/cloud/guides/AI_ML/AIChat/using_AI_chat.md similarity index 96% rename from docs/use-cases/AI_ML/AIChat/index.md rename to docs/cloud/guides/AI_ML/AIChat/using_AI_chat.md index adfd2814c77..b6fe2dc5d89 100644 --- a/docs/use-cases/AI_ML/AIChat/index.md +++ b/docs/cloud/guides/AI_ML/AIChat/using_AI_chat.md @@ -1,7 +1,7 @@ --- slug: /use-cases/AI_ML/AIChat -sidebar_label: 'AI chat' -title: 'Using AI Chat in ClickHouse Cloud' +sidebar_label: 'Use Ask AI chat in ClickHouse Cloud' +title: 'Use Ask AI chat in ClickHouse Cloud' pagination_prev: null pagination_next: null description: 'Guide to enabling and using the AI Chat feature in ClickHouse Cloud Console' @@ -21,7 +21,7 @@ import img_history from '@site/static/images/use-cases/AI_ML/AIChat/5_history.pn import img_result_actions from '@site/static/images/use-cases/AI_ML/AIChat/6_result_actions.png'; import img_new_tab from '@site/static/images/use-cases/AI_ML/AIChat/7_open_in_editor.png'; -# Using AI Chat in ClickHouse Cloud +# Use Ask AI chat in ClickHouse Cloud > This guide explains how to enable and use the AI Chat feature in the ClickHouse Cloud Console. diff --git a/docs/cloud/guides/AI_ML/_category_.json b/docs/cloud/guides/AI_ML/_category_.json new file mode 100644 index 00000000000..ee20a4e9fab --- /dev/null +++ b/docs/cloud/guides/AI_ML/_category_.json @@ -0,0 +1,5 @@ +{ + "label": "AI/ML", + "collapsible": true, + "collapsed": true +} \ No newline at end of file diff --git a/docs/use-cases/AI_ML/MCP/01_remote_mcp.md b/docs/cloud/guides/AI_ML/remote_mcp.md similarity index 98% rename from docs/use-cases/AI_ML/MCP/01_remote_mcp.md rename to docs/cloud/guides/AI_ML/remote_mcp.md index e7a79e5046c..58383cd858e 100644 --- a/docs/use-cases/AI_ML/MCP/01_remote_mcp.md +++ b/docs/cloud/guides/AI_ML/remote_mcp.md @@ -1,6 +1,6 @@ --- slug: /use-cases/AI/MCP/remote_mcp -sidebar_label: 'ClickHouse Cloud remote MCP' +sidebar_label: 'Enable remote MCP server' title: 'Enabling the ClickHouse Cloud Remote MCP Server' pagination_prev: null pagination_next: null diff --git a/docs/use-cases/AI_ML/MCP/index.md b/docs/use-cases/AI_ML/MCP/index.md index 6241f8b9fd2..42489bd9842 100644 --- a/docs/use-cases/AI_ML/MCP/index.md +++ b/docs/use-cases/AI_ML/MCP/index.md @@ -43,6 +43,8 @@ The [ClickHouse MCP Server](https://github.com/ClickHouse/mcp-clickhouse) offers * `list_databases` - List all databases on your ClickHouse cluster. * `list_tables` - List all tables in a database. +If you're looking for a remote MCP server in ClickHouse Cloud, see page ["Remote MCP server in Cloud"](/cloud/features/ai-ml/remote-mcp) + ## Guides for using the ClickHouse MCP Server {#clickhouse-mcp-server-guides} Below are some guides showing how to use the ClickHouse MCP Server. @@ -50,7 +52,6 @@ Below are some guides showing how to use the ClickHouse MCP Server. | Page | Description | |-----|-----| -| [Enabling the ClickHouse Cloud Remote MCP Server](/use-cases/AI/MCP/remote_mcp) | This guide explains how to enable and use the ClickHouse Cloud Remote MCP | | [How to build a ClickHouse-backed AI Agent with Streamlit](/use-cases/AI/MCP/ai-agent-libraries/streamlit-agent) | Learn how to build a web-based AI Agent with Streamlit and the ClickHouse MCP Server | | [How to build a LangChain/LangGraph AI agent using ClickHouse MCP Server.](/use-cases/AI/MCP/ai-agent-libraries/langchain) | Learn how to build a LangChain/LangGraph AI agent that can interact with ClickHouse's SQL playground using ClickHouse's MCP Server. | | [How to build a LlamaIndex AI agent using ClickHouse MCP Server.](/use-cases/AI/MCP/ai-agent-libraries/llamaindex) | Learn how to build a LlamaIndex AI agent that can interact with ClickHouse MCP Server. | From 078caf0d3bcb05eea623d8bde12a04e1d5fc536f Mon Sep 17 00:00:00 2001 From: Shaun Struwig <41984034+Blargian@users.noreply.github.com> Date: Tue, 30 Dec 2025 15:03:31 +0100 Subject: [PATCH 2/5] fix style --- docs/cloud/features/09_AI_ML/index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/cloud/features/09_AI_ML/index.md b/docs/cloud/features/09_AI_ML/index.md index d285789c5e0..383f00a9baa 100644 --- a/docs/cloud/features/09_AI_ML/index.md +++ b/docs/cloud/features/09_AI_ML/index.md @@ -15,4 +15,3 @@ making it possible for a product manager to ask "What's driving the spike in chu - [Ask AI agent](/cloud/features/ai-ml/ask-ai) - [Remote MCP server](/cloud/features/ai-ml/remote-mcp) - From de094ea26b169faa9b34e25eb799401ad0bcdecf Mon Sep 17 00:00:00 2001 From: Shaun Struwig <41984034+Blargian@users.noreply.github.com> Date: Tue, 30 Dec 2025 15:03:53 +0100 Subject: [PATCH 3/5] newline --- docs/cloud/features/09_AI_ML/_category_.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cloud/features/09_AI_ML/_category_.json b/docs/cloud/features/09_AI_ML/_category_.json index ee20a4e9fab..2bdf35ef292 100644 --- a/docs/cloud/features/09_AI_ML/_category_.json +++ b/docs/cloud/features/09_AI_ML/_category_.json @@ -2,4 +2,4 @@ "label": "AI/ML", "collapsible": true, "collapsed": true -} \ No newline at end of file +} From 11861628ac85681ba0e13e50a420c5df5ed9be80 Mon Sep 17 00:00:00 2001 From: Shaun Struwig <41984034+Blargian@users.noreply.github.com> Date: Tue, 30 Dec 2025 15:04:06 +0100 Subject: [PATCH 4/5] newline --- docs/cloud/guides/AI_ML/AIChat/_category_.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cloud/guides/AI_ML/AIChat/_category_.json b/docs/cloud/guides/AI_ML/AIChat/_category_.json index 2adfcdd640a..e400fda4f08 100644 --- a/docs/cloud/guides/AI_ML/AIChat/_category_.json +++ b/docs/cloud/guides/AI_ML/AIChat/_category_.json @@ -2,4 +2,4 @@ "label": "Ask AI", "collapsible": true, "collapsed": true -} \ No newline at end of file +} From f06b6d3de2384373cdece5e99ef914d8de894e6e Mon Sep 17 00:00:00 2001 From: Shaun Struwig <41984034+Blargian@users.noreply.github.com> Date: Tue, 30 Dec 2025 15:04:19 +0100 Subject: [PATCH 5/5] newline --- docs/cloud/guides/AI_ML/_category_.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cloud/guides/AI_ML/_category_.json b/docs/cloud/guides/AI_ML/_category_.json index ee20a4e9fab..2bdf35ef292 100644 --- a/docs/cloud/guides/AI_ML/_category_.json +++ b/docs/cloud/guides/AI_ML/_category_.json @@ -2,4 +2,4 @@ "label": "AI/ML", "collapsible": true, "collapsed": true -} \ No newline at end of file +}