SBOM pipeline docs (#523)

* Add pipeline setup docs for addon compatibility upgrade processes

This hopefully should make that more clear, we should also just make it the default setup from `plural up`

* bring back png

* Add docs for multi-model configuration

This is currently not covered, this will help people understand the tunability of our ai config

Author: michaeljguarino

generated/routes.json

@@ -149,7 +149,7 @@
   },
   "/plural-features/k8s-upgrade-assistant/addon-compatibilities": {
     "relPath": "/plural-features/k8s-upgrade-assistant/addon-compatibilities.md",
-    "lastmod": "2025-03-23T01:07:28.000Z"
+    "lastmod": "2025-08-15T02:39:28.000Z"
   },
   "/plural-features/k8s-upgrade-assistant/cluster-drain": {
     "relPath": "/plural-features/k8s-upgrade-assistant/cluster-drain.md",
@@ -223,6 +223,10 @@
     "relPath": "/plural-features/plural-ai/cost.md",
     "lastmod": "2025-03-12T14:59:41.000Z"
   },
+  "/plural-features/plural-ai/multi-model-configuration": {
+    "relPath": "/plural-features/plural-ai/multi-model-configuration.md",
+    "lastmod": "2025-10-14T19:52:44.000Z"
+  },
   "/plural-features/flows": {
     "relPath": "/plural-features/flows/index.md",
     "lastmod": "2025-05-11T23:04:59.000Z"
@@ -373,11 +377,11 @@
   },
   "/resources/architecture": {
     "relPath": "/resources/architecture.md",
-    "lastmod": "2025-08-11T16:06:36.000Z"
+    "lastmod": "2025-08-11T16:38:17.000Z"
   },
   "/resources/architecture/gitops-architecture": {
     "relPath": "/resources/architecture/gitops-architecture.md",
-    "lastmod": "2025-08-11T16:06:36.000Z"
+    "lastmod": "2025-08-11T16:38:17.000Z"
   },
   "/getting-started/agent-api-reference": {
     "relPath": "/overview/agent-api-reference.md",

pages/plural-features/plural-ai/multi-model-configuration.md

@@ -0,0 +1,86 @@
+---
+title: Configure Against Multiple Providers
+description: How to mix and match models to optimize cost and performance
+---
+
+The current state of GenerativeAI is a sprawl of vendors offering products with different specialties and price points, and its common to have an optimal AI setup involve usage of models across multiple different vendors or multiple models within the same vendor.  Plural provides a number of knobs that are designed to make that degree of customization seamless, and compatible w/in a GitOps workflow.
+
+## Provider Selection within Plural AI
+
+There are three main usecases where we can differentiate models:
+
+1. High-volume insight inference - usually a smaller, cheaper model is the right choice here (gpt-4.1-mini for instance)
+2. On-demand agentic, tool-calling - this is used in Plural AI chat, pr generation, and similar features within the platform.  Here a user very likely will want to use a capable model like Anthropic Claude Sonnet 4.5.
+3. Embedding - Plural also consistently vector embeds your infra data derived from GitOps and data scraping.  Its possible you'll need to configure a dedicated embedding model provider if the base provider doesn't support it.
+
+Often toggling these individual can give you the best cost/feature tradeoff for your usecase.
+
+## Example Configuration
+
+To tune your AI configuration, the recommended approach is to do it within a GitOps workflow using our `DeploymentSettings` Kubernetes CRD.  If you set up Plural with `plural up`, this will already be defined for you at `bootstrap/settings.yaml`.  Here's a basically complete example of how to configure its AI model settings:
+
+
+```yaml
+apiVersion: deployments.plural.sh/v1alpha1
+kind: DeploymentSettings
+metadata:
+  name: global
+  namespace: plrl-deploy-operator # this namespace is required
+spec:
+  ai:
+    enabled: true
+    provider: OPENAI # OPENAI gpt-4.1-mini for low-cost, high-volume
+    embeddingProvider: OPENAI # openai has an embedding model built-in
+    toolProvider: ANTHROPIC # anthropic for complex tool calling
+
+    # example configurations of the various different AI providers supported, its not necessary to
+    # configure all of them
+    anthropic:
+      model: claude-sonnet-4-5
+      tokenSecretRef:
+        name: ai-config
+        key: anthropic
+
+    openAI:
+      tokenSecretRef:
+        name: ai-config
+        key: openai
+      model: gpt-4.1-mini
+      toolModel: gpt-4.1
+    
+    azure: 
+      tokenSecretRef:
+        name: ai-config
+        key: azure
+      endpoint: https://plural-openai.openai.azure.com/openai/deployments
+      apiVersion: '2024-10-21'
+
+    vertex:
+      project: pluralsh-test-384515
+      location: us-east5
+      model: anthropic/claude-sonnet-4-5
+      serviceAccountJsonSecretRef:
+        name: ai-config
+        key: vertex
+```
+
+{% callout severity="info" %}
+All the secretRef's below reference a kubernetes secret defined like:
+
+```yaml
+apiVersion: v1
+kind: Secret
+metadata:
+    namespace: plrl-deploy-operator
+    name: ai-config
+stringData:
+  openai: ...
+  anthropic: ...
+  azure: ...
+  vertex: ...
+```
+{% /callout %}
+
+## Learn More
+
+You can see the full docs for this resource at https://docs.plural.sh/overview/management-api-reference#deploymentsettingsspec

src/routing/docs-structure.ts

@@ -140,6 +140,10 @@ export const docsStructure: DocSection[] = [
           { path: 'setup', title: 'Setup Plural AI' },
           { path: 'architecture', title: 'Plural AI Architecture' },
           { path: 'cost', title: 'Plural AI cost analysis' },
+          {
+            path: 'multi-model-configuration',
+            title: 'Configure Against Multiple Providers',
+          },
         ],
       },
       {