SuperAPI AI 工具集

workspace

设计与创作

查看项目

更新于 10-15 17:22

技能介绍

用途:在当前会话中对所有文件进行统一读写,跨技能共享文件,例如把代码智能体生成的输出传给其他技能,或读取用户上传的数据。userId 和 sessionId 由系统自动注入,使用时只需给出逻辑路径。

路径约定:uploads/<file> 为用户上传文件;code-agent/<file> 为代码智能体创建并自动同步的文件;code-interpreter/<file> 为代码解释器工作区文件;documents/powerpoint/<file>、documents/word/<file>、documents/excel/<file>、documents/image/<file> 分别对应演示文稿、Word 文档、Excel 表格与图片。写入 /mnt/workspace 的文件在本次聊天会话内持久,用户上传位于 /mnt/workspace/inputs;委派时 Code Agent 会把会话上传下载到自己的工作目录。

主要能力:workspace_list() 可列出会话内文件,也可按前缀过滤,如 workspace_list("uploads/")、workspace_list("code-agent/")。workspace_read() 读取文件,文本返回 encoding: "text" 和字符串内容,二进制返回 base64。workspace_write() 支持 text 与 base64 两种编码,二进制需用 base64 写回,写入后其他技能立即可用。

典型用法:读取代码智能体生成的文件,如 workspace_read("code-agent/report.md");在技能间传递文件,可先读 documents/excel/data.xlsx 再把内容以 base64 写入 code-agent/data.xlsx。

限制:文本大文件读取有上限,返回 truncated: true 时应改用 Code Interpreter 处理完整文件,而非反复读入模型上下文;Code Interpreter 使用 /mnt/workspace/inputs/<file>。JSON、JSONL、NDJSON 上传按文本处理,较大的聊天附件可能在模型上下文中被截断,但完整文件仍保留在 uploads/ 下。图片、Office 文档、PDF 等二进制文件返回 base64,写回时须使用相同编码。具体定价、平台可用范围等资料未提供。