修改代码与环境变量

本文说明部署后如何修改 Agent 代码、调整环境变量，以及哪些操作需要重新发布部署物后才会生效。

适用场景

• 需要在线查看或修改 Agent 代码。

• 需要调整 Agent 读取的环境变量。

• 绑定或更换 Agent 连接后，需要让新配置在运行环境中生效。

• 使用代码创建 Agent，需要重新发布自己的代码包、Git 仓库代码或容器镜像。

如果左侧导航没有 代码调试 入口，先确认实例状态是否为 已部署：代码调试入口仅在 已部署 状态展示，部署中 不展示。若实例已部署后仍没有该入口，表示当前 Agent 不支持在线代码调试，或没有输出 8080 端口对应的代码调试页面。仍可根据 Agent 创建方式，通过重新发布部署物或重新创建实例完成代码更新。

代码调试入口通常对应 8080 端口。该端口只是平台预留的输出位置，需要运行环境实际提供代码调试页面并声明输出后才会展示；如果使用官方提供的 Docker 镜像，镜像中已经包含 8080 端口的代码调试页面。

修改代码

不同来源的 Agent，代码修改后的生效方式不同：

代码调试适合修改提示词、路由、工具调用、轻量业务逻辑、环境变量读取逻辑或诊断日志。不要在日志中打印 AccessKey、Token、数据库密码或连接完整地址。若采用集群部署，发布后还需要重启 Pod 才能加载最新代码。

如果涉及依赖升级、镜像变更、大规模重构或生产代码更新，建议回到代码来源中修改，并通过部署物重新发布。

修改环境变量

环境变量用于向 Agent 传入模型 Key、业务参数或连接地址。修改环境变量后，仅保存参数不会立即改变运行中的 Agent，需要重新发布最新部署物。

操作步骤：

1. 进入 Agent 实例详情页。

2. 打开应用分组的 参数 页签，修改需要变更的环境变量。

3. 打开 部署物 页签。

4. 找到最新的部署物。

5. 在操作列点击 发布。

6. 等待发布完成后，回到 Web UI、API 或日志中验证新变量是否生效。

Agent 代码应通过环境变量读取配置。例如 Python 代码可使用 os.getenv() 读取变量。不同连接类型注入的变量名请参考 添加网页链接。若采用集群部署，发布后还需要重启 Pod 才能加载新的环境变量。

绑定连接后发布

绑定或更换连接后，平台会更新 Agent 运行环境需要使用的连接配置。该变更也需要重新发布最新部署物后生效。

操作步骤：

1. 在 Agent 管理 > Agent 连接 中完成绑定、解绑或参数修改。

2. 返回应用分组页面，打开 部署物 页签。

3. 找到最新的部署物。

4. 点击 发布。

5. 发布完成后，通过 Web UI、API 或日志验证连接能力是否可用。

例如绑定知识库、记忆、沙箱、Skills 或 MCP 后，Agent 代码需要读取对应连接注入的环境变量或配置，并在重新发布后使用新配置。若采用集群部署，发布后还需要重启 Pod 才能加载新配置。

常见问题

修改后没有生效

确认是否已经执行对应生效操作：市场 Agent 和快速创建 Agent 通常需要在代码调试终端执行 ./server.sh restart；代码创建 Agent、环境变量变更和连接绑定通常需要在 部署物 页签发布最新部署物。若采用集群部署，发布后还需要重启 Pod 才能加载最新配置。

找不到代码调试入口

并非所有 Agent 都支持在线代码调试。代码调试入口仅在实例状态为 已部署 后展示，部署中 不展示。如果实例已部署后仍没有 代码调试 入口，请通过代码来源重新构建部署物，或按服务提供方说明更新 Agent。

发布后 Agent 无法启动

查看应用日志，优先检查启动命令、端口、依赖、环境变量和最近一次代码修改。如为代码创建 Agent，请先在本地或测试环境验证代码包、Git 仓库或镜像。