vrr/agent-zero
2
0
Fork 0
mirror of https://github.com/agent0ai/agent-zero.git synced 2026-04-28 11:40:47 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2
agent-zero/plugins/_model_config
History
Alessandro 1304195d4c ux: onboarding flow prototype 
reuse /banners for composer missing-key status

polish onboarding ui; add chat composer API key banner

drop dedicated status backend endpoint
2026-03-27 18:46:09 +01:00
..
api Refactor API key handling and update system improvements 2026-03-24 14:41:46 +01:00
extensions ux: onboarding flow prototype 2026-03-27 18:46:09 +01:00
helpers model_config: decouple browser agent model wiring 2026-03-24 18:09:48 +01:00
webui Add force refresh support and state management improvements to plugin installer and model config 2026-03-26 17:24:32 +01:00
default_config.yaml Update default_config.yaml 2026-03-24 19:28:32 +01:00
default_presets.yaml Refactor default presets, fix chardet version conflict, improve welcome banner refresh logic 2026-03-24 19:17:12 +01:00
hooks.py Refactor API key handling and update system improvements 2026-03-24 14:41:46 +01:00
plugin.yaml feat: add _model_config plugin with call-time model resolution 2026-03-14 09:41:19 -07:00
README.md model_config: decouple browser agent model wiring 2026-03-24 18:09:48 +01:00

README.md

Model Configuration

Manage which models Agent Zero uses for chat, utility, and embeddings, with support for scoped overrides and reusable presets.

What It Does

This plugin centralizes model selection and model-related settings for the application. It provides helpers and APIs for:

  • selecting chat, utility, and embedding models
  • reading and saving model presets
  • checking for missing API keys
  • allowing optional per-chat model overrides
  • resolving config at global, project, agent, and chat scope

Main Behavior

  • Scoped configuration
    • Reads plugin config through the standard plugin config system with project and agent overrides.
  • Preset management
    • Loads presets from a user file when present and falls back to bundled defaults.
  • Per-chat override
    • Allows a chat context to store a temporary override or preset reference in context data.
  • Model object construction
    • Builds ModelConfig objects and the runtime chat, utility, and embedding wrappers used elsewhere in the app.
    • Note: Browser model wiring now lives in the _browser_agent plugin.
  • API key validation
    • Reports configured providers that still require API keys.

Key Files

  • Core helper
    • helpers/model_config.py resolves config, presets, overrides, and runtime model objects.
  • APIs
    • api/model_config_get.py
    • api/model_config_set.py
    • api/model_override.py
    • api/model_presets.py
    • api/model_search.py
    • api/api_keys.py
  • Hooks
    • hooks.py exposes plugin-level integration hooks.

Configuration Scope

  • Settings section: agent
  • Per-project config: true
  • Per-agent config: true
  • Always enabled: true

Plugin Metadata

  • Name: _model_config
  • Title: Model Configuration
  • Description: Manages LLM model selection and configuration for chat, utility, and embedding models. Supports per-project and per-agent overrides with optional per-chat model switching.