Coleções e conhecimento

Uma Coleção é um conjunto de documentos que um Agente pode consultar antes de responder. É o mecanismo pelo qual a plataforma responde com o conteúdo da sua empresa, e não só com o que o modelo aprendeu no treino.

Coleções pertencem a um workspace e não são compartilhadas entre workspaces.

Do que uma Coleção é feita

Uma Coleção reúne fontes de dois tipos, nas abas Arquivos e Conectores:

• Arquivos: documentos que você envia, em PDF, DOCX, TXT e formatos equivalentes. Ficam parados até alguém substituí-los.
• Conectores: fontes externas que a plataforma sincroniza, como um site indexado ou um repositório de documentos. Voltam a buscar conteúdo de tempos em tempos.

O ciclo de vida de um documento

Todo documento passa pelos mesmos estados até ficar utilizável, e a aba Arquivos mostra o estado de cada um:

1. Em fila: o arquivo chegou e espera processamento.
2. Extraindo: a plataforma está transformando o arquivo em texto.
3. Indexando: o texto está sendo quebrado em trechos e preparado para a busca.
4. Extraído: o documento está disponível para as respostas.

Apesar do nome, Extraído é o estado final: ele vem depois de Indexando, não logo após a extração.

Os dois estados de erro são Extração falhou e Indexação falhou. Nenhum dos dois se recupera sozinho, e um documento nesses estados não participa das respostas.

Só documentos em Extraído são consultados. Um Agente ligado a uma Coleção cujos arquivos ainda estão indexando responde como se a Coleção estivesse vazia.

O que acontece a cada pergunta

Quando um Agente com Coleções recebe uma mensagem, a plataforma:

1. Converte a pergunta em uma representação numérica e busca os trechos mais próximos dentro das Coleções associadas àquele Agente.
2. Entrega os trechos encontrados ao modelo, junto do prompt e do histórico.
3. Pede a resposta, agora com esse material à vista.

Esse desenho é o que a indústria chama de RAG, geração aumentada por recuperação. A consequência prática é que a qualidade da resposta depende mais do conteúdo indexado do que do modelo escolhido.

Limites que valem conhecer

• A busca é por conteúdo, não por título. Perguntar pelo nome do arquivo raramente encontra o arquivo. Use os termos que aparecem dentro dele.
• Coleção vazia significa "sem conhecimento", nunca "busque em tudo". Um Agente sem Coleções não varre o workspace; ele apenas não busca.
• PDFs digitalizados dependem de extração de texto e demoram mais. Quando o original é uma imagem sem texto selecionável, a extração pode falhar.
• O escopo é o workspace. Levar uma Coleção para outro workspace significa recriá-la ali.

Próximos passos

• Veja como a Coleção se liga a quem responde em Agentes e SuperAgentes.
• Crie a sua primeira Coleção em Seu primeiro agente.