The Google Search tool enables your agent to base its responses on up-to-date information from the web, effectively grounding the conversation in real-world data. This tool is ideal for scenarios requiring world knowledge, current events, or a broad range of topics.
Configuration
Configure the following settings when creating the tool:
- Name:
The display name for the tool instance (for example:
search_web). - Description: A brief description of the tool's purpose. Reasoning agents use this description to decide when to invoke the tool.
- Excluded domains: A list of domains to exclude from search results (max 2000). For example: "www.example.com" or "example.com"
- Preferred domains: A list of domains to restrict search results to (max 20). For example: "www.example.com" or "example.com"
- URLs for context: Specific URLs to fetch for grounding context (max 20). The model uses content from these pages directly. For example: "example.com/page/path"
Settings precedence
Domain and URL settings apply in the following order:
- Excluded domains: Highest precedence. Domains are excluded even if listed in URLs for context or Preferred domains.
- URLs for context: Content is fetched unless the domain is excluded.
- Preferred domains: Lowest precedence.
Runtime context URLs
In addition to the URLs for context provided in tool configuration, you can instruct your agent to inject dynamically inject URLs at runtime.
For example, you can add the following in your agent instructions:
none
If the user query is about x, look into these urls url1, url2, url3 using
the 'Product Information Search' tool.