SuperAPI AI 工具集

swell

通用与其它

查看项目

更新于 10-16 06:46

技能介绍

用途:该技能让 AI 智能体通过 Membrane CLI 与 Swell 平台对接,管理 Organizations、Pipelines、Users、Filters 等资源;Swell 是收集并利用客户反馈、提升在线声誉与客户体验的平台,相关资源涵盖 User、Goal、Task、Subtask、Project、Template 等实体。

主要能力:Membrane 负责自动处理认证与凭据刷新,无需手动管理密钥;支持按自然语言意图搜索可用动作,可在指定连接下执行动作;当预置动作不足时,可通过 Membrane 代理直接请求 Swell API,并自动附加基础 URL 与正确认证头,凭据过期时自动刷新。

使用方式:先安装 CLI,命令为 npm install -g @membranehq/cli@latest。认证使用 membrane login --tenant --clientName=<agentType>,支持 claude、openclaw、codex、warp、windsurf 等类型;无界面环境会打印授权 URL,登录后执行 membrane login complete <code>。连接可用 membrane connection ensure "https://www.swell.is/" --json 查找或创建,返回 state: READY 即可使用,若为 BUILDING 则用 npx @membranehq/cli connection get <id> --wait --json 轮询;CLIENT_ACTION_REQUIRED 时按 clientAction 提示完成认证或补充输入。搜索动作使用 membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json,执行使用 membrane action run <actionId> --connectionId=CONNECTION_ID --json,可加 --input 传入 JSON。代理请求使用 membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--rawData、--query、--pathParam 等选项。

限制与建议:应始终优先使用 Membrane 的预置动作而非原始 API 调用,以获得内置认证、分页与错误处理;先发现再构建,用 action list 查找已有动作;不要让用户提供 API 密钥或令牌,改为创建连接。具体可用动作清单与 Swell API 端点细节以官方文档 https://developers.swell.is/ 为准,资料中未提供完整动作列表。