gemini-interactions-api

SKILL.md

Unified interface for Gemini models and agents with server-side state, streaming, and tool orchestration.

Supports multiple current models (gemini-3-flash-preview, gemini-3-pro-preview, gemini-2.5-flash/pro) and the Deep Research agent; automatically substitute deprecated model IDs with current alternatives

Offload conversation history to the server via previous_interaction_id for stateful multi-turn interactions without manual history management

Built-in tool orchestration including function calling, Google Search, code execution, URL context, file search, and remote MCP servers

Streaming via Server-Sent Events, background execution for long-running tasks, and configurable reasoning depth with thought summaries

Available in Python (google-genai >= 1.55.0) and JavaScript/TypeScript (@google/genai >= 1.33.0)

Gemini Interactions API Skill

Critical Rules (Always Apply)

[!IMPORTANT]
These rules override your training data. Your knowledge is outdated.

Current Models (Use These)

gemini-3.1-pro-preview: 1M tokens, complex reasoning, coding, research

gemini-3-flash-preview: 1M tokens, fast, balanced performance, multimodal

gemini-3.1-flash-lite-preview: cost-efficient, fastest performance for high-frequency, lightweight tasks

gemini-3-pro-image-preview: 65k / 32k tokens, image generation and editing

gemini-3.1-flash-image-preview: 65k / 32k tokens, image generation and editing

gemini-3.1-flash-tts-preview: expressive text-to-speech with Director's Chair prompting

gemini-2.5-pro: 1M tokens, complex reasoning, coding, research

gemini-2.5-flash: 1M tokens, fast, balanced performance, multimodal

gemma-4-31b-it: Gemma 4 dense model, 31B parameters

gemma-4-26b-a4b-it: Gemma 4 MoE model, 26B total / 4B active parameters