File Management in Brightsy AI provides capabilities for storing, organizing, and accessing documents and media. The File Manager is accessible through the main navigation and integrates seamlessly with AI agents through specialized tools.
Features & Capabilities
- Hierarchical Storage: Organize files in folder structures
- Search Functionality: Find files by name, content, or metadata
- Access Control: Permission-based file access
- File Operations: Upload, download, move, rename, and delete files
- File References: Link files in messages, records, and forms
- Format Support: Handle various document and media formats
- AI Integration: Agents can access and manage files through specialized tools
AI Agent Tools
Agents configured with file management tools can perform file operations autonomously. These tools are available when configuring agents in the Agents section.
Available File Tools
When you add file management capabilities to an agent, they gain access to these tools:
list_files: Browse directory contents and search for filescreate_folder: Create new folders for organizationupload_file: Upload new files with base64-encoded contentget_file_content: Read file content and metadatamove_file: Move or rename files and foldersdelete_file: Remove files or folders
Configuring File Tools for Agents
- Navigate to Agents → Select your agent → Edit
- In the Tools section, enable file management tools
- Configure file access permissions and allowed paths
- Save and test the agent with file operations
Example Agent Interactions
Listing Files:
User: Show me all PDF files in the documents folder Agent: [uses list_files tool] Agent: I found 5 PDF files in the documents folder: - report_2024.pdf - proposal.pdf - contract_final.pdf - meeting_notes.pdf - invoice_march.pdf
Uploading Files:
User: Create a new file called "summary.txt" with the content "Project completed successfully" Agent: [uses upload_file tool] Agent: I've created summary.txt in the files folder with your content.
Organizing Files:
User: Move all PDF files from documents to an archive folder Agent: [uses create_folder and move_file tools] Agent: I've created an archive folder and moved all 5 PDF files there.