Struct ToolUseBlock 

pub struct ToolUseBlock { /* private fields */ }

Tool use request from the AI model.

When the model determines it needs to call a tool/function, it returns a ToolUseBlock specifying which tool to call and with what parameters. The application must then execute the tool and return results via ToolResultBlock.

Fields

• id: Unique identifier for this tool call, used to correlate results
• name: Name of the tool to execute (must match a registered tool)
• input: JSON parameters to pass to the tool

Example

use open_agent::{ToolUseBlock, ContentBlock};
use serde_json::json;

let block = ToolUseBlock::new(
    "call_123",
    "calculate",
    json!({"expression": "2 + 2"})
);
assert_eq!(block.id(), "call_123");
assert_eq!(block.name(), "calculate");

Implementations

impl ToolUseBlock

pub fn new(id: impl Into<String>, name: impl Into<String>, input: Value) -> Self

Creates a new tool use block.

Parameters

• id: Unique identifier for this tool call
• name: Name of the tool to execute
• input: JSON parameters for the tool

Example

use open_agent::ToolUseBlock;
use serde_json::json;

let block = ToolUseBlock::new(
    "call_abc",
    "search",
    json!({"query": "Rust async programming"})
);

pub fn id(&self) -> &str

Returns the unique identifier for this tool call.

pub fn name(&self) -> &str

Returns the name of the tool to execute.

pub fn input(&self) -> &Value

Returns the JSON parameters for the tool.

Trait Implementations

impl Clone for ToolUseBlock

fn clone(&self) -> ToolUseBlock

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ToolUseBlock

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolUseBlock

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ToolUseBlock

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.