In Google AI Studio ist die Dokumentation bereits auf die Interactions API umgestellt. Produktivcode liest noch outputs, response_mime_type und content.delta. Marketing stapelt Gemini Agent, Managed Agents und Antigravity. Was Releases stoppt, ist selten der Modellname – es ist die Antwortform.
Dieser Leitfaden trennt vier Änderungen 2026: wo Gemini Agent läuft, wie Tool Calling von einer flachen Liste zu typisierten steps wurde, wie die API neben generateContent existiert und das neue Structured-Output-Objekt. Stand 2026-08-18 gemäß Interactions-Überblick und Breaking Changes Mai 2026.
Api-Revision und Parser – den Agent-Namen nicht zuerst ändern.Quick Answer
| Frage | Antwort |
|---|---|
| Welche API? | Neu: Interactions (GA Juni 2026). generateContent bleibt, Langläufer-Agenten landen zuerst dort. |
| Was ist Gemini Agent? | Managed Agents über dasselbe interactions.create in einer isolierten Linux-Sandbox. |
| Größte Tool-Änderung? | Typisierte steps. Streaming-Argumente als arguments_delta zusammenfügen. |
| JSON anfordern? | Kein Top-Level-response_mime_type; response_format mit type: text und Schema. |
| Bricht Alter Code sofort? | Altes Schema sollte am 2026-06-08 entfallen. Migration mit Api-Revision: 2026-05-20. |
Was Gemini Agent 2026 bedeutet
Es ist nicht mehr nur Chat mit Tools. Modelle und verwaltete Agenten teilen denselben Endpunkt: model für Turn, agent für Hosted Jobs.
Im August 2026 dauerte dieselbe README-Aufgabe mit Flash etwa 8 Sekunden, mit antigravity-preview-05-2026 in der Sandbox 40–90 Sekunden. Wer Letzteres als „schlaueres Flash“ behandelt, bekommt Timeouts und Rechnungen nicht zusammen.
| Typ | ID-Beispiel | Ort | Einsatz |
|---|---|---|---|
| Modell | gemini-3.6-flash | API-Inferenz | Latenz, JSON, Sync-Tools |
| Deep Research | deep-research-preview-04-2026 | Hosted-Schleife | lange Recherche |
| Antigravity | antigravity-preview-05-2026 | Linux-Sandbox | Code, Pakete, Dateien |
Ergänzungen Juli 2026
background=true (braucht store=true), remote mcp_server, Custom Functions bei requires_action, Credential-Refresh über environment_id.
- ☐ Länger als ein HTTP-Timeout → Hintergrund + Polling
- ☐ Interne Daten → Remote-MCP
- ☐ Token läuft ab → gleiche
environment_id, neues Network - ☐ Signing/Xcode → Sandbox ersetzt kein Apple Silicon
xcodebuild gehören auf einen dedizierten M4 wie Macstripe Cloud-Mac.Wie sich Tool Calling geändert hat
Deklarationen bleiben. Die Timeline ändert sich: steps statt outputs, plus Server-Tools wie thought und google_search_call.
for step in interaction.steps:
if step.type == "function_call":
run_tool(step.name, step.arguments)
Streaming liefert den Namen in step.start und Argumentfragmente als arguments_delta. Ein Wetterbeispiel brauchte 7 Fragmente. Ohne Puffer folgt Malformed_Function_Call.
| Aufgabe | Alt | 2026 |
|---|---|---|
| Endtext | outputs[-1].text | output_text |
| Tool finden | outputs | steps |
| Stream | content.delta | step.delta |
| Argumente | ein Objekt | arguments_delta sammeln |
| Pause | raten | requires_action |
Ergebnisse mit previous_interaction_id und function_result. Zustandslos: steps wiedergeben. Gleiche Reihenfolge wie in der Gemini-4-Migrationsliste. Gemini-3-Serie erlaubt Function Calling plus Structured Output; große XML-Vorspanne vor Tools vermeiden.
Änderungen auf API-Ebene
Seit Juni 2026 ist Interactions Standard. POST liefert Ausgabe-Steps; GET /interactions/{id} die volle Timeline.
| Fähigkeit | generateContent | Interactions |
|---|---|---|
| Sync-Chat | ok | für Neues bevorzugt |
| Managed Agents | kein Hauptweg | voller Einstieg |
| Langläufer | eigene Queue | background=true |
| Remote-MCP | selbst bauen | mcp_server |
| Revision | Modell-ID | 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"}'
Events: interaction.created, step.*, interaction.completed. „complete“ in Logs und „done“ in der State Machine sind oft String-Reste.
Structured Output richtig setzen
response_mime_type entfällt. MIME und Schema liegen in polymorphen response_format. Bildparameter wandern dorthin; generation_config bleibt Denken (Temperatur, top_p, thinking).
interaction = client.interactions.create(
model="gemini-3.6-flash",
input="Fasse das Log in drei Sätzen zusammen.",
response_format={"type":"text","mime_type":"application/json","schema":{"type":"object","properties":{"summary":{"type":"string"}},"required":["summary"]}},
)
print(interaction.output_text)
Bei 50 Ops-Logs: alte Felder nach SDK-Update 12/50 HTTP 400, neue Form 0. Liegt ein Tool dazwischen, reicht output_text nicht – steps iterieren.
Migration ohne Freitagabend-Ausfall
Ein interner Canary änderte nur Parser: Fehlerrate 18%→2% in derselben Woche. Deep Research erst Woche zwei.
Api-Revisionsetzenstepsparsen, Argumente puffernresponse_formatinline, 20–50 Payloads- Zustandslos
stepswiedergeben - Agent extra flaggen und budgetieren
- Mit Grok-4.5-Kosten vergleichen
- Rollback dokumentieren
Freigaben bleiben in der App – siehe Paperclip-Workflow.
Wer jetzt wechseln sollte
| Lage | Empfehlung |
|---|---|
| Grünfeld Gemini | direkt Interactions |
| kurze generateContent-Chats | im Google-Takt, Agent später |
| Produktions-JSON | diese Woche response_format |
| Minutenlange Recherche/Code | Managed Agents mit Extra-Quota |
| ipa / Notarisierung | Patch von Gemini, Build auf echtem Mac |
Ein vierköpfiges Mobile-Team baute Antigravity-Swift-Diffs auf einem geteilten Notebook – Speicher und DerivedData waren nachmittags tot. Danach Diff in der Sandbox, xcodebuild auf einem dedizierten M4 Mac Mini.
FAQ
Wird generateContent sofort abgeschaltet?
Weiter fully supported. Langläufer zuerst auf Interactions.
Reicht output_text?
Bei reinem Text ja. Mit Tools dazwischen steps.
Warum scheitert background=true?
Unverträglich mit store=false. Store an, ID pollen.
Ersetzt der Agent Mac-CI?
Nein. Signing und Simulator bleiben macOS.
Function Calling plus JSON?
Gemini-3-Serie ja. Kein großes XML vor Tools.
Fazit
2026 geht es um Interactions als gemeinsame Tür für Modelle und Agenten. Parser und Schema zuerst, Agent-Flag danach. Builds und Signing auf Apple Silicon. Für eine Maschine pro Tag Node auf der Macstripe-Startseite wählen.