What the data for this category looks like
Residential development marketing-related data comes primarily from sales office operation ledgers, official floor plan PDFs, pre-sale permit public documents, surrounding facility location maps, long-format property brochures, and Moments marketing copy. Data update rhythm changes with project milestones: Weekly updates for pre-sale permits, model open dates and similar information before launch. Monthly updates for sales performance and offline event schedules after launch. Document structure includes structured tables (pre-sale permit information, floor plan parameter tables) and unstructured text (brochures, event copy). Fixed fields include 建筑面积, 套内面积 (both measured in square meters), 预售证号, 开盘时间, 周边配套距离 (measured in meters), and other fixed attributes.
What constraints do these characteristics impose on deployment and upgrade
Mixed structured and unstructured data types require deploying both document parsing modules and structured data access interfaces during deployment. This avoids single parsing rules failing to adapt to all materials. High-frequency updated project node data requires supporting incremental sync configuration during upgrades. Full re-upload of all marketing materials is not required each time. Fixed field and unit requirements need field validation rules configured during deployment. This prevents unit confusion or missing fields in parsed text. Coexisting long-format brochures and short copy requires retaining differentiated configuration for segmentation and recall during upgrades. This avoids uniform rules causing short copy matching failures or incomplete long text parsing.
How to set configurations
| Configuration Item | Recommended Value | Rationale |
|---|---|---|
UPLOAD_FILE_MAX_SIZE | 1000 MB | Single files of residential development floor plans and brochures typically do not exceed 800 MB, with reasonable redundant space reserved |
PARSE_FILE_TIMEOUT_SECONDS | 600 seconds | Large brochure PDFs require longer processing time, avoiding parsing failure due to timeout |
maxContext | 800–1200 characters | Meets context length requirements for matching core residential marketing information, balancing recall accuracy and response speed |
Recall count | Top 3–5 entries | Marketing content matching does not need excessive redundant results, focusing on core matching items |
Similarity threshold | 0.75–0.85 | Balances matching accuracy and coverage, avoiding irrelevant facility data from being included in marketing content recall results |
Chunk size | 1500 characters | Adapts to information density of long paragraphs in brochures, ensuring each segment contains complete floor plan or facility descriptions |
The parameter values provided on this page are common starting points for configuration. Actual values are affected by material format, data volume, and business rules. Specific issues require specific analysis, and it is recommended to test on your own samples before finalizing.
Three common mistakes
SSL certificate verify failederror occurs, and service cannot provide normal functionality. Cause: SSL certificate files are not mounted to the specified directory of the FastGPT container during local deployment, causing the service to fail to read the certificate files.- After upgrading to a new version, internet-connected plugins configured in
V4.6.7cannot be called normally. Cause: Environment variable configurations for original plugins were not retained during upgrade, causing keys required for internet functionality to be lost. - Docker deployment fails to start on Windows Server 2022 environment, returning
container start failederror. Cause: Port mapping between host and container was not configured correctly, causing port 80 or 443 to be occupied by other processes.
How to confirm configurations are correct
- Upload a single floor plan PDF larger than 100 MB, check if the parsing task completes within the duration set by
PARSE_FILE_TIMEOUT_SECONDS. - Initiate a query containing "floor plan area", check if returned result fields include preset fields such as
建筑面积and套内面积, with no missing or abnormal values. - Restart the FastGPT service, check that SSL certificate-related logs have no errors, and verify certificate validity by accessing the bound domain name via a browser.
- After upgrade, check if the
Recall countconfiguration in the knowledge base matches the pre-upgrade value, to avoid being overwritten by default configuration values.
Question material comes from public community discussions. Configuration values are common starting points and should be measured against your own samples. Verified on 2026-09-14.