From f51f384865cf336c5bb1db814bc41e6f26c8e913 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 22 Nov 2025 23:19:01 +0100
Subject: [PATCH] [AiBundle][Doc] Update tools registration documentation

Clarify that dedicated tool packages (Brave, Firecrawl, Mapbox,
OpenMeteo, Tavily) are automatically configured via Flex recipes and
require no manual setup.

Only tools in the Toolbox\Tool namespace need manual service registration.
---
 docs/bundles/ai-bundle.rst | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/docs/bundles/ai-bundle.rst b/docs/bundles/ai-bundle.rst
index fc2d9bb56..d35a8bb41 100644
--- a/docs/bundles/ai-bundle.rst
+++ b/docs/bundles/ai-bundle.rst
@@ -771,7 +771,17 @@ the :class:`Symfony\\AI\\AiBundle\\Attribute\\AsOutputProcessor` attributes::
 Register Tools
 ~~~~~~~~~~~~~~
 
-To use existing tools, you can register them as a service:
+The following tools can be installed as dedicated packages, no configuration is needed as these bridges come with flex recipes.
+
+.. code-block:: terminal
+
+    $ composer require symfony/ai-brave-tool
+    $ composer require symfony/ai-firecrawl-tool
+    $ composer require symfony/ai-mapbox-tool
+    $ composer require symfony/ai-openmeteo-tool
+    $ composer require symfony/ai-tavily-tool
+
+For tools not available as dedicated packages (those in the ``Toolbox\Tool`` namespace), register them manually as services:
 
 .. code-block:: yaml
 
@@ -781,19 +791,14 @@ To use existing tools, you can register them as a service:
             autoconfigure: true
 
         Symfony\AI\Agent\Toolbox\Tool\Clock: ~
-        Symfony\AI\Agent\Bridge\OpenMeteo\OpenMeteo: ~
         Symfony\AI\Agent\Toolbox\Tool\SerpApi:
             $apiKey: '%env(SERP_API_KEY)%'
         Symfony\AI\Agent\Toolbox\Tool\SimilaritySearch: ~
         Symfony\AI\Agent\Toolbox\Tool\Wikipedia: ~
         Symfony\AI\Agent\Toolbox\Tool\YouTubeTranscriber: ~
-        Symfony\AI\Agent\Bridge\Firecrawl\Firecrawl:
-          $endpoint: '%env(FIRECRAWL_ENDPOINT)%'
-          $apiKey: '%env(FIRECRAWL_API_KEY)%'
-        Symfony\AI\Agent\Bridge\Brave\Brave:
-          $apiKey: '%env(BRAVE_API_KEY)%'
-        Symfony\AI\Agent\Bridge\Tavily\Tavily:
-          $apiKey: '%env(TAVILY_API_KEY)%'
+
+Creating Custom Tools
+---------------------
 
 Custom tools can be registered by using the :class:`Symfony\\AI\\Agent\\Toolbox\\Attribute\\AsTool` attribute::