> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

> To use your own models instead of Langdock's included AI models, BYOK needs to be activated.

Langdock requires three types of models to cover all platform features. Add them in [Workspace Settings -> Models](https://app.langdock.com/settings/workspace/models). For setup instructions per model type, see [Adding your own models](https://docs.langdock.com/en/admin/byok/adding-models.md).

***

## Set up your models in Langdock

### Completion models

These are the models your users select in chat. Add the models you want to make available from the providers you have keys for.

We support models hosted by Microsoft Azure, AWS Bedrock, Gemini Enterprise Agent Platform, Google AI Studio, OpenAI, Anthropic, Mistral, DeepSeek, Perplexity, Black Forest Labs, Replicate, the Vercel AI Gateway, and any OpenAI-compatible endpoint.

For quotas, between 200k and 500k TPM (tokens per minute) covers around 200 users. For your most-used model, you may need 500k–1M TPM.

> [!NOTE]
>
> Use [How to add fallback models](https://docs.langdock.com/en/admin/byok/fallback-models.md) to add multiple deployments for the same model.

***

### Image generation models

Add at least one image generation model so users can generate images from chat. See the [Image tab](https://docs.langdock.com/en/admin/byok/adding-models.md) in the adding models guide for setup instructions.

***

### Embedding model

Embedding models power document search and [Knowledge bases](https://docs.langdock.com/en/using-langdock/library/knowledge-bases.md). The platform requires a model with **1536 dimensions**. Any OpenAI or Azure-compatible embedding model with 1536 dimensions will work. Set the model as the workspace default with the **Embedding model** selector on the Models settings page.

***

### Decision model

When your workspace uses its own keys, **Decision model** appears under **Backbone model** on the Models settings page. Auto mode uses it to choose a fast or a powerful model for a new chat. Leave **Default** to use the first model in the **Decision** tab that can run. A model you select is used only while it can run. If that model cannot run, Langdock does not switch to another model in the tab.

![Models settings with Decision model set to Default, under Backbone model](https://mintcdn.com/langdock-34/xXQWhciIOnctgOzs/images/decision_model_settings.png?fit=max\&auto=format\&n=xXQWhciIOnctgOzs\&q=85\&s=29bd33e8f3a5a99ae89b1244e50211ec)

The menu lists **Default**, the decision models from the **Decision** tab, and **Configure new model…**.

![Decision model menu with Default, a decision model, and Configure new model](https://mintcdn.com/langdock-34/xXQWhciIOnctgOzs/images/decision_model_menu.png?fit=max\&auto=format\&n=xXQWhciIOnctgOzs\&q=85\&s=e216d1b2773c9bac309ea73a1b65a5f8)

**Configure new model…** adds a decision model and selects it when you save. You can't delete the selected model until you choose another decision model or **Default**.

![Message that the selected decision model cannot be deleted until you choose another decision model or Default](https://mintcdn.com/langdock-34/xXQWhciIOnctgOzs/images/decision_model_delete.png?fit=max\&auto=format\&n=xXQWhciIOnctgOzs\&q=85\&s=532ea6bf4dd227ec23561f023a6a57b5)

If the model you selected can't run, or **Default** is selected and none of your decision models can, a dedicated deployment uses the decision model for the deployment while that model can run. If it cannot, Auto mode uses the **Backbone model** and shows a warning under **Auto mode**, the same as on Langdock Cloud.

![Auto mode warning that no decision model is configured, so Auto mode uses the backbone model](https://mintcdn.com/langdock-34/xXQWhciIOnctgOzs/images/decision_model_warning.png?fit=max\&auto=format\&n=xXQWhciIOnctgOzs\&q=85\&s=96927f4fd058b9c442d3d7bd909bb11d)

The decision model also suggests an existing folder for a meeting. When no decision model can run, users see a note in the meeting's **Add to folder** menu.

***

### Deep Research models

Cloud BYOK workspaces need a Reasoning model and a Fast Reasoning model. They also need a Backbone model. Deep Research uses the dedicated Deep Research Backbone model when one is configured, and automatically falls back to the workspace Backbone model otherwise. Go to [Settings > Products > Deep Research](https://app.langdock.com/settings/workspace/products/deep-research) and configure the required models:

| Role | What it does | Recommended |
| - | - | - |
| **Reasoning Model** | Plans the research, evaluates results, and generates the final report. | GPT-6 Luna |
| **Fast Reasoning Model** | Generates per-task summaries during the research loop. | GPT-6 Luna |
| **Backbone Model** | Handles loop decisions and polishes the final report. | GPT-5 Mini |

> [accordion] Recommended settings: Reasoning and Fast Reasoning models
>
> | Setting | Recommended value |
> | - | - |
> | **API Type** | Responses API |
> | **Reasoning Effort** | High |
> | **Verbosity** | Medium |
> | **Supports Temperature** | Disabled |
> | **Supports Tools** | Enabled |

> [accordion] Recommended settings: Backbone model
>
> | Setting | Recommended value |
> | - | - |
> | **API Type** | Responses API |
> | **Reasoning Effort** | Minimal |
> | **Verbosity** | Low |
> | **Supports Temperature** | Disabled |
> | **Strict Mode** | Disabled |
> | **Supports Tools** | Enabled |

You can set a usage limit in the Deep Research settings (default: 15 queries per user per 30 days).

> [!WARNING]
>
> Deep Research uses the reasoning and verbosity settings configured on each model. If these are wrong or missing, Deep Research will produce poor results or fail entirely.

**Checklist before continuing:**

* [ ] Completion models from the providers you want to offer
* [ ] 1 or more image generation models
* [ ] 1x Embedding model (1536 dimensions)
* [ ] Reasoning and Fast Reasoning models configured with the correct settings above
* [ ] A Backbone model configured for the workspace or Deep Research

***

## 2. Reach out to the Langdock team

Once your models are set up, contact the [Langdock team](mailto:support@langdock.com), and we will activate BYOK for your workspace on our side.

***

## 3. Test your models

Once BYOK is active, verify each model type works:

* **Completion models**: send a prompt to each model in the interface (e.g. "write a story about dogs").
* **Image model**: ask any model to generate an image.
* **Embedding model**: create a Knowledge base in the Library, upload a file, then @mention the Knowledge base in a chat and ask a question about the file. You should get an answer based on the file content.
* **Deep Research**: run a Deep Research query and check that the report is detailed and well-structured. If it's shallow, recheck the model configuration settings above.

Contact [support@langdock.com](mailto:support@langdock.com) if anything isn't working.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.