ByteHouse云数仓版
ByteHouse云数仓版
- 文档首页
ByteHouse云数仓版最佳实践业务应用Bytehouse Skills 使用手册
复制全文
下载 pdf
文档反馈
问问助手本指南覆盖火山引擎 ByteHouse 当前已上线的全部 Skills，提供所有 Skills 的相关简介、通用配置方式和单 Skill 的最佳实践。
本文档覆盖ByteHouse 已全量上线的所有 Skills，完整提供各 Skills 功能简介、通用配置流程与单 Skill 落地最佳实践。
ByteHouse Skills 支持在不同 Agent 上的直接使用，可承担"通过自然语言驱动 ByteHouse 全链路操作"的能力底座。客户可以根据需求下载相关的 Skills 并根据下述操作指引进行配置。
ByteHouse 当前在火山 Findskill 上线的 Skills：
序号 | Skill 名称 | 能力 | 核心定位 |
|---|---|---|---|
1 | 基础连接 | 基于 MCP 协议提供 ByteHouse 标准化 Tool 接口 | |
2 | 混合检索 | 自然语言支持多模态数据向量化与混合检索，对接豆包模型 | |
3 | 多模态检索 | 自然语言支持文本 / 图片等多模态向量化与检索，对接豆包模型 | |
4 | 智能问数 | 自然语言转 SQL，支持向量 / 全文 / 标量 / 多模态混合检索 | |
5 | 数据资产 | 自然语言生成数据资产目录，分析表血缘与列相似性 | |
6 | 计算组诊断 | 自然语言进行计算组健康检查、节点状态诊断、异常问题排查 | |
7 | 负载分析 | 自然语言进行集群负载分析、资源使用监控、性能瓶颈识别 | |
8 | 查询优化 | 自然语言进行慢查询识别分析、执行计划解析、优化建议生成 | |
9 | 知识库管理 | 自然语言对 ByteHouse 的知识库完成管理，包括创建知识库、添加知识库内容、查询知识库 | |
10 | 智能问答 | ByteHouse 官网知识问答，对产品功能，用户指南等问题进行回答 | |
11 | 质量检测 | 自然语言检测数据库表的列空值、零值、异常分布及主键排序键重复等数据质量问题 |
前期准备
- 已经开通 ByteHouse 服务，详细操作请参考： ByteHouse 开通指南。
- 若需要存储和检索多模态数据，还需开通 TOS，并为相关 Skill 配置方舟 API Key，详细操作请参考：TOS 开通指南。
连接配置
ByteHouse Skills 的连接配置流程共分为 2 步：配置 ByteHouse 连接信息 → 按需配置方舟 API Key。
Bytehouse Skills使用的准备工作一共包括以下步骤：安装Skill、配置Bytehous连接信息、配置方舟API Key（按需）。其中“配置方舟API Key” 为涉及多模态数据向量化的必选步骤，每个 Skills需要的连接配置信息如下：
序号 | Skill 名称 | 是否需要配置ByteHouse连接信息 | 是否需要配置方舟API Key |
|---|---|---|---|
1 | byted-bytehouse-mcp | ✅ | ❌ |
2 | byted-bytehouse-hybrid-search | ✅ | 涉及多模态检索分析时 ✅ |
3 | byted-bytehouse-multimodal-search | ✅ | 涉及多模态检索分析时 ✅ |
4 | byted-bytehouse-ai-query | ✅ | 涉及多模态检索分析时 ✅ |
5 | byted-bytehouse-data-asset-analyzer | ✅ | ❌ |
6 | byted-bytehouse-diagnostics | ✅ | ❌ |
7 | byted-bytehouse-load-analyzer | ✅ | ❌ |
8 | byted-bytehouse-slow-query | ✅ | ❌ |
9 | byted-bytehouse-knowledge-base-management | ✅ | ❌ |
10 | byted-bytehouse-smart-qa | ❌ | ❌ |
11 | byted-bytehouse-cluster-diagnostics | ✅ | ❌ |
12 | byted-bytehouse-data-quality-inspector | ✅ | ❌ |
配置 ByteHouse 连接信息
说明
不同 Agent 安装 Skills 的流程不相同，因此本章节仅作参考，客户根据 实际情况完成 Skills 的安装。
- 安装 ByteHouse Skills。
- 用户根据需求下载 Bytehouse Skills 。下载路径请参考Skills 简介。
- 将 ZIP 包直接上传给 Agent，由 Agent 自动解析并完成安装。
- 将BYTEHOUSE_HOST、BYTEHOUSE_PORT、BYTEHOUSE_USER、BYTEHOUSE_PASSWORD 四部分集群配置信息发送给 Agent，连接 ByteHouse。
说明
所有 Bytehouse Skills 的使用都需要进行 Bytehouse 相关信息的配置。
参数说明
参数 | 说明 |
|---|---|
ByteHouse版本（必填） | 固定为 CDW，代表 ByteHouse 云数仓版 |
BYTEHOUSE_HOST（必填） | 集群的访问地址。您可以在 ByteHouse 控制台的租户管理 > 基本信息 > 网络信息中查看网络组配置，详情请参见步骤二：配置网络信息。 |
BYTEHOUSE_PORT（必填） | 固定为8123。 |
BYTEHOUSE_USER（必填） | 您在火山引擎控制台的用户名称，固定为：bytehouse。 |
BYTEHOUSE_PASSWORD（必填） | 集群的访问密钥。您可登录 ByteHouse 控制台，在 租户管理 > 连接信息页面中，单击 API Key 表单下的”＋ 新建“按钮来创建 API Key。 注意 API Key 创建后无法再次查看，建议将秘钥下载到本地保存。 |
配置方舟 API Key（按需）
说明
- 用户需要使用到多模态向量化相关功能时（如文搜图/图搜图/图搜文等），需要开通并配置方舟 API Key。
- Bytehouse Skills 默认使用方舟 Doubao-embedding-vision-251215 模型。
- 开通Coding plan：在方舟控制台左侧工具栏系统管理模块找到“开通管理”，点击Coding plan，开通不同套餐。
- 开通独立计费模型：在左侧工具栏系统管理模块找到“开通管理”，找到“Doubao-embedding-vision”模型后点击“开通服务”。
- 开通Coding plan：在方舟控制台左侧工具栏系统管理模块找到“开通管理”，点击Coding plan，开通不同套餐。
创建自定义推理点（endpoint）。
- 左侧工具栏依次选择在线推理 > 模型推理接入点 > 创建推理接入点。
- 在创建页面中填写接入点名称，推理模式选择指定单一模型，接入模型点击添加模型。
- 在选择模型弹窗中依次选择 Doubao-embedding-vision > 版本 251215，点击确认。
- 配置完接入模式后，点击创建并接入。
- 创建成功后可在模型推理接入点页面获取该推理点的 endpoint id。
创建火山 API key。
- 在左侧工具栏系统管理模块找到API key管理，点击创建API key。
- 权限选择可访问项目下所有资源后即可创建。
将 API key 和模型 endpoint 发送给 Agent，完成连接 。
Skills 使用说明
说明
- 在阅读“使用说明”前请保证 Agent 已经配置完 Bytehouse 相关信息，完成集群连接。
- 需要进行多模态数据向量化相关处理任务的需要链接方舟 API Key。
- 本章节主要展示每个 Skill 的典型能力与快速示例。
- 不建议直接通过 Agent 执行 DML 操作（增 / 删 / 改），可能导致数据不可恢复。
byted-bytehouse-mcp
功能描述
在本地拉起 ByteHouse MCP Server 并提供标准化 Tool 调用接口，遵循 Model Context Protocol 协议。
功能模块 |
|---|
|
快速开始
在Agent端输入SQL语句，完成DDL/DML/DQL相关的操作。
示例如下：
- 列出所有库：
- 列出指定库的所有表：
- 运行 SELECT 查询：
byted-bytehouse-hybrid-search
功能描述
针对Bytehouse的混合检索能力，同时支持 BM25 全文检索和向量相似度检索，使用 RRF 算法融合排名。
功能模块 |
|---|
|
快速开始
在Agent端输入自然语言，完成混合检索。
示例如下：
- 全文+向量检索：
- 文本+标量：
- 图搜图
byted-bytehouse-multimodal-search
功能描述
支持文本、图片等模态数据的向量化存储和检索，基于豆包多模态向量化模型 doubao-embedding-vision-251215。
功能模块 |
|---|
|
快速开始
在Agent端输入自然语言，完成多模态混合检索。
示例如下：
- 文搜图：
- 图搜图：
- 图文混搜：
byted-bytehouse-ai-query
功能描述
支持自然语言直接查询，支持多模态数据的向量化存储和检索，基于豆包多模态向量化模型 doubao-embedding-vision-251215。
功能模块 |
|---|
|
快速开始
在Agent端输入自然语言，完成智能问数。
示例如下：
- 自然语言查结果：
- 自然语言+图查结果：
- 图查结果：
byted-bytehouse-data-asset-analyzer
功能描述
基于 ByteHouse MCP Server，生成数据资产目录和血缘关系分析。
功能模块 |
|---|
|
快速开始
在Agent端输入自然语言，完成Bytehouse下的库表血缘分析。
示例如下：
- Schema的获取：
- 数据资产统计：
- 血缘分析：
byted-bytehouse-diagnostics
功能描述
ByteHouse 集群诊断和健康检查工具。
功能模块 |
|---|
|
快速开始
在Agent端输入自然语言，完成集群诊断和健康检查。
示例如下：
- 集群健康检查：
- 节点状态诊断：
- 查询历史分析：
byted-bytehouse-load-analyzer
功能描述
ByteHouse 集群负载分析和性能监控工具。
功能模块 |
|---|
|
快速开始
在Agent端输入自然语言，完成Bytehouse下的集群负载分析。
示例如下：
- 资源使用分析：
- 查询负载分析：
- 表负载分析：
byted-bytehouse-slow-query
功能描述
ByteHouse 慢查询分析和性能优化工具。
功能模块 |
|---|
|
快速开始
在Agent端输入自然语言，完成Bytehouse下的查询分析和性能优化。
示例如下：
- 慢查询识别：
- 查询性能分析：
- 优化建议生成：
byted-bytehouse-knowledge-base-management
功能描述
自然语言对 ByteHouse 的知识库完成管理，包括创建知识库、添加知识库内容、查询知识库。
功能模块 |
|---|
|
快速开始
在Agent端输入自然语言，完成Bytehouse下的知识库的管理和检索。
示例如下：
- 创建知识库：
- 导入知识：
- 知识检索：
byted-bytehouse-smart-qa
功能描述
基于火山 ByteHouse 官网文档进行知识问答。
功能模块 |
|---|
|
快速开始
在Agent端输入自然语言，完成 ByteHouse 相关的知识问答，包括产品功能，用户指南等相关问题。
示例如下：
- 计费相关问题：
- 数据导入导出：
- 租户管理和权限：