> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速入门

> 构建并运行首个连接到 ClickHouse Cloud 服务的 ClickHouse Agent

[Beta 版功能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

在 Cloud 控制台中创建自定义 agent，并针对您的服务执行自然语言查询。

## 前置条件

* 一个可供查询的 ClickHouse Cloud 服务。
* 智能体构建器中有 **创建智能体** 选项。若未显示，请让组织管理员按照[共享与访问](https://clickhouse.com/docs/zh/agents/sharing-and-access.md)中的说明，通过管理员设置授予创建智能体的权限。

## 构建智能体

**1. 启动 ClickHouse 智能体**

在你的 Cloud 服务中，点击左侧边栏中的 **ClickHouse 智能体**，打开智能体启动页。点击 **Launch ClickHouse 智能体** 以打开智能体构建器。

![Cloud 服务导航中已选中 ClickHouse 智能体（Beta），显示带有 Launch ClickHouse 智能体 按钮的启动页](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/launch-ch-agents.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=7b76b7220ae2e5848fefb70d25e6401c)

**2. 创建智能体**

在智能体构建器中，点击左侧面板顶部的 **Create New Agent**。填写以下核心字段：

* **Name** - 智能体的简短标识。
* **Description** - 对智能体用途的说明，团队成员可以看到。
* **Category** - 智能体所属的类别。除非你的组织定义了自定义类别，否则保留为 `General` 即可。
* **Instructions** - 系统提示，用于说明智能体的角色、应回答的问题以及必须遵循的业务规则。
* **Model** - 从下拉列表中选择模型。

![智能体构建器面板，显示 Create New Agent 下拉菜单、表单字段（Name、Description、Category、Instructions、Model）以及 Capabilities 部分](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/agent-builder.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=b18a3db920e9ec695938613037a72578)

**3. 附加能力和工具**

智能体的能力和工具分布在两个位置。

主面板中的 **Capabilities** —— 包括第一方功能，例如 [Run Code](https://clickhouse.com/docs/zh/agents/builder/code-interpreter.md)、[Web Search](https://clickhouse.com/docs/zh/agents/builder/web-search.md)、File Context、Artifacts、[MCP Servers](https://clickhouse.com/docs/zh/agents/builder/mcp-servers.md) 和 [Skills](https://clickhouse.com/docs/zh/agents/builder/skills.md)。打开智能体所需的开关。

![智能体构建器面板中的 Capabilities 部分，显示 Run Code、Web Search、File Context、Artifacts、MCP Servers 和 Skills 开关](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/capabilities.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=b82e23e834b7b1a8321f80ffc526c936)

面板底部 **Add Tools** 按钮中的 **Tools** —— 包括第三方集成，例如 [image generation](https://clickhouse.com/docs/zh/agents/builder/image-generation.md)、[vision](https://clickhouse.com/docs/zh/agents/builder/vision.md)、搜索 API 和外部服务。

![智能体构建器面板底部，突出显示 Add Tools 按钮](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/tools-button.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=42c611769822a510b7b372437b0ddd70)

点击 **Add Tools** 浏览目录：

![Agent Tools 模态框，显示第三方集成网格，包括 Google、OpenAI Image Tools、Wolfram、DALL-E-3、Tavily Search、Calculator 和 Stable Diffusion](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/tools-modal.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=31187ed13e978de4ad88020c060ab2d5)

[Subagents](https://clickhouse.com/docs/zh/agents/builder/subagents.md) 在 **Advanced settings** 下配置 —— 详情请参阅子智能体页面。

你可以随时更改已附加的能力和工具。

**4. 运行查询**

保存智能体，打开一个新对话，然后从智能体选择器中选择你的智能体。输入一个问题——例如，*"本周按行数统计，排在前 10 的表有哪些？"*——智能体会先进行规划，再按需调用工具并返回答案。

![聊天记录显示问题“What are my top 10 tables by row count this week?”以及智能体的响应——一个按行数对各服务前 10 张表进行排名的 Markdown 表格，下方还有 Key Observations](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/chat-query.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=09fc2481502e3af9c35a59641528c8aa)

## 后续步骤

* [将该智能体共享给队友](https://clickhouse.com/docs/zh/agents/sharing-and-access.md)。
* 该智能体进入稳定版本后，将其发布到[市场](https://clickhouse.com/docs/zh/agents/marketplace.md)。
