mcpField
W
workspace

workspace

github.com/aws-samples生产力19737 次安装3 周前更新
代码仓库

关于 workspace

workspace 为当前会话中的文件提供统一读写能力，面向需要在不同工具或技能间访问和传递文件的工作流。它按逻辑路径组织上传文件、代码产物及 Office 文档等内容。

主要功能

  1. 01列出会话文件
  2. 02读取文本与二进制文件
  3. 03写入文本或 Base64 内容
  4. 04在工具和技能间传递文件
  5. 05按路径前缀访问不同文件类别

适用场景

  1. 01查看会话中的上传文件
  2. 02读取代码 Agent 生成的文件
  3. 03将文件从一种技能传给另一种
  4. 04保存图片或 Office 文档

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aws-samples/sample-strands-agent-with-agentcore --skill workspace

安装后在 Claude Code 中输入/workspace确认已加载。

详细介绍

工作区

提供对当前会话中所有文件的统一读写访问。userId 和 sessionId 会自动注入——你只需指定逻辑路径。

路径约定

前缀访问内容
uploads/<file>用户上传的文件
code-agent/<file>编码 Agent 创建的文件（自动同步）
code-interpreter/<file>在 Code Interpreter 工作区中创建的文件
documents/powerpoint/<file>PowerPoint 演示文稿
documents/word/<file>Word 文档
documents/excel/<file>Excel 电子表格
documents/image/<file>其他工具生成的图片

注意： 写入 /mnt/workspace 下的文件会在整个聊天会话期间保留， 用户上传的文件可在 /mnt/workspace/inputs 下找到。委派任务时，Code Agent 会将会话上传的文件下载到自己的工作目录中。

用法

查看会话中的所有内容：

workspace_list()
workspace_list("uploads/")
workspace_list("code-agent/")

读取编码 Agent 创建的文件：

workspace_read("uploads/data.jsonl")           # uploaded structured data
workspace_read("code-agent/calculator.png")   # binary → base64
workspace_read("code-agent/report.md")        # text → string

将文件从一种技能传递给另一种技能：

result = workspace_read("documents/excel/data.xlsx")   # encoding: base64
workspace_write("code-agent/data.xlsx", result["content"], encoding="base64")

注意事项

  • 文本文件会以 encoding: "text" 返回，并包含纯字符串内容。大型文本 读取有大小限制；当 truncated 为 true 时，请使用 Code Interpreter 获取 完整文件，而不要反复将其读入模型上下文。Code Interpreter 使用 /mnt/workspace/inputs/<file>。
  • JSON、JSONL 和 NDJSON 上传文件属于文本文件；大型聊天附件在模型上下文中可能会被截断，但完整文件仍保存在 uploads/ 下。
  • 二进制文件（图片、Office 文档、PDF 等）会以 encoding: "base64" 返回。
  • workspace_write 接受这两种编码——二进制文件请使用 "base64"。
  • 写入此处的文件会立即对会话中的所有其他技能开放。

UI 指南（来自 tools-config）

路径约定（userId/sessionId 会自动注入）：

  • uploads/<file> — 用户上传的文件
  • code-agent/<file> — 来自编码 Agent 的文件
  • documents/powerpoint/<file> — PowerPoint
  • documents/word/<file> — Word
  • documents/excel/<file> — Excel
  • documents/image/<file> — 图片

二进制与文本： 图片/PDF/Office 文件会以 base64 编码返回（encoding: "base64"）；写回时请使用相同的编码。

评论

支持 Markdown