Google Search
Google Custom Search integration for web search, image search, and site-restricted search
The Google Search integration lets your agents perform web and image searches and run scoped lookups against a specific website, backed by the Google Custom Search JSON API.
Prerequisites
- A Programmable Search Engine ID (the
cxparameter). Create one at programmablesearchengine.google.com — configure it to search the whole web or a specific list of sites. - An API Key with the Custom Search API enabled. Create one in Google Cloud Console → APIs & Credentials and enable the Custom Search API for your project.
The free tier allows 100 queries/day. Beyond that, billing must be enabled on the Google Cloud project.
Setup
- Open Integrations from the sidebar
- Select Google Search from the catalog
- Click Add Integration Config
- Give the config a display name (e.g., "Google Search — Whole web").
- Paste your Search Engine ID and API Key.
- Save the config
Using in Your Agent
- Open your agent in Agent Studio and select an Agent Step
- Under Attached Integration Configurations, click Attach configuration and choose your config
- Attach Google Search tools from the tools panel
- Tools are referenced as
google_search.web_search,google_search.image_search,google_search.site_search.
Each tool call costs one query against your Custom Search quota.
Available Tools
| Tool | Description | Action Type |
|---|---|---|
web_search | Search the web, returning titles, snippets, and URLs | ReadOnly |
image_search | Search for images with URLs, thumbnails, dimensions, and context pages | ReadOnly |
site_search | Search within a specific website or domain | ReadOnly |