Cloud模式配置支持在火山引擎上构建和运行，适合生产环境。 ## 配置示例 ```YAML launch_types: cloud: region: cn-beijing # 区域 image_tag: "{{timestamp}}" # 镜像标签（支持模板变量） # TOS 对象存储配置 tos_bucket: Auto # 自动创建存储桶 # Container Registry 配置 cr_instance_name: Auto # CR 实例名（Auto = 自动创建） cr_namespace_name: agentkit # CR 命名空间 cr_repo_name: "" # CR 仓库名（空 = 使用 agent_name） # Runtime 配置 runtime_name: Auto # Runtime 名称 runtime_role_name: Auto # 授权角色名 runtime_apikey_name: Auto # API Key 密钥名 # 环境变量 runtime_envs: MODEL_AGENT_API_KEY: xxx # 模型 API Key MODEL_AGENT_NAME: ep-xxx # 模型接入点 ``` ## 模板变量 Cloud模式支持**模板变量**，在构建/部署时自动渲染： |**变量** |**说明** |**示例值** | |---|---|---| | |当前时间戳（YYYYMMDDHHmmss）。 |20251128153042 | | |火山引擎账号ID。 |2100123\*\*\*\* | **使用示例**： ```YAML image_tag: "{{timestamp}}" # 每次构建唯一 tag cr_instance_name: "agentkit-platform-{{account_id}}" # 账号隔离的 CR 实例 tos_bucket: "agentkit-platform-{{account_id}}" # 账号隔离的存储桶 ``` ## Auto关键字当配置值为`Auto`时，CLI会自动创建或管理对应资源： |**字段** |**Auto 行为** | |---|---| |`tos_bucket` |自动创建存储桶 `agentkit-platform-`。 | |`cr_instance_name` |自动创建 CR 实例 `agentkit-platform-`。 | |`runtime_name` |自动创建 Runtime。 | |`runtime_role_name` |自动创建授权角色。 | |`runtime_apikey_name` |自动创建 API Key 密钥。 | ## 配置项详解 |字段 |说明 |示例 | |---|---|---| |`region` |选择服务运行所在地域。 |cn\-beijing | |`image_tag` |镜像版本标签。| |\ | | |```YAML|\ | | | # 方式 1：使用时间戳（推荐，确保每次构建唯一）|\ | | |image_tag: "{{timestamp}}"|\ | | ||\ | | | # 方式 2：固定版本|\ | | |image_tag: v1.0.0|\ | | ||\ | | | # 方式 3：使用 latest（不推荐用于生产）|\ | | |image_tag: latest|\ | | |```|\ | | ||\ | | | | |`tos_bucket` |**对象存储桶，** 存储代码压缩包（用于云端构建）。默认自动创建（Auto）。| |\ | |```YAML|```YAML|\ | | # 自动创建（推荐）|tos_bucket: Auto|\ | |tos_bucket: Auto|```|\ | |||\ | | # 使用已有存储桶| |\ | |tos_bucket: my-existing-bucket| |\ | |```| |\ | || |\ | | | | |`cr_instance_name` |CR 实例名，默认自动创建（Auto）。| |\ | | |```YAML|\ | | | # 自动创建|\ | | |cr_instance_name: Auto|\ | | ||\ | | | # 使用已有实例|\ | | |cr_instance_name: my-existing-cr|\ | | |```|\ | | ||\ | | | | |`cr_namespace_name` |CR命名空间。默认`agentkit`。不存在时自动创建。 |agentkit | |`runtime_name`/ `runtime_role_name` / `runtime_apikey_name` |管理云端运行时实例及其认证 **，** 默认自动创建（Auto）。| |\ | | |```YAML|\ | | |runtime_name: Auto #Runtime名称|\ | | |runtime_role_name: Auto #IAM授权角色|\ | | |runtime_apikey_name: Auto #API Key密钥名|\ | | |```|\ | | ||\ | | | | ||Agent运行时的**策略级运行时环境变量。** 会与 `common.runtime_envs`合并。| |\ |#### `runtime_envs` ||```YAML|\ | |* 必须配置：|runtime_envs:|\ | | ```YAML| MODEL_AGENT_API_KEY: xxx # 火山方舟 API Key|\ | | runtime_envs:| MODEL_AGENT_NAME: ep-xxx # 火山方舟接入点 ID|\ | | MODEL_AGENT_API_KEY: xxx # 火山方舟 API Key|```|\ | | MODEL_AGENT_NAME: ep-xxx # 火山方舟接入点 ID||\ | | ```| |\ | | | |\ | |* 可选配置| |\ | | ```YAML| |\ | | runtime_envs:| |\ | | # 基础配置| |\ | | MODEL_AGENT_API_KEY: xxx| |\ | | MODEL_AGENT_NAME: ep-xxx| |\ | | | |\ | | # 可观测性（日志、监控、链路追踪）| |\ | | OBSERVABILITY_OPENTELEMETRY_APMPLUS_API_KEY: xxx| |\ | | OBSERVABILITY_OPENTELEMETRY_APMPLUS_ENDPOINT: http://apmplus-cn-beijing.volces.com:4317| |\ | | OBSERVABILITY_OPENTELEMETRY_APMPLUS_SERVICE_NAME: my_agent| |\ | | | |\ | | # 其他配置| |\ | | DEBUG: 'true' # 开启调试模式| |\ | | LOG_LEVEL: info # 设置日志级别| |\ | | ```| |\ | | | |\ | | | | ||设置云端构建的最大等待时间。默认3600（秒）。 |3600 |\ |#### `build_timeout` | | | ## 自动管理的字段以下字段由CLI自动生成和管理，**不需要手动配置。** ### **TOS 存储相关** |**字段** |**说明** | |---|---| |`tos_prefix` |对象存储前缀（默认`agentkit-builds`）。 | |`tos_region` |TOS服务区域。 | |`tos_object_key` |代码包的存储路径。 | |`tos_object_url` |代码包的访问地址。 | ### **Code Pipeline 构建相关** |**字段** |**说明** | |---|---| |`cp_workspace_name` |构建工作区名称。 | |`cp_pipeline_name` |构建流水线名称。 | |`cp_pipeline_id` |流水线ID。 | ### **镜像相关** |**字段** |**说明** | |---|---| |`cr_region` |镜像仓库区域。 | |`cr_image_full_url` |完整的镜像URL。 | ### **Runtime运行时相关** |**字段** |**说明** | |---|---| |`runtime_id` |Runtime实例ID。 | |`runtime_endpoint` |应用访问地址。 | |`runtime_apikey` |Runtime API密钥。 | |`build_timestamp` |构建时间。 | |`deploy_timestamp` |部署时间。 | ##

AgentKit