# Depois do envio: o processamento e o detalhe de um documento

> Acompanhar o processamento de um documento enviado à Dri, entender por que ele falhou, ler aproveitamento e triagem, reprocessar ou excluir.

Fonte: https://vendria.com/ajuda/depois-do-envio-processamento-de-um-documento

## Onde fica

No menu da sua conta, em **Conhecimento da Dri**, aba **Documentos**. Clique no
título de um documento (ou na linha inteira) para abrir o detalhe dele. O botão
**Base de conhecimento**, no topo do detalhe, volta para a lista.

## Os estados de um documento na lista

Depois de **Subir**, a tela avisa **"Documento recebido. Está na fila — a lista
acompanha."** O processamento roda em segundo plano, e a coluna **Estado** se
atualiza sozinha enquanto houver documento em andamento; não precisa
recarregar a página.

| Estado | o que significa |
|---|---|
| **Na fila** | recebido, ainda não começou |
| **Lendo o arquivo** | extraindo o texto (ou transcrevendo por visão, se for escaneado) |
| **Triando** | separando o que é fato do que é preço, ruído ou dúvida |
| **Destilando** | reescrevendo os trechos aproveitados como fatos |
| **Indexando** | tornando os fatos pesquisáveis pela Dri |
| **Na base** | pronto: a Dri já responde com ele |
| **Revisar** | entrou na base com o que passou, e ainda há trechos esperando decisão |
| **Falhou** | parou numa etapa; o motivo aparece ao passar o mouse sobre o estado |

Um manual escaneado pode levar alguns minutos; um texto curto, segundos.

## Por que um documento falhou

Passe o mouse sobre **Falhou** na lista, ou abra o detalhe: a faixa vermelha
diz **"A ingestão parou:"** seguido do motivo. Os mais comuns:

- **"o arquivo não tem texto que eu consiga aproveitar"**: arquivo vazio ou só
  com imagens sem texto legível;
- **"não consegui ler as páginas escaneadas"**: a transcrição por visão falhou;
- **"o arquivo diz ser … mas não consegui abri-lo"**: arquivo corrompido ou
  exportado pela metade; exporte de novo e suba;
- **"a triagem do conteúdo falhou"**, **"a destilação dos fatos falhou"** ou
  **"o embedding dos fatos falhou"**: falha temporária do serviço de leitura;
  clique em reprocessar mais tarde.

## As colunas Aproveitamento e Rendimento

**Aproveitamento** diz quanto do documento passou na triagem, com o total ao
lado: "40% 12/30" são 12 trechos aproveitados de 30. Verde a partir de 50%,
âmbar entre 20% e 50%, vermelho abaixo. Aparece **—** quando o documento ainda
não foi triado. Não é zero.

**Rendimento** mostra quantos **fatos** e quantos **trechos** o documento
gerou. Fato é cada informação que a Dri pode citar; trecho é o bloco pesquisável
que agrupa fatos do mesmo título. Ter mais fatos que trechos é o normal.

Aproveitamento baixo nem sempre é defeito: um catálogo cheio de preço e imagem
aproveita pouco, e está certo. Num documento escrito para a Dri, é sinal de
abrir o detalhe e ver o que foi descartado.

## Os números no topo do detalhe de um documento

- **Passou na triagem**: a mesma taxa da lista, com "12 de 30" ao lado. Logo
  abaixo, **"% responde na busca"**: quantos fatos deste documento a Dri de fato
  alcança por esta busca. Um fato pode passar na triagem e ficar fora dela por
  três motivos: é repetição de outro documento (quem responde é o outro, nada se
  perdeu), foi ligado a um produto do catálogo (passa a responder junto do
  produto) ou está em conflito, e só este último é perda de verdade.
- **Fatos extraídos**, **Trechos no índice** e **Aguardando revisão**: este
  último é quantos trechos estão na gaveta **Revisar**.

Quando algum fato está fora por conflito, aparece a faixa **"N fatos deste
documento estão fora da busca por conflito com outro documento"** com o link
**Ver a fila de conflitos**. A decisão é tomada lá, com os dois lados à vista.

## As abas Triagem, Destilado e Trechos indexados

**Triagem** mostra cada trecho do documento com o texto literal (**O que o
documento diz**) ao lado do motivo (**Por que foi para esta gaveta**). Os
botões **Todos**, **Revisar**, **Fato**, **Volátil** e **Ruído** filtram por
gaveta:

- **Fato**: entrou na base;
- **Volátil**: preço de produto, estoque ou promoção com prazo; fica de fora
  de propósito;
- **Ruído**: rodapé, numeração de página, endereço repetido;
- **Revisar**: a triagem não soube decidir; fica parado.

**Destilado** é o texto que a leitura produziu a partir dos fatos. **Trechos
indexados** mostra o que a busca da Dri enxerga, cada trecho com o título de
seção de onde veio.

## Mover um trecho de gaveta

Em cada trecho da aba **Triagem**, **Mover para:** troca a gaveta com um clique:
vale para qualquer trecho, não só os de **Revisar**, porque a triagem também
erra para o outro lado.

⚠️ Mover para **Fato** não coloca o trecho na base na hora: a tela avisa
**"Movido para Fato. Reprocesse o documento para que ele entre na base."**
Reprocesse, e o trecho entra. O reprocessamento refaz a triagem do documento,
mas **mantém a gaveta que uma pessoa escolheu** para cada trecho de texto igual.
Se o texto daquele trecho mudou numa versão nova do arquivo, ele é lido de novo
e a triagem decide outra vez.

## Reprocessar e excluir um documento

Os dois ícones na coluna **Ações** (e o botão **Reprocessar** no detalhe):

- **Reprocessar** refaz a leitura inteira a partir do arquivo **original**
  guardado. Serve para documento que **Falhou** por problema temporário, ou que
  ficou parado numa etapa. Não serve para atualizar o conteúdo; para isso,
  suba o arquivo novo.
- **Excluir** pede confirmação e apaga o documento, os fatos extraídos dele e o
  que está no índice **na hora**. A Dri deixa de responder com aquele material.
  Não há lixeira: para voltar, suba o arquivo de novo.

## O documento Respostas da equipe

Quando você responde uma pergunta na aba **Dúvidas** e a resposta é guardada,
ela entra num documento criado sozinho, chamado **Respostas da equipe**, com
origem **Resposta**. Ele aparece na lista como qualquer outro.

⚠️ **Excluir Respostas da equipe apaga todas as respostas guardadas** pela fila
de dúvidas. E ele não tem arquivo original, então **Reprocessar** nele termina
em **Falhou**. Não use.

## Quando dá errado

**Está em "Na fila" há muito tempo.** A lista pergunta de novo sozinha a cada
poucos segundos. Se continuar parado depois de alguns minutos, clique em
reprocessar.

**Está "Na base" e a Dri não responde.** Teste a pergunta em **Qualidade**: o
teste mostra o que a Dri leu. Ver [Qualidade da base: testar o que a Dri responde](/ajuda/qualidade-da-base).

**Ficou em "Revisar".** O documento já responde com o que passou. Abra o
detalhe, filtre por **Revisar** e veja se há algo importante parado ali.
