Module: tool

Builders in this module

Builder

Description

ActiveStreamingTool

Manages streaming tool related resources during invocation.

AgentTool

A tool that wraps an agent.

APIHubToolset

APIHubTool generates tools from a given API Hub resource.

ApplicationIntegrationToolset

ApplicationIntegrationToolset generates tools from a given Application.

IntegrationConnectorTool

A tool that wraps a RestApiTool to interact with a specific Application Integration endpoint.

BaseAuthenticatedTool

A base tool class that handles authentication before the actual tool logic.

BaseTool

The base class for all tools.

BaseToolset

Base class for toolset.

BigQueryToolset

BigQuery Toolset contains tools for interacting with BigQuery data and metadata.

BigtableToolset

Bigtable Toolset contains tools for interacting with Bigtable data and metadata.

ComputerUseTool

A tool that wraps computer control functions for use with LLMs.

ComputerUseToolset

Fluent builder for ComputerUseToolset.

DataAgentToolset

Data Agent Toolset contains tools for interacting with data agents.

DiscoveryEngineSearchTool

Tool for searching the discovery engine.

EnterpriseWebSearchTool

A Gemini 2+ built-in tool using web grounding for Enterprise compliance.

ExampleTool

A tool that adds (few-shot) examples to the LLM request.

FunctionTool

A tool that wraps a user-defined Python function.

GoogleApiTool

Fluent builder for GoogleApiTool.

GoogleApiToolset

Google API Toolset contains tools for interacting with Google APIs.

CalendarToolset

Auto-generated Calendar toolset based on Google Calendar API v3 spec exposed by Google API discovery API.

DocsToolset

Auto-generated Docs toolset based on Google Docs API v1 spec exposed by Google API discovery API.

GmailToolset

Auto-generated Gmail toolset based on Google Gmail API v1 spec exposed by Google API discovery API.

SheetsToolset

Auto-generated Sheets toolset based on Google Sheets API v4 spec exposed by Google API discovery API.

SlidesToolset

Auto-generated Slides toolset based on Google Slides API v1 spec exposed by Google API discovery API.

YoutubeToolset

Auto-generated YouTube toolset based on YouTube API v3 spec exposed by Google API discovery API.

GoogleMapsGroundingTool

A built-in tool that is automatically invoked by Gemini 2 models to ground query results with Google Maps.

GoogleSearchAgentTool

A tool that wraps a sub-agent that only uses google_search tool.

GoogleSearchTool

A built-in tool that is automatically invoked by Gemini 2 models to retrieve search results from Google Search.

GoogleTool

GoogleTool class for tools that call Google APIs.

LoadArtifactsTool

A tool that loads the artifacts and adds them to the session.

LoadMcpResourceTool

A tool that loads the MCP resources and adds them to the session.

LoadMemoryTool

A tool that loads the memory for the current user.

LongRunningFunctionTool

A function tool that returns the result asynchronously.

MCPTool

Deprecated name, use McpTool instead.

McpTool

Turns an MCP Tool into an ADK Tool.

MCPToolset

Deprecated name, use McpToolset instead.

McpToolset

Connects to a MCP Server, and retrieves MCP Tools into ADK Tools.

OpenAPIToolset

Class for parsing OpenAPI spec into a list of RestApiTool.

RestApiTool

A generic tool that interacts with a REST API.

PreloadMemoryTool

A tool that preloads the memory for the current user.

PubSubToolset

Pub/Sub Toolset contains tools for interacting with Pub/Sub topics and subscriptions.

BaseRetrievalTool

Fluent builder for BaseRetrievalTool.

SetModelResponseTool

Internal tool used for output schema workaround.

LoadSkillResourceTool

Tool to load resources (references or assets) from a skill.

LoadSkillTool

Tool to load a skill’s instructions.

SkillToolset

A toolset for managing and interacting with agent skills.

SpannerToolset

Spanner Toolset contains tools for interacting with Spanner data, database and table information.

ToolboxToolset

A class that provides access to toolbox toolsets.

TransferToAgentTool

A specialized FunctionTool for agent transfer with enum constraints.

UrlContextTool

A built-in tool that is automatically invoked by Gemini 2 models to retrieve content from the URLs and use that content to inform and shape its response.

VertexAiSearchTool

A built-in tool using Vertex AI Search.

ActiveStreamingTool

Fluent builder for google.adk.agents.active_streaming_tool.ActiveStreamingTool

Manages streaming tool related resources during invocation.

Quick start:

from adk_fluent import ActiveStreamingTool

result = (
    ActiveStreamingTool()
    .build()
)

Control Flow & Execution

.build() -> ActiveStreamingTool Control Flow & Execution

Resolve into a native ADK ActiveStreamingTool.

Example:

activestreamingtool = ActiveStreamingTool("activestreamingtool").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.task(value)

`Task

.stream(value)

`LiveRequestQueue


AgentTool

Fluent builder for google.adk.tools.agent_tool.AgentTool

A tool that wraps an agent.

Quick start:

from adk_fluent import AgentTool

result = (
    AgentTool("agent_value")
    .build()
)

Constructor

AgentTool(agent: BaseAgent)

Argument

Type

agent

BaseAgent

Control Flow & Execution

.build() -> AgentTool Control Flow & Execution

Resolve into a native ADK AgentTool.

Example:

agenttool = AgentTool("agenttool").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.skip_summarization(value)

bool

.include_plugins(value)

bool


APIHubToolset

Fluent builder for google.adk.tools.apihub_tool.apihub_toolset.APIHubToolset

APIHubTool generates tools from a given API Hub resource.

Quick start:

from adk_fluent import APIHubToolset

result = (
    APIHubToolset("apihub_resource_name_value")
    .build()
)

Constructor

APIHubToolset(apihub_resource_name: str)

Argument

Type

apihub_resource_name

str

Control Flow & Execution

.build() -> APIHubToolset Control Flow & Execution

Resolve into a native ADK APIHubToolset.

Example:

apihubtoolset = APIHubToolset("apihubtoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.access_token(value)

`str

.service_account_json(value)

`str

.name(value)

str

.description(value)

str

.lazy_load_spec(value)

Any

.auth_scheme(value)

`AuthScheme

.auth_credential(value)

`AuthCredential

.apihub_client(value)

`APIHubClient

.tool_filter(value)

`ToolPredicate


ApplicationIntegrationToolset

Fluent builder for google.adk.tools.application_integration_tool.application_integration_toolset.ApplicationIntegrationToolset

ApplicationIntegrationToolset generates tools from a given Application.

Quick start:

from adk_fluent import ApplicationIntegrationToolset

result = (
    ApplicationIntegrationToolset("project_value", "location_value")
    .build()
)

Constructor

ApplicationIntegrationToolset(project: str, location: str)

Argument

Type

project

str

location

str

Control Flow & Execution

.build() -> ApplicationIntegrationToolset Control Flow & Execution

Resolve into a native ADK ApplicationIntegrationToolset.

Example:

applicationintegrationtoolset = ApplicationIntegrationToolset("applicationintegrationtoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.connection_template_override(value)

`str

.integration(value)

`str

.triggers(value)

`list[str]

.connection(value)

`str

.entity_operations(value)

`str

.actions(value)

`list[str]

.tool_name_prefix(value)

`str

.tool_instructions(value)

`str

.service_account_json(value)

`str

.auth_scheme(value)

`AuthScheme

.auth_credential(value)

`AuthCredential

.tool_filter(value)

`ToolPredicate


IntegrationConnectorTool

Fluent builder for google.adk.tools.application_integration_tool.integration_connector_tool.IntegrationConnectorTool

A tool that wraps a RestApiTool to interact with a specific Application Integration endpoint.

Quick start:

from adk_fluent import IntegrationConnectorTool

result = (
    IntegrationConnectorTool("name_value", "description_value", "connection_name_value")
    .build()
)

Constructor

IntegrationConnectorTool(name: str, description: str, connection_name: str)

Argument

Type

name

str

description

str

connection_name

str

Control Flow & Execution

.build() -> IntegrationConnectorTool Control Flow & Execution

Resolve into a native ADK IntegrationConnectorTool.

Example:

integrationconnectortool = IntegrationConnectorTool("integrationconnectortool").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.connection_host(value)

str

.connection_service_name(value)

str

.entity(value)

str

.operation(value)

str

.action(value)

str

.rest_api_tool(value)

RestApiTool

.auth_scheme(value)

`AuthScheme

.auth_credential(value)

`AuthCredential


BaseAuthenticatedTool

Fluent builder for google.adk.tools.base_authenticated_tool.BaseAuthenticatedTool

A base tool class that handles authentication before the actual tool logic.

Quick start:

from adk_fluent import BaseAuthenticatedTool

result = (
    BaseAuthenticatedTool("name_value", "description_value")
    .build()
)

Constructor

BaseAuthenticatedTool(name: Any, description: Any)

Argument

Type

name

Any

description

Any

Control Flow & Execution

.build() -> BaseAuthenticatedTool Control Flow & Execution

Resolve into a native ADK BaseAuthenticatedTool.

Example:

baseauthenticatedtool = BaseAuthenticatedTool("baseauthenticatedtool").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.auth_config(value)

AuthConfig

.response_for_auth_required(value)

`dict[str, Any]


BaseTool

Fluent builder for google.adk.tools.base_tool.BaseTool

The base class for all tools.

Quick start:

from adk_fluent import BaseTool

result = (
    BaseTool("name_value", "description_value")
    .build()
)

Constructor

BaseTool(name: Any, description: Any)

Argument

Type

name

Any

description

Any

Control Flow & Execution

.build() -> BaseTool Control Flow & Execution

Resolve into a native ADK BaseTool.

Example:

basetool = BaseTool("basetool").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.is_long_running(value)

bool

.custom_metadata(value)

`dict[str, Any]


BaseToolset

Fluent builder for google.adk.tools.base_toolset.BaseToolset

Base class for toolset.

Quick start:

from adk_fluent import BaseToolset

result = (
    BaseToolset()
    .build()
)

Control Flow & Execution

.build() -> BaseToolset Control Flow & Execution

Resolve into a native ADK BaseToolset.

Example:

basetoolset = BaseToolset("basetoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.tool_filter(value)

`ToolPredicate

.tool_name_prefix(value)

`str


BigQueryToolset

Fluent builder for google.adk.tools.bigquery.bigquery_toolset.BigQueryToolset

BigQuery Toolset contains tools for interacting with BigQuery data and metadata.

Quick start:

from adk_fluent import BigQueryToolset

result = (
    BigQueryToolset()
    .build()
)

Control Flow & Execution

.build() -> BigQueryToolset Control Flow & Execution

Resolve into a native ADK BigQueryToolset.

Example:

bigquerytoolset = BigQueryToolset("bigquerytoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.tool_filter(value)

`ToolPredicate

.credentials_config(value)

`BigQueryCredentialsConfig

.bigquery_tool_config(value)

`BigQueryToolConfig


BigtableToolset

Fluent builder for google.adk.tools.bigtable.bigtable_toolset.BigtableToolset

Bigtable Toolset contains tools for interacting with Bigtable data and metadata.

Quick start:

from adk_fluent import BigtableToolset

result = (
    BigtableToolset()
    .build()
)

Control Flow & Execution

.build() -> BigtableToolset Control Flow & Execution

Resolve into a native ADK BigtableToolset.

Example:

bigtabletoolset = BigtableToolset("bigtabletoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.tool_filter(value)

`ToolPredicate

.credentials_config(value)

`BigtableCredentialsConfig

.bigtable_tool_settings(value)

`BigtableToolSettings


ComputerUseTool

Fluent builder for google.adk.tools.computer_use.computer_use_tool.ComputerUseTool

A tool that wraps computer control functions for use with LLMs.

Quick start:

from adk_fluent import ComputerUseTool

result = (
    ComputerUseTool("func_value", "screen_size_value")
    .build()
)

Constructor

ComputerUseTool(func: Callable[..., Any], screen_size: tuple[int, int])

Argument

Type

func

Callable[..., Any]

screen_size

tuple[int, int]

Control Flow & Execution

.build() -> ComputerUseTool Control Flow & Execution

Resolve into a native ADK ComputerUseTool.

Example:

computerusetool = ComputerUseTool("computerusetool").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.virtual_screen_size(value)

tuple[int, int]


ComputerUseToolset

Fluent builder for google.adk.tools.computer_use.computer_use_toolset.ComputerUseToolset

Fluent builder for ComputerUseToolset.

Quick start:

from adk_fluent import ComputerUseToolset

result = (
    ComputerUseToolset("computer_value")
    .build()
)

Constructor

ComputerUseToolset(computer: BaseComputer)

Argument

Type

computer

BaseComputer

Control Flow & Execution

.build() -> ComputerUseToolset Control Flow & Execution

Resolve into a native ADK ComputerUseToolset.

Example:

computerusetoolset = ComputerUseToolset("computerusetoolset").build("...")

DataAgentToolset

Fluent builder for google.adk.tools.data_agent.data_agent_toolset.DataAgentToolset

Data Agent Toolset contains tools for interacting with data agents.

Quick start:

from adk_fluent import DataAgentToolset

result = (
    DataAgentToolset()
    .build()
)

Control Flow & Execution

.build() -> DataAgentToolset Control Flow & Execution

Resolve into a native ADK DataAgentToolset.

Example:

dataagenttoolset = DataAgentToolset("dataagenttoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.tool_filter(value)

`ToolPredicate

.credentials_config(value)

`DataAgentCredentialsConfig

.data_agent_tool_config(value)

`DataAgentToolConfig


DiscoveryEngineSearchTool

Fluent builder for google.adk.tools.discovery_engine_search_tool.DiscoveryEngineSearchTool

Tool for searching the discovery engine.

Quick start:

from adk_fluent import DiscoveryEngineSearchTool

result = (
    DiscoveryEngineSearchTool()
    .build()
)

Control Flow & Execution

.build() -> DiscoveryEngineSearchTool Control Flow & Execution

Resolve into a native ADK DiscoveryEngineSearchTool.

Example:

discoveryenginesearchtool = DiscoveryEngineSearchTool("discoveryenginesearchtool").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.data_store_id(value)

`str

.data_store_specs(value)

`list[types.VertexAISearchDataStoreSpec]

.search_engine_id(value)

`str

.filter(value)

`str

.max_results(value)

`int


EnterpriseWebSearchTool

Fluent builder for google.adk.tools.enterprise_search_tool.EnterpriseWebSearchTool

A Gemini 2+ built-in tool using web grounding for Enterprise compliance.

Quick start:

from adk_fluent import EnterpriseWebSearchTool

result = (
    EnterpriseWebSearchTool()
    .build()
)

Control Flow & Execution

.build() -> EnterpriseWebSearchTool Control Flow & Execution

Resolve into a native ADK EnterpriseWebSearchTool.

Example:

enterprisewebsearchtool = EnterpriseWebSearchTool("enterprisewebsearchtool").build("...")

ExampleTool

Fluent builder for google.adk.tools.example_tool.ExampleTool

A tool that adds (few-shot) examples to the LLM request.

Quick start:

from adk_fluent import ExampleTool

result = (
    ExampleTool("examples_value")
    .build()
)

Constructor

ExampleTool(examples: list[Example] | BaseExampleProvider)

Argument

Type

examples

`list[Example]

Control Flow & Execution

.build() -> ExampleTool Control Flow & Execution

Resolve into a native ADK ExampleTool.

Example:

exampletool = ExampleTool("exampletool").build("...")

FunctionTool

Fluent builder for google.adk.tools.function_tool.FunctionTool

A tool that wraps a user-defined Python function.

Quick start:

from adk_fluent import FunctionTool

result = (
    FunctionTool("func_value")
    .build()
)

Constructor

FunctionTool(func: Callable[..., Any])

Argument

Type

func

Callable[..., Any]

Control Flow & Execution

.build() -> FunctionTool Control Flow & Execution

Resolve into a native ADK FunctionTool.

Example:

functiontool = FunctionTool("functiontool").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.require_confirmation(value)

`bool


GoogleApiTool

Fluent builder for google.adk.tools.google_api_tool.google_api_tool.GoogleApiTool

Fluent builder for GoogleApiTool.

Quick start:

from adk_fluent import GoogleApiTool

result = (
    GoogleApiTool("rest_api_tool_value")
    .build()
)

Constructor

GoogleApiTool(rest_api_tool: RestApiTool)

Argument

Type

rest_api_tool

RestApiTool

Control Flow & Execution

.build() -> GoogleApiTool Control Flow & Execution

Resolve into a native ADK GoogleApiTool.

Example:

googleapitool = GoogleApiTool("googleapitool").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.client_id(value)

`str

.client_secret(value)

`str

.service_account(value)

`ServiceAccount

.additional_headers(value)

`dict[str, str]


GoogleApiToolset

Fluent builder for google.adk.tools.google_api_tool.google_api_toolset.GoogleApiToolset

Google API Toolset contains tools for interacting with Google APIs.

Quick start:

from adk_fluent import GoogleApiToolset

result = (
    GoogleApiToolset("api_name_value", "api_version_value")
    .build()
)

Constructor

GoogleApiToolset(api_name: str, api_version: str)

Argument

Type

api_name

str

api_version

str

Control Flow & Execution

.build() -> GoogleApiToolset Control Flow & Execution

Resolve into a native ADK GoogleApiToolset.

Example:

googleapitoolset = GoogleApiToolset("googleapitoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.client_id(value)

`str

.client_secret(value)

`str

.tool_filter(value)

`ToolPredicate

.service_account(value)

`ServiceAccount

.tool_name_prefix(value)

`str

.additional_headers(value)

`dict[str, str]


CalendarToolset

Fluent builder for google.adk.tools.google_api_tool.google_api_toolsets.CalendarToolset

Auto-generated Calendar toolset based on Google Calendar API v3 spec exposed by Google API discovery API.

Quick start:

from adk_fluent import CalendarToolset

result = (
    CalendarToolset()
    .build()
)

Control Flow & Execution

.build() -> CalendarToolset Control Flow & Execution

Resolve into a native ADK CalendarToolset.

Example:

calendartoolset = CalendarToolset("calendartoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.client_id(value)

`str

.client_secret(value)

`str

.tool_filter(value)

`ToolPredicate

.service_account(value)

`ServiceAccount

.tool_name_prefix(value)

`str


DocsToolset

Fluent builder for google.adk.tools.google_api_tool.google_api_toolsets.DocsToolset

Auto-generated Docs toolset based on Google Docs API v1 spec exposed by Google API discovery API.

Quick start:

from adk_fluent import DocsToolset

result = (
    DocsToolset()
    .build()
)

Control Flow & Execution

.build() -> DocsToolset Control Flow & Execution

Resolve into a native ADK DocsToolset.

Example:

docstoolset = DocsToolset("docstoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.client_id(value)

`str

.client_secret(value)

`str

.tool_filter(value)

`ToolPredicate

.service_account(value)

`ServiceAccount

.tool_name_prefix(value)

`str


GmailToolset

Fluent builder for google.adk.tools.google_api_tool.google_api_toolsets.GmailToolset

Auto-generated Gmail toolset based on Google Gmail API v1 spec exposed by Google API discovery API.

Quick start:

from adk_fluent import GmailToolset

result = (
    GmailToolset()
    .build()
)

Control Flow & Execution

.build() -> GmailToolset Control Flow & Execution

Resolve into a native ADK GmailToolset.

Example:

gmailtoolset = GmailToolset("gmailtoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.client_id(value)

`str

.client_secret(value)

`str

.tool_filter(value)

`ToolPredicate

.service_account(value)

`ServiceAccount

.tool_name_prefix(value)

`str


SheetsToolset

Fluent builder for google.adk.tools.google_api_tool.google_api_toolsets.SheetsToolset

Auto-generated Sheets toolset based on Google Sheets API v4 spec exposed by Google API discovery API.

Quick start:

from adk_fluent import SheetsToolset

result = (
    SheetsToolset()
    .build()
)

Control Flow & Execution

.build() -> SheetsToolset Control Flow & Execution

Resolve into a native ADK SheetsToolset.

Example:

sheetstoolset = SheetsToolset("sheetstoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.client_id(value)

`str

.client_secret(value)

`str

.tool_filter(value)

`ToolPredicate

.service_account(value)

`ServiceAccount

.tool_name_prefix(value)

`str


SlidesToolset

Fluent builder for google.adk.tools.google_api_tool.google_api_toolsets.SlidesToolset

Auto-generated Slides toolset based on Google Slides API v1 spec exposed by Google API discovery API.

Quick start:

from adk_fluent import SlidesToolset

result = (
    SlidesToolset()
    .build()
)

Control Flow & Execution

.build() -> SlidesToolset Control Flow & Execution

Resolve into a native ADK SlidesToolset.

Example:

slidestoolset = SlidesToolset("slidestoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.client_id(value)

`str

.client_secret(value)

`str

.tool_filter(value)

`ToolPredicate

.service_account(value)

`ServiceAccount

.tool_name_prefix(value)

`str


YoutubeToolset

Fluent builder for google.adk.tools.google_api_tool.google_api_toolsets.YoutubeToolset

Auto-generated YouTube toolset based on YouTube API v3 spec exposed by Google API discovery API.

Quick start:

from adk_fluent import YoutubeToolset

result = (
    YoutubeToolset()
    .build()
)

Control Flow & Execution

.build() -> YoutubeToolset Control Flow & Execution

Resolve into a native ADK YoutubeToolset.

Example:

youtubetoolset = YoutubeToolset("youtubetoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.client_id(value)

`str

.client_secret(value)

`str

.tool_filter(value)

`ToolPredicate

.service_account(value)

`ServiceAccount

.tool_name_prefix(value)

`str


GoogleMapsGroundingTool

Fluent builder for google.adk.tools.google_maps_grounding_tool.GoogleMapsGroundingTool

A built-in tool that is automatically invoked by Gemini 2 models to ground query results with Google Maps.

Quick start:

from adk_fluent import GoogleMapsGroundingTool

result = (
    GoogleMapsGroundingTool()
    .build()
)

Control Flow & Execution

.build() -> GoogleMapsGroundingTool Control Flow & Execution

Resolve into a native ADK GoogleMapsGroundingTool.

Example:

googlemapsgroundingtool = GoogleMapsGroundingTool("googlemapsgroundingtool").build("...")

GoogleSearchAgentTool

Fluent builder for google.adk.tools.google_search_agent_tool.GoogleSearchAgentTool

A tool that wraps a sub-agent that only uses google_search tool.

Quick start:

from adk_fluent import GoogleSearchAgentTool

result = (
    GoogleSearchAgentTool("agent_value")
    .build()
)

Constructor

GoogleSearchAgentTool(agent: LlmAgent)

Argument

Type

agent

LlmAgent

Control Flow & Execution

.build() -> GoogleSearchAgentTool Control Flow & Execution

Resolve into a native ADK GoogleSearchAgentTool.

Example:

googlesearchagenttool = GoogleSearchAgentTool("googlesearchagenttool").build("...")

GoogleSearchTool

Fluent builder for google.adk.tools.google_search_tool.GoogleSearchTool

A built-in tool that is automatically invoked by Gemini 2 models to retrieve search results from Google Search.

Quick start:

from adk_fluent import GoogleSearchTool

result = (
    GoogleSearchTool()
    .build()
)

Control Flow & Execution

.build() -> GoogleSearchTool Control Flow & Execution

Resolve into a native ADK GoogleSearchTool.

Example:

googlesearchtool = GoogleSearchTool("googlesearchtool").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.bypass_multi_tools_limit(value)

bool

.model(value)

`str


GoogleTool

Fluent builder for google.adk.tools.google_tool.GoogleTool

GoogleTool class for tools that call Google APIs.

Quick start:

from adk_fluent import GoogleTool

result = (
    GoogleTool("func_value")
    .build()
)

Constructor

GoogleTool(func: Callable[..., Any])

Argument

Type

func

Callable[..., Any]

Control Flow & Execution

.build() -> GoogleTool Control Flow & Execution

Resolve into a native ADK GoogleTool.

Example:

googletool = GoogleTool("googletool").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.credentials_config(value)

`BaseGoogleCredentialsConfig

.tool_settings(value)

`BaseModel


LoadArtifactsTool

Fluent builder for google.adk.tools.load_artifacts_tool.LoadArtifactsTool

A tool that loads the artifacts and adds them to the session.

Quick start:

from adk_fluent import LoadArtifactsTool

result = (
    LoadArtifactsTool()
    .build()
)

Control Flow & Execution

.build() -> LoadArtifactsTool Control Flow & Execution

Resolve into a native ADK LoadArtifactsTool.

Example:

loadartifactstool = LoadArtifactsTool("loadartifactstool").build("...")

LoadMcpResourceTool

Fluent builder for google.adk.tools.load_mcp_resource_tool.LoadMcpResourceTool

A tool that loads the MCP resources and adds them to the session.

Quick start:

from adk_fluent import LoadMcpResourceTool

result = (
    LoadMcpResourceTool("mcp_toolset_value")
    .build()
)

Constructor

LoadMcpResourceTool(mcp_toolset: McpToolset)

Argument

Type

mcp_toolset

McpToolset

Control Flow & Execution

.build() -> LoadMcpResourceTool Control Flow & Execution

Resolve into a native ADK LoadMcpResourceTool.

Example:

loadmcpresourcetool = LoadMcpResourceTool("loadmcpresourcetool").build("...")

LoadMemoryTool

Fluent builder for google.adk.tools.load_memory_tool.LoadMemoryTool

A tool that loads the memory for the current user.

Quick start:

from adk_fluent import LoadMemoryTool

result = (
    LoadMemoryTool()
    .build()
)

Control Flow & Execution

.build() -> LoadMemoryTool Control Flow & Execution

Resolve into a native ADK LoadMemoryTool.

Example:

loadmemorytool = LoadMemoryTool("loadmemorytool").build("...")

LongRunningFunctionTool

Fluent builder for google.adk.tools.long_running_tool.LongRunningFunctionTool

A function tool that returns the result asynchronously.

Quick start:

from adk_fluent import LongRunningFunctionTool

result = (
    LongRunningFunctionTool("func_value")
    .build()
)

Constructor

LongRunningFunctionTool(func: Callable)

Argument

Type

func

Callable

Control Flow & Execution

.build() -> LongRunningFunctionTool Control Flow & Execution

Resolve into a native ADK LongRunningFunctionTool.

Example:

longrunningfunctiontool = LongRunningFunctionTool("longrunningfunctiontool").build("...")

MCPTool

Fluent builder for google.adk.tools.mcp_tool.mcp_tool.MCPTool

Deprecated name, use McpTool instead.

Quick start:

from adk_fluent import MCPTool

result = (
    MCPTool("args_value", "kwargs_value")
    .build()
)

Constructor

MCPTool(args: Any, kwargs: Any)

Argument

Type

args

Any

kwargs

Any

Control Flow & Execution

.build() -> MCPTool Control Flow & Execution

Resolve into a native ADK MCPTool.

Example:

mcptool = MCPTool("mcptool").build("...")

McpTool

Fluent builder for google.adk.tools.mcp_tool.mcp_tool.McpTool

Turns an MCP Tool into an ADK Tool.

Quick start:

from adk_fluent import McpTool

result = (
    McpTool("mcp_tool_value", "mcp_session_manager_value")
    .build()
)

Constructor

McpTool(mcp_tool: McpBaseTool, mcp_session_manager: MCPSessionManager)

Argument

Type

mcp_tool

McpBaseTool

mcp_session_manager

MCPSessionManager

Control Flow & Execution

.build() -> McpTool Control Flow & Execution

Resolve into a native ADK McpTool.

Example:

mcptool = McpTool("mcptool").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.auth_scheme(value)

`AuthScheme

.auth_credential(value)

`AuthCredential

.require_confirmation(value)

`bool

.header_provider(value)

`Callable[[ReadonlyContext], dict[str, str]]

.progress_callback(value)

`ProgressFnT


MCPToolset

Fluent builder for google.adk.tools.mcp_tool.mcp_toolset.MCPToolset

Deprecated name, use McpToolset instead.

Quick start:

from adk_fluent import MCPToolset

result = (
    MCPToolset("args_value", "kwargs_value")
    .build()
)

Constructor

MCPToolset(args: Any, kwargs: Any)

Argument

Type

args

Any

kwargs

Any

Control Flow & Execution

.build() -> MCPToolset Control Flow & Execution

Resolve into a native ADK MCPToolset.

Example:

mcptoolset = MCPToolset("mcptoolset").build("...")

McpToolset

Fluent builder for google.adk.tools.mcp_tool.mcp_toolset.McpToolset

Connects to a MCP Server, and retrieves MCP Tools into ADK Tools.

Quick start:

from adk_fluent import McpToolset

result = (
    McpToolset("connection_params_value")
    .build()
)

Constructor

McpToolset(connection_params: StdioServerParameters | StdioConnectionParams | SseConnectionParams | StreamableHTTPConnectionParams)

Argument

Type

connection_params

`StdioServerParameters

Control Flow & Execution

.build() -> McpToolset Control Flow & Execution

Resolve into a native ADK McpToolset.

Example:

mcptoolset = McpToolset("mcptoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.tool_filter(value)

`ToolPredicate

.tool_name_prefix(value)

`str

.errlog(value)

TextIO

.auth_scheme(value)

`AuthScheme

.auth_credential(value)

`AuthCredential

.require_confirmation(value)

`bool

.header_provider(value)

`Callable[[ReadonlyContext], dict[str, str]]

.progress_callback(value)

`ProgressFnT

.use_mcp_resources(value)

`bool


OpenAPIToolset

Fluent builder for google.adk.tools.openapi_tool.openapi_spec_parser.openapi_toolset.OpenAPIToolset

Class for parsing OpenAPI spec into a list of RestApiTool.

Quick start:

from adk_fluent import OpenAPIToolset

result = (
    OpenAPIToolset()
    .build()
)

Control Flow & Execution

.build() -> OpenAPIToolset Control Flow & Execution

Resolve into a native ADK OpenAPIToolset.

Example:

openapitoolset = OpenAPIToolset("openapitoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.spec_dict(value)

`dict[str, Any]

.spec_str(value)

`str

.spec_str_type(value)

Literal['json', 'yaml']

.auth_scheme(value)

`AuthScheme

.auth_credential(value)

`AuthCredential

.credential_key(value)

`str

.tool_filter(value)

`ToolPredicate

.tool_name_prefix(value)

`str

.ssl_verify(value)

`bool

.header_provider(value)

`Callable[[ReadonlyContext], dict[str, str]]


RestApiTool

Fluent builder for google.adk.tools.openapi_tool.openapi_spec_parser.rest_api_tool.RestApiTool

A generic tool that interacts with a REST API.

Quick start:

from adk_fluent import RestApiTool

result = (
    RestApiTool("name_value", "description_value", "endpoint_value")
    .build()
)

Constructor

RestApiTool(name: str, description: str, endpoint: OperationEndpoint | str)

Argument

Type

name

str

description

str

endpoint

`OperationEndpoint

Control Flow & Execution

.build() -> RestApiTool Control Flow & Execution

Resolve into a native ADK RestApiTool.

Example:

restapitool = RestApiTool("restapitool").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.operation(value)

`Operation

.auth_scheme(value)

`AuthScheme

.auth_credential(value)

`AuthCredential

.should_parse_operation(value)

Any

.ssl_verify(value)

`bool

.header_provider(value)

`Callable[[ReadonlyContext], dict[str, str]]

.credential_key(value)

`str


PreloadMemoryTool

Fluent builder for google.adk.tools.preload_memory_tool.PreloadMemoryTool

A tool that preloads the memory for the current user.

Quick start:

from adk_fluent import PreloadMemoryTool

result = (
    PreloadMemoryTool()
    .build()
)

Control Flow & Execution

.build() -> PreloadMemoryTool Control Flow & Execution

Resolve into a native ADK PreloadMemoryTool.

Example:

preloadmemorytool = PreloadMemoryTool("preloadmemorytool").build("...")

PubSubToolset

Fluent builder for google.adk.tools.pubsub.pubsub_toolset.PubSubToolset

Pub/Sub Toolset contains tools for interacting with Pub/Sub topics and subscriptions.

Quick start:

from adk_fluent import PubSubToolset

result = (
    PubSubToolset()
    .build()
)

Control Flow & Execution

.build() -> PubSubToolset Control Flow & Execution

Resolve into a native ADK PubSubToolset.

Example:

pubsubtoolset = PubSubToolset("pubsubtoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.tool_filter(value)

`ToolPredicate

.credentials_config(value)

`PubSubCredentialsConfig

.pubsub_tool_config(value)

`PubSubToolConfig


BaseRetrievalTool

Fluent builder for google.adk.tools.retrieval.base_retrieval_tool.BaseRetrievalTool

Fluent builder for BaseRetrievalTool.

Quick start:

from adk_fluent import BaseRetrievalTool

result = (
    BaseRetrievalTool("name_value", "description_value")
    .build()
)

Constructor

BaseRetrievalTool(name: Any, description: Any)

Argument

Type

name

Any

description

Any

Control Flow & Execution

.build() -> BaseRetrievalTool Control Flow & Execution

Resolve into a native ADK BaseRetrievalTool.

Example:

baseretrievaltool = BaseRetrievalTool("baseretrievaltool").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.is_long_running(value)

bool

.custom_metadata(value)

`dict[str, Any]


SetModelResponseTool

Fluent builder for google.adk.tools.set_model_response_tool.SetModelResponseTool

Internal tool used for output schema workaround.

Quick start:

from adk_fluent import SetModelResponseTool

result = (
    SetModelResponseTool("output_schema_value")
    .build()
)

Constructor

SetModelResponseTool(output_schema: type[BaseModel])

Argument

Type

output_schema

type[BaseModel]

Control Flow & Execution

.build() -> SetModelResponseTool Control Flow & Execution

Resolve into a native ADK SetModelResponseTool.

Example:

setmodelresponsetool = SetModelResponseTool("setmodelresponsetool").build("...")

LoadSkillResourceTool

Fluent builder for google.adk.tools.skill_toolset.LoadSkillResourceTool

Tool to load resources (references or assets) from a skill.

Quick start:

from adk_fluent import LoadSkillResourceTool

result = (
    LoadSkillResourceTool("toolset_value")
    .build()
)

Constructor

LoadSkillResourceTool(toolset: 'SkillToolset')

Argument

Type

toolset

'SkillToolset'

Control Flow & Execution

.build() -> LoadSkillResourceTool Control Flow & Execution

Resolve into a native ADK LoadSkillResourceTool.

Example:

loadskillresourcetool = LoadSkillResourceTool("loadskillresourcetool").build("...")

LoadSkillTool

Fluent builder for google.adk.tools.skill_toolset.LoadSkillTool

Tool to load a skill’s instructions.

Quick start:

from adk_fluent import LoadSkillTool

result = (
    LoadSkillTool("toolset_value")
    .build()
)

Constructor

LoadSkillTool(toolset: 'SkillToolset')

Argument

Type

toolset

'SkillToolset'

Control Flow & Execution

.build() -> LoadSkillTool Control Flow & Execution

Resolve into a native ADK LoadSkillTool.

Example:

loadskilltool = LoadSkillTool("loadskilltool").build("...")

SkillToolset

Fluent builder for google.adk.tools.skill_toolset.SkillToolset

A toolset for managing and interacting with agent skills.

Quick start:

from adk_fluent import SkillToolset

result = (
    SkillToolset("skills_value")
    .build()
)

Constructor

SkillToolset(skills: list[models.Skill])

Argument

Type

skills

list[models.Skill]

Control Flow & Execution

.build() -> SkillToolset Control Flow & Execution

Resolve into a native ADK SkillToolset.

Example:

skilltoolset = SkillToolset("skilltoolset").build("...")

SpannerToolset

Fluent builder for google.adk.tools.spanner.spanner_toolset.SpannerToolset

Spanner Toolset contains tools for interacting with Spanner data, database and table information.

Quick start:

from adk_fluent import SpannerToolset

result = (
    SpannerToolset()
    .build()
)

Control Flow & Execution

.build() -> SpannerToolset Control Flow & Execution

Resolve into a native ADK SpannerToolset.

Example:

spannertoolset = SpannerToolset("spannertoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.tool_filter(value)

`ToolPredicate

.credentials_config(value)

`SpannerCredentialsConfig

.spanner_tool_settings(value)

`SpannerToolSettings


ToolboxToolset

Fluent builder for google.adk.tools.toolbox_toolset.ToolboxToolset

A class that provides access to toolbox toolsets.

Quick start:

from adk_fluent import ToolboxToolset

result = (
    ToolboxToolset("server_url_value", "kwargs_value")
    .build()
)

Constructor

ToolboxToolset(server_url: str, kwargs: Any)

Argument

Type

server_url

str

kwargs

Any

Control Flow & Execution

.build() -> ToolboxToolset Control Flow & Execution

Resolve into a native ADK ToolboxToolset.

Example:

toolboxtoolset = ToolboxToolset("toolboxtoolset").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.toolset_name(value)

`str

.tool_names(value)

`list[str]

.auth_token_getters(value)

`Mapping[str, Callable[[], str]]

.bound_params(value)

`Mapping[str, Union[Callable[[], Any], Any]]

.credentials(value)

`CredentialConfig

.additional_headers(value)

`Mapping[str, str]


TransferToAgentTool

Fluent builder for google.adk.tools.transfer_to_agent_tool.TransferToAgentTool

A specialized FunctionTool for agent transfer with enum constraints.

Quick start:

from adk_fluent import TransferToAgentTool

result = (
    TransferToAgentTool("agent_names_value")
    .build()
)

Constructor

TransferToAgentTool(agent_names: list[str])

Argument

Type

agent_names

list[str]

Control Flow & Execution

.build() -> TransferToAgentTool Control Flow & Execution

Resolve into a native ADK TransferToAgentTool.

Example:

transfertoagenttool = TransferToAgentTool("transfertoagenttool").build("...")

UrlContextTool

Fluent builder for google.adk.tools.url_context_tool.UrlContextTool

A built-in tool that is automatically invoked by Gemini 2 models to retrieve content from the URLs and use that content to inform and shape its response.

Quick start:

from adk_fluent import UrlContextTool

result = (
    UrlContextTool()
    .build()
)

Control Flow & Execution

.build() -> UrlContextTool Control Flow & Execution

Resolve into a native ADK UrlContextTool.

Example:

urlcontexttool = UrlContextTool("urlcontexttool").build("...")

VertexAiSearchTool

Fluent builder for google.adk.tools.vertex_ai_search_tool.VertexAiSearchTool

A built-in tool using Vertex AI Search.

Quick start:

from adk_fluent import VertexAiSearchTool

result = (
    VertexAiSearchTool()
    .build()
)

Control Flow & Execution

.build() -> VertexAiSearchTool Control Flow & Execution

Resolve into a native ADK VertexAiSearchTool.

Example:

vertexaisearchtool = VertexAiSearchTool("vertexaisearchtool").build("...")

Forwarded Fields

These fields are available via __getattr__ forwarding.

Field

Type

.data_store_id(value)

`str

.data_store_specs(value)

`list[types.VertexAISearchDataStoreSpec]

.search_engine_id(value)

`str

.filter(value)

`str

.max_results(value)

`int

.bypass_multi_tools_limit(value)

bool