File

Read and write workspace files

The File Parser tool provides a powerful way to extract and process content from various file formats, making it easy to incorporate document data into your agent workflows. This tool supports multiple file formats and can handle files up to 200MB in size.

With the File Parser, you can:

  • Process multiple file formats: Extract text from PDFs, CSVs, Word documents (DOCX), text files, and more
  • Handle large files: Process documents up to 200MB in size
  • Parse files from URLs: Directly extract content from files hosted online by providing their URLs
  • Process multiple files at once: Upload and parse several files in a single operation
  • Extract structured data: Maintain formatting and structure from the original documents when possible

The File Parser tool is particularly useful for scenarios where your agents need to work with document content, such as analyzing reports, extracting data from spreadsheets, or processing text from various document sources. It simplifies the process of making document content available to your agents, allowing them to work with information stored in files just as easily as with direct text input.

Usage Instructions

Read and parse files from uploads or URLs, write new workspace files, or append content to existing files.

Tools

file_parser

Parse one or more uploaded files or files from URLs (text, PDF, CSV, images, etc.)

Input

ParameterTypeRequiredDescription
filePathstringNoPath to the file(s). Can be a single path, URL, or an array of paths.
filefileNoUploaded file(s) to parse
fileTypestringNoType of file to parse (auto-detected if not specified)

Output

ParameterTypeDescription
filesfile[]Parsed files as UserFile objects
combinedContentstringCombined content of all parsed files

file_write

Create a new workspace file. If a file with the same name already exists, a numeric suffix is added (e.g.,

Input

ParameterTypeRequiredDescription
fileNamestringYesFile name (e.g., "data.csv"). If a file with this name exists, a numeric suffix is added automatically.
contentstringYesThe text content to write to the file.
contentTypestringNoMIME type for new files (e.g., "text/plain"). Auto-detected from file extension if omitted.

Output

ParameterTypeDescription
idstringFile ID
namestringFile name
sizenumberFile size in bytes
urlstringURL to access the file

file_append

Append content to an existing workspace file. The file must already exist. Content is added to the end of the file.

Input

ParameterTypeRequiredDescription
fileNamestringYesName of an existing workspace file to append to.
contentstringYesThe text content to append to the file.

Output

ParameterTypeDescription
idstringFile ID
namestringFile name
sizenumberFile size in bytes
urlstringURL to access the file

On this page