> For the complete documentation index, see [llms.txt](https://docs.flxbl.io/flxbl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flxbl.io/flxbl/codev/integrations/ai-providers.md).

# AI Providers

codev can use an AI model you connect to power its AI features. You bring your own provider and key — configure a provider once and every AI feature can use it.

You configure AI providers under **Settings > Organization > Integrations** (the **AI Providers** category). Only organization owners can manage them.

## What AI powers

A connected provider powers AI across codev, including:

* **AI Insight reports** — on-demand code and architecture analysis for a package or domain, from the **AI Insight** tab in the **Workspace Explorer** / **Packages** / **Domains** views. See [AI Assisted Insight Report](https://docs.flxbl.io/flxbl/sfp/analysing-a-project/ai-powered-report).
* **AI architecture analysis** — an architectural review of a pull request's changes, run as the **architecture** analysis linter; results appear on the PR check. See [AI Assisted Architecture Analysis](https://docs.flxbl.io/flxbl/sfp/analysing-a-project/ai-pr-linter).
* **AI-assisted error analysis** — when a pull request validation fails, codev asks your provider to explain it (root cause, severity, confidence, suggested fixes) and posts the result into the PR check. See [AI-Assisted Error Analysis](https://docs.flxbl.io/flxbl/sfp/validating-a-change/ai-assisted-error-analysis).
* **AI-assisted version intent** *(limited preview)* — reads a pull request diff and posts a `/version` comment with the semantic version intent. See [AI Assisted Version Intent](https://docs.flxbl.io/flxbl/sfp/analysing-a-project/ai-version-assist).
* **cherry-to** — transplants a change onto a diverged branch with AI when a plain apply won't fit, as a draft pull request you review. See [Cherry-to](/flxbl/codev/branch-operations/cherry-to.md).
* **Environment drift review** — after a mechanical drift comparison, an AI pass classifies each finding with a verdict, severity, and confidence. See [Environment drift](/flxbl/codev/environments/environment-drift.md).
* **Unbundle coherence check** — before rebuilding a release candidate with commits removed, an AI model reasons about whether what remains still depends on what was removed. See [Unbundle](/flxbl/codev/branch-operations/unbundle.md).
* **Rollback safety analysis** — assesses whether a release rollback can be cleanly re-applied, with the risks and a recommendation. See [Rollback](/flxbl/codev/ci-cd/rollback.md).
* **AI-assisted cascade merge** — resolves three-way merge conflicts on a cascade edge, recording its reasoning for review. See [Cascades](/flxbl/codev/branch-operations/cascades.md).

codev sends only the relevant context — a package's code, a pull request's diff, or a failing validation's output — to the provider you connected, under your own key.

## Providers

Each provider connects the same way: pick its card under **Settings > Organization > Integrations**, paste the credential, and set its availability. Setup and the exact fields are on each provider's page.

{% content-ref url="/pages/Pov410mdYCxxs00SkaYf" %}
[Anthropic (Claude)](/flxbl/codev/integrations/ai-providers/anthropic.md)
{% endcontent-ref %}

{% content-ref url="/pages/PaaCBwJjIEi7V9xXnPpQ" %}
[OpenAI](/flxbl/codev/integrations/ai-providers/openai.md)
{% endcontent-ref %}

{% content-ref url="/pages/GhoVEo2jheGZ5LsbBD9T" %}
[Google AI (Gemini)](/flxbl/codev/integrations/ai-providers/google-ai.md)
{% endcontent-ref %}

{% content-ref url="/pages/bqHqq3w2ik1txQYw3Mk2" %}
[Amazon Bedrock](/flxbl/codev/integrations/ai-providers/amazon-bedrock.md)
{% endcontent-ref %}

{% content-ref url="/pages/W9O7KHsM4EzRLXuh4SrY" %}
[GitHub Copilot](/flxbl/codev/integrations/ai-providers/github-copilot.md)
{% endcontent-ref %}

{% content-ref url="/pages/LOisDmsi8ZRnjSQ6VCCN" %}
[Claude on Google Vertex](/flxbl/codev/integrations/ai-providers/claude-on-vertex.md)
{% endcontent-ref %}

For default models and how to verify a provider with `sfp ai test`, see [Configuring LLM Providers](https://docs.flxbl.io/flxbl/sfp/getting-started/configuring-llm-providers).

## Choosing which provider codev uses

The provider you connect here is the **server-managed credential** every AI feature draws from — in codev and in any pipeline connected to the same sfp server. codev resolves the provider for a project in this order:

1. **The project's AI provider setting.** During project setup you can pick an **AI Provider** — choose a provider, or **None** to disable AI for that project.
2. **The default AI provider** — a registered AI integration marked as the **default** for the AI category, used when a project hasn't chosen its own.
3. **A global AI integration**, if no default is set.

## Data handling

When an AI feature runs, the relevant code or failing output is sent to the AI provider you connected, under your own account and key. Pick a provider that fits your organization's data policy, and set a project's AI provider to **None** to opt it out entirely.

## Self-hosting

AI providers are connected the same way on a self-hosted instance — you supply your own keys. Credential resolution and configuration details (environment variables, `config/ai-assist.yaml`, and server-managed credentials) are covered in [Configuring LLM Providers](https://docs.flxbl.io/flxbl/sfp/getting-started/configuring-llm-providers) and the [sfp server](https://docs.flxbl.io/sfp-server) documentation.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.flxbl.io/flxbl/codev/integrations/ai-providers.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.