This page documents all new features and configuration details for FastGPT version 4.16.0, targeted at self-hosted engineers and technical decision makers.
Core Runtime & Workflow Enhancements
The Agent Sandbox now operates at the App-user level, sharing a single sandbox across multiple sessions from the same user and application while maintaining strict file isolation via separate session directories. Sandbox HTML content and attached files can be previewed directly through short-lived, read-only links without re-uploading to object storage. For workflow applications, automatic archiving and restoration of workspaces occurs when the sandbox provider or runtime image changes, with upgrades completing silently during active runs to avoid downtime. Workflow application system settings have been moved to a dedicated panel in the canvas toolbar, which automatically opens when a new workflow app is created. Users can also configure multiple preset questions with drag-and-drop reordering for improved content organization.
Tool & Agent Configuration Updates
Workflow tool nodes now support delegating selected input parameters to the Agent for generation, while preserving fixed values, citations, and original user inputs to maintain consistency. ChatAgent tool selection includes explicit controls to define whether parameters should be generated by AI, giving finer granularity over tool execution behavior.
Dataset & File Management Features
This release adds support for custom metadata fields on dataset data, which can be imported via API, API JSON, CSV templates, or Excel templates. Search results and backup exports preserve these custom metadata fields, while template and backup imports accept both .csv and .xlsx files with standardized headers. The table below outlines required import formats:
| File Type | Required Headers | Format Rules |
|---|---|---|
| CSV | q, a, metadata, index | q, a, and metadata each use one column; index may use multiple columns in any order |
| Excel | Same as CSV | Single worksheet, no merged cells |
Each field has specific requirements: q and a are required single-column fields for question/input and response/answer text respectively; metadata is an optional single-column field for custom stored data; index is an optional 1+ column field for custom identifiers. Parsing failures for CSV or Excel import files will trigger the explicit error string invalid file format. Large-file chunked uploads are now supported for dataset, file, and asset management. Administrator-configured system tool keys are now encrypted at rest, with full backward compatibility for existing stored keys.
UI & Skill Management Improvements
The Skill list now includes empty-state guidance to assist new users navigating the interface, and users can directly create linked skills from the Skill selector to streamline workflow construction.