现象
国内网络环境下，FastGPT的DuckDuckGo插件无法正常发起搜索请求并返回结果，影响搜索场景下的功能使用。同时该插件默认返回的搜索结果数量固定为10条，无法根据实际轻量化或精细化的搜索需求调整结果条数。
可能原因
无法使用插件的直接原因为国内网络无法直接访问DuckDuckGo的API接口。当前插件未提供代理配置参数，无法适配受限网络环境；同时未提供搜索结果数量控制参数，无法替代默认的10条固定结果配置，无法满足多样化的搜索结果需求。
排查步骤
- 确认已将FastGPT升级至最新版本，避免因旧版本存在的功能缺陷导致异常。
- 检查当前网络环境，确认无法正常请求DuckDuckGo相关API接口。
- 查看插件的现有配置项，确认未包含代理地址配置与结果数量控制相关的可选参数。
解决与验证
针对上述问题，可通过添加两类参数完成配置优化。第一类为代理地址参数，用于配置后端模块请求DuckDuckGo API时使用的代理服务器地址，解决国内网络访问受限的问题。第二类为搜索结果数量控制参数，用于自定义返回的搜索结果条数，替代默认的10条固定值。配置代理地址参数时，需按照实际部署的代理服务器地址填写，确保后端模块可通过代理正常访问目标API。调整结果数量参数时，需输入符合业务需求的正整数，替代默认配置。完成配置后，可通过插件的搜索测试功能验证功能是否正常，确认搜索结果可正常返回且数量符合设置要求。
来源： FastGPT 官方来源
适用性与版本范围
本页适用于官方来源记录的 故障排查 场景。执行变更前，需核对 FastGPT、依赖、API 与部署版本。
安全护栏
凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。
回滚指引
恢复变更前的技术内容权威快照、已保存配置与数据快照，再执行最小验证场景。