Guias
Base de conhecimento
Envie documentos no dashboard e deixe a busca acontecer na hora da requisição, nas chaves que você escolher.
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 na hora da requisição de chat, sem parâmetros extras do seu lado. Quais chaves consultam a base é uma opção de cada chave, escolhida na criação e alterável depois.
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 os injeta no prompt, antes da conversa.
Quem decide se isso acontece é a chave de API usada na requisição, em Chaves de API → Configurações:
| Configuração | Quando a base é consultada |
|---|---|
| Ativada | Em toda pergunta, mesmo que você envie uma mensagem system própria |
| Desativada | Nunca |
| Automático | Só quando a requisição não traz mensagem system — é o estado das chaves criadas antes dessa opção existir |
Com a base ativada e uma mensagem system sua na requisição, as duas coisas
convivem: a sua instrução continua valendo, e o trecho recuperado é anexado
depois dela. A base responde pelo sobre o quê, não pelo como responder.
Ative em automações e atendimento — o n8n, por exemplo, sempre envia uma
mensagem system própria, então uma chave em "automático" nunca consultaria a
base. Em ferramentas de código (Claude Code, Cursor), prefira desativar: o
trecho recuperado muda a cada pergunta e desfaz o cache de contexto da sessão.
Uma saudação isolada ("oi", "bom dia") não dispara busca, mesmo com a base
ativada. Veja Conceitos básicos e Chat
completions para a regra do
system.
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.