SuperAPI AI 工具集

kibana

数据与分析

查看项目

更新于 10-16 00:26

技能介绍

用途:Kibana 是面向 Elasticsearch 数据的可视化仪表盘,允许用户(通常是数据分析师和工程师)探索数据并创建可视化。本技能用于在用户需要与 Kibana 数据交互时,通过 Membrane CLI 管理数据、记录并自动化工作流。官方文档见 https://www.elastic.co/guide/en/kibana/current/index.html。

主要对象:Discover、Saved Discover Query、Dashboard、Saved Dashboard、Visualization、Saved Visualization、Index Pattern、Alert、Case。使用时按需选用动作名称和参数。

安装与认证:运行 npm install -g @membranehq/cli@latest 安装 CLI。使用 membrane login --tenant --clientName=<agentType> 登录,交互模式会打开浏览器,否则打印授权 URL;无头环境需让用户在浏览器打开并完成,再用 membrane login complete <code> 结束。任意命令加 --json 可输出机器可读 JSON。Agent 类型包括 claude、openclaw、codex、warp、windsurf 等。

连接 Kibana:使用 membrane connection ensure "https://www.elastic.co/products/kibana" --json 按应用 URL 或域名查找或创建连接,用户在浏览器完成认证,输出含新连接 id。若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询直到 READY。CLIENT_ACTION_REQUIRED 时按 clientAction 指引处理(connect 表示需认证,provide-input 表示需补充信息,可能提供 uiUrl);CONFIGURATION_ERROR 或 SETUP_FAILED 时查看 error 字段。

动作使用:先搜索动作,如 membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json,结果含 id、name、description、inputSchema、outputSchema。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参可用 --input '{"key": "value"}',结果在响应的 output 字段。

代理请求:当现成动作不覆盖需求时,可通过代理直接调用 Kibana API:membrane request CONNECTION_ID /path/to/endpoint。常用选项包括 -X/--method(HTTP 方法,默认 GET)、-H/--header(可重复)、-d/--data(请求体)、--json(发送 JSON 体并设置 Content-Type)、--rawData(原样发送)、--query(可重复)、--pathParam(可重复)。

最佳实践:优先用 Membrane 与外部应用通信,以复用内置认证、分页与错误处理;先搜索已有动作再自建 API 调用;不要向用户索取 API key 或 token,改为创建连接,由 Membrane 服务端管理完整认证生命周期,本地不保存密钥。

限制:资料未提供具体收费、价格、平台支持、配额或性能指标,暂未提供。