docs: document AI providers seeding mechanism & support for new types (#25855)

Browse Source

Adds a new **Provider Configuration** reference page (`providers.md`) covering:

- The migration from environment-variable-based provider config to database-backed management introduced in v2.34, including the one-time seeding behavior and deprecation of `CODER_AI_GATEWAY_PROVIDER_<N>_*` and related flags
- All supported provider types (`openai`, `anthropic`, `bedrock`, `copilot`, `azure`, `google`, `openrouter`, `vercel`, `openai-compat`) with setup notes for each
- Provider lifecycle statuses (`enabled`, `disabled`, `error`) and their effect on request handling
- Reload behavior and how configuration changes apply without restarting `coderd`
- Bring Your Own Key (BYOK) and failure mode reference table

Updates **Setup** (`setup.md`) to replace the environment-variable-based provider configuration instructions with dashboard-driven steps (Add provider form, provider list, edit/disable flow), referencing the new `providers.md` page for deeper detail. Screenshots of the provider list, add, and edit forms are included.

Adds a **Provider metrics** section to **Monitoring** (`monitoring.md`) documenting the `coder_aibridged_*` and `coder_aibridgeproxyd_*` Prometheus metrics for provider status and reload timestamps, along with two suggested PromQL alert queries.

...

This commit is contained in:

Danny Kopping

2026-06-01 15:33:37 +02:00

committed by GitHub

parent d0fa9ff986

commit f9937a8931

7 changed files with 260 additions and 216 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download Patch File Download Diff File Expand all files Collapse all files

docs/images/aibridge/provider-add-anthropic.png

BIN

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 58 KiB

docs/images/aibridge/provider-edit-anthropic.png

BIN

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 62 KiB

docs/images/aibridge/providers-list.png

BIN

Binary file not shown.

Side by Side After Width:  |  Height:  |  Size: 80 KiB