Back to Fastgpt

V4.16.0-beta2 (Upgrade Scripts)

document/content/self-host/upgrading/4-16/41602.en.mdx

4.16.03.8 KB
Original Source

πŸ“¦ Upgrade Guide

1. Update images

  • Update the fastgpt-app (FastGPT main service) image tag to v4.16.0-beta2
  • Update the fastgpt-pro (FastGPT commercial edition) image tag to v4.16.0-beta2

2. Clean up legacy system model configurations

This release applies strict schemas when system models are initialized or saved. Numeric strings, serialized price tiers, and missing fields saved by earlier releases may fail initialization validation. After upgrading, run a dry run first to inspect the model configurations that require cleanup. A dry run does not modify data or reload the model cache:

bash
curl -X POST 'https://δ½ ηš„εŸŸε/api/admin/dataClean/cleanSystemModelConfigs' \
  -H 'Content-Type: application/json' \
  -H 'rootkey: δ½ ηš„ROOT_KEY' \
  -d '{"dryRun":true}'

After confirming that invalidSamples contains no records that require manual correction, run the cleanup:

bash
curl -X POST 'https://δ½ ηš„εŸŸε/api/admin/dataClean/cleanSystemModelConfigs' \
  -H 'Content-Type: application/json' \
  -H 'rootkey: δ½ ηš„ROOT_KEY' \
  -d '{"dryRun":false}'

The cleanup converts valid numeric strings to numbers, converts serialized priceTiers values to arrays, and removes invalid optional numeric fields. Invalid or missing required numeric fields use system defaults: LLM maxContext/maxResponse/quoteMaxToken default to 16000/16000/13000, Embedding defaultToken/maxToken default to 500/3000, and price fields default to 0. functionCall remains optional, and a missing Embedding weight defaults to 0.

The cleanup writes the updated data consistently and immediately reloads the system model cache. The runtime cache is rebuilt even when no database record needs an update. The endpoint is safe to run repeatedly; a follow-up dry run should report wouldUpdate as 0. Records that still fail the complete current model schema are not written, and all of them are listed in invalidSamples.

πŸš€ New

  1. Moved Workflow app system settings to a dedicated panel in the canvas toolbar. The panel opens automatically when a new Workflow app is created.
  2. Added support for configuring multiple preset questions separately, with drag-and-drop reordering.

βš™οΈ Improvements

  1. Redesigned the Publish Channels page with separate native and third-party channel groups and a count of configured connections for each channel.
  2. Improved batch updates in the Tool Marketplace. Partially failed updates now remain visible and can be retried or uninstalled individually, with clearer installed-version and update-status information.
  3. Limited portal quick apps to three while preserving compatibility with existing configurations that exceed the limit.
  4. Replaced fixed PDF edge cropping with dynamic edge detection to prevent valid content near page boundaries from being removed.

πŸ› Fixes

  1. Fixed legacy Workflow HTTP tools not restoring the correct default input mode for dynamic parameters.
  2. Fixed incorrect initial configuration labels caused by Workflow translations not being preloaded when an app was created.
  3. Fixed duplicate rendering of Workflow tool parameters.
  4. Fixed file variables not accepting uploads after an app was published.
  5. Fixed file uploads failing for shared Workflow tool parameters.
  6. Fixed upload, parsing, preview, or download failures when S3 object keys or filenames contained spaces or special characters such as %, #, ?, or slashes.
  7. Fixed missing sensitive-data filtering for system default models, preventing model API keys, request URLs, and internal configuration from being returned in system initialization responses.

πŸ› οΈ Code optimizations

  1. Changed audit log retention from deletion to cold archival in S3.
  2. Added validation and cleanup for admin configuration data.
  3. Removed SSR from account/* pages.
  4. Built and published images through CI/CD.