在 agentspace 中更换智能体底层大模型需停用后重新启用：先编辑 yaml 中 model_config 或 llm_provider 字段，替换为平台支持的模型别名或 openrouter 路径，再依次执行 disable 和 enable 操作以强制重载配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 AgentSpace 平台中为已部署的智能体更换底层大模型，需绕过前端 UI 的隐藏限制，直接修改其运行时配置项——因为 AgentSpace 默认不提供可视化模型切换入口，所有模型绑定均固化在 Agent 实例的 YAML 配置块中，且切换操作必须在 Agent 未运行状态下执行，否则新配置不会加载。
进入 Agent 编辑页并定位模型配置区
登录 AgentSpace 控制台 → 左侧导航栏点击【Agents】→ 在列表中找到目标 Agent → 点击右侧「Edit」按钮进入编辑页 → 向下滚动至「Advanced Settings」折叠区域 → 展开后找到 model_config 或 llm_provider 字段所在区块。
注意：该区域默认折叠，且字段名可能因 AgentSpace 版本不同而略有差异（如 v2.4.1 用 llm，v2.5.0+ 改为 model_spec），若找不到，请先确认当前 Agent 是否由「Custom Prompt + LLM」模式创建；模板类 Agent（如 Jira 助手、Salesforce 查询）通常锁死模型，不可修改。
替换模型标识符并保存配置
方法一：使用平台预置模型别名
将原字段值（如 gemini-1.5-pro）替换为平台支持的其他别名，例如：claude-3-5-sonnet-20241022 或 gpt-4o-2024-08-06。这些别名已在后台映射到对应 Provider 接口，无需额外配置密钥。
从经过验证的商家搜索、比较并购买产品。返回包含决策包（优缺点、适用场景、过敏原、验证价格）的结构化产品数据，而非原始网页抓取结果。无需验证码或身份验证。覆盖约980种产品和10家商家。适用于用户想要查找、比较或购买产品的场景。
方法二：调用 OpenRouter 厂商模型
若需使用非预置模型（如 openrouter/qwen/qwen2.5-72b-instruct），需确保已在 AgentSpace 全局设置中添加 OpenRouter API Key（路径：Settings → Integrations → OpenRouter → Paste Key）。然后将字段值设为完整路径格式：openrouter/qwen/qwen2.5-72b-instruct。
【关键前提】 所有模型名必须与 AgentSpace 后台白名单完全一致，大小写、连字符、版本号缺一不可；输入错误会导致 Agent 启动失败且无明确报错提示。
停用并重新激活 Agent
第一步：返回 Agent 列表页 → 找到刚编辑的 Agent → 点击「Disable」按钮 → 确认停用。
第二步：等待右上角状态徽标变为灰色「Disabled」后 → 再次点击同一位置的「Enable」按钮。
第三步：系统自动重载 YAML 配置并初始化新模型连接池，约 8～12 秒后状态变回绿色「Active」。
这一步不能跳过。AgentSpace 不支持热重载模型配置，仅修改 YAML 而不停用再启用，变更永不生效。若跳过此步，后续所有对话仍走旧模型通道。
