交换空间

交换空间解决一个具体问题：Agent 需要密钥，但密钥不该出现在提示词和对话记录里。

你把凭据放进来，运行时系统会以环境变量或文件的形式注入沙盒；Agent 只能使用，看不到明文。

平台与条目

结构分两层：

平台 Platform（一组凭据的集合，例如 acme-cloud）
  ├─ 变量 Variable（NAME=value，注入为环境变量）
  └─ 文件 File（写入指定目录，路径通过环境变量指路）

新建平台

1. 左侧菜单 Exchange Space → 新建平台。
2. 填写：
   • 标识（slug）：小写字母、数字、-、_，会作为文件路径的一部分。
   • 展示名：给人看。
   • 描述：会进入提示词，告诉 Agent 这组凭据是干什么的。
   • 文档：可选，标题 + 链接，只进提示词、不进容器。
3. 保存。

添加条目

在平台下点添加变量或添加文件：

类型	字段	效果
变量	变量名、值、注释	注入为同名环境变量
文件	文件名、内容、变量名（可选）	写入工作目录下的凭据目录；填了变量名则同时注入该路径

约定：

• 值保存后脱敏显示；编辑时留空表示保持原值。
• 变量名必须符合环境变量命名规则（字母/下划线开头）。
• 条目和平台都可以单独启用/停用；停用后不再注入。

在运行时怎么用

Agent 在沙盒里执行命令时，可以直接读环境变量，例如：

echo "$ACME_API_KEY"

文件类条目会落在固定的凭据目录下，变量名指向该文件路径，按提示词里的说明使用即可。

安全建议

• 一个平台只放一组相关凭据，便于整体停用。
• 不要在对话里粘贴密钥；需要时让 Agent 从环境变量读取。
• 定期轮换；轮换时直接编辑条目，留空其他字段即可保持原值。

常见问题

Agent 读不到变量：确认条目与平台都已启用，且会话使用的沙盒已重启加载新配置。

文件没出现：检查文件名与变量名；文件内容为空时不会创建。

想临时停用某个 Key：停用条目即可，不必删除。