mirror of
https://github.com/coder/coder.git
synced 2026-09-22 05:05:20 +08:00
Matt Vollmer
506fba9ebf
Fixes several documentation gaps and inaccuracies in the Coder Agents docs identified during a deep review against the current product state. ## BYOK (User API Keys) `models.md` stated *"Developers cannot add their own providers, models, or API keys"* — this has been incorrect since the provider key policy system shipped (Apr 2, #23751/#23781). - Added **Key policy** section documenting the three admin toggles (`central_api_key_enabled`, `allow_user_api_key`, `allow_central_api_key_fallback`) with a truth table showing all resolution outcomes - Added **User API keys (BYOK)** section covering the developer-facing key management page, status indicators, selection priority, and key removal - Updated `platform-controls/index.md` to reference BYOK instead of claiming keys are admin-only ## Reasoning effort enum fixes - **OpenAI**: removed `none` — code accepts `minimal, low, medium, high, xhigh` - **OpenRouter**: narrowed to `low, medium, high` per `ReasoningEffortFromChat` in `chatprovider.go` ## Tool table completeness - Added `spawn_computer_use_agent`, `read_skill`, `read_skill_file` to `index.md` tool table - Added "Workspace extension tools" section to `architecture.md` for `read_skill`/`read_skill_file` - Fixed orchestration restriction note to list all 5 gated tools instead of just `spawn_agent` - Added conditional availability notes for desktop and skills tools ## Platform controls Three admin-only settings existed in the Behavior tab with no documentation: - **Virtual desktop** — admin toggle, Anthropic + portabledesktop requirements - **Workspace autostop fallback** — default TTL for agent workspaces without template-defined autostop - **Data retention** — moved `chat-retention.md` into `platform-controls/` since it's admin-only, fixed nav path --- > PR generated with Coder Agents