SuperAPI AI 工具集

cargo-workspace-management

编程与开发

查看项目

更新于 10-15 21:51

技能介绍

用途:通过 Cargo CLI 完成工作区(workspace)级别的管理操作,包括用户与角色、API 令牌、资源文件夹、报告提交、会话记录、环境变量与工作区文件。

主要能力:

  • 用户与角色:列出成员、邀请用户、更新角色、移除用户;邀请前先用 role list 获取角色 slug。
  • API 令牌:列出、创建、删除令牌。--name 必填,创建时返回令牌值且仅显示一次,应存入密钥管理器。CLI 创建的令牌 permissions 为 null,权限随所属用户,细粒度权限需通过 API 或 Cargo 应用配置。
  • 文件夹:组织 plays、tools、agents 等资源,支持 list/get/create/update/remove,kind 可为 tool、play、agent、file。
  • 报告:当 CLI 失败、行为异常、缺少能力或反复重试无进展时,用 report create 提交官方反馈,标题加描述,附上命令与错误信息。
  • 会话:session upsert 记录 Claude Code 会话,以 workspaceUuid 与 sessionId 为一行,--session-id、--title、--summary 必填,--finished 会写入 finished_at。
  • 环境变量:工作区变量注入所有 worker、app 和 agent;同名的 worker/app 级条目会覆盖。secret 变量加密存储且不再返回。create 可省略 --value 以从同名 shell 环境变量读取;update 需用 uuid。
  • 工作区文件:上传 CSV 等文件用于批量运行,返回 s3Filename,可用 list-columns 查看列名以映射工作流输入。

使用方式:先 cargo-ai whoami 确认当前用户与工作区,再用 cargo-ai workspaceManagement <子命令>。安装命令:npm install -g @cargo-ai/cli;也可用 npx @cargo-ai/cli。登录:cargo-ai login --email you@company.com,另有 --oauth 与 --token <api-token> 方式。

限制:命令输出 JSON 到 stdout,失败以非零退出并返回 errorMessage。创建运行或批次的操作为异步,需 --wait-until-finished 或轮询。用户、角色、令牌写入需管理员权限令牌;文件夹写入与报告创建非管理员令牌即可。具体命令、响应结构、故障排查与示例见对应 references 文档。