Como construir uma base de conhecimento para um assistente
Para construir uma base de conhecimento para um assistente, começa pelas perguntas que ele precisa de responder. Reúne fontes autorizadas, organiza cada assunto com contexto e identifica a versão válida. Depois testa se o assistente encontra a informação certa, reconhece o que falta e mantém essas respostas corretas quando os documentos mudam.

Vamos trabalhar um exemplo concreto: um centro de formação fictício que quer ajudar a equipa a responder a dúvidas sobre workshops. Vais criar um inventário, preparar uma ficha consultável e definir testes. O exercício organiza conhecimento; não instala um chatbot nem liga automaticamente os teus documentos a uma ferramenta.
Que informação deve entrar na primeira versão?
Escolhe um conjunto pequeno de perguntas que a tua equipa recebe e consegue verificar. Para cada pergunta, identifica a fonte que contém a resposta e quem pode confirmar a sua validade. A primeira versão deve cobrir um assunto delimitado, com lacunas visíveis, para conseguires avaliar o resultado antes de acrescentar mais documentos.
No centro fictício, as perguntas iniciais são: que conhecimentos são necessários para participar, que material deve o participante levar e onde encontra os exercícios? Isto permite começar com informação pedagógica relativamente estável. Preços, vagas e pagamentos ficam fora desta primeira versão, porque exigem outras fontes e atualização.
Recolhe perguntas na linguagem de quem as faz. «Tenho de saber programar?» e «Quais são os pré-requisitos?» podem procurar a mesma informação. Guarda ambas como exemplos, sem duplicar a regra em vários ficheiros. Mais tarde vais usá-las para conferir se a pesquisa reconhece diferentes formulações.
Escreve também o limite: o assistente pode explicar o conteúdo disponível, mas não confirmar uma inscrição nem alterar acessos. Uma resposta sobre um procedimento não equivale à execução desse procedimento. Esta distinção evita desenhar uma base documental como se ela já tivesse ligações operacionais ao negócio.
Se ainda não decidiste que materiais podem ser usados, consulta primeiro o guia sobre escolher os documentos que um assistente pode consultar. Aqui vamos partir desse conjunto autorizado e trabalhar a sua organização, transformação e manutenção.
Como criar um inventário que acompanhe os ficheiros?
Cria uma tabela em que cada fonte tem identificador, título, localização, versão, estado e responsável. Acrescenta a data de revisão e as perguntas que consegue apoiar. O inventário permite perceber o que entrou na base, o que foi substituído e o que continua em falta, sem depender da memória de uma conversa.
Não precisas de uma aplicação nova para começar. Uma folha de cálculo pode registar o inventário, enquanto os originais permanecem na pasta ou sistema onde já são mantidos. O ponto essencial é conseguires ligar cada texto consultável ao documento que lhe deu origem e à pessoa que o validou.
Este inventário reduzido é um exemplo editorial. Os nomes, documentos e condições pertencem ao centro fictício, não descrevem a oferta do Laboratório da IA.
| Identificador | Fonte e versão | Cobertura | Estado e responsável |
|---|---|---|---|
| KB001 | Guia do workshop de automações, v2 | Pré-requisitos e preparação | Ativo; coordenação pedagógica |
| KB002 | Guia de materiais, v1 | Localização dos exercícios | Ativo; equipa de apoio |
| KB003 | Guia do workshop de automações, v1 | Preparação anterior | Arquivado; coordenação pedagógica |
| LAC001 | Fonte ainda não identificada | Vagas disponíveis | Lacuna; equipa comercial |
Na tua tabela completa, acrescenta o caminho ou ligação real, a data da última conferência e o público autorizado. Para uma lacuna, não inventes um endereço de documento. Regista o que falta obter, quem deve confirmar e o efeito dessa ausência nas respostas.
Distingue a data de publicação da data em que recolheste o ficheiro. Um PDF descarregado hoje pode conter condições antigas. Também podes ter uma revisão recente que só corrigiu uma gralha. Regista o significado de cada data para não usar «mais recente» como sinónimo automático de «aplicável».
Como transformar um documento numa ficha consultável?
Lê a fonte original e cria secções com títulos que descrevam as perguntas respondidas. Mantém condições, exceções e referências junto da informação a que pertencem. Guarda a ligação ao original e identifica o que foi transcrito, resumido ou acrescentado como orientação editorial, para poderes conferir a ficha sem reconstruir todo o processo.
Para o exercício, cria um documento chamado «KB001, preparação do workshop, v2». No início, escreve o título da fonte, a versão, o estado ativo, o público interno e o responsável pela revisão. Em seguida, organiza três secções: pré-requisitos, preparação e assuntos não cobertos.
O conteúdo fictício da primeira secção é: «O workshop introdutório de automações não exige programação. Pressupõe que o participante consegue criar uma folha de cálculo e introduzir dados. Quem ainda não faz estas tarefas deve concluir primeiro o exercício de preparação indicado pela equipa.»
A segunda secção diz: «Para acompanhar os exercícios, o participante deve levar um computador portátil com navegador atualizado. Pode usar dados fictícios durante a prática. Os ficheiros de exercício são disponibilizados na área reservada do centro; o guia KB002 explica onde os encontrar.»
Na terceira secção escreve: «Esta ficha não confirma vagas, preços, pagamentos ou inscrições. Esses assuntos exigem consulta da fonte atual pela equipa responsável.» Assim, o documento contém uma regra, uma condição e o seu limite, em vez de uma lista de frases soltas que parecem responder a tudo.
Este texto foi criado para o exercício e não resulta da extração de um documento real. Quando trabalhares com o teu material, confere a ficha frase a frase contra a origem. Um resumo que elimina a preparação obrigatória muda a resposta, mesmo que conserve a frase sobre não ser necessário programar.
Como dividir textos longos sem perder o contexto?
Organiza documentos extensos em unidades que façam sentido por si mesmas, preservando o assunto, a origem e as condições relevantes. Uma secção deve permitir compreender a regra sem depender de uma exceção escondida noutra parte. Experimenta a divisão com perguntas reais e ajusta-a quando a resposta recuperar apenas uma parte incompleta da informação.
A documentação da Microsoft sobre divisão de documentos para pesquisa descreve abordagens por tamanho, estrutura e significado. O tamanho adequado depende do conteúdo e do uso. Não há um número universal de palavras que torne qualquer documento pronto para um assistente.
Na ficha do centro, «não exige programação» deve continuar associado ao requisito de saber criar uma folha de cálculo. Separar estas frases em unidades sem contexto facilita uma resposta incompleta a quem pergunta se pode participar sem qualquer preparação. Mantém o título da secção e a referência da ficha disponíveis.
Tabelas merecem atenção especial. Se uma linha contém uma condição e outra coluna identifica a modalidade a que se aplica, não transformes cada célula numa frase isolada. Confere se o texto extraído preserva cabeçalhos, unidades e relações. Faz o mesmo com notas de rodapé e indicações colocadas em imagens.
Quando a plataforma faz a divisão automaticamente, procura formas de inspecionar ou testar o resultado. Mesmo sem acesso aos excertos internos, podes fazer perguntas que dependam das condições e conferir a resposta contra a fonte. Se o teste falhar, regista a limitação em vez de concluir que o documento foi interpretado integralmente.

O que distingue a base de conhecimento das instruções?
A base de conhecimento contém informação que o assistente pode consultar. As instruções definem como deve trabalhar com essa informação, responder e reconhecer limites. Mantém estes elementos separados para poderes atualizar uma regra do negócio sem reescrever o comportamento do assistente, e ajustar o comportamento sem alterar silenciosamente as fontes que sustentam as respostas.
Uma instrução inicial para o exercício pode ser: «Responde às perguntas sobre preparação usando as fichas ativas. Indica o identificador e a secção que sustentam a resposta. Preserva requisitos e exceções. Quando faltar informação ou houver conflito sem resolução, explica o limite e identifica a equipa responsável pela confirmação.»
Esta instrução não transforma documentos em permissões nem garante que todas as respostas sejam corretas. Serve para explicitar o comportamento que vais avaliar. Se o sistema disponibilizar documentos a pessoas que não deveriam vê-los, escrever «não reveles» nas instruções não substitui o controlo de acesso adequado.
Carregar ficheiros também não equivale a treinar um novo modelo. Num sistema com pesquisa em fontes, são recuperados conteúdos relevantes para apoiar a resposta. A visão geral da Microsoft sobre RAG e pesquisa de conhecimento explica este padrão e destaca desafios de relevância, limites de contexto e acesso autorizado.
A escolha técnica vem depois dos requisitos. Uma base pequena pode ser preparada e revista sem montares infraestrutura de pesquisa própria. Se precisares de pesquisa em muitos documentos ou de integrações, confirma as capacidades da ferramenta e a forma como mantém fontes e permissões. O exercício não exige contratar um serviço específico.
Como tratar versões antigas e regras contraditórias?
Define qual documento está ativo, a partir de quando se aplica e que versão substitui. Preserva o histórico num local identificado, mas evita que versões retiradas continuem a responder como atuais. Se duas fontes válidas discordarem, pede uma decisão ao responsável e regista a resolução antes de apresentar uma regra única ao utilizador.
Imagina que a versão antiga KB003 dizia que bastava um telemóvel para acompanhar o workshop. A versão KB001 v2 exige portátil para realizar os exercícios. No exemplo, a coordenação confirmou que a segunda substitui a primeira para o workshop atual. Essa decisão deve ficar registada, não ser deduzida pelo assistente a partir do nome do ficheiro.
Há situações em que duas versões continuam válidas para públicos diferentes. Um guia pode aplicar-se a uma turma anterior e outro à turma atual. Nesses casos, preserva o contexto de aplicação e pede a informação que falta ao utilizador. Não escolhas sempre o ficheiro com a data mais recente.
Para treinar a tua revisão, coloca as duas fichas num conjunto de teste separado e pergunta que equipamento é necessário. Se não forneceste uma regra de vigência ou contexto suficiente, a resposta esperada deve reconhecer o conflito. Só depois de acrescentares a decisão confirmada deves esperar uma resposta única.
O guia sobre comparar documentos e encontrar contradições com IA desenvolve esta análise. Usa a IA para localizar diferenças e preparar perguntas ao responsável. A confirmação de uma política pertence a quem tem autoridade para a definir.
Que testes mostram se a base está pronta para uso?
Cria uma lista de perguntas com a resposta esperada, a fonte necessária e o comportamento aceitável quando falta informação. Inclui perguntas diretas, formulações alternativas, casos com exceções e pedidos fora do âmbito. Executa os testes na ferramenta escolhida e guarda os resultados observados, sem confundir uma resposta convincente com uma resposta comprovada.
O primeiro teste do centro é «Preciso de programar?». A resposta deve dizer que não, mas preservar o requisito de saber criar uma folha de cálculo e introduzir dados. Uma resposta que termina apenas em «não precisas de conhecimentos prévios» falha, porque elimina uma condição explícita.
O segundo teste é «Posso fazer os exercícios só com o telemóvel?». Com a versão atual identificada, a resposta deve indicar o portátil. O terceiro é «Quantas vagas ainda existem?». Como a base não contém essa informação, deve reconhecer a ausência e encaminhar para a equipa comercial, sem inventar um número.
O quarto teste pergunta onde estão os exercícios. A resposta pode indicar a área reservada, mas não deve inventar um endereço. Se KB002 ainda não estiver disponível, deve declarar que falta o guia com a localização detalhada. Uma referência para um documento ausente não prova que o seu conteúdo foi consultado.
Acrescenta um teste de acesso com uma conta de destinatário autorizada, quando houver partilha real. Confirma que essa conta só alcança os materiais previstos. Esta verificação avalia o sistema de acesso; os testes de perguntas anteriores avaliam conteúdo e respostas. São resultados diferentes, e ambos precisam de evidência própria.
Os resultados aqui descritos são critérios esperados do exercício. Não representam uma avaliação executada num produto ou numa conta. Quando os aplicares, regista o que a tua ferramenta efetivamente respondeu, a versão da base e a correção necessária.
Como descobrir se a falha está na pesquisa ou na resposta?
Quando uma resposta falhar, verifica primeiro se a informação correta existe na base e está acessível à consulta. Depois procura evidência de que foi recuperada e usada. Esta sequência ajuda a separar uma lacuna documental de um problema de pesquisa ou de interpretação, para corrigires a causa em vez de acrescentares documentos indiscriminadamente.
Se a condição sobre folhas de cálculo não entrou na ficha, o problema está na preparação do conteúdo. Se entrou mas a pesquisa só devolveu a frase sobre programação, investiga a organização e recuperação. Se ambas foram recuperadas e a resposta omitiu a condição, revê o comportamento e repete o teste.
Nem todas as ferramentas mostram os excertos recuperados. Quando não consegues observar essa etapa, regista a incerteza. Podes testar com uma pergunta mais específica ou uma fonte isolada, mas não afirmar que descobriste uma causa interna apenas porque a resposta mudou.
Abre sempre a referência apresentada para conferir a afirmação importante. O artigo sobre verificar uma citação apresentada por um assistente mostra como procurar a passagem, a autoria e o contexto. Uma ligação correta pode acompanhar uma interpretação errada.
Corrige uma variável de cada vez e guarda o antes e o depois. Se mudares simultaneamente documentos, instruções e ferramenta, torna-se difícil saber o que resolveu o problema. Reutiliza as perguntas anteriores para confirmar que a alteração não estragou respostas que já estavam corretas.
Como manter a base atualizada sem refazer tudo?
Atribui um responsável a cada conjunto de informação e define o que desencadeia uma revisão. Uma mudança de procedimento, uma nova edição do workshop ou uma resposta incorreta pode exigir atualização imediata. Depois de alterar a fonte, confere a versão consultável, repete os testes afetados e regista quando a mudança ficou efetivamente disponível.
No exemplo, se a preparação passar a exigir outro material, a coordenação atualiza a ficha e identifica a versão substituída. Quem mantém o assistente confirma que a versão nova foi carregada ou sincronizada, segundo o funcionamento da ferramenta. O simples ato de editar o original não prova que o assistente já recebeu a mudança.
Mantém uma lista curta de alterações: documento, motivo, responsável, versão anterior, nova versão e testes repetidos. Guarda o histórico necessário para perceber uma resposta antiga, mas evita que esse arquivo seja confundido com a base ativa. Também os links para materiais retirados devem ser revistos.
Para informação que muda rapidamente, como vagas ou disponibilidade, avalia uma consulta atual ao sistema responsável. Uma cópia de uma página é válida apenas para o momento que representa. A integração precisa de autorização, tratamento de falhas e indicação do que acontece quando não há resposta atual.
A tua primeira entrega pode ser simples: inventário preenchido, fichas revistas, regras de uso e uma lista de testes com resultados. A partir daí, tens uma base concreta para melhorar. O objetivo é conseguires explicar de onde vem cada resposta importante e como a manténs correta ao longo do tempo.
Aprende no Laboratório a organizar conhecimento para os teus assistentes
No Laboratório da IA podes aprender a preparar fontes, estruturar processos e testar assistentes aplicados ao teu trabalho. As aulas semanais e os Zooms de acompanhamento semanais ajudam-te a transformar documentação dispersa num projeto com perguntas concretas, limites definidos e uma forma de verificar os resultados.
Este guia adapta unidades revistas de João Carvalho sobre fontes para assistentes, da equipa de suporte, de Sara e Márcia, de Paula Ribeiro e de Roberto Cortez, além da biblioteca introdutória de pesquisa e RAG. O centro de formação e as fichas são exemplos editoriais fictícios. Referências oficiais consultadas em 17 de outubro de 2026.
Leva um conjunto pequeno de documentos autorizados e três perguntas que a tua equipa recebe. Podes começar por organizar esse material, identificar o que falta e preparar os primeiros testes antes de alargar a base a outros assuntos.
Aprende a construir isto no Lab.
Trabalha o processo com aulas, materiais e acompanhamento. Leva o que estás a construir e esclarece as dúvidas da tua implementação.
- Criar um inventário e fichas consultáveis com origem, versão, âmbito e responsável.
- Testar respostas, lacunas e conflitos antes de ampliar a base de conhecimento.
- Trabalhar o teu projeto nas aulas semanais e nos Zooms de acompanhamento semanais do Laboratório.
Aulas semanais para aprender e aplicar. Zooms de acompanhamento semanais para esclarecer dúvidas. Replay e materiais para retomar o trabalho ao teu ritmo.
Entrar no Laboratório da IA