File

Read, fetch, write, and append 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 workspace files by picker or canonical ID, fetch and parse files from URLs with optional headers, write new workspace files, or append content to existing files.

Tools

file_fetch

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
filefileFirst workspace file object (read)
filesfile[]Workspace file objects (read) or fetched file objects (fetch)
combinedContentstringAll fetched file contents merged into a single text string (fetch)
idstringFile ID (write)
namestringFile name (write)
sizenumberFile size in bytes (write)
urlstringURL to access the file (write)

file_read

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
filefileFirst workspace file object (read)
filesfile[]Workspace file objects (read) or fetched file objects (fetch)
combinedContentstringAll fetched file contents merged into a single text string (fetch)
idstringFile ID (write)
namestringFile name (write)
sizenumberFile size in bytes (write)
urlstringURL to access the file (write)

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