Google I/O 2026 的 Gemini API 管理型 Agent 怎么改变开发流程

Google I/O 2026 的 Gemini API Managed Agents，改变的不是“模型会不会回答”，而是开发者要不要自己搭建 Agent 的运行底座。它把推理、工具调用、代码执行和远程 Linux 环境放进一次交互里，并允许后续请求接着使用文件和状态。对开发团队来说，最明显的变化是：应用后端从拼装一串模型调用，转向管理一个可恢复、可观测、可限制权限的任务会话。

Managed Agents 到底增加了什么

Google 公布的 Managed Agents 由 Antigravity agent harness 驱动，当前通过 Interactions API 和 Google AI Studio 提供预览能力。一次调用可以让 Agent 进行推理、使用工具、管理文件，并在隔离的 Linux 沙箱中执行代码；它还可以浏览网页获取实时数据。每次交互都会创建或接收一个环境，后续调用可以继续使用已有文件和状态。

这几个词要分开看：模型负责生成决策，Agent harness 负责决定什么时候调用工具，远程环境负责承载代码与文件，Interaction 则记录一轮任务的输入、工具步骤和输出。过去团队需要自己维护队列、容器、上下文拼接和重试，现在这些基础设施被收进了平台能力，但业务方仍要负责权限、数据和结果验收。

开发流程为什么从调模型变成管理交互

普通的 generateContent 更像“输入一段内容，得到一段输出”。托管 Agent 则把一次任务拆成连续执行步骤：先理解目标，再选工具，可能写入文件或运行代码，最后返回结果。Interactions API 还支持用 previous_interaction_id 续接对话，并提供后台执行等能力，因此产品代码需要保存的核心对象不再只有 prompt 和 response，还包括 interaction ID、任务状态、超时策略和人工接管入口。

最小调用可以这样写，重点不在复制示例，而在于明确远程环境是一次任务的资源边界：

from google import genai

client = genai.Client()

# 让托管 Agent 在远程 Linux 环境中完成一个可复查的分析任务
first = client.interactions.create(
    agent="antigravity-preview-05-2026",
    input="分析给定的 CSV，并生成一份 HTML 报告",
    environment="remote",
)

# 实际项目应持久化 ID，方便用户在下一轮继续任务
print(first.id)
print(first.output_text)

生产代码不要把这段调用直接放进同步 HTTP 请求里。更稳妥的路径是：创建任务后立即返回任务 ID；后台 worker 负责轮询或接收结果；前端展示当前步骤；用户追问时用保存的交互 ID 续接。这样即使 Agent 执行代码或等待外部数据，Web 请求也不会被长时间占住。

普通模型调用、自建编排和托管 Agent 怎么选

如果任务只是把工单改写成 JSON，引入远程环境反而增加复杂度；如果任务要读取一批文件、运行分析脚本，再让用户追问修改报告，托管 Agent 才体现出价值。Google 还允许用 Markdown 文件定义自定义指令和技能，这让团队可以把行为约束版本化，但不能替代业务侧的权限校验。

迁移前先检查这四个边界

• 数据边界：确认哪些文件可以进入远程环境，Interaction 是否存储，以及团队是否需要显式设置 store=false。
• 权限边界：工具调用要采用最小权限，写文件、访问网络和发布动作必须分级，不能因为 Agent 能执行代码就放开生产凭据。
• 运行边界：为单任务设置超时、预算和最大工具次数；长任务使用后台执行，不把一次调用当作永不失败的事务。
• 结果边界：把生成的文件、数据结论和外部操作分开验收，涉及发布、删除或财务动作时保留人工确认。

更实际的试点顺序是内部资料分析、测试报告生成和原型脚手架。先记录任务成功率、平均交互轮数、人工接管率与单任务成本，再决定是否把同一模式推到面向用户的生产链路。

相关问题

Managed Agents 是不是普通 Gemini API 的替代品？

不是。单轮生成仍适合普通模型调用；Managed Agents 主要解决工具、文件、代码执行和多轮任务状态问题。

为什么要保存 interaction ID？

因为后续请求可以用 previous_interaction_id 续接服务端保存的会话状态，避免每次重新提交完整上下文。

现在就应该把现有 Agent 全部迁移吗？

不建议。它在公告中仍以预览能力推出，先用低风险任务验证数据留存、费用、权限和失败恢复，再决定是否替换自建运行底座。

官方资料：Managed Agents 公告、Interactions API 文档。