Initial implementation of google search for Gemini models

[mathieubrunpicard]

Google Search Integration with Gemini Models

Issue

Reference: #40

Description

This PR adds built-in Google Search support for Gemini models by introducing a with_google_search method to the model.

Example Usage

# Without Google Search
chat = RubyLLM.chat(model: 'gemini-2.0-flash')
chat.ask("What is the google stock price?")

Example response

Unfortunately, I cannot give you the exact, real-time Google (Alphabet Inc.) stock price. Here's why:

• Stock prices fluctuate constantly. The market changes every second.
• I'm not a financial platform. I don't have access to live stock market data.

However, here's how you can find the current Google stock price:

1. Google Search: Just type "Google stock price" into the Google search bar. It will usually display the current price and some basic information.
2. Financial Websites: Go to reputable financial websites like:
   • Google Finance
   • Yahoo Finance
   • Bloomberg
   • MarketWatch
3. Brokerage Accounts: If you have an account with a brokerage (like Fidelity, Schwab, Robinhood, etc.), the stock price will be displayed there.

Important Considerations:

• Ticker Symbols: Google has two main classes of shares:
  • GOOGL: Alphabet Inc. (Class A)
  • GOOG: Alphabet Inc. (Class C)
• After-Hours Trading: Keep in mind that prices may differ during after-hours trading.
• Do Your Research: Never make investment decisions based solely on the current stock price. Research the company thoroughly.

# With Google Search enabled
chat.with_google_search.ask("What is the google stock price?")

Example response

Here's the latest information on Google (Alphabet Inc.) stock prices as of March 19, 2025:

Class A (GOOGL):

• INDMoney reports the stock opened at $163.68 today, after a previous close of $164.29.
• It reached a high of $165.82 and a low of $162.78 today.
• Robinhood shows a high today of $165.93 and a low of $162.45.

Class C (GOOG):

• TradingView indicates the current price is $167.47, a decrease of 2.34% in the last 24 hours.
• Nasdaq reports a high of $166.44 and a low of $158.8 today.

Key Data (GOOGL):

• Market Cap: $2.03T
• Price-Earnings Ratio: 20.57
• Dividend Yield: 0.36%

Please note: Real-time data may vary slightly across different sources.

Source

Implementation based on: https://ai.google.dev/gemini-api/docs/grounding?lang=rest

[bafraikin]

Cool !

[crmne]

chat.rb shouldn't have any code that's provider specific.

I think we should implement a provider overrides API, e.g. .with_provider_overrides({tools: :google_search}) This name is not set in stone, let's discuss naming and implementation.

[mathieubrunpicard]

What do you think of :

in lib/ruby_llm/chat.rb

def with_provider_overrides(overrides)
      unless @model.supports_functions
        raise UnsupportedFunctionsError, "Model #{@model.id} doesn't support function calling"
      end

      case overrides
      when Hash
        @tools = @provider.format_provider_overrides(overrides)
      when Array
        @tools = overrides
      else
        raise ArgumentError, 'Provider overrides must be a Hash or Array'
      end
      self
end

and then in gemini.rb

def format_provider_overrides(overrides)
        case overrides
        when { tools: :google_search }
          [{ google_search: {} }]
        else
          raise ArgumentError, "Unsupported provider override: #{overrides}"
        end
end

[crmne]

The best interface IMO would be chat.with_tool(RubyLLM::Providers::Gemini::GoogleSearchTool)

[crmne]

same here, no provider specific code.

[crmne]

The best interface IMO would be chat.with_tool(RubyLLM::Providers::Gemini::GoogleSearchTool)