Akana by Perforce 是一个 API 管理平台,面向希望设计、保护、管理和发布 API 的企业,常用于架构现代化和以 API 方式暴露服务。本技能用于让用户与 Akana by Perforce 数据交互,管理数据、记录并自动化工作流。其涉及对象包括 API、Definition、Policy、Application、Service、User 等。
使用方式:通过 Membrane CLI 与 Akana by Perforce 交互,Membrane 自动处理认证与凭证刷新。安装命令为 npm install -g @membranehq/cli@latest。登录命令为 membrane login --tenant --clientName=<agentType>;无交互环境会打印授权 URL,用户完成登录后执行 membrane login complete <code>。可用 --json 获取机器可读输出。
连接方式:使用 membrane connection ensure "https://www.akana.com/" --json 按应用 URL 或域名查找或创建连接,用户需在浏览器完成认证,输出包含连接 id。若连接处于 BUILDING 状态,可用 npx @membranehq/cli connection get <id> --wait --json 轮询直至 READY;出现 CLIENT_ACTION_REQUIRED 时按 clientAction 说明处理;CONFIGURATION_ERROR 或 SETUP_FAILED 时检查错误字段。
查找与运行动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json 可用自然语言搜索动作,结果含 id、name、description、输入与输出结构。运行示例如 membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参可用 --input '{"key": "value"}',结果在 output 字段。
代理请求:当预置动作不覆盖需求时,可用 membrane request CONNECTION_ID /path/to/endpoint 直接请求 Akana API 路径,Membrane 会拼接基础 URL 并注入认证头,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。
限制与说明:官方资料未提供具体收费、价格与平台支持信息;使用前需完成 Membrane 登录与 Akana 认证。官方文档见 https://www.perforce.com/products/akana/documentation。