docs: Add comprehensive documentation for Google Gemini server tools (#370)

- Created detailed documentation explaining URL Context, Google Search,
and Code Execution tools
- Added usage examples, configuration options, and best practices
- Updated README.md to reference the new documentation
- Covers implementation from PR #356

cc @valtzu

Author: OskarStark

src/platform/doc/google-gemini-server-tools.rst

@@ -0,0 +1,99 @@
+Google Gemini Server Tools
+==========================
+
+Server tools are built-in capabilities provided by Google Gemini that allow the model to perform specific actions without requiring custom tool implementations. These tools run on Google's servers and provide access to external data and execution environments.
+
+Overview
+--------
+
+Google Gemini provides several server-side tools that can be enabled when calling the model:
+
+- **URL Context** - Fetches and analyzes content from URLs
+- **Google Search** - Performs web searches using Google
+- **Code Execution** - Executes code in a sandboxed environment
+
+Available Server Tools
+----------------------
+
+**URL Context**
+
+The URL Context tool allows Gemini to fetch and analyze content from web pages. This is useful for:
+
+- Analyzing current web content
+- Extracting information from specific pages
+- Understanding context from external sources
+
+::
+
+    $model = new Gemini('gemini-2.5-pro-preview-03-25', [
+        'server_tools' => [
+            'url_context' => true
+        ]
+    ]);
+
+    $messages = new MessageBag(
+        Message::ofUser('What was the 12 month Euribor rate a week ago based on https://www.euribor-rates.eu/en/current-euribor-rates/4/euribor-rate-12-months/')
+    );
+
+    $response = $platform->request($model, $messages);
+
+
+**Google Search**
+
+The Google Search tool enables the model to search the web and incorporate search results into its responses::
+
+    $model = new Gemini('gemini-2.5-pro-preview-03-25', [
+        'server_tools' => [
+            'google_search' => true
+        ]
+    ]);
+
+    $messages = new MessageBag(
+        Message::ofUser('What are the latest developments in quantum computing?')
+    );
+
+    $response = $platform->request($model, $messages);
+
+**Code Execution**
+
+The Code Execution tool provides a sandboxed environment for running code::
+
+    $model = new Gemini('gemini-2.5-pro-preview-03-25', [
+        'server_tools' => [
+            'code_execution' => true
+        ]
+    ]);
+
+    $messages = new MessageBag(
+        Message::ofUser('Calculate the factorial of 20 and show me the code')
+    );
+
+    $response = $platform->request($model, $messages);
+
+
+## Using Multiple Server Tools
+
+You can enable multiple server tools simultaneously::
+
+    $model = new Gemini('gemini-2.5-pro-preview-03-25', [
+        'server_tools' => [
+            'url_context' => true,
+            'google_search' => true,
+            'code_execution' => true
+        ]
+    ]);
+
+Example
+-------
+
+See `examples/google/server-tools.php`_ for a complete working example.
+
+Limitations
+-----------
+
+- API key must have appropriate permissions
+- Server tools may have usage quotas
+- Response times may vary based on the complexity of server tool operations
+- Not all Gemini model versions support all server tools
+
+.. _`examples/google/server-tools.php`: https://github.com/symfony/ai/blob/main/examples/google/server-tools.php

src/platform/doc/index.rst

@@ -256,6 +256,13 @@ The standalone usage results in an ``Vector`` instance::
 * `Embeddings with Voyage`_
 * `Embeddings with Mistral`_
 
+Server Tools
+------------
+
+Some platforms provide built-in server-side tools for enhanced capabilities without custom implementations:
+
+1. **[Google Gemini](google-gemini-server-tools.md)** - URL Context, Google Search, Code Execution
+
 Parallel Platform Calls
 -----------------------