Knowledge

Use vector search

Configuration

Operation
Search
Knowledge Base*
Select knowledge base
Search Query
Enter your search query (optional when using tag filters)
Number of Results
Enter number of results (default: 10)
Tag Filters
Add tag filters
Available in Advanced mode.
Search (knowledge_search)

Search a knowledge base by query, text tag equality, or both. Repeated values for one tag use OR; different tags use AND.

Input
ParameterTypeRequiredDescription
knowledgeBaseIdstringYesID of the knowledge base to search in
querystringNoSearch query text (optional when using tag filters)
topKnumberNoNumber of most similar results to return (1-100)
tagFiltersarrayNoText-equality filters with tagName and tagValue. Repeated tag names are OR alternatives; different tags are combined with AND.
Output
ParameterTypeDescription
resultsarrayArray of search results from the knowledge base
results[].documentIdstringDocument ID
results[].documentNamestringDocument name
results[].contentstringContent of the result
results[].chunkIndexnumberIndex of the chunk within the document
results[].similaritynumberSimilarity score of the result
results[].metadataobjectMetadata of the result, including tags
querystringThe search query that was executed
totalResultsnumberTotal number of results found
costobjectCost information for the search operation

Upload Chunk

Operation
Upload Chunk
Knowledge Base*
Select knowledge base
Document*
Select document
Chunk Content*
Enter the chunk content to upload
Upload Chunk (knowledge_upload_chunk)

Upload a new chunk to a document in a knowledge base

Input
ParameterTypeRequiredDescription
knowledgeBaseIdstringYesID of the knowledge base containing the document
documentIdstringYesID of the document to upload the chunk to
contentstringYesContent of the chunk to upload
Output
ParameterTypeDescription
dataobjectInformation about the uploaded chunk
data.chunkIdstringChunk ID
data.chunkIndexnumberIndex of the chunk within the document
data.contentstringContent of the chunk
data.contentLengthnumberLength of the content in characters
data.tokenCountnumberNumber of tokens in the chunk
data.enabledbooleanWhether the chunk is enabled
data.createdAtstringCreation timestamp
data.updatedAtstringLast update timestamp
messagestringSuccess or error message describing the operation result
documentIdstringID of the document the chunk was added to
documentNamestringName of the document the chunk was added to
costobjectCost information for the upload operation

Create Document

Operation
Create Document
Knowledge Base*
Select knowledge base
Document Name*
Enter document name
Document Content*
Enter the document content
Document Tags
Document Tags
Create Document (knowledge_create_document)

Create a new document in a knowledge base

Input
ParameterTypeRequiredDescription
knowledgeBaseIdstringYesID of the knowledge base containing the document
namestringYesName of the document
contentstringYesContent of the document
documentTagsDataarrayNoStructured tag data with names, types, and values
Output
ParameterTypeDescription
dataobjectInformation about the created document
data.documentIdstringDocument ID
data.documentNamestringDocument name
data.typestringDocument type
data.enabledbooleanWhether the document is enabled
data.createdAtstringCreation timestamp
data.updatedAtstringLast update timestamp
messagestringSuccess or error message describing the operation result
documentIdstringID of the created document

Input

ParameterTypeRequiredDescription
operationstringNoOperation to perform
knowledgeBaseIdstringNoKnowledge base identifier. Shown when operation is one of 'search', 'upload_chunk', 'create_document'.
querystringNoSearch query terms. Shown when operation is 'search'.
topKnumberNoNumber of results. Shown when operation is 'search'.
documentIdstringNoDocument identifier. Shown when operation is 'upload_chunk'.
contentstringNoContent data
namestringNoDocument name. Shown when operation is 'create_document'.
tagFiltersstringNoTag filter criteria. Shown when operation is 'search'.
documentTagsstringNoDocument tags. Shown when operation is 'create_document'.

Output

ParameterTypeDescription
resultsjsonSearch results
querystringQuery used
totalResultsnumberTotal results count

Usage Instructions

Search a knowledge base, upload chunks, or create documents. Search accepts a query, text tag filters, or both. Tag equality is case-insensitive; repeated values for the same tag use OR and different tags use AND. Tag-only searches do not generate a query embedding. Unknown tags and unsupported filter operators are rejected. Write operations return confirmation data under data, not results.

Notes

  • Category: blocks
  • Type: knowledge