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.
Enviar arquivos é uma ação do dashboard, não uma chamada de API — não existe endpoint público para adicionar ou remover documentos da base de conhecimento. A busca, uma vez que os documentos estão indexados, funciona através dos endpoints normais de chat.
Enviando arquivos
Abra a página de Conhecimento do stack
No dashboard, abra seu stack e vá até a seção de base de conhecimento.
Envie seus arquivos
.txt,.mdou.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.Teste com uma pergunta real
Pergunte algo que só o documento responda, através de chat completions sem nenhuma mensagem
system— uma mensagemsystemque 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.
A busca é best-effort: se a busca por similaridade falhar por qualquer motivo, a requisição de chat ainda é processada normalmente, apenas sem o contexto extra. Uma queda na base de conhecimento nunca vira uma falha na requisição de chat.
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
systemque rege quando a busca é executada.

