(gemini): Google Search Action

[swerner]

Performs a Google search and returns the top search results. Useful for gathering up-to-date information for prompts or agents.

[augmentations-ai]

This is a great addition! To ensure thorough testing, could you provide a manual testing example and detailed steps to verify the Google Search Action is working as expected? Specifically, the steps should cover:

1. Setup: How to set up the necessary environment variables (GOOGLE_SEARCH_API_KEY and GOOGLE_SEARCH_ENGINE_ID).
2. Execution: An example of how to call the GoogleSearchAction with a sample query.
3. Verification: How to verify that the search results are accurate, well-formatted (title, URL, snippet), and that errors are handled gracefully (e.g., invalid API key, search query resulting in no results).

For example:

Manual Testing Steps:

1. Setup:

   • Set the GOOGLE_SEARCH_API_KEY environment variable to your Google Cloud Search API key.
   • Set the GOOGLE_SEARCH_ENGINE_ID environment variable to your Custom Search Engine ID.

2. Execution:

   • In a Rails console or a similar Ruby environment, initialize the GoogleSearchAction with a query:

     action = GoogleSearchAction.new(query: 'latest news on AI')
     results = action.call
     puts results

3. Verification:

   • Successful Search:
     • Examine the results array.
     • Verify that each element in the array is a hash containing title, url, and snippet keys.
     • Check the url values to ensure they are valid and relevant to the query 'latest news on AI'.
     • Inspect the title and snippet to confirm they accurately represent the content of the linked pages.
   • Error Handling (Invalid API Key):
     • Temporarily invalidate the GOOGLE_SEARCH_API_KEY environment variable (e.g., set it to an empty string or an invalid key).
     • Run the same execution steps as above.
     • Verify that the action.call raises a StandardError with a message indicating an authentication or authorization failure.
     • Check the logs to confirm that the error message "Google search failed: ..." is present.
   • Error Handling (No Results):
     • Execute the search with a query that is unlikely to return any results, e.g., a very specific and uncommon string
     • Verify that action.call returns an empty array.

Providing these steps will help ensure that the action is easily testable and maintainable.