管理环境变量

本文将帮助你快速上手扣子编程的环境变量功能，了解其在 AI 编程项目开发中的作用，及相关操作步骤。

什么是环境变量

扣子编程提供环境变量管理工具，用于将 AI 编程项目运行所需的信息以环境变量形式进行存储与管理，例如 API 密钥、数据库密码、鉴权 Token 等。通过将数据与代码分离，可有效避免硬编码风险，大幅提升 AI 编程项目的安全性、灵活性与合规性。支持以下两种类型的环境变量：

• 系统环境变量： 由平台内置并管理，以COZE_作为命名前缀。例如为 AI 编程项目接入数据库能力时，扣子 AI 会自动在代码中使用数据库相关的环境变量存储数据库的访问地址等信息。
• 自定义环境变量：由你根据项目需求自行创建。创建后，你需要与扣子 AI 对话，将环境变量写入项目代码中。

核心特性如下：

• 应用级密钥管理：AI 编程项目维度独立管理环境变量。
• 生产与开发环境隔离：开发与生产环境完全隔离，避免开发调试阶段的配置变动影响线上运行。

开发与生产环境

扣子编程的环境变量区分开发环境和生产环境，数据完全隔离，避免开发阶段的配置变动影响线上业务运行。

权限说明

仅 AI 编程项目的所有者具备对应环境变量的操作权限。

使用环境变量

你可以参考如下步骤创建并使用自定义环境变量。

1. 创建自定义环境变量。
   1. 在扣子编程首页，按需输入你的开发需求，然后进入 AI 编程环境。
   2. 在 AI 编程环境的右上角，单击➕，然后在集成服务区域，单击环境变量。
   3. 在开发环境页签中，单击新建变量。
   4. 设置环境变量名称和值，单击确认。

      说明

      环境变量 Key 不允许以 COZE_ 开头，COZE_ 为系统环境变量专用前缀。

      
2. 通过自然语言与扣子 AI 对话，将已创建的环境变量集成到项目代码中。

   说明

   创建自定义环境变量后，你需要通过对话，让扣子 AI 将其集成到业务代码中。

   

示例

在开发识别发票并将识别结果发送到飞书多维表格的工作流时，工作流中会提供输入参数来配置飞书多维表格的 app_token 和 table_id。在该场景中，你可以：

1. 创建环境变量 FEISHU_APP_TOKEN 和 FEISHU_TABLE_ID，并根据实际的app_token 和 table_id，配置环境变量值。
2. 与扣子 AI 对话，更新代码，将这两个环境变量集成到业务代码中。

运行工作流时，系统会自动读取环境变量中的配置值，你无需手动填写 app_token 和 table_id，即可将发票提取结果写入指定的飞书多维表格。如果你需要切换目标飞书多维表格，只需更新环境变量值。

相关操作

在 AI 编程环境的环境变量页签中，你还可以进行如下相关操作。

常见问题

• 各个项目之间的环境变量是共享的吗？