Skip to content

Agent Zero AI framework

feat: add per-chat model switcher with preset selection

keyboardstaffdd1b84579f6a
diff --git a/plugins/_model_config/api/model_override.py b/plugins/_model_config/api/model_override.py
new file mode 100644
index 000000000..82960496c
--- /dev/null
+++ b/plugins/_model_config/api/model_override.py
@@ -0,0 +1,49 @@
+from helpers.api import ApiHandler, Request, Response
+from helpers.persist_chat import save_tmp_chat
+from agent import AgentContext
+from plugins._model_config.helpers import model_config
+
+
+class ModelOverride(ApiHandler):
+ async def process(self, input: dict, request: Request) -> dict | Response:
+ context_id = input.get("context_id", "")
+ action = input.get("action", "get") # get | set | set_preset | clear
+
+ if not context_id:
+ return Response(status=400, response="Missing context_id")
+
+ ctx = AgentContext.get(context_id)
+ if not ctx:
+ return Response(status=404, response="Context not found")
+
+ if action == "get":
+ override = ctx.get_data("chat_model_override")
+ return {"override": override}
+
+ elif action == "set":
+ override_config = input.get("override")
+ if not override_config or not isinstance(override_config, dict):
+ return Response(status=400, response="Missing or invalid override config")
+ ctx.set_data("chat_model_override", override_config)
+ save_tmp_chat(ctx)
+ return {"ok": True, "override": override_config}
+
+ elif action == "set_preset":
+ preset_name = input.get("preset_name", "")
+ if not preset_name:
+ return Response(status=400, response="Missing preset_name")
+ # Verify preset exists
+ preset = model_config.get_preset_by_name(preset_name)
+ if not preset:
+ return Response(status=404, response=f"Preset '{preset_name}' not found")
+ # Store as a preset reference
+ ctx.set_data("chat_model_override", {"preset_name": preset_name})
+ save_tmp_chat(ctx)
+ return {"ok": True, "preset_name": preset_name}
+
+ elif action == "clear":
+ ctx.set_data("chat_model_override", None)
+ save_tmp_chat(ctx)
+ return {"ok": True, "override": None}
+
+ return Response(status=400, response=f"Unknown action: {action}")
diff --git a/plugins/_model_config/extensions/webui/chat-input-start/model-switcher.html b/plugins/_model_config/extensions/webui/chat-input-start/model-switcher.html
new file mode 100644
index 000000000..7d5bc239f
--- /dev/null
+++ b/plugins/_model_config/extensions/webui/chat-input-start/model-switcher.html
@@ -0,0 +1,203 @@
+<!-- Model Switcher - Floating Preset Selector -->
+<div x-data="{
+ allowed: false,
+ override: null,
+ loading: true,
+ showDropdown: false,
+ presets: [],
+ _fns: null,
+
+ async init() {
+ this._fns = await import('/plugins/_model_config/webui/model-switcher.js');
+ await this.refresh();
+ this.$watch('$store.chats.selected', () => this.refresh());
+ },
+
+ async refresh() {
+ this.loading = true;
+ try {
+ const contextId = this.$store.chats?.selected || '';
+ const state = await this._fns.loadSwitcherState(contextId);
+ this.allowed = state.allowed;
+ this.presets = state.presets;
+ this.override = state.override;
+ } catch (e) {
+ console.error('Model switcher refresh failed:', e);
+ } finally {
+ this.loading = false;
+ }
+ },
+
+ get currentLabel() {
+ if (!this.override) return 'Default';
+ if (this.override.preset_name) return this.override.preset_name;
+ const p = this.override.provider || '';
+ const n = this.override.name || '';
+ return n || p || 'Custom';
+ },
+
+ get hasOverride() {
+ return !!this.override;
+ },
+
+ async selectPreset(presetName) {
+ const contextId = this.$store.chats?.selected || '';
+ if (!contextId) return;
+ const ok = await this._fns.setPresetOverride(contextId, presetName);
+ if (ok) {
+ this.override = { preset_name: presetName };
+ justToast('Switched to ' + presetName, 'success');
+ }
+ this.showDropdown = false;
+ },
+
+ async clearOverride() {
+ const contextId = this.$store.chats?.selected || '';
+ if (!contextId) return;
+ const ok = await this._fns.clearOverride(contextId);
+ if (ok) {
+ this.override = null;
+ justToast('Reverted to default model', 'info');
+ }
+ this.showDropdown = false;
+ }
+}">
+ <template x-if="allowed && !loading">
+ <div class="model-switcher-container">
+ <div class="model-switcher-anchor">
+ <button class="model-switcher-btn"
+ :class="{ 'has-override': hasOverride }"
+ @click="showDropdown = !showDropdown"
+ @click.outside="showDropdown = false">
+ <span class="material-symbols-outlined" style="font-size: 15px;">swap_horiz</span>
+ <span class="model-switcher-label" x-text="currentLabel"></span>
+ <span class="material-symbols-outlined" style="font-size: 14px;"
+ x-text="showDropdown ? 'expand_less' : 'expand_more'"></span>
+ </button>
+
+ <div class="model-switcher-dropdown" x-show="showDropdown" x-transition.opacity>
+ <!-- Use Default -->
+ <template x-if="hasOverride">
+ <div class="model-switcher-item revert" @click="clearOverride()">
+ <span class="material-symbols-outlined" style="font-size: 15px;">undo</span>
+ <span>Use Default</span>
+ </div>
+ </template>
+ <div class="model-switcher-divider" x-show="hasOverride"></div>
+
+ <!-- No presets message -->
+ <template x-if="presets.length === 0">
+ <div class="model-switcher-item disabled">No presets configured</div>
+ </template>
+
+ <!-- Preset list -->
+ <template x-for="preset in presets" :key="preset.name">
+ <div class="model-switcher-item"
+ :class="{ 'active': override?.preset_name === preset.name }"
+ @click="selectPreset(preset.name)">
+ <div class="model-switcher-preset-name" x-text="preset.name"></div>
+ <div class="model-switcher-preset-detail"
+ x-text="_fns.getPresetSummary(preset)"></div>
+ </div>
+ </template>
+ </div>
+ </div>
+ </div>
+ </template>
+</div>
+
+<style>
+ .model-switcher-container {
+ position: absolute;
+ bottom: calc(100% + 50px);
+ right: 16px;
+ z-index: 10;
+ pointer-events: auto;
+ }
+ .model-switcher-anchor {
+ position: relative;
+ }
+ .model-switcher-btn {
+ display: inline-flex;
+ align-items: center;
+ gap: 4px;
+ padding: 3px 10px;
+ border: 1px solid var(--color-border);
+ border-radius: 16px;
+ background: var(--color-panel);
+ color: var(--color-text-secondary, #999);
+ font-size: 0.75rem;
+ cursor: pointer;
+ transition: all 0.15s ease;
+ white-space: nowrap;
+ box-shadow: 0 1px 6px rgba(0, 0, 0, 0.25);
+ }
+ .model-switcher-btn:hover {
+ border-color: var(--color-border);
+ color: var(--color-text-secondary, #666);
+ }
+ .model-switcher-btn.has-override {
+ border-color: var(--color-accent, #4a9eff);
+ color: var(--color-accent, #4a9eff);
+ }
+ .model-switcher-label {
+ max-width: 160px;
+ overflow: hidden;
+ text-overflow: ellipsis;
+ }
+ .model-switcher-dropdown {
+ position: absolute;
+ bottom: calc(100% + 6px);
+ right: 0;
+ min-width: 250px;
+ max-height: 550px;
+ overflow-y: auto;
+ background-color: var(--color-panel);
+ border: 1px solid var(--color-border);
+ border-radius: 8px;
+ padding: 6px;
+ box-shadow: 0 4px 16px rgba(0, 0, 0, 0.1);
+ z-index: 100;
+ }
+ .model-switcher-item {
+ padding: 6px 10px;
+ border-radius: 6px;
+ cursor: pointer;
+ font-size: 0.8rem;
+ transition: background 0.1s ease;
+ }
+ .model-switcher-item:hover {
+ background: var(--color-background-hover, rgba(255,255,255,0.06));
+ }
+ .model-switcher-item.active {
+ background: var(--color-accent-bg, rgba(74, 158, 255, 0.12));
+ color: var(--color-accent, #4a9eff);
+ }
+ .model-switcher-item.revert {
+ display: flex;
+ align-items: center;
+ gap: 6px;
+ opacity: 0.8;
+ }
+ .model-switcher-item.disabled {
+ opacity: 0.4;
+ cursor: default;
+ font-style: italic;
+ }
+ .model-switcher-item.disabled:hover {
+ background: transparent;
+ }
+ .model-switcher-divider {
+ border-top: 1px solid var(--color-border);
+ margin: 4px 0;
+ opacity: 0.3;
+ }
+ .model-switcher-preset-name {
+ font-weight: 500;
+ }
+ .model-switcher-preset-detail {
+ font-size: 0.7rem;
+ opacity: 0.6;
+ margin-top: 1px;
+ }
+</style>
diff --git a/plugins/_model_config/webui/model-switcher.js b/plugins/_model_config/webui/model-switcher.js
new file mode 100644
index 000000000..f5a4ce445
--- /dev/null
+++ b/plugins/_model_config/webui/model-switcher.js
@@ -0,0 +1,87 @@
+const API_BASE = "/plugins/_model_config";
+
+export async function loadSwitcherState(contextId) {
+ const result = {
+ allowed: false,
+ presets: [],
+ chatProviders: [],
+ override: null,
+ };
+
+ try {
+ const cfgRes = await fetchApi(`${API_BASE}/model_config_get`, {
+ method: "POST",
+ headers: { "Content-Type": "application/json" },
+ body: JSON.stringify({}),
+ });
+ const cfgData = await cfgRes.json();
+ const chatCfg = cfgData.config?.chat_model || {};
+
+ result.allowed = !!chatCfg.allow_chat_override;
+ result.chatProviders = cfgData.chat_providers || [];
+ result.presets = cfgData.config?.model_presets || [];
+
+ if (!result.allowed) return result;
+
+ // Fetch current override status
+ if (contextId) {
+ const overRes = await fetchApi(`${API_BASE}/model_override`, {
+ method: "POST",
+ headers: { "Content-Type": "application/json" },
+ body: JSON.stringify({ action: "get", context_id: contextId }),
+ });
+ const overData = await overRes.json();
+ result.override = overData.override || null;
+ }
+ } catch (e) {
+ console.error("Model switcher load failed:", e);
+ }
+
+ return result;
+}
+
+export async function setPresetOverride(contextId, presetName) {
+ try {
+ const res = await fetchApi(`${API_BASE}/model_override`, {
+ method: "POST",
+ headers: { "Content-Type": "application/json" },
+ body: JSON.stringify({
+ action: "set_preset",
+ context_id: contextId,
+ preset_name: presetName,
+ }),
+ });
+ const data = await res.json();
+ return !!data.ok;
+ } catch (e) {
+ console.error("Failed to set preset override:", e);
+ return false;
+ }
+}
+
+export async function clearOverride(contextId) {
+ try {
+ const res = await fetchApi(`${API_BASE}/model_override`, {
+ method: "POST",
+ headers: { "Content-Type": "application/json" },
+ body: JSON.stringify({ action: "clear", context_id: contextId }),
+ });
+ const data = await res.json();
+ return !!data.ok;
+ } catch (e) {
+ console.error("Failed to clear override:", e);
+ return false;
+ }
+}
+
+export function getPresetLabel(preset) {
+ return preset?.name || "Unnamed";
+}
+
+export function getPresetSummary(preset) {
+ if (!preset) return "";
+ const parts = [];
+ if (preset.chat?.name) parts.push(preset.chat.name);
+ if (preset.utility?.name) parts.push(preset.utility.name);
+ return parts.join(" / ");
+}