Struct ToolUseBlock 

pub struct ToolUseBlock {
    pub id: String,
    pub name: String,
    pub input: Value,
}

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");

Fields

id: String

Unique identifier for this tool call.

Generated by the model. Used to correlate the tool result back to this specific request, especially when multiple tools are called.

name: String

Name of the tool to execute.

Must match the name of a tool that was provided in the agent’s configuration, otherwise execution will fail.

input: Value

JSON parameters to pass to the tool.

The structure should match the tool’s input schema. The tool’s execution function receives this value as input.

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"})
);

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.