Fields
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
Enabled | *bool | :heavy_minus_sign: | Set to false to disable the web-search plugin for this request. Defaults to true. | |
Engine | *components.WebSearchEngine | :heavy_minus_sign: | The search engine to use for web search. | exa |
ExcludeDomains | []string | :heavy_minus_sign: | A list of domains to exclude from web search results. Supports wildcards (e.g. “*.substack.com”) and path filtering (e.g. “openai.com/blog”). | [ “example.com”, “*.substack.com”, “openai.com/blog” ] |
ID | components.WebSearchPluginID | :heavy_check_mark: | N/A | |
IncludeDomains | []string | :heavy_minus_sign: | A list of domains to restrict web search results to. Supports wildcards (e.g. “*.substack.com”) and path filtering (e.g. “openai.com/blog”). | [ “example.com”, “*.substack.com”, “openai.com/blog” ] |
MaxResults | *int64 | :heavy_minus_sign: | N/A | |
MaxUses | *int64 | :heavy_minus_sign: | Maximum number of times the model can invoke web search in a single turn. Passed through to native providers that support it (e.g. Anthropic). | |
SearchPrompt | *string | :heavy_minus_sign: | N/A | |
UserLocation | optionalnullable.OptionalNullable[components.UserLocation] | :heavy_minus_sign: | N/A | {"city": "San Francisco","country": "US","region": "California","timezone": "America/Los_Angeles","type": "approximate"} |