docs: refine model config decisions
This commit is contained in:
@@ -12,6 +12,8 @@ Goals
|
|||||||
- Model selection via `/model` with sensible fallback
|
- Model selection via `/model` with sensible fallback
|
||||||
- Global (not per-session) fallback logic
|
- Global (not per-session) fallback logic
|
||||||
- Keep last-known-good auth profile when switching models
|
- Keep last-known-good auth profile when switching models
|
||||||
|
- Profile override only when explicitly requested
|
||||||
|
- Image routing override only when explicitly configured
|
||||||
|
|
||||||
Non-goals (v1)
|
Non-goals (v1)
|
||||||
- Auto-discovery of provider capabilities beyond catalog input tags
|
- Auto-discovery of provider capabilities beyond catalog input tags
|
||||||
@@ -77,7 +79,7 @@ Login
|
|||||||
Model selection
|
Model selection
|
||||||
- `/model Opus` → resolve alias to full id.
|
- `/model Opus` → resolve alias to full id.
|
||||||
- `/model anthropic/claude-opus-4-5` → explicit.
|
- `/model anthropic/claude-opus-4-5` → explicit.
|
||||||
- Optional: `/model Opus@anthropic:work` (pin auth profile for session override).
|
- Optional: `/model Opus@anthropic:work` (explicit profile override for session only).
|
||||||
|
|
||||||
Model listing
|
Model listing
|
||||||
- `/model` list shows:
|
- `/model` list shows:
|
||||||
@@ -109,8 +111,8 @@ Model not found / capability mismatch
|
|||||||
## Image routing
|
## Image routing
|
||||||
|
|
||||||
Rule
|
Rule
|
||||||
- If current text model supports image input, use it.
|
- Only use `agent.imageModel` when explicitly configured.
|
||||||
- Else use `agent.imageModel` (primary then fallbacks).
|
- If `agent.imageModel` is configured and the current text model lacks image input, use it.
|
||||||
|
|
||||||
Support detection
|
Support detection
|
||||||
- From model catalog `input` tags when available (e.g. `image` in models.json).
|
- From model catalog `input` tags when available (e.g. `image` in models.json).
|
||||||
@@ -143,11 +145,10 @@ Auto-run
|
|||||||
- Alternative: allow `agent.models[...].authOrder` override.
|
- Alternative: allow `agent.models[...].authOrder` override.
|
||||||
|
|
||||||
2) /model auth pinning
|
2) /model auth pinning
|
||||||
- Do we support `/model Opus@profile`? If not, keep purely automatic rotation.
|
- Keep `/model Opus@profile` for explicit session override only.
|
||||||
|
|
||||||
3) Image routing
|
3) Image routing
|
||||||
- If model catalog lacks input tags, should we require explicit `agent.imageModel` or probe at runtime?
|
- Only apply image routing override when `agent.imageModel` is explicitly configured.
|
||||||
|
|
||||||
4) Legacy compatibility
|
4) Legacy compatibility
|
||||||
- Keep reading old keys if migration fails, or hard-break?
|
- Keep reading old keys if migration fails, or hard-break?
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user