Skip to content

Gemini agents API vs Gemini interactions API

Gemini agents API is an open-source agent skill for ai models and llm tooling. Gemini interactions API is an open-source agent skill for ai models and llm tooling.

  • Gemini agents API is best for create a custom gemini agent with a system instruction and google search enabled.
  • Gemini interactions API is best for build a chatbot that remembers earlier turns of a conversation.
What it is
Gemini agents API is an open-source agent skill for ai models and llm tooling.
Gemini interactions API is an open-source agent skill for ai models and llm tooling.
Best for
Create a custom Gemini agent with a system instruction and Google Search enabled
Build a chatbot that remembers earlier turns of a conversation
Kind
Skill
Skill
Pricing
Open source
Open source
Platforms
Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
GitHub stars
24.4K
24.4K
Last commit
Nov 2026
Nov 2026
License
Apache-2.0
Apache-2.0
Open source
Good for
Create a custom Gemini agent with a system instruction and Google Search enabled; Mount a Cloud Storage folder of skills into an agent's workspace; Update an existing agent's system instruction without touching its other settings
Build a chatbot that remembers earlier turns of a conversation; Stream a generated response token by token into a terminal app; Get a recommendation returned as validated JSON for downstream code

What Gemini agents API does

  • Agent lifecycle operations

    Covers creating, reading, listing, updating and deleting custom Agent resources over REST.

  • Long-running operation polling

    Shows how to track agent provisioning through an asynchronous operation until it completes.

  • Mounted files and skills

    Describes mounting Cloud Storage folders or Skill Registry revisions into the agent workspace.

  • Built-in and MCP tools

    Lists built-in tools to enable and how to register external MCP servers with headers.

  • Safe partial updates

    Explains patching agents with an update_mask so only the named fields change.

  • Data plane handoff

    Shows how to reference a created agent in a conversation request and points to the interactions skill.

What Gemini interactions API does

  • Authentication and client setup

    Covers ADC login, enabling the API, and creating the client through environment variables, inline parameters or an API key.

  • Multi-turn stateful chats

    Shows how to chain turns with previous interaction IDs while server-side storage is on.

  • Streaming and structured output

    Explains typed streaming events and how to request JSON matching a Pydantic or schema definition.

  • Function calling flow

    Walks through declaring local tools, reading function call steps and returning function results.

  • Background managed agents

    Describes starting long-running research or coding agents in the background and polling their status.

  • REST API reference

    Provides HTTP endpoint details for shell scripts and non-SDK environments, with SSE streaming notes.

Gemini agents API vs Gemini interactions API: questions

Is Gemini agents API or Gemini interactions API cheaper?

Both are open source. Compare current plans on each official site.

What is the difference between Gemini agents API and Gemini interactions API?

Gemini agents API is an open-source agent skill for ai models and llm tooling. Gemini interactions API is an open-source agent skill for ai models and llm tooling.

Keep comparing