SuperAPI AI 工具集

roboflow-cloud-storage

智能体与模型

查看项目

更新于 10-15 23:25

技能介绍

用途:将云存储桶内容镜像到 Roboflow 工作区,使新增对象自动流入。由两部分组成:Credential(Roboflow 访问桶的密钥,服务端加密存储、可复用)与 Datasource(桶镜像配置,指定桶、glob 规则与同步方式)。注意:导入落在工作区层级,数据源 API 目前无法指定到具体项目或数据集;如只想对文件跑模型并收集结果而不导入,属于批处理场景。

主要能力:connect_cloud_storage 可一次完成创建凭据、创建数据源、校验访问并启动首次镜像;也可用 credentials_list、datasource_create 等工具分步操作。凭据类型包括 AWS IAM、AssumeRole、AssumeRoleWithWebIdentity、GCS(服务账号 JSON)、usernamePassword、apiKey(后两者用于 S3 兼容)。AWS PrivateLink(require_vpce)必须使用 AssumeRoleWithWebIdentity 凭据。镜像规则 mirror_configs 支持 glob_patterns 选择对象、glob_file_path 清单文件,以及多项同步设置,如 removeOrphanedSourcesWhenDisappeared、namingStrategy、updateImageWhenNewer、updateMetadataWhenNewer、runScheduledEvery(当前仅支持固定 24 小时开关)。

使用方式:密钥通过 MCP 外部采集,不作为工具参数、不进入对话或模型上下文;credentials_list 仅返回脱敏字段。若客户端无法安全采集,工具返回 manual_entry_required 并给出应用内创建凭据的 URL,再通过 credentials_list 获取 id。流程为:创建数据源 → datasource_validate 自检(检查 listFiles、headFile、getFile 及每规则 headGlobFile)→ datasource_trigger 启动镜像(消耗计算/存储额度)→ 用 datasource_job_get 轮询 running/completed/failed 与各阶段计数。更新时仅传入字段发生变更;改桶需同时传 bucket_type、bucket_name、region。删除数据源只移除配置,不影响已镜像图片;删除仍被数据源引用的凭据会导致其运行失败。

限制:创建凭据后若后续步骤失败会返回 status: partial 与相关 id,需自行清理;未提供插件时应回退使用 MCP 资源,但可能滞后于仓库。其余细节(如具体额度消耗规则)暂未提供。