前置条件
- 一个可供查询的 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。打开智能体所需的开关。面板底部 Add Tools 按钮中的 Tools —— 包括第三方集成，例如 image generation、vision、搜索 API 和外部服务。点击 Add Tools 浏览目录：Subagents 在 Advanced settings 下配置 —— 详情请参阅子智能体页面。你可以随时更改已附加的能力和工具。
4
运行查询
保存智能体，打开一个新对话，然后从智能体选择器中选择你的智能体。输入一个问题——例如，“本周按行数统计，排在前 10 的表有哪些？“——智能体会先进行规划，再按需调用工具并返回答案。
后续步骤
- 将该智能体共享给队友。
- 该智能体进入稳定版本后，将其发布到市场。