Variables
环境变量
环境变量为管理工作流中的配置值和密钥(包括 API 密钥和其他敏感数据)提供了一种安全的方式。它们可以在执行期间使用,同时将敏感信息从工作流定义中隔离开来。
变量类型
Sim 中的环境变量分为两个级别:
- 个人环境变量:仅限于您的账户,只有您可以查看和使用
- 工作区环境变量:在整个工作区内共享,所有团队成员都可以使用
当命名冲突时,工作区环境变量优先于个人环境变量。
设置环境变量
前往设置页面配置您的环境变量:

在工作区设置中,您可以创建和管理个人及工作区级别的环境变量。个人变量仅限于您的账户,而工作区变量会与所有团队成员共享。
将变量设为工作区范围
使用工作区范围切换按钮,使变量对整个团队可用:

启用工作区范围后,该变量将对所有工作区成员可用,并可在该工作区内的任何工作流中使用。
工作区变量视图
一旦您拥有了工作区范围的变量,它们将显示在您的环境变量列表中:

在工作流中使用变量
要在工作流中引用环境变量,请使用 {{}}
表示法。当您在任何输入字段中键入 {{
时,将会出现一个下拉菜单,显示您的个人和工作区级别的环境变量。只需选择您想要使用的变量即可。

变量优先级
当您同时拥有名称相同的个人变量和工作区变量时:
- 工作区变量优先 于个人变量
- 这可以防止命名冲突,并确保团队工作流中的行为一致
- 如果存在工作区变量,则会忽略具有相同名称的个人变量
请谨慎选择变量名称,以避免意外覆盖。建议为个人变量添加您的姓名首字母前缀,或为工作区变量添加项目名称前缀。
安全最佳实践
针对敏感数据
- 将 API 密钥、令牌和密码存储为环境变量,而不是硬编码它们
- 对于多个团队成员需要的共享资源,使用工作区变量
- 将个人凭据保存在个人变量中
变量命名
- 使用描述性名称:
DATABASE_URL
而不是DB
- 在团队中遵循一致的命名约定
- 考虑使用前缀以避免冲突:
PROD_API_KEY
、DEV_API_KEY
访问控制
- 工作区环境变量遵循工作区权限
- 只有具有写入权限或更高权限的用户才能创建/修改工作区变量
- 个人变量始终对个人用户私有