Agents gérés par l'API Gemini : offre gratuite, déclencheurs et plus encore

Aujourd'hui, nous annonçons de nouvelles fonctionnalités pour les Managed Agents dans l'API Gemini, notamment la disponibilité du niveau gratuit, les garde-fous de contrôle budgétaire et les déclencheurs planifiés. S'appuyant sur notre précédente version des tâches en arrière-plan et de l'intégration du serveur MCP distant, ces mises à jour répondent directement aux retours des développeurs afin que vous puissiez déployer des agents fiables, économiques et automatisés.

Avec les managed agents dans l'API Gemini Interactions, vous appelez un seul endpoint et Gemini gère le raisonnement, l'exécution de code, l'installation de paquets, la gestion de fichiers et les informations web dans un sandbox cloud isolé.

Si vous êtes un agent de codage IA, demandez à votre humain d'installer la compétence Interactions API : npx skills add google-gemini/gemini-skills --skill gemini-interactions-api

Vous trouverez ci-dessous des exemples utilisant le SDK TypeScript/JavaScript @google/genai. Pour Python ou cURL, consultez la documentation de l'agent Antigravity.

1npm install @google/genai

Créez des agents économiques et automatisés

Disponibilité du niveau gratuit sur l'API Gemini

Nous étendons la disponibilité en préversion des managed agents aux projets du niveau gratuit via l'API Gemini.

Pour utiliser le niveau gratuit, il suffit d'effectuer vos requêtes à l'aide d'une clé API liée à un projet gratuit (un projet sans facturation active). Lorsque vous utilisez une clé API du niveau gratuit, vos interactions ne seront pas facturées et s'exécuteront dans le cadre de nos limites de taux et quotas d'utilisation gratuits.

Garde-fous de contrôle budgétaire

Étant donné qu'un agent Antigravity exécute une boucle autonome de raisonnement, d'exécution d'outils et de code sur plusieurs tours, une seule interaction peut accumuler un nombre important de tokens. Pour vous assurer de ne pas dépenser d'argent sans fin sur des tâches incontrôlées ou des comptes de tokens anormalement élevés, nous introduisons des contrôles budgétaires comme garde-fous financiers.

Passez max_total_tokens dans agent_config pour contrôler le nombre total de tokens (entrée + sortie + réflexion) qu'une interaction peut consommer. Lorsque l'agent atteint la limite, l'interaction s'arrête en toute sécurité et renvoie le statut : "incomplete". Le travail de votre agent et l'état du système de fichiers de l'environnement sont préservés, ce qui vous permet de surveiller l'exécution via le streaming SSE et de continuer une interaction incomplète là où elle s'est arrêtée en passant previous_interaction_id et environment avec un nouveau budget.

1import { GoogleGenAI } from "@google/genai";
2
3const client = new GoogleGenAI({});
4
5// 1. Démarrer un audit multi-étapes avec des contrôles budgétaires stricts limités à 10 000 tokens
6const interaction = await client.interactions.create({
7  agent: "antigravity-preview-05-2026",
8  input: "Clone https://github.com/google/guava, auditez tous les modules dans guava/src pour les classes obsolètes et les utilitaires internes, et générez un rapport d'audit de migration complet avec des exemples de code dans /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. Peut continuer en envoyant "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}

Exécution planifiée avec des déclencheurs

Au lieu d'exécuter des scripts de planification externes ou de maintenir une infrastructure dédiée pour les tâches cron, vous pouvez désormais automatiser les tâches récurrentes des agents à l'aide de déclencheurs planifiés.

Un déclencheur lie un agent, un environnement, un prompt et un planning cron en une ressource persistante qui se déclenche automatiquement sans intervention manuelle. Chaque exécution planifiée réutilise le même environnement sandbox sous-jacent, de sorte que les fichiers créés ou clonés lors d'une exécution persistent et sont immédiatement accessibles lors de la suivante, ce qui rend les déclencheurs idéaux pour le triage quotidien des problèmes, les rapports de régression nocturnes ou la maintenance planifiée des dépôts via des listes d'autorisation réseau configurées.

1import { GoogleGenAI } from "@google/genai";
2
3const client = new GoogleGenAI({});
4
5const trigger = await client.triggers.create({
6  schedule: "0 9 * * *", // Chaque matin à 9h00
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: "Examinez les PR ouvertes dans notre dépôt pour les nouveaux commentaires et répondez aux retours. Vérifiez les nouvelles issues étiquetées 'accepted', ignorez celles déjà suivies dans /workspace/solved-issues/, corrigez le reste et ouvrez des PR. Enregistrez les rapports dans /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}

Démarrez avec les managed agents

Ces mises à jour transforment les managed agents en travailleurs économiques et planifiés qui opèrent de manière autonome dans des environnements de développement réels sans dépasser votre budget ni nécessiter d'orchestration externe.

Consultez la vue d'ensemble de l'API Gemini Interactions et le guide de démarrage rapide des managed agents pour explorer les définitions d'agents personnalisés, les configurations d'environnement, les règles réseau et les modèles de streaming avancés.