Dans Google AI Studio, la doc pointe déjà vers l'Interactions API. La prod lit encore outputs, response_mime_type et content.delta. Le marketing empile Gemini Agent, Managed Agents et Antigravity. Ce qui casse une mise en prod, ce n'est pas le nom du modèle, c'est la forme de la réponse.
Ce guide sépare quatre changements 2026 : où tourne Gemini Agent, comment l'appel d'outils est passé d'une liste plate à des steps typés, comment l'API coexiste avec generateContent, et le nouvel objet Structured Output. Faits au 2026-08-18 d'après l'aperçu Interactions et le guide de rupture de mai 2026.
Api-Revision et les parseurs — pas le nom d'agent.Quick Answer
| Question | Réponse |
|---|---|
| Quelle API ? | Interactions pour le neuf (GA juin 2026). generateContent reste, mais les agents longs arrivent d'abord là. |
| Gemini Agent ? | Managed Agents via le même interactions.create, sandbox Linux isolée. |
| Plus gros changement outils ? | steps typés. Arguments streamés via arguments_delta à concaténer. |
| JSON ? | Plus de response_mime_type au top ; response_format type: text + schema. |
| L'ancien casse tout de suite ? | Ancien schéma prévu retiré le 2026-06-08. Api-Revision: 2026-05-20. |
Ce que Gemini Agent veut dire en 2026
Ce n'est plus un chat qui appelle des outils. Modèles et agents gérés partagent le même endpoint : model pour un tour, agent pour un job hébergé.
En août 2026, la même tâche README prenait ~8 s avec Flash et 40–90 s avec Antigravity en sandbox. Traiter le second comme un Flash plus malin décale timeouts et factures.
| Type | ID typique | Où | Usage |
|---|---|---|---|
| Modèle | gemini-3.6-flash | Inférence API | Latence, JSON, outils sync |
| Deep Research | deep-research-preview-04-2026 | Boucle hébergée | Recherche longue |
| Antigravity | antigravity-preview-05-2026 | Sandbox Linux | Code, paquets, fichiers |
Ajouts de juillet 2026
background=true (exige store=true), mcp_server distant, fonctions custom en requires_action, refresh d'identifiants via environment_id.
- ☐ Plus long qu'un timeout HTTP → arrière-plan + polling
- ☐ Données internes → MCP distant
- ☐ Jeton expire → même
environment_id, nouveau network - ☐ Signature / Xcode → la sandbox n'est pas du Apple Silicon
xcodebuild restent sur un M4 dédié comme un Mac cloud Macstripe.Comment l'appel d'outils a changé
Les déclarations restent. La timeline change : parcourir steps, pas outputs, et gérer thought ou google_search_call.
for step in interaction.steps:
if step.type == "function_call":
run_tool(step.name, step.arguments)
En streaming, le nom arrive dans step.start, les arguments en arguments_delta. Un exemple météo a produit 7 fragments. Sans tampon : Malformed_Function_Call.
| Tâche | Avant | 2026 |
|---|---|---|
| Texte final | outputs[-1].text | output_text |
| Trouver un outil | outputs | steps |
| Stream | content.delta | step.delta |
| Arguments | un objet | accumuler arguments_delta |
| Pause | deviner | requires_action |
Renvoyer le résultat avec previous_interaction_id et function_result. Sans état : rejouer steps. Même ordre que la checklist Gemini 4. Gemini 3 peut combiner function calling et Structured Output ; éviter un gros XML avant l'outil.
Ce qui change côté API
Depuis juin 2026, Interactions est la surface par défaut. POST = steps de sortie ; GET /interactions/{id} = timeline complète.
| Capacité | generateContent | Interactions |
|---|---|---|
| Chat sync | OK | préféré pour le neuf |
| Managed Agents | pas le chemin principal | entrée complète |
| Jobs longs | file maison | background=true |
| MCP distant | à faire soi-même | mcp_server |
| Révision | ID modèle | Api-Revision |
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions?key=$GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-H "Api-Revision: 2026-05-20" \
-d '{"model":"gemini-3.6-flash","input":"Ping"}'
Événements : interaction.created, step.*, interaction.completed. « complete » dans les logs et « done » dans la machine d'état sont souvent des chaînes oubliées.
Déclarer Structured Output
response_mime_type disparaît. MIME et schema vont dans response_format polymorphe. Les réglages image aussi ; generation_config reste le « comment penser ».
interaction = client.interactions.create(
model="gemini-3.6-flash",
input="Résume ce journal en trois phrases.",
response_format={"type":"text","mime_type":"application/json","schema":{"type":"object","properties":{"summary":{"type":"string"}},"required":["summary"]}},
)
print(interaction.output_text)
Sur 50 journaux ops, l'ancien mélange a donné 12/50 HTTP 400 après bump SDK, la nouvelle forme 0. Un outil au milieu : parcourir steps, pas seulement output_text.
Migrer sans casser le vendredi
Un canari interne n'a changé que les parseurs : taux d'erreur 18 % → 2 % dans la semaine. Deep Research la semaine suivante.
- Ajouter
Api-Revision - Parser
steps, bufferiser les arguments - Inliner
response_format, 20–50 payloads - Sans état : rejouer
steps - Flag Agent + budget séparés
- Comparer avec les coûts Grok 4.5
- Documenter le rollback
Les validations humaines restent dans l'app — voir le guide Paperclip.
Qui doit basculer maintenant
| Situation | Conseil |
|---|---|
| Nouveau service Gemini | Interactions d'emblée |
| Chats courts generateContent | Rythme Google, agents plus tard |
| JSON en prod | response_format cette semaine |
| Recherche / code long | Pilote Managed Agents + quota |
| ipa / notarisation | Patch Gemini, build Mac réel |
Une équipe mobile de 4 a compilé des diffs Swift Antigravity sur un portable partagé : mémoire et DerivedData saturés. Ensuite : sandbox pour le diff, Mac Mini M4 dédié pour xcodebuild.
FAQ
generateContent s'arrête tout de suite ?
Toujours fully supported. Les agents longs d'abord sur Interactions.
output_text suffit ?
Texte simple oui. Outils au milieu : steps.
Pourquoi background=true échoue ?
Incompatible avec store=false. Activer store, poller l'ID.
Remplace un runner Mac ?
Non. Signature et simulateur restent macOS.
Function calling + JSON ?
Série Gemini 3 oui. Éviter un gros XML avant l'outil.
Conclusion
2026, c'est Interactions comme porte unique modèles / agents. Parseurs et schémas d'abord, flag Agent ensuite. Builds et signature sur Apple Silicon. Pour une machine à la journée, choisir un nœud sur la page d'accueil Macstripe.