### 多环境管理为不同环境创建独立配置文件： ```Bash agentkit.dev.yaml # 开发环境（local 模式） agentkit.test.yaml # 测试环境（hybrid 模式） agentkit.prod.yaml # 生产环境（cloud 模式） ``` **使用方式**： ```Bash # 开发 agentkit launch --config-file agentkit.dev.yaml # 生产 agentkit launch --config-file agentkit.prod.yaml ``` ### 安全管理敏感信息 **错误做法**（硬编码）： ```Bash runtime_envs: MODEL_AGENT_API_KEY: c05d49af-1234-5678-abcd-xxxx # 不要这样！ ``` **正确做法**： **方案 1**：交互式配置 ```Bash agentkit config # 运行时输入敏感信息 ``` **方案 2**：使用 .gitignore ```Bash # .gitignore 文件 agentkit.local.yaml # 本地配置不提交 agentkit.prod.yaml # 生产配置不提交 *.secret.yaml # 所有包含密钥的配置 ``` **方案 3**：创建配置模板 ```Bash # agentkit.yaml.template （提交到 Git） runtime_envs: MODEL_AGENT_API_KEY: <请填写你的 API Key> MODEL_AGENT_NAME: <请填写接入点 ID> ``` ### 添加配置注释让团队成员更容易理解配置： ```YAML common: agent_name: weather_agent entry_point: app.py launch_type: cloud # 生产环境使用云端部署 launch_types: cloud: region: cn-beijing # 北京区域，离用户最近 runtime_envs: # 火山方舟的模型访问凭证 MODEL_AGENT_API_KEY: xxx MODEL_AGENT_NAME: ep-xxx ``` ### 定期验证配置确保配置文件始终有效： ```Bash # 方式 1：运行配置命令检查 agentkit config # 方式 2：查看配置内容 cat agentkit.yaml # 方式 3：尝试构建（不部署） agentkit build ```

AgentKit