Skip to content

Integrate with Local File System

Samurai AI can integrate with the local file system to retrieve and organize files.

01. Select External Connector on Workflow Screen

Section titled “01. Select External Connector on Workflow Screen”

Create a workflow app in Studio and add an external connector.

After placing the external connector, click the node to open the prompt settings screen.

External connector

Select “Filesystem” from “Add Tool” at the bottom right of the external connector panel.

Select file operation from Add Tool

Here, set a prompt in the user prompt to get a list of PDF files.

By including the folder location (full path) in the prompt, AI can identify files more accurately.

To operate under the samurai download on Mac:

Search for PDF files (*.pdf) from /Users/username/.samurai/Downloads and display a file list.

※ Replace username with your PC’s username.

Local file system

In “Select allowed directories”, select the directories that AI can access.

  • Documents: Documents folder
  • Downloads: Downloads folder
  • Desktop: Desktop folder
  • Pictures: Pictures folder
  • Samurai Downloads: Storage location for files acquired by Samurai during workflow execution

Directory path formats differ by OS. Please refer to the following.

DirectoryPath Example
DocumentsC:\Users\username\Documents
DownloadsC:\Users\username\Downloads
DesktopC:\Users\username\Desktop
PicturesC:\Users\username\Pictures
Samurai DownloadsC:\Users\username\.samurai\Downloads
DirectoryPath Example
Documents/Users/username/Documents
Downloads/Users/username/Downloads
Desktop/Users/username/Desktop
Pictures/Users/username/Pictures
Samurai Downloads/Users/username/.samurai/Downloads

Using the Filesystem connector, you can retrieve and organize local files within selected folders.

Just by giving instructions in natural language in prompts, AI will execute the following operations:

  • File reading: Read the contents of text files, PDFs, image files, audio files (mp3, wav, ogg, etc.), and Microsoft Office formats (docx, xlsx, pptx)
  • File writing: Create and edit new text files
  • Folder operations: Create folders, get file lists, check hierarchical structure
  • File operations: Search, move, and rename files