Struct BypassBuiltinTool 

pub struct BypassBuiltinTool { /* private fields */ }

Available on crate feature tools only.

A built-in tool converted into a function-calling tool so it can coexist with custom function tools under the Gemini Interactions API.

The wrapper is provider-neutral and generic: any built-in tool can adopt it by supplying a name, description, parameter schema, the field that carries the natural-language query, and an internal agent that performs the built-in behaviour.

Example

use adk_tool::GoogleSearchTool;
use std::sync::Arc;

// `search_agent` is an LlmAgent configured with GoogleSearchTool + a Gemini model.
let tool = GoogleSearchTool::new().with_bypass_multi_tools_limit(Arc::new(search_agent));
assert!(!tool.is_builtin());

Implementations

impl BypassBuiltinTool

pub fn new( name: impl Into<String>, description: impl Into<String>, parameters_schema: Value, query_field: impl Into<String>, agent: Arc<dyn Agent>, ) -> BypassBuiltinTool

Create a bypass wrapper around agent.

• name / description — surfaced to the model as a function tool.
• parameters_schema — the JSON Schema for the function’s parameters.
• query_field — the property in the incoming arguments that carries the natural-language query forwarded to the internal agent.
• agent — the internal single-turn agent that performs the built-in behaviour (e.g. an LlmAgent with the built-in Google Search tool).

Trait Implementations

impl Tool for BypassBuiltinTool

fn is_builtin(&self) -> bool

Bypass-converted tools are ordinary function-calling tools, never built-in. This is what allows them to coexist with custom function tools.

fn name(&self) -> &str

Returns the unique name of this tool.

fn description(&self) -> &str

Returns a human-readable description of what this tool does.

fn parameters_schema(&self) -> Option<Value>

Returns the JSON Schema for this tool’s parameters, if any.

fn execute<'life0, 'async_trait>( &'life0 self, ctx: Arc<dyn ToolContext>, args: Value, ) -> Pin<Box<dyn Future<Output = Result<Value, AdkError>> + Send + 'async_trait>>

where 'life0: 'async_trait, BypassBuiltinTool: 'async_trait,

Executes the tool with the given context and arguments.

fn declaration(&self) -> Value

Returns the tool declaration that should be exposed to model providers.

fn enhanced_description(&self) -> String

Returns an enhanced description that may include additional notes. For long-running tools, this includes a warning not to call the tool again if it has already returned a pending status. Default implementation returns the base description.

fn is_long_running(&self) -> bool

Indicates whether the tool is a long-running operation. Long-running tools typically return a task ID immediately and complete the operation asynchronously.

fn response_schema(&self) -> Option<Value>

Returns the JSON Schema for this tool’s response, if any.

fn required_scopes(&self) -> &[&str]

Returns the scopes required to execute this tool.

fn is_read_only(&self) -> bool

Indicates whether this tool performs no side effects. Read-only tools may be executed concurrently in Auto mode.

fn is_concurrency_safe(&self) -> bool

Indicates whether this tool is safe for concurrent execution. Used by the Parallel strategy to validate dispatch safety.