Agent Skills

借助 databend-cloud skill，Agent 可协助您使用 Databend Cloud，完成数据查询、计算集群管理和故障排查。

此 skill 仅适用于 Databend Cloud，不适用于自建部署。

功能概览

• 配置连接，使用 API token 连接指定的组织和计算集群。
• 查询数据，查阅 Databend SQL 语法，查看数据库和表结构。
• 诊断查询问题，结合执行状态、查询历史和性能分析（profile），分析慢查询和执行失败的原因。
• 管理计算集群，查看、创建、调整规格、恢复运行、暂停、重命名或删除计算集群。操作需具备相应管理权限，并获得您的明确授权。
• 排查故障，分析告警、内存不足（OOM）、节点异常退出、任务失败和版本变更后的异常。
• 导出日志，按指定范围生成 JSON Lines 格式的原始日志，或便于阅读的日志文件。

使用前需有 Databend Cloud 账号，并具备目标组织的访问权限。可执行的操作以账号权限为准，查询诊断和故障排查还需要访问相应的历史记录、profile 和日志。

通过 Agent 安装

复制以下指令，安装 skill 并配置可复用的 API key。Token 可在 Cloud 控制台 的 账户 API 令牌 → 访问令牌 → 生成新令牌 创建。

请安装以下 databend-cloud skill。
https://github.com/databendcloud/databend-cloud-skill

按 SKILL.md 为 https://api.databend.cn 复用已有 API key，缺少时引导我保存。
不要在聊天中索取 key。配置完成即停止，不连接数据库或执行 SQL。

快速验证

运行以下命令，确认 token、组织和计算集群配置正确。请将占位符替换为实际值。

curl --request POST 'https://api.databend.cn/v1/query' \
  --header 'Content-Type: application/json' \
  --header 'X-DATABENDCLOUD-TOKEN: <YOUR_API_TOKEN>' \
  --header 'X-DATABENDCLOUD-ORG: <YOUR_ORGANIZATION_ID>' \
  --header 'X-DATABENDCLOUD-WAREHOUSE: <YOUR_WAREHOUSE>' \
  --data '{"sql":"SELECT 1"}'

安全须知

• 为 Token 设置 IP 白名单，拒绝名单外的访问。白名单为空时不限制 IP。
• 请添加 Agent 实际运行环境的出口 IP。远程 Agent 的出口 IP 可能与你的本地电脑不同。
• Token 遵循账号当前的组织角色权限；只读访问需通过数据库权限控制。Skill 本身不提供只读沙箱。
• 可在 Cloud 控制台禁用或删除 Token，以撤销访问权限。替换本地密钥文件不会使旧 Token 失效。
• 可在 Cloud 控制台查看 Token 最近使用的 IP 和时间，但这不代表完整的请求审计记录。
• 请勿将 Token 放入聊天、代码或代码仓库。本地凭证以明文保存，辅助脚本会将文件的 Unix 权限设为 600。
• 查询结果和日志可能进入 Agent 的模型上下文，请遵循组织的数据安全要求。

更多说明请参阅身份认证和 Query API 参考。

如需让 Agent 通过控制台 API 管理数据源、数据集成任务、计算集群等资源，请参阅面向 Agent 的 Cloud API。