Agent绑定模型需在UI中指定，否则无法启动；须先在Model Registry注册模型，再从下拉列表选择；支持动态切换但清空历史上下文；多版本需通过Advanced Settings中model_id精确锁定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
AgentSpace中为Agent绑定指定模型
在AgentSpace UI中配置Agent时，必须明确指定其运行所依赖的模型，否则Agent将无法启动推理流程，系统会提示“未选择模型”并禁用保存按钮。
第一步：进入Agent编辑页后，在右侧配置面板找到【Model Configuration】区域。
第二步：点击下拉菜单，默认显示“Google Gemini 2.0 Pro”，但该选项仅适用于已授权接入Google AI Studio的企业账号；若你使用的是自托管模型或第三方API，需先在AgentSpace后台的Model Registry中完成注册并成功验证连通性，否则该模型不会出现在下拉列表中。
第三步：从下拉列表中选择目标模型，例如“Claude-3.5-Sonnet-20240620”或“Qwen2.5-72B-Instruct”。注意：部分模型名称后缀带“-restricted”标识，表示该模型已启用企业级内容过滤策略，仅对通过RBAC权限校验的请求放行。
切换已有Agent的模型（不重建）
已上线的Agent支持动态更换模型，无需删除重配，但切换后所有历史对话上下文将被清空，因为不同模型的tokenization方式与system prompt解析逻辑存在差异，继续复用旧记忆可能导致幻觉加剧。
方法一：在AgentSpace主界面的“All Agents”列表中，找到目标Agent右侧的⋯按钮→点击“Edit”→滚动至底部点击“Change Model”→从弹窗中选取新模型→确认替换。
方法二：直接在Agent聊天窗口右上角点击齿轮图标→选择“Switch Model”→输入管理员密码二次验证→完成切换。此操作要求当前登录账号具备“Model Admin”角色权限，普通开发者账号无权执行。
强制指定模型版本（精确控制）
当同一模型存在多个部署实例（如v1/v2/v3）且行为差异显著时，必须通过API参数锁定版本，UI下拉菜单仅支持选择模型名称，不暴露版本号字段。
在Agent配置页的Advanced Settings区域，勾选“Enable Custom Model Parameters”，展开后填入JSON格式参数：
{"model_id": "us-central1/claude-3-5-sonnet@20240620", "temperature": 0.3, "max_output_tokens": 4096}
其中model_id字段值必须与Model Registry中注册的完整ID完全一致，大小写、斜杠、@符号均不可省略或更改，否则调用时返回HTTP 404错误。
