runtime 命令组用于管理 AgentKit 运行时,涵盖列表、详情查看、日志获取、版本历史、发布、更新与删除等操作。
先使用具备运行时管理权限的账号登录。运行时按云厂商和区域隔离;示例名称应替换为 runtime list 返回的实际名称,自动化中优先保存并使用运行时 ID。BytePlus 查询示例:
--json 在查询命令中表示输出 JSON,在 runtime update 中则接受请求体 JSON,二者不可混用
runtime list
列出所有运行时。
runtime show
查看运行时的详情,可选择指定某个版本。
使用 --json 查看当前运行时时,如果该运行时绑定了 Tool,输出会包含 toolId。
删除运行时会停止该服务,现有调用方将无法继续使用它。先检查绑定资源和调用方,确认名称、ID 与区域;--yes 会跳过确认
runtime delete
删除运行时。
runtime logs
查看运行时实例的日志。
runtime attach
进入运行时某个运行中实例的交互式终端,与控制台的实例终端一致。按 Ctrl-] 脱离,脱离后实例继续运行。当运行时已缩容至零、没有实例时,会先自动拉起一个实例再接入;使用 custom_jwt 鉴权的运行时无法在缺少 token 时自动拉起,请先 agentkit invoke run 一次。
runtime versions
列出运行时的版本历史。
runtime release 与 runtime update --auto-release 会改变线上运行版本,调整计算资源也可能改变费用。--no-wait 只表示请求已提交,不表示新版本已就绪
runtime release
发布运行时版本,使其正式上线。
runtime update
更新运行时的配置。除非传入 --auto-release,否则不会发布新版本。
网关信息与变更限制
runtime list 显示网关信息,runtime show 显示网关模式、实例 ID 与名称。可按网关筛选运行时
网关模式、网关实例与网络配置只能在创建时设置。runtime update --json 不允许修改这些字段;需要不同网关时,应使用新的运行时名称创建,并迁移调用方
检查发布结果
先用 runtime versions 确认版本号,再用 runtime show 检查当前状态。实例未就绪时使用 runtime logs 排查启动失败;日志可能包含用户请求和业务数据,应按项目的数据要求处理
runtime attach 中的命令直接作用于运行实例,修改不会自动回写本地项目或构建镜像。需要持续生效的修改应从项目重新构建与发布