用途:该技能通过 Membrane CLI 与 SwaggerHub 交互,用于设计、构建和文档化符合 OpenAPI 规范的 API 时管理相关数据,覆盖 API、版本、配置、组织、用户与 Domain 等对象。
主要能力:借助 Membrane 预置动作完成查询与操作;CLI 会自动处理认证与凭据刷新。官方资料列出 SwaggerHub 涉及的 API、Version、Configuration、Organization、User、Domain 等对象,具体可用动作需按需检索。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest;登录:membrane login --tenant --clientName=<agentType>,无图形环境时会打印授权 URL,完成登录后用 membrane login complete <code> 收尾。建立连接:membrane connection ensure "https://swagger.io/tools/swaggerhub/" --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、--query、--pathParam 等参数。任意命令可加 --json 获得机器可读输出。
适用场景:在 AI 智能体中需要与 SwaggerHub 中的 API、Domain、组织数据交互时使用。
限制:具体可用动作、参数与返回结构需通过 action list 实时发现;资料未说明 SwaggerHub 本身的收费与价格信息,也未提供更多固定流程,暂未提供。