Gemini Deep Research旧版10月23日停用：改agent字段

10月23日停的是哪个入口？

Google在10月8日的Gemini API更新说明中宣布，旧版deep-research-pro-preview-12-2025已弃用，将于10月23日停用。本次10月9日核验时仍是未来计划，公告没有给出具体时刻或时区。

弃用表也列出10月23日，但说明表内日期一般表示最早可能退役日；本次应结合更新说明的明确通知安排迁移。范围是Gemini API的托管研究代理，不能扩大成消费者Gemini应用、所有Gemini模型或整个研究功能停服。

选速度，还是选更全面的研究？

标准替代是deep-research-preview-04-2026，官方定位为速度与效率，适合把研究进度流式展示到客户端界面。若主要任务是给用户一份及时的研究结果，可先从这个方向评估。

另一个选项deep-research-max-preview-04-2026侧重更全面的资料收集与综合分析，适合自动化研究。Max不是每项任务都更合适的保证，仍要比较所需覆盖、耗时与实际费用。

两个版本的弃用表发布日期都是4月21日，目前没有公布停用日期。10月8日的新消息是旧代理退役与迁移要求，不是两个替代当天首次上线；当前研究代理仍处于Preview阶段。

改agent字段，别把它填进模型名

找到实际创建研究任务的interactions.create请求，把agent中的旧标识换成选定的替代。Deep Research是会搜索、阅读并综合资料的代理，官方只通过Interactions API提供，不能当作普通模型传给generateContent。

同时检查定时任务、封装函数、环境配置与共享模板里的固定标识。假设网页已经换了代理，但夜间汇总脚本仍保存旧名称，后者还需单独调整；这是未执行的示例，不代表已发现你的项目故障。

研究还没结束，不要再创建一份

官方要求background=True异步运行；这种后台执行还要求store=True。任务可能经历多轮搜索和阅读，不会像普通聊天立即返回最终报告。先确认项目对保存研究交互及输入资料的要求，再决定传入哪些内容。

创建成功后保存返回的interaction ID，用同一个ID查询状态或接收流式更新。completed后读取报告，failed时记录错误；仍在进行中就继续跟踪原任务，不把网页关闭或等待超时自动当成失败。

流式连接断开时，官方示例用原interaction ID和最后收到的事件ID重连。结果未知时先查原任务，避免重复创建研究、重复成本；尚未拿到任务ID的情况也不能自行认定服务端没有创建成功。

迁移费用怎样确认？

Deep Research按底层Gemini模型及实际使用的工具按量计费。一次研究请求可能触发多轮规划、搜索、阅读和推理，不能用普通聊天的一次输出成本推算，也不能把“偏效率”理解成固定单价或费用上限。

已有调用授权的团队，可用同一份非敏感研究问题比较报告覆盖、引用质量、总耗时和账单。核对账号可用性、地区、配额与现行费率后再扩大；本文没有调用API、执行迁移或验证任何账号费用。

截止前，按什么次序迁移？

先盘点仍使用旧标识的工作流，记录入口、配置位置、负责人和已有在途任务ID。然后按交付速度或研究覆盖选择替代，保留原提示词与配置版本，避免同时更换全部工具和任务要求。

再核对有效agent配置、后台状态查询及结果读取。报告返回后检查引用是否支持结论，分清已确认事实、预测与缺失资料；完成状态说明任务结束，不保证来源正确或报告适合直接对外使用。

最后确认成本和错误处理，再逐步恢复自动任务。出现关键资料缺失、引用失真或费用超出团队预算时，暂停扩大并保留记录；10月23日后的回退方案不能依赖即将停用的旧代理。