Guias

Base de conhecimento

Envie documentos no dashboard e deixe a busca acontecer automaticamente na hora da requisição.

Um stack pode responder a partir dos seus próprios documentos sem que você tenha que construir um pipeline de busca. Envie arquivos pelo dashboard; a busca acontece automaticamente em toda requisição de chat, sem parâmetros extras do seu lado.

Enviando arquivos

  1. Abra a página de Conhecimento do stack

    No dashboard, abra seu stack e vá até a seção de base de conhecimento.

  2. Envie seus arquivos

    .txt, .md ou .pdf (PDFs devem ter texto embutido — PDFs escaneados ou apenas imagens ainda não são suportados). A indexação roda em segundo plano após o envio. Arquivos são limitados a 10MB cada, e o número de arquivos depende do seu plano — veja Planos e preços.

  3. Teste com uma pergunta real

    Pergunte algo que só o documento responda, através de chat completions sem nenhuma mensagem system — uma mensagem system que você envia ignora tanto o prompt configurado quanto a base de conhecimento para aquela requisição.

Como a busca funciona

No momento da requisição, o Stac cria embeddings da última mensagem do usuário e busca nos documentos indexados do stack os chunks mais próximos, então injeta-os no prompt antes da mensagem do usuário. Isso só acontece quando você não envia nenhuma mensagem system — veja Conceitos básicos e Chat completions para a regra exata.

Para que serve

A base de conhecimento serve para fundamentar respostas de chat nos seus materiais de referência — políticas, documentação de produto, FAQs. Ela não é usada pelos endpoints de extração estruturada: esses trabalham a partir do único arquivo que você envia naquela requisição, propositalmente, para que um campo nunca seja preenchido a partir de um documento não relacionado.

Próximos passos

  • Conceitos básicos — como o prompt do sistema e a base de conhecimento são escopados a um stack.
  • Chat completions — a regra da mensagem system que rege quando a busca é executada.