SuperAPI AI 工具集

harperdb

数据与分析

查看项目

更新于 10-16 00:26

技能介绍

用途:该技能用于让 AI 代理与 HarperDB 分布式数据库交互,管理数据、记录并自动化工作流。HarperDB 是面向易用性与可扩展性的分布式数据库平台,可处理事务型与分析型工作负载。

主要能力:围绕 Schema、Table(数据记录表)、Record(表内数据)、User(访问与权限)、Role(权限集合)等对象操作。动作选择上,SQL 是通用且强大的动作,适合复杂查询或没有更具体动作时使用;SearchByHash 用于已知记录哈希值时精确查找;Update 修改已有记录,需提供哈希值;Delete 删除记录,也需提供哈希值。

使用方式:先安装 Membrane CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无头环境会打印授权 URL,完成后执行 membrane login complete <code>。连接 HarperDB:membrane connection ensure "https://harperdb.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/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。

适用场景:需要以自然语言方式查询、更新、删除 HarperDB 记录,或通过代理直接调用其 API 的集成任务。

限制:认证与凭据刷新由 Membrane 处理,不应向用户索要 API 密钥或令牌;应优先使用预置动作而非手写 API 调用。官方文档见 https://studio3.harperdbcloud.com/docs/。具体收费、价格与平台支持等资料暂未提供。