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

# Knowledge bases pelo AI Gateway

> Integre knowledge bases pelo AI Gateway. Habilite a recuperação de RAG em chamadas de LLM com injeção automática de contexto para respostas de IA mais completas.

**Casos de uso**

* Fundamentar respostas em documentos proprietários sem fine-tuning.
* Bots internos de perguntas e respostas sobre manuais, políticas ou bases de código da empresa.
* Adicionar conhecimento específico de um domínio a um modelo genérico sem sobrecarregar o prompt.
* Reduzir alucinações dando ao modelo acesso a fontes confiáveis no momento da consulta.

***

## Pré-requisitos

As Knowledge Bases foram criadas para fornecer informações relevantes e específicas para um LLM usar. Para começar, consulte Criar uma Knowledge Base. As Knowledge Bases precisam ser enriquecidas com os documentos de origem e configuradas para expor chunks adequados ao caso de uso.

> [!NOTE]
>
> Use o `id` da Knowledge Base como `knowledge_id` na geração do modelo.

> [!NOTE]
>
> O campo `knowledge_bases` está disponível apenas no endpoint de Chat Completions (`/v3/router/chat/completions`), por meio do objeto de extensão `orq`. Ele não é compatível com a Responses API (`/v3/router/responses`).

## Início rápido

Usando a Knowledge Base criada e o seu `id`, inclua o payload `knowledge_bases` na chamada de geração do modelo.

> O payload knowledge\_bases contém a configuração da consulta e o tipo de busca. Para saber mais, consulte Modos de busca e Estratégia de chunking.

```bash cURL (Chat Completions) theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST https://router.toqan.ai/eu/v3/router/chat/completions \
  -H "Authorization: Bearer $TOQAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.6-sol",
    "messages": [{"role": "user", "content": "How can I upgrade my account?"}],
    "orq": {
      "knowledge_bases": [
        {
          "knowledge_id": "api-documentation",
          "top_k": 5,
          "threshold": 0.7,
          "search_type": "hybrid_search"
        }
      ]
    }
  }'
```

```typescript TypeScript (Chat Completions) theme={"theme":{"light":"github-light","dark":"github-dark"}}
import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: process.env.TOQAN_API_KEY,
  baseURL: "https://router.toqan.ai/eu/v3/router",
});

const response = await openai.chat.completions.create({
  model: "openai/gpt-5.6-sol",
  messages: [{ role: "user", content: "How can I upgrade my account?" }],
  orq: {
    knowledge_bases: [
      {
        knowledge_id: "api-documentation",
        top_k: 5,
        threshold: 0.7,
        search_type: "hybrid_search",
      },
    ],
  },
});
```

```python Python (Chat Completions) theme={"theme":{"light":"github-light","dark":"github-dark"}}
from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ.get("TOQAN_API_KEY"),
    base_url="https://router.toqan.ai/eu/v3/router",
)

response = client.chat.completions.create(
    model="openai/gpt-5.6-sol",
    messages=[{"role": "user", "content": "How can I upgrade my account?"}],
    extra_body={
        "orq": {
            "knowledge_bases": [
                {
                    "knowledge_id": "api-documentation",
                    "top_k": 5,
                    "threshold": 0.7,
                    "search_type": "hybrid_search",
                }
            ]
        }
    },
)
```

> [!TIP]
>
> O **Toqan Router** enriquecerá automaticamente a geração do modelo com o contexto e a consulta fornecidos à knowledge base

Knowledge Base


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