Skip to main content
此为预览文档，正式版本尚未发布。
Managed Agent 的配置分为 Agent 定义、会话资源和 Dataplane 部署配置。先完成创建与首次对话，再按本页调整参数。

​
Agent 定义参数

下表使用 API 字段名。控制台在 Behavior、Workspace 和 Runtime/资源设置中编辑这些字段；创建页的 Advanced settings 可以选择环境。 保存时保留版本检查；配置冲突后重新加载再修改。Agent key 是目录中的稳定身份，不通过改显示名称来迁移身份。

​
默认模型与显式模型

标准 Dataplane 配置包含 DashScope 模型扩展。管理员在 Dataplane 进程/容器 中提供 DASHSCOPE_API_KEY；BUILDER_MODEL_NAME 选择默认模型，部署配置的默认值是 qwen-max。修改部署环境变量后需要重启相应服务。 当 Agent 的 Model 留空时使用这个默认 Model。显式填写 dashscope:qwen-max 时，通过模型注册表加载 DashScope provider，并读取它的凭据。不要把 Hosted provider 的账号配置当作 Managed 模型凭据。
这是定义字段片段，不是完整创建请求。扩展模型的条件见支持的能力与接入类型。仅把 Model 改成另一个厂商的名称，不能给部署安装缺失的扩展或配置凭据。

​
会话资源如何选择

普通 Chat 和 Issue 使用 Agent 的资源设置。通过 Managed Session API 创建会话时，也可以指定 environmentId、memoryStoreIds 和 vaultIds。省略资源列表与显式传入空列表的含义不同：省略使用默认绑定，空列表表示不挂载该类默认资源。
此片段应放入所用 Session API 的请求中，并补全该接口的 Agent 等必填参数。资源必须在当前身份可用的范围内。对话、知识与凭据都在建立运行上下文时解析；保存定义之后用新 Chat 或 Issue 检查结果。

​
一次调整一个层次

  1. Model 留空完成第一轮问答，验证部署默认模型。
  2. 调整 Instructions 和 maxIters，验证职责与迭代边界。
  3. 绑定 Workspace 和 Environment，验证文件工具。
  4. 再绑定 Memory 与 Vault，分别验证知识读取和工具认证。
遇到 model cannot resolve 一类错误，检查 Model 标识和部署扩展；401/403 检查相应 provider 的认证；等待 Worker 应检查 Environment，不要通过增加迭代次数处理连接故障。