> For the complete documentation index, see [llms.txt](https://docs.decisionrules.io/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decisionrules.io/doc/ai-assistant/assistant-setup/define-ai-provider.md).

# Define AI Provider

## AI Provider Settings

AI Provider Settings allow you to configure which **model**, **provider**, and **credentials** the DecisionRules AI Assistant will use.

In the configuration form, the user first selects a **model**, then a compatible **provider**, and finally fills in the required provider-specific credentials such as an **API key**, **endpoint**, **credentials JSON**, or **location**.

### Supported Providers

DecisionRules currently supports these providers:

* **Google**
* **Google Vertex**
* **Anthropic**
* **OpenAI**
* **Microsoft Foundry**

### How Configuration Works

The setup always follows the same flow:

1. Select a **model**
2. Select a compatible **provider**
3. Fill in the required provider-specific credentials
4. Test the connection
5. Save the configuration

The exact fields in the form depend on the selected provider.

## Provider Setup

### Google

For the **Google** provider, the user only needs to provide:

* **API Key**

### Anthropic

For the **Anthropic** provider, the user only needs to provide:

* **API Key**

### OpenAI

For the **OpenAI** provider, the user only needs to provide:

* **API Key**

### Microsoft Foundry

For **Microsoft Foundry**, the user must provide:

* **Endpoint**
* **API Key**

#### Where to find the Endpoint

The endpoint is available in Microsoft Foundry in:

**Build → Models → Select model → Code → Endpoint**

#### Where to find the API Key

The API key is available in:

**Home → API Key**

### Google Vertex

For **Google Vertex**, the user must provide:

* **Credentials JSON**
* **Location ID**

This setup is intended for organizations that want to use Gemini through **Vertex AI** with their own Google Cloud project and service account.

How to get [Google Vertex Credentials JSON](/doc/ai-assistant/assistant-setup/google-vertex-credentials-json.md)


---

# 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.decisionrules.io/doc/ai-assistant/assistant-setup/define-ai-provider.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.