快速入门

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

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

​

前置条件

• 一个可供查询的 ClickHouse Cloud 服务。
• 智能体构建器中有 创建智能体 选项。若未显示，请让组织管理员按照共享与访问中的说明，通过管理员设置授予创建智能体的权限。

​

构建智能体

1. ​

   启动 ClickHouse 智能体

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

2. ​

   创建智能体

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

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

   附加能力和工具

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

   Capabilities 在主面板中 —— 第一方功能，例如 Run Code、Web Search、File Context、Artifacts、MCP Servers 和 Skills。打开智能体所需的开关。

   Tools 在面板底部的 Add Tools 按钮后 —— 第三方集成，例如 image generation、vision、搜索 API 和外部服务等。

   点击 Add Tools 浏览目录：

   Subagents 在 Advanced settings 下配置 —— 详情请参阅子智能体页面。

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

4. ​

   运行查询

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

​

后续步骤

• 与队友共享该智能体。
• 该智能体达到稳定版本后，将其发布到市场。