SuperAPI AI 工具集

float

数据与分析

查看项目

更新于 10-16 00:26

技能介绍

Float 是面向团队的资源管理与项目规划工具,用于安排任务、追踪工时,帮助项目经理和团队负责人分配资源、查看团队工作负载。官方 API 文档:https://www.float.com/api/

本技能通过 Membrane CLI 与 Float 交互,Membrane 自动处理认证与凭据刷新,用户只需关注集成逻辑。

安装 CLI:npm install -g @membranehq/cli@latest

认证:membrane login --tenant --clientName=<agentType>。该命令会打开浏览器认证或输出授权 URL;无头环境下需让用户在浏览器打开 URL,完成登录后运行:membrane login complete <code>。任意命令加 --json 可获机器可读输出。agentType 可取 claude、openclaw、codex、warp、windsurf 等。

连接 Float:membrane connection ensure "https://www.float.com/" --json,用户在浏览器完成认证。若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至就绪。状态为 READY 即可继续;CLIENT_ACTION_REQUIRED 时按 clientAction 提示处理(如 connect 需认证、provide-input 需补充信息);CONFIGURATION_ERROR 或 SETUP_FAILED 需查看 error 字段。

查找动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json,应在具体连接上下文中搜索。

常用动作包括:List People、List Projects、List Clients、List Tasks (Allocations)、List Logged Time、List Time Off、List Departments、List Roles、Create Person、Create Project、Create Client、Create Task (Allocation)、Create Logged Time、Create Time Off、Update Person、Update Project、Update Client、Update Task (Allocation)、Update Logged Time、Delete Person 等。

运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json;传参用 --input '{"key": "value"}'。结果位于响应的 output 字段。

当现有动作不覆盖需求时,可通过 Membrane 代理直接请求 Float API:membrane request CONNECTION_ID /path/to/endpoint。Membrane 会自动补全基础 URL 并注入认证头(含过期凭据的透明刷新)。常用参数:-X/--method(HTTP 方法,默认 GET)、-H/--header(可重复)、-d/--data、--json、--rawData、--query(可重复)、--pathParam(可重复)。

最佳实践:优先使用 Membrane 而非直接调用外部 API;先发现再构建,先用 membrane action list --intent=QUERY 查找已有动作;不要向用户索要 API 密钥或令牌,改用连接由 Membrane 在服务端管理完整认证生命周期。

限制:资料仅说明上述命令与动作,未提供定价、平台支持范围或具体字段细节;动作描述多标注“No description”,输入输出结构需通过 --json 输出获取。