SuperAPI AI 工具集

folder-management

通用与其它

查看项目

更新于 10-15 17:33

技能介绍

用途:这是 Spuree(面向智能体的云存储)中的文件夹管理技能。项目(creative_project)包含可任意嵌套的文件夹(API 术语为 session,sessionType="session"),文件夹内可含子文件夹、实体(资产)与文件。

主要能力:getSearchFoldersByName 支持一次性有界搜索(直接文件夹名与包含文件证据并行,8 秒上限),返回去重的规范文件夹;跨项目列出全部可访问文件夹(支持按 createdAt/updatedAt/name 排序与分页);创建文件夹;重命名、移动或修改标签与描述;软删除文件夹;浏览文件夹直接子项(子文件夹、实体、文件,统一 items 数组,带 type 判别符);文件名与内容证据仅返回计数,不返回文件名、ID 或片段。

使用方式:认证用 Authorization: Bearer $SPUREE_ACCESS_TOKEN 或 X-API-Key: $SPUREE_API_KEY。基础地址:命名查找 https://data.spuree.com/api/v1/search/folders;跨项目列表 https://data.spuree.com/api/v1/folders;CRUD 与子项浏览 https://data.spuree.com/api/v1/sessions。示例:curl "https://data.spuree.com/api/v1/search/folders?q=...&limit=5" -H "Authorization: Bearer $SPUREE_ACCESS_TOKEN";创建用 POST /v1/sessions;更新用 PATCH /v1/sessions/{sessionId};删除用 DELETE /v1/sessions/{sessionId};浏览用 GET /v1/sessions/{sessionId}/children。

适用场景:智能体按名称查找文件夹、列出最近文件夹、在项目中组织与移动文件夹、批量获取文件下载 URL 等。

限制:文件夹名须兼容 Windows 文件系统;实体(entity)下仅允许一层子文件夹;不允许循环引用;移动会继承新父级的 workspace 与 project ID;仅 sessionType="session" 可通过上述端点更新或删除;查询过宽返回 400,权限不足返回 403,请求预算耗尽返回 503。文档未提供指定收费信息。