Indexação
Os estados por que um documento passa até responder, e o que fazer quando um falha.
Entre enviar um documento e ele aparecer em uma resposta há um processamento em etapas. Cada documento carrega o estado da etapa em que está.
Só documentos Ativos participam das respostas. Todos os outros estados são intermediários ou de erro.
Os estados
| Estado | O que está acontecendo |
|---|---|
Em fila | O arquivo chegou e aguarda processamento. |
Extraindo | O conteúdo está sendo transformado em texto. |
Indexando | O texto está sendo quebrado em trechos e preparado para a busca. |
Ativo | O documento está disponível para as respostas. |
Extração falhou | Não foi possível obter texto do arquivo. |
Indexação falhou | O texto foi obtido, mas não entrou no índice de busca. |
O tempo total depende do tamanho e do tipo do arquivo. PDFs digitalizados demoram mais porque a extração precisa reconhecer o texto na imagem.
Nenhum dos dois estados de erro se recupera sozinho. Um documento parado neles fica invisível para os Agentes indefinidamente, sem nenhum aviso na tela do Agente.
Quando a extração falha
Extração falhou quase sempre significa que o arquivo não tem texto recuperável:
- Um PDF que é apenas a imagem de uma página digitalizada, sem camada de texto.
- Um arquivo corrompido ou protegido por senha.
- Um formato que a plataforma não processa.
A saída é converter o arquivo para um formato com texto selecionável e enviá-lo de novo. Reenviar o mesmo arquivo produz a mesma falha.
Quando a indexação falha
Indexação falhou é mais raro e não depende do formato: o texto foi obtido, mas não entrou no índice.
Remova o documento e envie de novo. Se a falha se repetir com o mesmo arquivo, o conteúdo tem alguma particularidade que vale reportar ao suporte, com o documento em mãos.
O efeito de um documento parado
Um Agente associado a uma Coleção cujos documentos ainda estão processando responde como se a Coleção estivesse vazia. Não há aviso, nem no Admin nem no Chat.
Por isso, ao publicar um Agente logo depois de criar a Coleção, vale voltar a esta aba e confirmar que os documentos chegaram a Ativo antes de avisar as pessoas.
Próximos passos
- Gerencie os documentos em Arquivos.
- Entenda como os trechos indexados viram resposta em Coleções e conhecimento.