Skip to main content
Use Write to Knowledge Base when you want a workflow step to add new content to one of your knowledge bases. Each run creates a new knowledge base item so that the full history of writes is preserved.

Configuration

OptionRequiredDescription
NameNoLabel for the step in the workflow canvas.
Knowledge BaseYesThe target knowledge base selected in Knowledge Base.
Write ModeYesOne of Text, Document, or Scrape.
ContentYes (Text mode)The text to embed. This field supports workflow variables through Insert Variable.
Website URLYes (Scrape mode)The URL to scrape.
Chunking StrategyNoDefault uses deterministic paragraph- and sentence-aware chunking. Advanced uses the same chunker and lets you set Max Chunk Length and Chunk Overlap manually.
Remove Email AddressesNoWhen enabled, strips email addresses from the content before embedding.
Remove Phone NumbersNoWhen enabled, strips phone numbers from the content before embedding.
When the step failsNoControls whether the workflow should Terminate Workflow or Continue if this step fails.

Write Mode

Text — Enter raw text directly in Content or pipe in a prior step’s output using {{step_n.output}}. Document — Attach a document to the step. The content is extracted automatically and embedded into the knowledge base. Scrape — Enter a URL in Website URL. Fetch Hive scrapes the page and embeds the extracted text.

Chunking Strategy

Leave Chunking Strategy set to Default for most use cases. Fetch Hive preserves paragraph and sentence boundaries where possible, and only falls back to hard splitting when a single unit is too large. Switch to Advanced to control exactly how the content is split:
  • Max Chunk Length — Maximum number of characters per chunk (default 500).
  • Chunk Overlap — Number of characters shared between adjacent chunks (default 50). Overlap helps preserve context at chunk boundaries.

PII Removal

Enable Remove Email Addresses and/or Remove Phone Numbers to redact those values from the content before it is embedded and stored.

Output

This step returns a summary of the write operation:
{
  "knowledge_base_item_id": "...",
  "knowledge_base_id": "...",
  "chunk_count": 12,
  "status": "completed",
  "write_mode": "custom_text"
}
Reference the output in a later step:
{{step_2.output}}
{{step_2.output.chunk_count}}

Cost

Each run of this step costs 1 task.

Example

Add Write to Knowledge Base from the Knowledge Base group in Search steps…. Set Knowledge Base to the target knowledge base. Choose Write Mode. For a pipeline that summarises web articles, select Scrape and set Website URL to {{step_1.output.url}}. Leave Chunking Strategy as Default unless you need precise control over chunk size. Enable Remove Email Addresses if the scraped content may contain personal data. Click Run in the step header to test the write, then check Output to confirm the chunk count and item ID.

Notes

  • Each run creates a new knowledge base item. Prior items written by earlier runs are not overwritten, so the full write history is preserved in the knowledge base.
  • The step validates that a knowledge base is selected and that the required input for the chosen mode is present before running.
  • Chunking and PII removal are applied before the content is embedded.
See also: Search Knowledge Base, Creating and Editing, Testing and Iteration, and Error Handling