你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

WebSearchTool interface

在网上搜索与该提示相关的资料。详细了解 web 搜索工具。

属性

custom_search_configuration	附加到此工具的project连接。最多可以有 1 个连接资源附加到该工具。
description	Deprecated. 该属性已被弃用，未来版本中将被移除。
filters	适用于网络搜索结果的筛选条件。
name	Deprecated. 该属性已被弃用，未来版本中将被移除。
search_context_size	用于搜索的上下文窗口空间量的高级指南。 `low`、`medium` 或 `high` 之一。 `medium` 是默认值。
tool_configs	Deprecated. 该属性已被弃用，未来版本中将被移除。
type	Web 搜索工具的类型。 `web_search` 或 `web_search_2025_08_26` 中的一项。
user_location	用户的大致位置，用于搜索相关性。

附加到此工具的project连接。最多可以有 1 个连接资源附加到该工具。

custom_search_configuration?: WebSearchConfiguration

Deprecated. 该属性已被弃用，未来版本中将被移除。

description?: string

string

适用于网络搜索结果的筛选条件。

filters?: WebSearchToolFilters

Deprecated. 该属性已被弃用，未来版本中将被移除。

name?: string

string

用于搜索的上下文窗口空间量的高级指南。 low、medium 或 high 之一。 medium 是默认值。

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

"low" | "medium" | "high"

Deprecated. 该属性已被弃用，未来版本中将被移除。

tool_configs?: Record<string, ToolConfig>

Record<string, ToolConfig>

Web 搜索工具的类型。 web_search 或 web_search_2025_08_26 中的一项。

type: "web_search"

"web_search"

用户的大致位置，用于搜索相关性。

user_location?: WebSearchApproximateLocation