SuperAPI AI 工具集

swagup

办公与效率

查看项目

更新于 10-16 06:46

技能介绍

用途:该技能用于让 AI 智能体与 SwagUp 平台数据交互。SwagUp 是创建、存储和分发品牌周边礼品(swag)的平台,企业常用于营销、活动和员工礼品管理。本技能通过 Membrane CLI 调用 SwagUp API,Membrane 自动处理认证与凭证刷新。官方文档见 https://developers.swagup.com/。

主要能力:可管理 Persons、Organizations、Deals、Leads、Projects、Activities 等数据;资料还列出 Swag Project、Step、Shipment、Delivery、User、Account、Item、Integration、Swag Distribution、Direct Send、Template、Order、Product、Brand Store、Warehouse 等对象,但未说明每项的具体操作细节,暂未提供。

使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无界面环境会打印授权 URL,用户完成登录后用 membrane login complete <code> 结束。连接 SwagUp:membrane connection ensure "https://swagup.com" --json;若状态为 BUILDING,则用 npx @membranehq/cli@latest 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 等选项。任意命令加 --json 可输出机器可读 JSON。

适用场景:需要与 SwagUp 数据交互、查询或变更上述对象的自动化流程。

限制:资料的连接状态可能为 CLIENT_ACTION_REQUIRED、CONFIGURATION_ERROR 或 SETUP_FAILED,需按提示处理;具体可用动作、字段与权限范围以实际搜索和返回为准,资料未给出;不向用户索取 API 密钥,认证由 Membrane 服务端管理。