Struct NodeTool 

pub struct NodeTool { /* private fields */ }

A Tool that runs a graph node, or a whole graph.

Implementations

impl NodeTool

pub fn for_node(graph: Arc<CompiledGraph>, node: impl Into<String>) -> Self

A tool that executes one node.

The node runs alone: no edges are followed and no checkpoint is written.

pub fn for_graph(graph: Arc<CompiledGraph>) -> Self

A tool that executes the whole graph.

pub fn with_name(self, name: impl Into<String>) -> Self

Set the name the model sees.

pub fn with_description(self, description: impl Into<String>) -> Self

Set the description the model sees.

The default names the node or graph, which tells a model nothing about when to call it. A real deployment should set this.

pub fn with_parameters_schema(self, schema: Value) -> Self

Set the parameter schema explicitly.

Trait Implementations

impl Tool for NodeTool

fn is_long_running(&self) -> bool

A graph may pause for approval, and a pause is not a value.

Reporting the tool as long-running routes that pause through the existing tool-confirmation path in adk-agent rather than inventing a second mechanism for it.

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>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: '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_builtin(&self) -> bool

Indicates whether this tool is a built-in server-side tool (e.g., google_search, url_context).

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.

fn is_concurrency_safe(&self) -> bool

Indicates whether this tool is safe for concurrent execution.