扣子编程的项目环境变量怎么配置
API 密钥、数据库密码这类配置不适合直接写在代码里。扣子编程可以把这些信息存成环境变量,开发环境和生产环境分别设置。自定义变量建好后,还需要通过对话让扣子 AI 在代码中使用它。
系统环境变量: 由平台内置并管理,以COZE_作为命名前缀。例如为 AI 编程项目接入数据库能力时,扣子 AI 会自动在代码中使用数据库相关的环境变量存储数据库的访问地址等信息。
自定义环境变量:由你根据项目需求自行创建。创建后,你需要与扣子 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 编程环境的环境变量页签中,你还可以进行如下相关操作。
操作 | 说明 | 图示 |
|---|---|---|
修改环境变量 | 开发环境:在环境变量的开发环境页签中,找到目标环境变量,进行修改。 生产环境:在发布管理页面修改环境变量,并在修改后重新部署才能生效。 说明 修改环境变量 Key,系统不会自动更新代码,你需要让扣子 AI 调整相关配置或者自行调整相关代码,避免项目运行异常。 修改环境变量 Value 后,你可以重启 AI 编程项目,使变更生效。 |
|
删除环境变量 | 开发环境:在环境变量的开发环境页签中,找到目标环境变量,选择更多 > 删除。 生产环境:在发布管理页面删除环境变量,并在删除后重新部署才能生效。 说明 删除环境变量并不会自动更新相关代码,你需要通过对话方式让扣子 AI 调整代码。 |
|
| 同步环境变量 | 在部署页面,如果你修改了环境变量名称或值,可以单击同步开发环境变量,一键同步开发环境变量。 |
|
| 查看环境变量 | 在环境变量页签中,查看开发环境或生产环境的环境变量。 |
|
-
2026-11-10 橙子
-
2026-11-10 橙子
-
2026-11-10 橙子
-
2026-11-10 橙子
-
2026-11-10 橙子
-
2026-11-10 橙子
-
2026-11-10 橙子
-
2026-11-10 橙子
-
扣子编程如何用对话创建智能体
2026-11-10
-
扣子编程开发的智能体怎么部署上线
2026-11-10





