Skip to main content
此为预览文档，正式版本尚未发布。
Hosted 有三层配置：Host 的连接与容量、Runtime Profile 的 provider 参数、Agent 的职责与模型覆盖。先按Runtime Host 安装连接建立在线主机。

​
连接参数

示例只发现并暴露所选 provider；对应 CLI 必须已安装、登录并可执行。 默认配置在 ~/.agentscope/runtime-host/config.json。其中 controlPlane、tenant、namespace、pool、capacity、workspaceRoot、stateRoot 与 providers 描述连接；credential 是身份凭据，不复制进公共示例。修改已运行 Host 的设置前先检查活跃工作，更新后重启并再次 probe。

​
Agent 与 Profile 的分工

Agent 的 system 定义职责，model 提供可选模型覆盖。Model 非空时优先于 Profile 的 model；两者都为空时使用 provider 自己的默认配置。 runtimeProfileId 选择 provider 配置，runtimePoolId 选择可承载执行的主机池。通常在控制台选择发现的 Runtime 即可，管理员再维护 Profile 和池。只增加 Host capacity 不等于增加模型额度或消除 Agent/任务策略限制。

​
Provider 参数

以下是 Runtime Profile configuration 中的字段，不是 connect 参数，也不是所有 provider 通用的表单。 provider 的模型名、推理档位和账号可用性以本机安装版本为准。Profile 保存参数并不会替你安装模型、登录账号或授予外部工具权限。

​
定义与参数冲突

Host 将可移植指令、技能和支持的 MCP/工具定义转换为 provider 配置。若 Workspace 要求 provider 不支持的能力，执行前会拒绝；不要把能力错误当作“可以忽略的提示”。详细差异见支持的 provider。 自定义参数以 argv 项传递；工作目录、模型、输出协议、MCP 配置和权限相关的保留参数不能随意覆盖。配置 Codex 原生工具时使用 Profile sandbox/审批语义，不能直接复用 Managed 内置工具策略。