TL;DR
- Google made
antigravity-preview-09-2026the default harness for Gemini managed agents in both the Interactions API and AI Studio, replacingantigravity-preview-05-2026, which reaches deprecation on October 5, 2026 and then redirects automatically. (Source : Google — Gemini API Managed Agents Update) - The default model moves from Gemini 3.5 Flash to Gemini 3.8 Flash, with five Flash sub-variants selectable per interaction. Existing requests keep running without interruption, and pricing is unchanged. (Source : AI Intel Report — Gemini Managed Agents Harness Update Adds Files API and Credentials API)
- Google’s internal telemetry claims 40% fewer output tokens on file edits, up to 6% higher task completion on multi-turn software engineering and research, and up to 16% more cache hits. An independent read of the same release reports roughly 9% cache gains on coding, 22% on long-form QA, and a 17% cost reduction on reasoning tasks.
- Two new APIs close the enterprise gaps: a Files API for moving data in and out of the sandbox, and a Credentials API that injects secrets through an egress proxy so the model never sees the token values.
- Complex workflows still burn 3 to 5 million tokens per interaction, and Flash pricing doubles on January 1, 2027. The economics work today; the question is whether they still work at $1.50/$7.50 per million.
The harness is the product now
Model releases have become a commodity cadence — Gemini 3.8 Flash arrived on September 2, 2026, the third Flash model in six weeks. What separates two agents running on the same checkpoint is the harness: the execution loop, the context budget, the way files get edited, and how credentials are handed out. That is precisely the layer Google just repackaged.
The company has promoted its Antigravity coding-agent harness to be the default execution environment behind Gemini managed agents, in the Interactions API and in AI Studio. The August release (our guide to the 3.7-era setup) already gave developers a one-call Linux sandbox; this update ports the loops and context-management strategies Google uses in its own Antigravity IDE, and frames it as versioned infrastructure rather than a preview toy.
What actually changed under the hood
The runtime still provisions an ephemeral Linux sandbox per interaction, with code_execution, filesystem, google_search, url_context and an env_id for session state. Four things are different in practice:
- File edits are diffs. Instead of rewriting whole files, the harness emits unified diffs, which Google measures as a 40% reduction in output tokens on file changes — a direct cut to the most expensive line item in a coding loop.
- Context compaction is automatic. Long sessions compact at roughly 135k tokens rather than dying on overflow, which is what used to end multi-turn runs without warning.
- Caching gets more deterministic. Stable system instructions lift cache hit rates by up to 16%, and cache reads are billed at a fraction of fresh input.
- Runs can be detached.
background=Truelets an interaction keep working after the client disconnects, which is the difference between a chat feature and a cron-shaped agent.
Task completion also moved: up to 6% higher pass rates on multi-turn software engineering and research workloads, per Google. Independent trackers put the cache improvement at about 9% on multi-turn coding and 22% on long question-answering, with a 17% cost reduction on reasoning tasks measured in AI Studio.
Files and Credentials: the last hand-rolled plumbing
Two new endpoints target the parts of agent deployments that teams had been building themselves, badly.
The Files API (/v1beta/environments/{env_id}/files) turns the sandbox into a proper data plane. You upload, list and retrieve files directly against a live environment, and the agent works on them from /workspace. The canonical example Google ships is telling: drop in a raw sales spreadsheet, ask for an interactive dashboard, get a finished file back.
The Credentials API (/v1beta/agent-credentials) is the more consequential one. Secrets are registered once in one of three forms — bearer_token, oauth2, or environment_variable — paired with an egress allowlist. Outbound requests from the sandbox route through a managed proxy that intercepts approved destinations and injects auth headers out-of-band. The credential never enters the model’s context window and never lands in the sandbox filesystem, so a prompt injection hidden in a fetched page cannot exfiltrate what was never there. Given the summer’s run of agent-side incidents — the rogue agents in package registries, the evaluation agents that wandered out of scope, the systems compromised during a Gemini safety test — this is the control enterprises were asking for in writing.
One operational detail matters for CI: when you provision a named agent with client.agents.create(), the model is locked at creation and cannot be overridden per turn. Ad-hoc interactions can still swap models freely. That is regression protection dressed as a constraint — and it means agent definitions can be pinned like any other dependency.
The cost math to run before January 1
Estimated production cost for the new harness, on Gemini 3.8 Flash:
- Code formatting and lint fixes: 3-5 turns, ~120k cached input tokens, 8k output — $0.25 to $0.45
- Bug localization and regression patch: 8-14 turns, ~380k input, 24k output — $0.85 to $1.40
- Full feature implementation with test suite: 18-30 turns, ~920k input, 55k output — $2.10 to $3.25
Sandbox compute is free during the preview, and Flash input/output stays at $0.75/$3.75 per million tokens through December 31, 2026. On January 1 it becomes $1.50/$7.50. Google’s own documentation warns that complex workflows can reach 3 to 5 million tokens in a single interaction, or roughly $5 per task. The harness improvements are what make those numbers tolerable — and the price step is what will decide which of today’s prototypes survive into production. Teams should be measuring tokens per accepted diff now, not in January.
Where this sits against the rest of the field
Every serious platform shipped harness-layer infrastructure this month. Anthropic is selling managed agents into enterprise reporting workflows; OpenAI opened its Agents API to all developers with durable sessions, subagents and a choice of hosted or customer-side execution; Cloudflare shipped an Agent Development Lifecycle stack; Google itself open-sourced the AX orchestrator and now versions the Antigravity harness. Open-source coding agents such as OpenHands 1.0 are converging on the same primitives from the other direction.
The differentiators are no longer benchmarks. They are sandbox isolation, credential proxying, the file and data plane, cache-friendliness, and how cleanly harness upgrades can be pinned. The October 5 deprecation of antigravity-preview-05-2026 is a useful reminder that agent configuration is now versioned infrastructure with an upgrade calendar — closer to a runtime dependency than to a prompt.
FAQ
Does the harness change break existing agents?
No. Requests running on the previous harness continue without interruption, and pricing is unchanged. The forced transition comes on October 5, 2026, when antigravity-preview-05-2026 is deprecated and traffic redirects to the new harness automatically.
Can I still choose which model the agent runs?
Yes, with one caveat. Ad-hoc interactions created with client.interactions.create() can switch among five Flash sub-variants (3.8, 3.7, 3.6, 3.5, and 3.5 Flash-Lite). Agents provisioned with client.agents.create() have their model locked at creation.
Who actually holds the secrets now? Google’s managed egress gateway. Credentials are stored as handles and injected as headers on outbound requests to allowlisted destinations. The model sees neither the token nor the destination list beyond what you approve.
What is the catch? Token burn and the January price step. A complex interaction can consume 3 to 5 million tokens, and Flash pricing doubles on January 1, 2027. The 40% output-token reduction and better cache hits buy real headroom, but only for workflows whose loops are structured to reuse context.
Further Reading
- Introducing Managed Agents in the Gemini API — Google
- Gemini API Managed Agents Update — Google on X
- Antigravity agent — Gemini API documentation
- Gemini Managed Agents Harness Update Adds Files API and Credentials API — AI Intel Report
- Google Just Changed How Its Managed Agents Work — Eyestech
- Google Makes Antigravity Coding Agent Free via Gemini API — i6eal