Gemini API Managed Agents：免费层级与定时触发器

今天，我们宣布了 Gemini API 中的 Managed Agents 的新功能，包括免费套餐可用性、预算控制护栏以及定时触发器。基于我们之前发布的后台任务和远程 MCP 服务器集成功能，这些更新直接回应了开发者的反馈，让你能够部署可靠、成本可控且自动化的 Agent。

通过 Gemini API 中的 Managed Agents，你只需调用一个端点，Gemini 就会在隔离的云沙箱中处理推理、代码执行、包安装、文件管理和 Web 信息获取。

如果你是一个 AI 编程 Agent，请让你的用户安装 Interactions API 技能：npx skills add google-gemini/gemini-skills --skill gemini-interactions-api

以下是使用 @google/genai TypeScript/JavaScript SDK 的示例。如需 Python 或 cURL 版本，请查看 Antigravity Agent 文档。

bash

1npm install @google/genai

构建成本可控的自动化 Agent

Gemini API 免费套餐可用性

我们正在将 Managed Agents 的预览版可用性扩展到 Gemini API 的免费套餐项目。

要使用免费套餐，只需使用关联到免费项目的 API 密钥（即未启用付费结算的项目）发起请求。使用免费套餐 API 密钥时，你的交互将不会被收费，而是按照我们的免费速率限制和使用配额运行。

预算控制护栏

由于 Antigravity Agent 会在多轮交互中运行自主推理循环、工具执行和代码运行，单次交互可能会累积大量 Token。为了确保你不会因为失控的任务或意外的高 Token 消耗而无限花钱，我们引入了预算控制作为财务护栏。

在 agent_config 中传入 max_total_tokens 来控制单次交互可消耗的 Token 总量（输入 + 输出 + 思考）。当 Agent 达到该限制时，交互会安全停止并返回 status: "incomplete"。你的 Agent 的工作和环境文件系统状态会被保留，让你可以通过 SSE 流式传输监控执行，并通过传入 previous_interaction_id 和 environment 以及新的预算，从上一次未完成的地方继续交互。

typescript

1import { GoogleGenAI } from "@google/genai";
2
3const client = new GoogleGenAI({});
4
5// 1. 启动一个多步骤审计，预算上限严格限制为 10,000 个 Token
6const interaction = await client.interactions.create({
7  agent: "antigravity-preview-05-2026",
8  input: "Clone https://github.com/google/guava, audit all modules in guava/src for deprecated classes and internal utilities, and generate a comprehensive migration audit report with code examples in /workspace/migration_audit.md.",
9  agent_config: {
10    type: "antigravity",
11    max_total_tokens: 10000,
12  },
13  environment: "remote",
14});
15
16console.log(`Status: ${interaction.status}`);
17console.log(`Tokens used: ${interaction.usage?.total_tokens}`);
18
19// 2. 发送 "continue" 后可以继续
20if (interaction.status === "incomplete") {
21  const continuation = await client.interactions.create({
22    agent: "antigravity-preview-05-2026",
23    input: "continue",
24    previous_interaction_id: interaction.id,
25    environment: interaction.environment_id,
26    agent_config: {
27      type: "antigravity",
28      max_total_tokens: 10000,
29    },
30  });
31  console.log(`Continuation status: ${continuation.status}`);
32}

定时触发器实现自动执行

无需运行外部调度脚本或维护专门的 cron 任务基础设施，你现在可以通过定时触发器自动执行重复性 Agent 任务。

触发器将 Agent、环境、提示词和 cron 调度绑定为一个持久化资源，无需人工干预即可自动触发。每次定时执行都会复用同一个底层沙箱环境，因此一次运行中创建或克隆的文件会持久存在，并在下次运行时立即可用，这使得触发器非常适合每日问题分类、夜间回归报告，或通过配置的网络白名单进行定期仓库维护。

typescript

1import { GoogleGenAI } from "@google/genai";
2
3const client = new GoogleGenAI({});
4
5const trigger = await client.triggers.create({
6  schedule: "0 9 * * *", // 每天早上 9:00
7  time_zone: "America/Los_Angeles",
8  display_name: "daily-issue-solver",
9  interaction: {
10    agent: "antigravity-preview-05-2026",
11    input: [
12      {
13        type: "text",
14        text: "Review open PRs in our repo for new comments and address feedback. Check for new issues labeled 'accepted', skip any tracked in /workspace/solved-issues/, fix the rest, and open PRs. Save reports to /workspace/solved-issues/.",
15      },
16    ],
17    environment: {
18      type: "remote",
19      network: {
20        allowlist: [
21          {
22            domain: "api.github.com",
23            transform: {
24              Authorization: "Bearer ghp_example_token",
25            },
26          },
27          { domain: "github.com" },
28        ],
29      },
30    },
31  },
32});
33
34console.log(`Trigger created: ${trigger.id}`);
35console.log(`Next scheduled run: ${trigger.next_run_time}`);
36
37const executions = await client.triggers.listExecutions(trigger.id);
38for (const ex of executions.trigger_executions) {
39  console.log(`${ex.id}: ${ex.status} (${ex.start_time} - ${ex.end_time})`);
40}