Today Google presents the Interactions API, a unified interface designed to work with models like Gemini 3 Pro and managed agents like Gemini Deep Research.
What's the main idea? To give you a native, robust way to manage complex histories, the model's internal thoughts, tool calls and states — all from a single endpoint.
What is the Interactions API
It's a single RESTful endpoint (/interactions) that lets you interact with both models and agents.
To pick the target you use simple parameters: specify "model" when you want to call a model, or "agent" when you want to invoke a specialized agent.
Right now the public beta supports deep-research-pro-preview-12-2025.
This API extends what generateContent did by adding key capabilities for modern agentic applications, like state management, interpretable data models and background execution.
