先说结论#
环境变量是保存在某个助手里的“名称 + 私密值”。它会随该助手持续保存;不同助手可以使用同一个变量名保存不同的值,彼此不会读取或覆盖。它适合保存 Skill 或 JavaScript 工具需要使用的 API Key、Token 等配置,避免把敏感值直接写进聊天消息、系统提示词、Skill 文件、日志或工具结果。
在哪里设置#
打开 助手 → 编辑助手 → 提示词 → 变量,新建变量名、用途和值,例如 SILICONFLOW_API_KEY。列表可按名称或用途搜索,默认不展示值;点条目编辑,点 插入 将引用添加到助手指令。需要给其他助手复用时,可用复制功能创建独立副本。
环境变量 单独保存、立即生效,不会等待助手右上角保存;放弃助手指令草稿也不会撤销已保存的变量。变量尚未保存时会拦截助手保存,并提示先处理变量草稿。新助手需先保存,再配置环境变量。
怎么使用#
- 调用外部接口时,通过网络请求的凭据代用指定当前助手变量,或在代码工作台申请服务商凭据;由应用在获准的 HTTPS 目标上添加鉴权,不把明文交给脚本。
- 助手提示词确实需要引用某个值时,可以写
{{env.SILICONFLOW_API_KEY}}。
会自动发送给模型吗#
不会。仅仅保存环境变量,不会把变量名或值自动放进模型上下文。
但如果在提示词中使用 {{env.变量名}},发送前会替换成真实值,这会把该值发送给当前模型服务商。密钥通常不应通过提示词传给模型;需要调用接口时,优先使用宿主凭据代用。process.env 默认为空,不要打印、写文件或返回敏感值。
备份与导出#
环境变量会随所选助手进入完整备份、助手导出和碰一碰传送,分享用途也保留,不会自动去除密钥。文件含明文凭据,请仅保存到可信位置或交给可信接收方;不希望外传时取消选择该助手,反馈中不要附上这类导出包。凭据无法读取时,整次导出会停止。
环境变量和提示词变量的区别#
{{current_date}}、{{current_clock}}等提示词变量由应用生成,用于日期与时间。- 助手环境变量由用户保存,主要承载外部服务配置和敏感值。
- 代码工作台的
process.env默认为空;外部接口鉴权使用宿主凭据代用。{{env.KEY}}会把实际值插入提示词并发送给模型。