Skip to content

Knowledge nodes

These nodes work with datasources of the Semantic Query Engine. For the concepts, see Knowledge and Search.

Configuration node with the client credentials for the Semantic Query Engine. All knowledge nodes in a flow can share it. Each node can select a datasource or receive it in msg.payload.datasource.

Use these nodes to build ingestion pipelines.

NodeWhat it doesInput
List DocumentsLists the document IDs of a datasource, page by page.Optional msg.payload.cursor for the next page
Upsert DocumentCreates or updates documents. Send an array for batches.msg.payload or msg.payload.documents
Get DocumentReturns one document.msg.payload.doc_id
Delete DocumentDeletes one document.msg.payload.doc_id

For document IDs, metadata and text preparation, see Ingesting documents and Ingestion best practices.

NodeWhat it doesMain settings
RetrieveSemantic searchsearch, similarity_top_k
Retrieve with RerankSemantic search with a second ranking for higher precisionsearch, search_context, similarity_top_k, rerank_top_n
Retrieve HybridSemantic and keyword search, good for part numbers and error codessearch, similarity_top_k, sparse_top_k
Filter DatasourceReturns documents by metadata only, without semantic searchmetadata_filters, top_k, sort

All search nodes accept an optional metadata_filters expression, for example and(eq(device_model,"CAM-45"),eq(document_type,"manual")). See Search and filters.

If a request fails, the node sends:

{
"payload": null,
"error": { "message": "…", "status": 404, "datasource": "ProductManuals" }
}