[Agent] Extract tools to dedicated bridges

Author: OskarStark

demo/composer.json

@@ -14,6 +14,9 @@
         "php-http/discovery": "^1.20",
         "runtime/frankenphp-symfony": "^0.2.0",
         "symfony/ai-bundle": "@dev",
+        "symfony/ai-clock-tool": "@dev",
+        "symfony/ai-similarity-search-tool": "@dev",
+        "symfony/ai-wikipedia-tool": "@dev",
         "symfony/asset": "~7.3.0",
         "symfony/asset-mapper": "~7.3.0",
         "symfony/clock": "~7.3.0",

demo/config/packages/ai.yaml

@@ -9,7 +9,7 @@ ai:
             platform: 'ai.platform.openai'
             model: 'gpt-4o-mini'
             tools:
-                - 'Symfony\AI\Agent\Toolbox\Tool\SimilaritySearch'
+                - 'Symfony\AI\Agent\Bridge\SimilaritySearch\SimilaritySearch'
                 - service: 'clock'
                   name: 'clock'
                   description: 'Provides the current date and time.'
@@ -40,7 +40,7 @@ ai:
                 text: 'Please answer the users question based on Wikipedia, only use information provided in the messages.'
                 include_tools: true
             tools:
-                - 'Symfony\AI\Agent\Toolbox\Tool\Wikipedia'
+                - 'Symfony\AI\Agent\Bridge\Wikipedia\Wikipedia'
             include_sources: true
         speech:
             platform: 'ai.platform.openai'
@@ -52,7 +52,7 @@ ai:
                 If you don't know the answer, say so. Keep in mind that you are in a spoken conversation, so keep your
                 answers concise and to the point. They will be read out loud to the user.
             tools:
-                - 'Symfony\AI\Agent\Toolbox\Tool\Clock'
+                - 'Symfony\AI\Agent\Bridge\Clock\Clock'
                 # Agent in agent 🤯
                 - agent: 'blog'
                   name: 'symfony_blog'
@@ -106,9 +106,11 @@ services:
         autowire: true
         autoconfigure: true
 
-    Symfony\AI\Agent\Toolbox\Tool\Clock: ~
-    Symfony\AI\Agent\Toolbox\Tool\Wikipedia: ~
-    Symfony\AI\Agent\Toolbox\Tool\SimilaritySearch:
+    # TODO: Remove once flex recipe works correctly
+    Symfony\AI\Agent\Bridge\Clock\Clock: ~
+    Symfony\AI\Agent\Bridge\Wikipedia\Wikipedia: ~
+
+    Symfony\AI\Agent\Bridge\SimilaritySearch\SimilaritySearch:
         $vectorizer: '@ai.vectorizer.openai'
         $store: '@ai.store.chroma_db.symfonycon'
 

docs/bundles/ai-bundle.rst

@@ -75,7 +75,7 @@ Advanced Example with Multiple Agents
                     include_tools: true # Include tool definitions at the end of the system prompt
                 tools:
                     # Referencing a service with #[AsTool] attribute
-                    - 'Symfony\AI\Agent\Toolbox\Tool\SimilaritySearch'
+                    - 'Symfony\AI\Agent\Bridge\SimilaritySearch\SimilaritySearch'
 
                     # Referencing a service without #[AsTool] attribute
                     - service: 'App\Agent\Tool\CompanyName'
@@ -91,7 +91,7 @@ Advanced Example with Multiple Agents
                 platform: 'ai.platform.anthropic'
                 model: 'claude-3-7-sonnet'
                 tools: # If undefined, all tools are injected into the agent, use "tools: false" to disable tools.
-                    - 'Symfony\AI\Agent\Toolbox\Tool\Wikipedia'
+                    - 'Symfony\AI\Agent\Bridge\Wikipedia\Wikipedia'
                 fault_tolerant_toolbox: false # Disables fault tolerant toolbox, default is true
             search_agent:
                 platform: 'ai.platform.perplexity'
@@ -776,13 +776,18 @@ The following tools can be installed as dedicated packages, no configuration is
 .. code-block:: terminal
 
     $ composer require symfony/ai-brave-tool
+    $ composer require symfony/ai-clock-tool
     $ composer require symfony/ai-firecrawl-tool
     $ composer require symfony/ai-mapbox-tool
     $ composer require symfony/ai-open-meteo-tool
+    $ composer require symfony/ai-scraper-tool
     $ composer require symfony/ai-serp-api-tool
+    $ composer require symfony/ai-similarity-search-tool
     $ composer require symfony/ai-tavily-tool
+    $ composer require symfony/ai-wikipedia-tool
+    $ composer require symfony/ai-youtube-tool
 
-For tools not available as dedicated packages (those in the ``Toolbox\Tool`` namespace), register them manually as services:
+Some tools may require additional configuration even when installed as dedicated packages. For example, the SimilaritySearch tool requires a vectorizer and store:
 
 .. code-block:: yaml
 
@@ -791,10 +796,9 @@ For tools not available as dedicated packages (those in the ``Toolbox\Tool`` nam
             autowire: true
             autoconfigure: true
 
-        Symfony\AI\Agent\Toolbox\Tool\Clock: ~
-        Symfony\AI\Agent\Toolbox\Tool\SimilaritySearch: ~
-        Symfony\AI\Agent\Toolbox\Tool\Wikipedia: ~
-        Symfony\AI\Agent\Toolbox\Tool\YouTubeTranscriber: ~
+        Symfony\AI\Agent\Bridge\SimilaritySearch\SimilaritySearch:
+            $vectorizer: '@ai.vectorizer.openai'
+            $store: '@ai.store.main'
 
 Creating Custom Tools
 ---------------------

examples/aimlapi/toolcall.php

@@ -10,8 +10,8 @@
  */
 
 use Symfony\AI\Agent\Agent;
+use Symfony\AI\Agent\Bridge\Wikipedia\Wikipedia;
 use Symfony\AI\Agent\Toolbox\AgentProcessor;
-use Symfony\AI\Agent\Toolbox\Tool\Wikipedia;
 use Symfony\AI\Agent\Toolbox\Toolbox;
 use Symfony\AI\Platform\Bridge\AiMlApi\PlatformFactory;
 use Symfony\AI\Platform\Message\Message;

examples/anthropic/structured-output-clock.php

@@ -10,8 +10,8 @@
  */
 
 use Symfony\AI\Agent\Agent;
+use Symfony\AI\Agent\Bridge\Clock\Clock;
 use Symfony\AI\Agent\Toolbox\AgentProcessor;
-use Symfony\AI\Agent\Toolbox\Tool\Clock;
 use Symfony\AI\Agent\Toolbox\Toolbox;
 use Symfony\AI\Platform\Bridge\Anthropic\PlatformFactory;
 use Symfony\AI\Platform\Message\Message;

examples/anthropic/toolcall.php

@@ -10,9 +10,9 @@
  */
 
 use Symfony\AI\Agent\Agent;
+use Symfony\AI\Agent\Bridge\Wikipedia\Wikipedia;
 use Symfony\AI\Agent\Toolbox\AgentProcessor;
 use Symfony\AI\Agent\Toolbox\Source\Source;
-use Symfony\AI\Agent\Toolbox\Tool\Wikipedia;
 use Symfony\AI\Agent\Toolbox\Toolbox;
 use Symfony\AI\Platform\Bridge\Anthropic\PlatformFactory;
 use Symfony\AI\Platform\Message\Message;

examples/bedrock/toolcall-claude.php

@@ -10,8 +10,8 @@
  */
 
 use Symfony\AI\Agent\Agent;
+use Symfony\AI\Agent\Bridge\Wikipedia\Wikipedia;
 use Symfony\AI\Agent\Toolbox\AgentProcessor;
-use Symfony\AI\Agent\Toolbox\Tool\Wikipedia;
 use Symfony\AI\Agent\Toolbox\Toolbox;
 use Symfony\AI\Platform\Bridge\Bedrock\PlatformFactory;
 use Symfony\AI\Platform\Message\Message;

examples/bedrock/toolcall-nova.php

@@ -10,8 +10,8 @@
  */
 
 use Symfony\AI\Agent\Agent;
+use Symfony\AI\Agent\Bridge\Wikipedia\Wikipedia;
 use Symfony\AI\Agent\Toolbox\AgentProcessor;
-use Symfony\AI\Agent\Toolbox\Tool\Wikipedia;
 use Symfony\AI\Agent\Toolbox\Toolbox;
 use Symfony\AI\Platform\Bridge\Bedrock\PlatformFactory;
 use Symfony\AI\Platform\Message\Message;

examples/composer.json

@@ -20,11 +20,16 @@
         "symfony/ai-agent": "@dev",
         "symfony/ai-brave-tool": "@dev",
         "symfony/ai-chat": "@dev",
+        "symfony/ai-clock-tool": "@dev",
         "symfony/ai-open-meteo-tool": "@dev",
+        "symfony/ai-scraper-tool": "@dev",
         "symfony/ai-serp-api-tool": "@dev",
+        "symfony/ai-similarity-search-tool": "@dev",
         "symfony/ai-platform": "@dev",
         "symfony/ai-store": "@dev",
         "symfony/ai-tavily-tool": "@dev",
+        "symfony/ai-wikipedia-tool": "@dev",
+        "symfony/ai-youtube-tool": "@dev",
         "symfony/cache": "^7.3|^8.0",
         "symfony/clock": "^7.3|^8.0",
         "symfony/console": "^7.3|^8.0",

examples/deepseek/structured-output-clock.php

@@ -10,8 +10,8 @@
  */
 
 use Symfony\AI\Agent\Agent;
+use Symfony\AI\Agent\Bridge\Clock\Clock;
 use Symfony\AI\Agent\Toolbox\AgentProcessor;
-use Symfony\AI\Agent\Toolbox\Tool\Clock;
 use Symfony\AI\Agent\Toolbox\Toolbox;
 use Symfony\AI\Platform\Bridge\DeepSeek\PlatformFactory;
 use Symfony\AI\Platform\Message\Message;