# Fazer upload de arquivos para a Base de Conhecimento

**POST /transformersapi/1.0/upload_files**

Realiza o upload de um arquivo para a **Base de Conhecimento** da plataforma IAN, como parte do fluxo de **RAG (Retrieval-Augmented Generation)**.

O endpoint executa as seguintes etapas:
1. Lê o arquivo a partir de uma URL pública
2. Armazena os dados na arquitetura interna
3. Processa e indexa os dados para recuperação eficiente via API `/questions`

Após o envio, os documentos ficam disponíveis para pipelines de IA que combinam **recuperação de contexto + geração de texto**.

**Tipos de arquivo suportados:** `.xls`, `.xlsx`, `.ods`, `.pdf`, `.csv`, `.txt`, `.tsv`, `.docx`, `.xml`, `.json`

**Parâmetros:**

| Parâmetro | Descrição | Obrigatório |
|---|---|---|
| `url_file` | URL pública do arquivo (não pode ser link do Google Drive) | ✅ Sim |
| `index_elastic` | Nome da base de conhecimento. Composto por: `{hostname}_{identificador}_data_pt`. Se já existir uma base com o mesmo nome, ela será sobrescrita | ✅ Sim |
| `separator_doc_elastic` | Separador de linhas usado no arquivo para identificar documentos | ❌ Não |
| `id_doc_elastic` | Nome da coluna que identifica cada documento como único | ❌ Não |

Consulte as abas de exemplo ao lado para ver o payload de cada tipo de arquivo.


## Servers
- Ambiente de Produção: https://api.neppo.com.br (Ambiente de Produção)


## Authentication methods
- Bearer auth


## Parameters



### Body: application/json (object)

- **url_file** (string)
  URL pública do arquivo a ser processado. Não pode ser link do Google Drive.

- **index_elastic** (string)
  Nome da base de conhecimento. Formato: {hostname}_{identificador}_data_pt. Se já existir uma base com o mesmo nome, será sobrescrita.

- **separator_doc_elastic** (string)
  Separador de linhas usado no arquivo para identificar documentos. Recomendado para CSV, DOCX e PDF.

- **id_doc_elastic** (string)
  Nome da coluna que identifica cada documento como único. Recomendado para JSON e XML.



## Responses
### 200
Arquivo recebido e processamento iniciado com sucesso

### 401
Não autorizado — token ausente ou inválido

### 403
Acesso proibido — sem permissão para este recurso

### 404
Recurso não encontrado


[Powered by Bump.sh](https://bump.sh)