SuperAPI AI 工具集

seven

办公与效率

查看项目

更新于 10-16 02:12

技能介绍

Seven 是一个用于与 Seven 数据交互的集成技能。根据资料,Seven 是一款帮助用户管理和跟踪习惯的 SaaS 应用,面向希望建立更好习惯并实现个人目标的个人用户。

该技能可管理的对象包括 Organizations(组织)、Users(用户)、Goals(目标)和 Filters(筛选器)。资料中列出的相关实体包括 Goal(目标)、Goal Details(目标详情)、Habit(习惯)、Habit Details(习惯详情),并提示按需使用动作名称和参数。

使用该技能需要 Membrane CLI。安装命令为:npm install -g @membranehq/cli@latest。登录命令为:membrane login --tenant --clientName=<agentType>。该命令会打开浏览器进行身份验证,或在无交互模式时打印授权 URL 到控制台。在无头环境中,命令会打印授权 URL,需请用户在浏览器中打开;用户完成登录后看到代码,再用 membrane login complete <code> 完成。任何命令加上 --json 可获得机器可读的 JSON 输出。可用的 agent 类型包括 claude、openclaw、codex、warp、windsurf 等,用于调整工具以最好地适配相应的 harness。

连接 Seven 时,可使用 membrane connection ensure 按应用 URL 或域名查找或创建连接,例如:membrane connection ensure "https://www.seven.io/en/" --json。用户在浏览器中完成身份验证,输出中包含新的 connection id。这是获取连接最快的方式:URL 会被规范化为域名并与已知应用匹配;如果未找到应用,则会创建一个应用并自动构建连接器。如果返回的连接状态为 READY,可直接跳到第二步。若连接处于 BUILDING 状态,则轮询直到就绪:npx @membranehq/cli connection get <id> --wait --json。--wait 标志会进行长轮询(最长 --timeout 秒,默认 30)直到状态变化。持续轮询直到状态不再是 BUILDING。状态含义包括:READY(连接已完全设置好);CLIENT_ACTION_REQUIRED(用户或代理需要执行操作,clientAction.type 为 "connect" 表示用户需要认证(OAuth、API key 等),为 "provide-input" 表示需要更多信息,clientAction.description 为人类可读说明,clientAction.uiUrl 为可选的操作 UI,clientAction.agentInstructions 为可选的代理说明);CONFIGURATION_ERROR 或 SETUP_FAILED 表示出错,需查看 error 字段。用户完成操作后,再次用 membrane connection get <id> --json 轮询检查状态是否变为 READY。

搜索动作时,使用自然语言描述想做的事:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。应始终在特定连接的上下文中搜索动作。每条结果包含 id、name、description、inputSchema(动作接受的参数)和 outputSchema(返回内容)。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json。传入 JSON 参数:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。结果位于响应的 output 字段中。

当可用动作不覆盖用例时,可通过 Membrane 的代理直接向 Seven API 发送请求:membrane request CONNECTION_ID /path/to/endpoint。Membrane 会自动在你提供的路径前追加基础 URL,并注入正确的认证头,包括凭证过期时的透明刷新。常用选项包括:-X / --method(HTTP 方法,默认 GET)、-H / --header(添加请求头,可重复)、-d / --data(请求体字符串)、--json(发送 JSON 体并设置 Content-Type: application/json 的简写)、--rawData(原样发送请求体)、--query(查询字符串参数,可重复)、--pathParam(路径参数,可重复)。

最佳实践包括:优先使用 Membrane 与外部应用通信,因为 Membrane 提供带内置认证、分页和错误处理的预置动作,更省 token 且更安全;在自行构建前先发现现有动作,运行 membrane action list --intent=QUERY 查找;让 Membrane 处理凭证,绝不要向用户索要 API key 或 token,而是创建连接,由 Membrane 在服务端管理完整的认证生命周期,无本地密钥。

资料中提到的官方文档地址为:https://www.7-pdf.de/support/online-help/7-pdf-website-converter。该集成具体支持的全部动作、参数细节、配额、收费方式及平台限制等信息暂未提供。