WebSearchToolboxTool interface

Package:

@azure/ai-projects

A web search tool stored in a toolbox.

Extends

ToolboxTool

Properties

custom_search_configuration	The project connections attached to this tool. There can be a maximum of 1 connection resource attached to the tool.
filters
search_context_size	High level guidance for the amount of context window space to use for the search. One of low, medium, or high. medium is the default.
type	The discriminator possible values: code_interpreter, file_search, web_search, mcp, azure_ai_search, openapi, a2a_preview, browser_automation_preview, reminder_preview, work_iq_preview, fabric_iq_preview, toolbox_search_preview
user_location

Inherited Properties

description	Optional user-defined description for this tool or configuration.
name	Optional user-defined name for this tool or configuration.
tool_configs	Per-tool configuration map. Keys are tool names or * (catch-all default). Resolution order: exact tool name match takes priority over *. Unknown tool names are silently ignored at runtime.

Property Details

custom_search_configuration

The project connections attached to this tool. There can be a maximum of 1 connection resource attached to the tool.

custom_search_configuration?: WebSearchConfiguration

Property Value

WebSearchConfiguration

filters

filters?: WebSearchToolFilters

Property Value

WebSearchToolFilters

search_context_size

High level guidance for the amount of context window space to use for the search. One of low, medium, or high. medium is the default.

search_context_size?: "low" | "medium" | "high"

Property Value

"low" | "medium" | "high"

type

The discriminator possible values: code_interpreter, file_search, web_search, mcp, azure_ai_search, openapi, a2a_preview, browser_automation_preview, reminder_preview, work_iq_preview, fabric_iq_preview, toolbox_search_preview

type: "web_search"

Property Value

"web_search"

user_location

user_location?: WebSearchApproximateLocation

Property Value

WebSearchApproximateLocation

Inherited Property Details

description

Optional user-defined description for this tool or configuration.

description?: string

Property Value

string

Inherited From ToolboxTool.description

name

Optional user-defined name for this tool or configuration.

name?: string

Property Value

string

Inherited From ToolboxTool.name

tool_configs

Per-tool configuration map. Keys are tool names or * (catch-all default). Resolution order: exact tool name match takes priority over *. Unknown tool names are silently ignored at runtime.

tool_configs?: Record<string, ToolConfig>

Property Value

Record<string, ToolConfig>

Inherited From ToolboxTool.tool_configs