Summary

This PR introduces YAML-defined agents - a new feature that allows administrators to define agents in YAML configuration files. These agents are automatically synchronized to the database at startup and are read-only in the UI, preventing users from modifying them while still allowing usage in conversations and duplication for customization.

Closes: #7741

Key Features:

• YAML Agent Configuration: Define agents with complete configurations including models, tools, instructions, and file resources directly in YAML
• File Resource Management: Automatic processing and embedding of files specified in YAML agent definitions for file_search, execute_code, and OCR tools
• Project Assignment: Configurable project membership for YAML agents with support for global and specific project assignments
• Read-only UI: YAML-defined agents are clearly marked and protected from modifications in the UI
• Startup Sync: Automatic synchronization of YAML agents to database on application startup
• Duplication Support: Users can duplicate YAML agents to create their own customizable versions

Technical Implementation:

• Added isYamlDefined flag to agent schema for identification
• Enhanced file search tool to handle embedding of YAML agent files
• Implemented comprehensive readonly mode throughout the agent UI components
• Added validation and permission checks to prevent unauthorized modifications
• Enhanced agent duplication to properly handle YAML agent properties

Change Type

Please delete any irrelevant options.

• New feature (non-breaking change which adds functionality)
• This change requires a documentation update

Testing

The feature has been tested with:

1. YAML Agent Definition: Created test agents in YAML configuration with various tool resources and file attachments
2. Database Sync: Verified agents are properly synchronized to database on startup
3. UI Readonly Mode: Confirmed YAML agents display as read-only with appropriate UI indicators
4. File Processing: Tested file embedding for file_search tool resources
5. Duplication: Verified users can duplicate YAML agents and modify the copies
6. Permission Checks: Validated all modification attempts are properly blocked for YAML agents
7. Project Assignment: Tested automatic project assignment based on YAML configuration

Checklist

Please delete any irrelevant options.

• My code adheres to this project's style guidelines
• I have performed a self-review of my own code
• I have commented in any complex areas of my code
• I have made pertinent documentation changes
• My changes do not introduce new warnings
• I have written tests demonstrating that my changes are effective or that my feature works
• Local unit tests pass with my changes
• Any changes dependent on mine have been merged and published in downstream modules.
• A pull request for updating the documentation has been submitted: Add documentation for yaml agents LibreChat-AI/librechat.ai#354