Web Search Integration

With this Public Integration, you can perform real-time web searches using the Google Custom Search API:

com.globant.geai.web_search

By default, this Integration may include a pre-configured API Key and Search Engine ID, allowing the Tool to be used without creating a Credential.

The default configuration typically uses a globally scoped Custom Search Engine. If your use case requires searching within specific domains, restricting results to particular websites, or targeting a specific country or region, you can configure your own Google Custom Search setup.

To customize the configuration, enable the Custom Search API in Google Cloud, generate an API Key, create a Custom Search Engine (CSE), and register the API Key as a Credential in your Project.

Configuration steps

1. Go to https://console.cloud.google.com/ and sign in.
2. Create a new project or select an existing one.
3. Go to APIs & Services > Library and enable the Custom Search API for the selected project.
4. Go to APIs & Services > Credentials and click on Create Credentials > API Key. Copy the generated API Key. This key will be used to authenticate requests to the Custom Search API.
5. In the Integrations Dashboard, go to the Credentials tab and click on + New Credential.
   • In the Name field, enter a descriptive name (for example, google_cse_api_key).
   • In the Integration dropdown, select Web Search.
   • After selecting the Integration, the Authentication Type is automatically set to API Key, and the Authentication Level is automatically set to Project. These values are predefined and cannot be modified.
   • In the Value field, paste the API Key generated in Google Cloud for the Custom Search API.
   • Click on Save to create the Credential.
6. Go to https://programmablesearchengine.google.com/controlpanel/all and create a new Custom Search Engine (CSE). During creation, define the sites or domains the engine will search. After creating the engine, copy the generated Search Engine ID (CX).
7. In Console, open the Project where you will use this Integration and create a new Secret. Follow the steps in How to create a Secret.
   • In the Name field, enter a descriptive name (for example, google_cse_engine_id).
   • In the Value field, paste the Search Engine ID (CX) obtained from Google Programmable Search Engine.
   • Confirm to save the Secret.
8. In the Integrations Dashboard, open Web Search and go to the Tool Parameters tab. There, complete the following:
   • engineId: Enter the name of the Secret created in the previous step (for example, google_cse_engine_id).

The API Key is resolved automatically from the configured Credential.

After completing these steps, you can add the Tool to your Agent from the AI & Tools Tab.