feat: expand FileManagerController with specialized agent file management endpoints
🎯 Overview
This MR expands the FileManagerController with specialized endpoints for managing different types of agent-related files, providing better granularity and organization for file operations.
📝 Changes
New Upload Endpoints
- General Agent Families KB Files: Upload shared knowledge base files accessible to all agent families
- Specific Agent Family KB Files: Upload knowledge base files for specific agent families
- N8N Workflow Templates: Upload main workflow template files for agent families
- Agent Knowledge Documents: Upload knowledge documents for individual agents
- Message Attachments: Upload file attachments for agent conversations
New Retrieval Endpoints
- GET General Agent Families KB Files: Retrieve shared knowledge base files
- GET Main N8N Workflow Template: Retrieve workflow template metadata
- GET Specific Agent Knowledge Documents: Retrieve documents for individual agents
- GET Agent Message Attachments: Retrieve conversation attachments
- GET Workflow Template Content: Retrieve JSON content of N8N workflow templates
Improvements
-
✅ Better endpoint organization with dedicated sections -
✅ Enhanced API documentation with detailed operation descriptions -
✅ Improved file type separation for different use cases -
✅ More granular control over agent-related file management
🔄 Breaking Changes
-
⚠ ️ Replaced singleuploadAgentFamilyKnowledgeBaseFilesendpoint with separateuploadGeneralAgentFamiliesKnowledgeBaseFilesanduploadSpecificAgentFamilyKnowledgeBaseFilesendpoints
📊 Impact
- 10 new endpoints added
- Better file management capabilities for agent systems
✅ Testing
-
All new endpoints tested with valid inputs -
Error handling verified for invalid requests -
API documentation reviewed and validated
Closes IAV-86