这个品类的数据长什么样
漏洞扫描服务的核心数据来源于漏洞扫描器、资产清单、CVE库、补丁公告，更新频率为周度或月度。日常产出的文档包含扫描计划、漏洞清单、整改工单、复扫报告四类，各文档字段包含扫描任务ID、关联资产IP、漏洞CVE编号、整改状态、复扫时间等，无统一的全局聚合字段，需按扫描周期关联各类文档数据。
这些特征在「上下文与 token」这一环带来什么约束
由于数据来源分散且按扫描周期更新，上下文需严格限定在单次扫描任务的关联文档范围内，避免跨周期数据混入导致token无效消耗。四类文档的字段差异要求上下文按文档类型分区存储，防止不同类别的数据相互干扰。周度/月度的更新节奏使得token消耗存在周期性峰值，需提前预留足够的上下文容量。同时，误报排除、复扫核对等耗时环节需要聚焦特定字段的上下文，若上下文包含无关数据会增加token占用并降低处理效率。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
| 最大上下文 | 20000–30000 token | 匹配单批次扫描任务的全量文档token总量，适配FastGPT v4.17.0的主流模型上下文上限 |
quoteMaxToken | 8000 token | 限制单条漏洞详情或整改工单的引用token，避免单条数据占用过多上下文空间 |
maxContext | 按扫描范围的文档量标定 | 适配周度或月度更新的扫描数据体量，避免上下文溢出 |
| 单次召回文档上限 | 前10条 | 聚焦当前扫描周期的核心漏洞数据，减少无关文档的token消耗 |
| 上下文分区配置 | 启用 | 区分扫描计划、漏洞清单、整改工单三类文档，避免不同类型数据的上下文混淆 |
容易做错的三处
- 现象：统计模型token消耗时出现与当前扫描任务不匹配的数值，原因：未按扫描周期限定上下文范围，混入了历史扫描任务的文档数据
- 现象：下载知识库上传的扫描报告时出现无效跳转地址，原因：上下文配置中未关联报告文件的接口参数，导致调用路径缺失必要标识
- 现象：服务启动校验失败或执行异常时提示
AIPROXY_API_ENDPOINT or AIPROXY_API_TOKEN is not set，排查项：未正确配置App/Admin服务端的环境变量AIPROXYAPIENDPOINT和AIPROXYAPITOKEN
怎么确认配好了
- 查看token消耗统计面板，确认仅显示当前扫描周期内的文档token消耗数据
- 触发一次测试扫描任务，检查上下文调用日志仅包含本次任务关联的扫描计划、漏洞清单等文档
- 测试下载扫描报告，确认跳转地址符合官方文档中定义的接口规范
- 确认服务端已正确配置环境变量AIPROXYAPIENDPOINT和AIPROXYAPITOKEN，避免因缺失必填环境变量导致服务异常
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-10-19，文中适用性按 FastGPT v4.17.0 基线讨论；部署前需核对实际版本。