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

# Bases de conhecimento

> O que são bases de conhecimento em Agentes de IA?

As Bases de Conhecimento são fontes de informação que ampliam a memória e o contexto de um agente, garantindo que o agente tenha acesso a dados confiáveis e específicos da organização ou domínio.

Uma base pode conter documentos internos, FAQs, artigos técnicos, registros históricos, planilhas, manuais, ou até mesmo páginas da web.

## Como os agentes usam Bases de Conhecimento

* Um agente pode consumir uma base de conhecimento de diversas formas:\
  Recuperação de contexto: quando uma pergunta do usuário é feita, o agente busca na base de conhecimento trechos relevantes.
* Integração com o modelo: o conteúdo recuperado é injetado no prompt do modelo de IA.
* Resposta fundamentada: o modelo gera a saída combinando linguagem natural com dados da base.
* Suporte multimodal: dependendo da configuração (multimodal: true), a base pode conter não só texto, mas também imagens, áudio e vídeo.

### Tipos de base:

* file: documentos como PDFs, planilhas ou apresentações.
* url: links de sites internos ou externos.
* text: blocos diretos de conhecimento estruturado.

### Boas práticas

* Utilize de tags para organizar e permitir que o agente faça buscas rápidas  (ex.: \["finance", "contracts"]).
* Segurança: restrinja acesso por sectors para evitar vazamento de informações sensíveis.
* Habilitação seletiva: controle enabled para ativar/desativar bases conforme o ambiente ou projeto.

### Interface de Bases de Conhecimento do Orkeia

O Orkeia permite, via API, que passemos bases de conhecimento para nossos agentes, abaixo temos um exemplo de interface:

```typescript theme={null}
export interface KnowledgeBase {
  id?: string;
  name: string;
  description: string;
  enabled: boolean;
  sectors: string[];
  content: string;
  type: 'file' | 'url' | 'text';
  multimodal: boolean;
  tags: string[];
}
```

### Exemplo de JSON de Base de Conhecimento do Orkeia

```json theme={null}
{
  "id": "kb_internal_policies",
  "name": "Políticas Internas",
  "description": "Base de conhecimento com regulamentos, políticas e procedimentos internos da empresa.",
  "enabled": true,
  "sectors": ["hr", "legal", "management"],
  "content": "https://storage.orkeia.ai/kb/policies.pdf",
  "type": "file",
  "multimodal": false,
  "tags": ["compliance", "employee-handbook", "contracts"]
}
```