用途:该技能用于让 AI 代理与 QuestDB 交互。QuestDB 是开源时序数据库,面向高性能数据写入与查询,常用于金融数据、IoT 传感器读数、应用指标等带时间戳数据的 SQL 分析,以及实时仪表盘、监控系统和数据分析管道。官方文档:https://questdb.io/docs/
主要能力:可查询数据、查看查询结果、管理表与表结构、处理配置,并自动化相关工作流。技能通过 Membrane CLI 与 QuestDB 通信,由 Membrane 自动处理认证与凭据刷新。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无交互环境会打印授权 URL,完成后执行 membrane login complete <code>。连接 QuestDB:membrane connection ensure "https://questdb.io/" --json,若状态为 BUILDING 可用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。动作不足时可用代理请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--query 等选项。任意命令加 --json 可获得机器可读输出。
适用场景:需要以自然语言驱动 QuestDB 查询、表结构管理与数据工作流的代理任务。
限制:具体可用动作、参数与返回结构需通过 action list 查询,资料未逐一列出;认证由 Membrane 管理,不应向用户索取 API 密钥或令牌;连接状态可能为 CLIENT_ACTION_REQUIRED、CONFIGURATION_ERROR 或 SETUP_FAILED,需按提示处理。