> For the complete documentation index, see [llms.txt](https://zaiadocs.gitbook.io/recursos/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zaiadocs.gitbook.io/recursos/agentes/como-criar-um-agente/cerebro/adicionar-e-remover-arquivos-no-cerebro.-aplicar-tags.md).

# Treinamento de Arquivos

### O que é o treinamento por Arquivos?

Além de websites, você pode alimentar o Cérebro do seu Agente diretamente com arquivos. Essa é a forma mais direta de carregar documentos internos, catálogos, manuais, scripts de atendimento, tabelas de preços ou qualquer outro conteúdo que o Agente precise conhecer para responder bem.

Os arquivos são processados página a página e seu conteúdo passa a fazer parte da base de conhecimento do Agente, sendo utilizado como referência nas respostas.

### Formatos e limites suportados

* **Formatos aceitos:** PDF, DOCX, PPTX, TXT e outros formatos de texto
* **Tamanho máximo por arquivo:** 100 MB
* **Quantidade máxima por envio:** 10 arquivos por vez
* **Tempo estimado de processamento:** aproximadamente 1 minuto por página

***

### Como adicionar um Arquivo ao Cérebro

#### Passo 1 — Selecione o Agente

No menu lateral, em **Funcionários AI**, clique no Agente que deseja configurar.

#### Passo 2 — Acesse o Cérebro

No menu lateral de configurações do Agente, clique em **"Cérebro"**.

#### Passo 3 — Clique em "Arquivos"

Na tela do Cérebro, clique no card **"Arquivos"** para acessar a área de upload.

#### Passo 4 — Faça o upload do arquivo

Na área de upload, clique em **"Clique e carregue o arquivo ou arraste e solte"** — ou simplesmente arraste o arquivo diretamente para a área indicada. Observe os formatos suportados antes de enviar.

#### Passo 5 — Aguarde o status "Pronto para treinar"

Após o upload, o arquivo aparecerá na lista com o status **"Pronto para treinar"**, indicando que ele foi carregado e está aguardando o treinamento.

#### Passo 6 — Clique em "Treinar Agente IA"

Clique no botão **"Treinar Agente IA"** para iniciar o processamento. O status passará por duas etapas:

* **Lendo arquivo. Aguarde** — a Zaia está fazendo a leitura do conteúdo do arquivo
* **Treinando** — o conteúdo lido está sendo incorporado ao Cérebro

Quando o processo for concluído, o status mudará para **"Treinado"** — indicando que o arquivo foi incorporado com sucesso à base de conhecimento do Agente.

***

### Como aplicar Tags nos arquivos

As tags ajudam a organizar os arquivos e orientam o Agente sobre quando utilizar o conteúdo de cada um. Isso é especialmente útil quando você tem múltiplos arquivos com temas distintos e quer que o Agente saiba diferenciar e priorizar o contexto correto.

#### Passo 1 — Abra o campo de tags

Na lista de arquivos, localize o arquivo ao qual deseja adicionar uma tag e clique no ícone de **hashtag (#)** ao lado dele.

#### Passo 2 — Digite o nome da tag

No campo que aparece, digite o nome da tag desejada e pressione **Enter** para adicioná-la. A tag aparecerá logo abaixo do campo. Para remover uma tag antes de salvar, clique no **"X"** ao lado dela.

#### Passo 3 — Clique em "Salvar Tags"

Após adicionar as tags desejadas, clique em **"Salvar Tags"** para confirmar.

> As tags não exigem novo treinamento do Agente — elas são salvas de forma independente e passam a valer imediatamente.

***

### Como remover um Arquivo do Cérebro

#### Passo 1 — Selecione o arquivo a remover

Na lista de arquivos treinados, marque o checkbox ao lado do arquivo que deseja remover. Para remover todos de uma vez, marque **"Marcar todos para remoção"**.

#### Passo 2 — Clique em "Deletar arquivos"

Com o arquivo selecionado, o botão **"Deletar arquivos"** aparecerá no topo da tela. Clique nele.

#### Passo 3 — Confirme a exclusão

Uma janela de confirmação será exibida com o aviso de que a ação é irreversível — ao deletar, você não conseguirá recuperar essa base e precisará realizar novos treinamentos. Clique em **"Deletar mesmo assim"** para confirmar, ou em **"Voltar e continuar utilizando"** para cancelar.

> **Atenção:** A exclusão de arquivos é permanente. Se precisar do conteúdo novamente, você terá que fazer o upload e treinar o Agente do zero.

***

### Dicas importantes

**Use tags para arquivos com temas específicos.** Se você tem um arquivo com tabela de preços, um com políticas de devolução e outro com o catálogo de produtos, nomear as tags de forma descritiva ajuda o Agente a identificar qual conteúdo é mais relevante para cada pergunta.

**Organize os arquivos antes de subir.** Remova páginas desnecessárias, imagens sem texto relevante e formatações muito complexas. Arquivos limpos e bem estruturados são processados com mais eficiência.

**Atenção ao limite de caracteres do Cérebro.** O total de caracteres entre todos os arquivos e fontes do Cérebro é compartilhado. Acompanhe o contador no rodapé da tela para não ultrapassar o limite disponível.

**Arquivos atualizados precisam ser re-treinados.** Se o conteúdo de um documento mudar, remova a versão antiga, faça upload da nova e treine o Agente novamente.