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 your agent in Agent Studio.
- In the Integrations panel, click Add Integration Config.
- Select Google Search from the integration list.
- Give the config a display name (e.g., "Google Search — Whole web").
- Paste your Search Engine ID and API Key.
- Save the agent revision.
Using in Your Agent
- In an Agent Step, 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 |