Write File

🤖 AI Drafted (Not reviewed)

Save upstream text to a file on disk (per-file or aggregate).

Tool id	write_file
Category	output
Uses a language model	no
Needs a generative model	no
Runs over many items	no
Item handling	batch
Structured output	no
Human-verified	not yet

What it reads

Port	Type	Required	What it is
Text (text)	text	yes	Text to write (string, list of strings, or dict).
Documents (documents)	json	no	Optional upstream document metadata for filename templating.

What it emits

Port	Type	Required	What it is
Output Files (output_files)	array	—	Absolute paths of files written.
Count (count)	number	—	Number of files written.

Options

Option	Type	Default	What it does
aggregate_separator	string	—	Separator between records in aggregate mode.
filename_template	string	{doc_name}-{tool}-{model}.{ext}	Filename template. Placeholders: {doc_name}, {tool}, {model}, {provider}, {ext}, {index}.
format	string	txt	Output file format (chooses extension + content encoding). One of: txt, md, json.
mode	string	per_file	per_file writes one file per upstream doc; aggregate writes one combined file for the whole run. One of: per_file, aggregate.
output_dir	string	—	Folder to write files into (absolute path).

The prompt it sends

This tool does not send a prompt — it does its work in code.