Gemini

agentscope-extensions-model-gemini integrates Google Gemini models through the Gemini API and supports the Vertex AI path through explicit configuration.

Add the dependency

<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope-extensions-model-gemini</artifactId>
    <version>${agentscope.version}</version>
</dependency>

ModelRegistry

Set GEMINI_API_KEY, then use the gemini:<model> id:

ReActAgent agent = ReActAgent.builder()
    .name("assistant")
    .model("gemini:gemini-2.0-flash") // Resolved internally by ModelRegistry.resolve(modelId)
    .build();

Explicit builder

Use the builder when you need custom API settings, Vertex AI credentials, formatter, transport, or generation options:

import io.agentscope.extensions.model.gemini.GeminiChatModel;

GeminiChatModel model = GeminiChatModel.builder()
    .apiKey(System.getenv("GEMINI_API_KEY"))
    .modelName("gemini-2.0-flash")
    .streamEnabled(true)
    .build();

Server-side tools

Gemini built-in tools run on the model provider instead of the local AgentScope toolkit. Build a Google GenAI SDK Tool definition, then wrap it with GeminiServerTool.of(...):

import io.agentscope.extensions.model.gemini.tool.GeminiServerTool;
import com.google.genai.types.GoogleSearch;
import com.google.genai.types.Tool;
import com.google.genai.types.UrlContext;

GeminiChatModel model = GeminiChatModel.builder()
    .apiKey(System.getenv("GEMINI_API_KEY"))
    .modelName("gemini-3.8-flash")
    .serverTools(List.of(
        GeminiServerTool.of(Tool.builder()
            .googleSearch(GoogleSearch.builder().build())
            .build()),
        GeminiServerTool.of(Tool.builder()
            .urlContext(UrlContext.builder())
            .build())
    ))
    .build();

When at least one server-side tool is configured, AgentScope enables Gemini server-side invocation context automatically and preserves returned calls and results in conversation history. Server-side tools can be combined with local function tools. Do not use GeminiServerTool.of(...) for custom function tools; it rejects those definitions.

Spring Boot

Spring Boot applications can use the Gemini starter:

<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope-gemini-spring-boot-starter</artifactId>
    <version>${agentscope.version}</version>
</dependency>

Full builder options, formatters, credentials, and registry context details are covered in Model.

Integration

Channels

Distributed storage

Add the dependency

ModelRegistry

Explicit builder

Server-side tools

Spring Boot

​Add the dependency

​ModelRegistry

​Explicit builder

​Server-side tools

​Spring Boot

Add the dependency

ModelRegistry

Explicit builder

Server-side tools

Spring Boot