Com a Knowledge Base search, a IA só consulta os seus documentos quando uma pergunta precisa, e você decide exatamente o que ela pode ler. O filtro Documents é a chave: ele limita a IA aos documentos que você escolher. Abra Advanced Parameters no editor de prompts, ative Knowledge Base search e clique nela para configurar a pesquisa.
📘 Quando são guardadas as suas alterações?
As alterações de Tools, Knowledge Base search e Exit conditions são guardadas quando fecha o respetivo painel; JSON output e Conversation history são guardados com o prompt, quando fecha o editor de prompts. Se um campo tiver um erro, uma mensagem deixa-o escolher entre Keep editing e Discard changes. Tudo é guardado na versão rascunho e chega à produção quando publica o seu fluxo. Uma versão em produção é só de leitura: crie um rascunho para a alterar.
📘 Os passos existentes continuam a funcionar como antes
Um passo que já tinha a base de conhecimento ligada continua a consultá-la automaticamente a cada mensagem até configurar e guardar a Knowledge Base search. Desativar o interruptor pede confirmação e elimina a configuração do rascunho: a base de conhecimento deixa de ser consultada.
Filters: decida exatamente o que a IA pode ler
Os filtros são a sua rede de segurança. Limitam os documentos que a pesquisa pode devolver, para que a IA responda apenas com fontes de confiança e nunca com o produto errado, o idioma errado ou um rascunho por publicar. Um documento tem de cumprir todos os seus filtros para ser devolvido. Cada filtro é Off, Fixed ou Let AI decide, exceto Documents, que é Off ou Fixed.
Documents: limite a IA às fontes certas
Documents é o filtro mais poderoso. Ponha-o em Fixed e escolha exatamente que documentos a IA pode ler: ela só se apoiará neles, seja qual for a pergunta do cliente. Use-o para manter um assistente no seu tema (uma oferta, uma marca, uma gama) ou para ligar as respostas sensíveis, como preços, termos legais ou condições, ao documento oficial.
Ponha Documents em Fixed.
Clique no campo de pesquisa, procure um documento pelo título e selecione-o, ou cole o URL ou o ID de um documento para o adicionar diretamente. Selecione quantos documentos precisar.
Os documentos escolhidos aparecem em N selected. Passe o cursor sobre um para pré-visualizar o conteúdo, clique para o abrir e use × para o retirar.
Off deixa toda a sua base de conhecimento ao alcance. A IA nunca escolhe documentos sozinha: este filtro é apenas Off ou Fixed.
Um documento ainda não sincronizado é sinalizado (Syncing, Sync failed) e pode não ser encontrado. Um documento que já não existe é sinalizado como No longer available.
Se um documento selecionado nunca puder ser devolvido por causa de outro filtro, por exemplo um rascunho enquanto State está em Live, um aviso nomeia-o ("N selected document(s) can never be returned with the current state or language filter"). Ajuste os filtros ou a seleção.
Language, State e Folder
Language: apenas documentos redigidos neste idioma.
State: Live por predefinição. Enquanto continuar em Fixed com Live, os rascunhos e os documentos arquivados nunca chegam aos seus utilizadores; também pode escolher Draft ou Archived.
Folder: apenas documentos das pastas da base de conhecimento cujo identificador escrever.
Com Let AI decide, a IA preenche o valor seguindo a Description que escrever para esse filtro.
💡 Combine filtros para enquadrar o seu assistente
Um assistente por oferta: fixe Documents nos documentos dessa oferta.
Só o texto oficial: fixe Documents e mantenha State em Live.
Nunca rascunhos: mantenha State em Fixed com Live.
Configurar a pesquisa
Tool description: indica à IA quando pesquisar.
Search query: com Let AI decide, a IA escreve a consulta seguindo a sua Description. Com Fixed, use a Last user message, um Custom text ou uma única variável. Se a consulta estiver vazia, a pesquisa é ignorada.
Results to return: o número de trechos enviados à IA (10 por predefinição, 100 no máximo). Vários trechos podem vir do mesmo documento.
Pesquisa avançada
Search method: Hybrid (recomendado, combina palavras-chave exatas e significado), Keyword ou Semantic. Em Hybrid, o controlo Keyword / semantic balance vai das palavras-chave exatas (0) ao significado (1).
Rerank results: reordena os trechos por relevância com um modelo de classificação dedicado, para resultados mais precisos. Acrescenta cerca de 0,3 s por pesquisa. Com Passages to rerank (50 por predefinição, entre o número de resultados e 100), escolhe quantos trechos são recolhidos antes de a IA receber os melhores.
Testar a sua pesquisa
Clique em Test search, preencha valores de exemplo e clique em Run search. Results mostra os trechos que a IA receberia, ordenados por pontuação, com a pontuação de reordenação e a posição anterior quando o reranking está ativo. Raw response mostra o JSON devolvido pela pesquisa e View or edit in Knowledge hub abre o documento.
📘 Veja também
Passo Gen AI: os tools · Passo Gen AI: as exit conditions · Gerar com IA