AnythingLLM: documentos no chat ou no workspace?

Você recebeu uma ficha de montagem e quer tirar uma dúvida agora. Na semana seguinte, quer consultar a mesma ficha em outra conversa sem carregá-la de novo. No AnythingLLM Desktop, esses dois usos pedem ações diferentes. O anexo acompanha uma conversa. Um documento incorporado ao workspace pode ser recuperado em outras conversas daquele espaço.

O exercício a seguir usa documentos fictícios de uma oficina para verificar essa diferença. Você vai repetir uma pergunta em conversas separadas, conferir o trecho que sustenta uma resposta e fazer uma pergunta cuja resposta ficou de fora dos arquivos. A documentação foi conferida em 6 de novembro de 2026. Os resultados descritos no exercício são critérios de teste.

Prepare arquivos que permitam conferir a resposta

Crie dois textos fictícios antes de abrir a ferramenta. No primeiro, chamado suporte-cedro-r02.txt, escreva que o suporte Cedro usa o espaçador S-17 na base curta. Dê à passagem um título legível, como “Montagem da base curta”. No segundo, chamado suporte-ipe-r01.txt, escreva que o suporte Ipê usa o espaçador S-09 na base curta. Acrescente um cabeçalho com o nome do documento, a revisão e a indicação de que os dados são fictícios.

Use códigos incomuns para que a resposta dependa dos arquivos. Se você perguntar apenas para que serve um espaçador, o modelo pode responder com conhecimento geral e fazer o teste parecer bem-sucedido. Pergunte qual é o código para um conjunto com nome próprio. O segundo arquivo, parecido com o primeiro, serve para perceber quando o sistema recupera um trecho sobre a peça errada. A palavra “espaçador” aparece nos dois textos, assim como a expressão “base curta”. A diferença que importa é o nome do conjunto.

Deixe o torque de aperto fora dos dois textos. É a ausência deliberada que você vai testar depois. Mantenha também uma folha de gabarito fora do aplicativo. Nela, registre S-17 para Cedro, S-09 para Ipê e “sem informação nos arquivos” para torque. A folha fica do lado de fora porque contém justamente a resposta que o exercício precisa descobrir por meio dos documentos selecionados.

Em arquivos de trabalho, uma linha pode depender de outra parte do mesmo material. Para aproximar o exercício dessa situação, escreva numa linha que o Cedro tem uma base curta e uma longa. Coloque S-17 na seção da curta e diga na seção da longa apenas que ela tem instruções próprias. Uma resposta que estende S-17 à base longa falha mesmo quando acerta o código pedido para a curta. O gabarito precisa incluir esse limite.

Use texto simples no primeiro ensaio. Assim você separa problemas de seleção e busca de erros que podem surgir quando a extração não reconhece colunas, imagens digitalizadas ou a ordem da tabela de um PDF. Depois que o fluxo estiver claro, repita com uma amostra do formato que pretende usar. O objetivo da primeira rodada é descobrir se o conteúdo chegou ao contexto esperado.

Confira o ambiente do AnythingLLM Desktop

Este fluxo usa o aplicativo Desktop em uma estação, com dois chats de teste sob o mesmo workspace. A documentação distingue o Desktop, de uso individual, da edição Docker, que oferece gestão de usuários e acesso aos espaços. Duas conversas em um Desktop podem testar o escopo dos documentos. Para avaliar o que uma segunda pessoa consegue ver numa instalação compartilhada, use a edição apropriada e teste a conta dela separadamente. Visão oficial da edição Desktop.

Na tela de configuração, confira qual provedor vai responder e como a busca nos documentos será processada. A documentação do provedor integrado descreve a escolha de um modelo para baixar e executar no computador. Para uma sessão que deve permanecer local, verifique também o provedor de embeddings, o banco vetorial e os conectores que você pretende utilizar. Se optar por um serviço remoto, a forma de processar os dados pode mudar. Use apenas os arquivos fictícios durante o exercício. Documentação do provedor de modelos integrado.

Confira se o AnythingLLM Desktop está na versão 1.8.5 ou superior. A documentação oficial limita a interface de anexos descrita neste exercício a essas versões. Em uma instalação anterior, atualize antes de começar. Anote a versão, o modelo escolhido e a configuração de recuperação usada. Mantenha esses itens iguais enquanto compara anexo e workspace. Se você troca de modelo ao abrir o segundo chat, fica difícil saber se a resposta mudou pela ausência do documento ou pela diferença de comportamento do modelo. Se for preciso atualizar uma configuração, faça isso após concluir a primeira comparação e repita o teste com o mesmo gabarito.

Crie um workspace de ensaio, como “Oficina de demonstração”. Abra um chat antes de enviar qualquer arquivo e pergunte pelo código para a base curta do Cedro. Registre se o aplicativo mostra uma fonte e se o modelo inventa um código. Esse primeiro chat serve como referência. Caso a resposta traga o código esperado por acaso, o teste continua dependendo da citação e do trecho, porque coincidência não demonstra acesso ao arquivo.

Faça o primeiro teste com um anexo

Abra outra conversa nesse workspace e arraste suporte-cedro-r02.txt para o chat ou selecione o arquivo com o botão de adição ao lado da entrada da mensagem. A documentação indica que esse tipo de anexo fica no escopo da conversa dentro do workspace. O vídeo oficial associado mostra os controles de anexo na interface em inglês. A incorporação persistente fica para a próxima etapa. Documentação oficial sobre anexos e documentos.

Escreva uma pergunta que identifique a peça, a variante e o que deve sair na resposta. Por exemplo, “Qual é o código do espaçador da base curta do suporte Cedro? Informe o código e transcreva a linha do documento que o confirma. Se o material não indicar o código, diga que ele não foi encontrado.” Guarde a redação para reutilizar em cada rodada. Uma pergunta diferente pode recuperar outra passagem mesmo com os mesmos arquivos.

Confira se a resposta traz S-17 com o nome Cedro e o limite “base curta”. A documentação explica que o texto do anexo pode entrar no contexto da conversa. Para este exemplo curto, isso permite olhar o arquivo como unidade. Em documentos grandes, a janela de contexto do modelo também precisa comportar instruções, pergunta e histórico. Se o AnythingLLM indicar que o limite foi excedido, pare e reduza a amostra para concluir esta rodada comparável.

Abra agora um terceiro chat no mesmo workspace e faça a mesma pergunta, sem anexar arquivo e sem colar o que apareceu na conversa anterior. Se o modelo disser que não encontrou o código, esse comportamento é coerente com o escopo do anexo. Se responder com um código, examine de onde ele veio. A resposta da rodada anterior não vale como evidência nessa conversa. Verifique se existe algum documento incorporado de um ensaio anterior ou uma instrução do workspace que já contenha o código.

Volte ao chat com o anexo e pergunte novamente sobre a base curta. Registre o nome do chat e o arquivo que estava anexado quando você obteve a resposta. Esse movimento de ida e volta é importante para separar o que depende do conteúdo anexado de uma alteração global. Em uma revisão posterior, alguém consegue refazer o percurso sem adivinhar em qual conversa você trabalhou.

Incorpore o documento no workspace

Incorpore os dois documentos fictícios ao workspace e confirme na lista daquele espaço que os arquivos aparecem como incorporados. Se a interface mostrar a opção Embed ao lidar com um anexo que excede o contexto, esse é o caminho documentado para incorporar o arquivo ao workspace. A documentação atual confirma que um documento incorporado fica disponível às conversas daquele espaço. Ver o arquivo no chat ou na lista de arquivos disponíveis ainda não confirma essa condição.

Ao incorporar um documento, o AnythingLLM divide o texto em trechos e os representa em vetores para a busca. Quando chega uma pergunta, o sistema procura passagens relevantes e entrega os trechos recuperados ao modelo. É por isso que incorporar material não faz o modelo memorizar o arquivo inteiro. A qualidade depende também do que foi extraído e do que a pergunta conseguiu recuperar. A referência a seguir é a explicação anterior do mecanismo. Para a interface de anexos e a opção de incorporação, siga a documentação atual citada na etapa anterior. Como a recuperação de documentos funciona no AnythingLLM.

Abra um novo chat no mesmo workspace depois que os arquivos forem incorporados. Repita a pergunta sobre Cedro sem usar o botão de anexo. Depois faça a equivalente para Ipê. Compare os dois resultados com o gabarito. O caso útil aqui é obter a resposta correta em conversas distintas usando o mesmo acervo, com os códigos separados pelos nomes dos conjuntos.

Repita a pergunta sobre o Cedro em um workspace de controle, vazio e com as mesmas configurações possíveis. Se você vê uma resposta concreta no espaço vazio, procure sinais de que o documento está anexado ali, de que o modelo está usando algum conector habilitado ou de que o código apareceu por geração sem fonte. O ensaio mede a recuperação no workspace escolhido. Uma resposta repetida fora desse espaço merece investigação.

Evite usar o mesmo chat que recebeu o anexo para demonstrar que a incorporação funcionou. A conversa já tem texto, respostas anteriores e possivelmente o arquivo anexado. O modelo pode repetir algo que viu antes. O novo chat reduz essa ambiguidade. Se for preciso mostrar o resultado a outra pessoa, apresente qual espaço foi usado, a lista de arquivos incorporados e o teste sem anexo.

Confronte a resposta com o trecho original

Uma referência é o ponto de partida da revisão. Abra o trecho mostrado como fonte, quando a interface o disponibilizar, e confira também o texto no arquivo original. Compare o conjunto, a variante e a revisão. Um trecho que cita S-09 pode ser totalmente válido no documento Ipê e ainda assim não responder à pergunta sobre Cedro. Uma citação verdadeira associada a uma conclusão errada precisa ser marcada como falha.

Peça ao modelo para separar o que foi recuperado da conclusão. Uma saída útil contém o código, o nome do arquivo ou o título da seção e uma linha que você consegue localizar no original. Se o modelo fornecer aspas, verifique se o conteúdo coincide com o texto. Se a interface exibir apenas uma referência ao arquivo, abra o arquivo e localize a passagem em vez de tratar a referência como prova suficiente.

Leia também o entorno. Uma linha sobre S-17 pode estar logo depois de “somente para a base curta”. Se o trecho retornado omitir a condição, procure a frase que a antecede no original. Em material de trabalho, cabeçalhos, datas e exceções costumam limitar a regra principal. Formule uma segunda pergunta sobre esse limite para ver se o modelo o recupera quando chamado a responder diretamente.

Se o texto disponível no aplicativo difere do arquivo que você guardou, verifique a etapa de extração. Uma ficha em PDF pode mostrar visualmente o código debaixo da coluna correta enquanto o texto extraído perde a ordem da tabela. Teste uma versão em texto estruturada com cabeçalhos, compare o resultado e só depois mude a configuração de recuperação. Esse teste ajuda a distinguir erro na leitura do arquivo de erro na seleção do trecho. Veja os conceitos de recuperação e geração com fontes.

Registre a evidência de forma proporcional. Para os dados fictícios, salve a pergunta, o código esperado e a frase conferida. Com dados internos, escolha um registro compatível com as permissões da equipe. É possível anotar o título, a revisão e a seção sem copiar uma página inteira para uma planilha compartilhada. O registro deve facilitar a conferência sem alargar a circulação do documento.

Teste uma pergunta sem resposta nos arquivos

Em um novo chat no workspace com os dois arquivos, pergunte “Qual torque de aperto a ficha do suporte Cedro estabelece para o espaçador da base curta? Se a ficha não informar, responda que não encontrou o valor.” O gabarito contém ausência de informação. Uma resposta que indica uma medida, supõe uma recomendação ou sugere um intervalo como se viesse da ficha deve ser registrada como falha.

Faça uma segunda versão mais natural, como a pergunta curta de um colega com pressa. “Qual é o torque dessa montagem?” é vaga se você abrir um chat novo. Por isso, teste tanto essa frase quanto uma segunda que repete o nome Cedro. Se o modelo pedir esclarecimento para a pergunta vaga, isso pode ser apropriado. Se reconhecer a peça e ainda inventar a medida, a deficiência é outra. Separe as observações na planilha de revisão.

O teste também deve captar negativas amplas demais. “A oficina nunca definiu torque” vai além do que a amostra permite afirmar. O enunciado fiel é “não encontrei o torque nos documentos consultados”. O modelo viu o material disponível para a consulta. Outro documento da oficina pode trazer a instrução. Ensine a equipe a distinguir ausência na fonte examinada de inexistência da informação.

Uma resposta negativa também pode esconder falha na recuperação. Depois da pergunta de torque, refaça a do espaçador numa conversa nova. Se nenhuma pergunta encontra conteúdo, o problema pode estar na conexão do modelo com os documentos, na extração ou no workspace escolhido. Se a pergunta positiva encontra S-17 com o trecho correto e a negativa informa a ausência do torque, você tem evidência melhor de que o fluxo distingue o que está e o que falta no acervo.

Você pode introduzir uma terceira ficha fictícia em outra rodada, com torque explícito, para separar a ausência inicial de incapacidade de recuperar aquele campo. Identifique a ficha como revisão de teste, incorpore-a no espaço de ensaio e repita a pergunta. Compare os trechos recuperados nas duas rodadas. Se a revisão antiga e a nova entrarem juntas, confira se o modelo indica de qual delas tirou a instrução. Faça esse ensaio separado para preservar o caso inicial sem resposta.

Descubra onde a consulta falhou

Comece pela etapa que consegue observar. Verifique se está no workspace esperado e se a incorporação terminou. Depois confira o arquivo certo e a revisão. Em seguida, busque a frase no original e teste uma pergunta que use o cabeçalho ou o nome exato da peça. Um diagnóstico nessa ordem evita gastar tempo com parâmetros enquanto a ficha correta ficou na lista de arquivos disponíveis.

Se a pergunta específica funciona e a versão mais livre falha, registre os termos que fizeram diferença. Talvez o texto use “base reduzida”, enquanto o usuário procura “base curta”. Uma ficha mais clara pode explicitar os dois nomes. Revise o conteúdo na origem e refaça a incorporação em condições controladas. Encher a pergunta de palavras-chave pode funcionar no ensaio, mas um documento que usa a linguagem da equipe facilita o uso diário.

Se o trecho esperado está sendo recuperado, mas a resposta combina os dois conjuntos, compare o trecho de cada fonte e teste uma pergunta que exija distinguir Cedro de Ipê. Se o erro persiste, experimente pedir uma resposta em duas linhas, uma por peça, cada qual com sua própria referência. Guarde uma rodada com a formulação original para conferir se a mudança trouxe benefício além do exemplo.

Se a passagem certa não aparece, examine o tamanho dos trechos recuperados e as opções de busca do workspace. A documentação descreve ajustes de similaridade, quantidade de trechos e reordenação dos trechos recuperados (reranking), opção que a documentação indica para a configuração com LanceDB. Mude um parâmetro de cada vez. Aumentar o número de trechos pode trazer a passagem perdida junto com texto irrelevante. Repita o caso positivo e o caso sem resposta para descobrir se a melhora veio acompanhada de novas confusões.

Volte ao anexo curto como controle quando o diagnóstico empacar. Se a mesma passagem funciona anexada em um chat novo, você sabe que o modelo consegue usar aquela frase quando recebe o texto. A busca, a indexação ou a associação ao workspace passam a ser suspeitas mais específicas. Se o erro aparece nos dois modos, reveja a formulação, o texto extraído, as instruções e a resposta do modelo antes de reconfigurar tudo. Veja como separar escolhas de execução local e na nuvem.

Decida o que merece ficar no workspace

Use o anexo para material temporário que serve a uma pergunta ou a uma conversa. Escolha a incorporação para documentos aprovados que voltam em consultas futuras. O workspace se torna mais fácil de revisar quando o conjunto tem um assunto claro, quando cada arquivo tem uma revisão identificável e quando a equipe sabe de onde vem a versão em vigor.

Registre o responsável pelo documento e pela verificação das respostas. Quando uma ficha mudar, atualize o arquivo com procedimento conhecido e rode novamente as perguntas que dependem dela. Escolha pelo menos uma pergunta cuja resposta mudou e outra que deveria continuar igual. Uma revisão que corrige o Cedro e começa a confundir o Ipê precisa de mais uma conferência antes de servir de referência diária.

Prepare também um encaminhamento para a pergunta sem fonte. A equipe pode consultar o responsável pela ficha ou abrir uma solicitação de atualização. O acervo melhora quando esses casos voltam para quem cuida do documento. Guarde o pedido com assunto e seção ausente. Para respostas que exigem avaliação de alguém, estabeleça uma rota clara de revisão. Veja como definir a transferência de um agente para uma pessoa.

Perguntas frequentes

Um anexo do chat aparece em outras conversas do AnythingLLM?

O anexo pertence à conversa em que foi adicionado. Para consultar o documento em outras conversas do mesmo workspace, incorpore-o ao espaço pelo gerenciamento de documentos.

Enviar um arquivo já coloca seu conteúdo nas buscas do workspace?

Confirme na lista do workspace que o documento foi incorporado. A documentação atual indica que a incorporação torna o conteúdo disponível às conversas desse espaço. Teste em um novo chat sem anexar o arquivo novamente.

O modelo recebe o documento inteiro quando uso recuperação?

Na recuperação, o modelo recebe trechos selecionados para a pergunta. A documentação distingue esse fluxo do anexo direto, que pode usar o texto inteiro se ele couber no contexto.

Como conferir se o código veio do documento certo?

Compare a resposta e a referência com a linha original, a revisão e a condição da ficha. Um trecho sobre outro conjunto pode ter palavras parecidas e indicar um código diferente.

Posso usar o Desktop para testar o acesso de dois usuários?

O Desktop é de uso individual. Para testar permissões de usuários em uma instalação compartilhada, a documentação distingue a edição Docker e seus recursos de acesso.