vrr/agent-zero
2
0
Fork 0
mirror of https://github.com/agent0ai/agent-zero.git synced 2026-07-10 01:18:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
agent-zero/plugins/_model_config/AGENTS.md
Alessandro 04ecaac0cd Add deferred first-send model gate 
Move missing-model setup out of the welcome screen and into an in-thread gate that preserves the pending prompt, survives refresh, and auto-dispatches after a usable model is configured.

Reuse existing onboarding, OAuth account settings, and advanced model configuration surfaces instead of duplicating provider forms. Connected OAuth accounts can now populate Main and Utility defaults when no chat model is configured.

Update model readiness checks, focused static regressions, and DOX contracts for the new deferred setup flow.
2026-07-02 17:29:40 +02:00

1.8 KiB
Raw Permalink Blame History

Model Configuration Plugin DOX

Purpose

  • Own LLM model selection, presets, API-key checks, scoped overrides, and model settings UI.

Ownership

  • helpers/model_config.py owns config resolution, presets, overrides, and runtime model object construction.
  • api/ owns model config, override, preset, search, and API-key endpoints.
  • webui/ owns model settings, summaries, switcher, and API-key UI.
  • default_config.yaml, default_presets.yaml, provider_metadata.yaml, hooks.py, and plugin.yaml own defaults, metadata, hooks, and manifest.

Local Contracts

  • Preserve global, project, agent, and chat override resolution order.
  • Project Settings llm payloads are owned here through the generic helpers.projects project extension-data hooks; keep project helper code agnostic to _model_config paths, presets, and inheritance rules.
  • Keep provider metadata and API-key checks safe around secrets.
  • Coordinate OAuth-backed providers with _oauth instead of hardcoding provider-specific auth here.
  • model_config_get exposes model_configured as a derived chat-model readiness flag from provider, model name, and API-key availability.
  • Applying a model preset may inherit durable tuning such as context windows and rate limits, but must replace or clear per-slot kwargs so provider-specific extra params never leak across model providers.
  • Repair provider-specific model-config aliases at the model-config read/build boundary; keep provider-specific repairs out of provider-agnostic core wrappers such as models.py.

Work Guidance

  • Keep backend model config shape and frontend settings fields synchronized.

Verification

  • Run model-config and onboarding-related tests when model provider, preset, or API-key behavior changes.

Child DOX Index

No child DOX files.