Struct WebSearchTool 

pub struct WebSearchTool<P: SearchProvider> { /* private fields */ }

Web search tool that uses a configurable search provider.

This tool allows agents to search the web using any implementation of the SearchProvider trait.

Example

use agent_sdk::web::{WebSearchTool, BraveSearchProvider};

let provider = BraveSearchProvider::new("api-key");
let tool = WebSearchTool::new(provider);

// Register with agent
tools.register(tool);

Implementations

impl<P: SearchProvider> WebSearchTool<P>

pub fn new(provider: P) -> Self

Create a new web search tool with the given provider.

pub const fn with_shared_provider(provider: Arc<P>) -> Self

Create a web search tool with a shared provider.

pub const fn with_max_results(self, max: usize) -> Self

Set the default maximum number of results.

Trait Implementations

impl<Ctx, P> Tool<Ctx> for WebSearchTool<P>

where Ctx: Send + Sync + 'static, P: SearchProvider + 'static,

type Name = PrimitiveToolName

The type of name for this tool.

fn name(&self) -> PrimitiveToolName

Returns the tool’s strongly-typed name.

fn display_name(&self) -> &'static str

Human-readable display name for UI (e.g., “Read File” vs “read”).

fn description(&self) -> &'static str

Human-readable description of what the tool does.

fn input_schema(&self) -> Value

JSON schema for the tool’s input parameters.

fn tier(&self) -> ToolTier

Permission tier for this tool.

async fn execute( &self, _ctx: &ToolContext<Ctx>, input: Value, ) -> Result<ToolResult>

Execute the tool with the given input.