WebSearchTool Class

Web search.

Constructor

WebSearchTool(*args: Any, **kwargs: Any)

Variables

Name	Description
type	str or <xref:azure.ai.projects.models.WEB_SEARCH> The type of the web search tool. One of `web_search` or `web_search_2025_08_26`. Required. WEB_SEARCH.
external_web_access	bool Allow live internet access for web search. Defaults to true when omitted. When false, the web search tool runs in offline/cache-only mode and will not fetch new external content.
filters	WebSearchToolFilters
user_location	WebSearchApproximateLocation
search_context_size	str or str or str 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. Is one of the following types: Literal["low"], Literal["medium"], Literal["high"]
name	str Deprecated. This property is deprecated and will be removed in a future version.
description	str Deprecated. This property is deprecated and will be removed in a future version.
tool_configs	dict[str, ToolConfig] Deprecated. This property is deprecated and will be removed in a future version.
custom_search_configuration	WebSearchConfiguration The project connections attached to this tool. There can be a maximum of 1 connection resource attached to the tool.

Methods

as_dict	Return a dict that can be turned into json using json.dump.
clear	Remove all items from the dictionary.
copy
get	Get the value for key if key is in the dictionary, else default. :param str key: The key to look up. :param any default: The value to return if key is not in the dictionary. Defaults to None :returns: The value for key if key is in the dictionary, else default. :rtype: any
items
keys
pop	Removes specified key and return the corresponding value. :param str key: The key to pop. :param any default: The value to return if key is not in the dictionary :returns: The value corresponding to the key. :rtype: any :raises KeyError: If key is not found and default is not given.
popitem	Removes and returns some (key, value) pair :returns: The (key, value) pair. :rtype: tuple :raises KeyError: if the dictionary is empty.
setdefault	Return the value for key if key is in the dictionary; otherwise set the key to default and return default. :param str key: The key to look up. :param any default: The value to set if key is not in the dictionary :returns: The value for key if key is in the dictionary, else default. :rtype: any
update	Update the dictionary from a mapping or an iterable of key-value pairs. :param any args: Either a mapping object or an iterable of key-value pairs.
values

as_dict

Return a dict that can be turned into json using json.dump.

as_dict(*, exclude_readonly: bool = False) -> dict[str, Any]

Keyword-Only Parameters

Name	Description
exclude_readonly	bool Whether to remove the readonly properties. Default value: False

Returns

Type	Description
dict	A dict JSON compatible object

clear

Remove all items from the dictionary.

clear() -> None

copy

copy() -> Model

get

Get the value for key if key is in the dictionary, else default. :param str key: The key to look up. :param any default: The value to return if key is not in the dictionary. Defaults to None :returns: The value for key if key is in the dictionary, else default. :rtype: any

get(key: str, default: Any = None) -> Any

Parameters

Name	Description
key Required
default	Default value: None

items

items() -> ItemsView[str, Any]

Returns

Type	Description
ItemsView	a set-like object providing a view on the mapping's items

keys

keys() -> KeysView[str]

Returns

Type	Description
KeysView	a set-like object providing a view on the mapping's keys

pop

Removes specified key and return the corresponding value. :param str key: The key to pop. :param any default: The value to return if key is not in the dictionary :returns: The value corresponding to the key. :rtype: any :raises KeyError: If key is not found and default is not given.

pop(key: str, default: ~typing.Any = <object object>) -> Any

Parameters

Name	Description
key Required
default

popitem

Removes and returns some (key, value) pair :returns: The (key, value) pair. :rtype: tuple :raises KeyError: if the dictionary is empty.

popitem() -> tuple[str, Any]

setdefault

Return the value for key if key is in the dictionary; otherwise set the key to default and return default. :param str key: The key to look up. :param any default: The value to set if key is not in the dictionary :returns: The value for key if key is in the dictionary, else default. :rtype: any

setdefault(key: str, default: ~typing.Any = <object object>) -> Any

Parameters

Name	Description
key Required
default

update

Update the dictionary from a mapping or an iterable of key-value pairs. :param any args: Either a mapping object or an iterable of key-value pairs.

update(*args: Any, **kwargs: Any) -> None

values

values() -> ValuesView[Any]

Returns

Type	Description
ValuesView	an object providing a view on the mapping's values

Attributes

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: _models.WebSearchConfiguration | None

description

Deprecated. This property is deprecated and will be removed in a future version.

description: str | None

external_web_access

Allow live internet access for web search. Defaults to true when omitted. When false, the web search tool runs in offline/cache-only mode and will not fetch new external content.

external_web_access: bool | None

filters

filters: _models.WebSearchToolFilters | None

name

Deprecated. This property is deprecated and will be removed in a future version.

name: str | None

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. Is one of the following types: Literal["low"], Literal["medium"], Literal["high"]

search_context_size: Literal['low', 'medium', 'high'] | None

tool_configs

Deprecated. This property is deprecated and will be removed in a future version.

tool_configs: dict[str, '_models.ToolConfig'] | None

type

The type of the web search tool. One of web_search or web_search_2025_08_26. Required. WEB_SEARCH.

type: WEB_SEARCH: 'web_search'>]

user_location

user_location: _models.WebSearchApproximateLocation | None

Opinia

Czy ta strona była pomocna?