Interactions API

The Gemini Interactions API is Google's unified API for calling Gemini models and specialized agents. It maintains server-side interaction state through interaction IDs and the `previous_interaction_id` parameter, while also supporting stateless requests. Each Interaction resource contains a chronological sequence of execution steps, including model thoughts, tool calls and results, and final output. The API supports text and multimodal generation, structured and strongly typed outputs, built-in and custom tools, tool orchestration, observable execution steps, background execution for long-running tasks, and chained image, video, and audio generation using shared context. Google documents it as generally available and recommends it for new Gemini API projects.

Managed Agents is a Google Gemini API service for running the Antigravity agent in persistent remote Linux sandboxes. A call to the Interactions API provisions a sandbox, runs the agent loop, and returns an interaction ID and environment ID; subsequent calls can use the previous interaction ID for conversation context and the environment ID to retain files, installed packages, and other sandbox state. The service supports streaming, file downloads, loadable sources such as Google Cloud Storage and GitHub, reusable skills, secure credential injection, and configurable named agents.

Google's Agents API defines and packages reusable AI agents with a base model, instructions, and a preconfigured environment. Agents run in managed cloud sandboxes rather than on the user's laptop; the environments can be shared with users or teams and accessed through an API call.