[AIBundle] Simplify agent-as-tool configuration

Author: valtzu

demo/config/packages/ai.yaml

@@ -46,10 +46,9 @@ ai:
             system_prompt: 'You are a friendly chatbot that likes to have a conversation with users and asks them some questions.'
             tools:
                 # Agent in agent 🤯
-                - service: 'ai.agent.blog'
+                - agent: 'blog'
                   name: 'symfony_blog'
                   description: 'Can answer questions based on the Symfony blog.'
-                  is_agent: true
     store:
         chroma_db:
             symfonycon:

src/ai-bundle/config/options.php

@@ -114,18 +114,22 @@
                                 ->arrayNode('services')
                                     ->arrayPrototype()
                                         ->children()
-                                            ->scalarNode('service')->isRequired()->end()
+                                            ->scalarNode('service')->cannotBeEmpty()->end()
+                                            ->scalarNode('agent')->cannotBeEmpty()->end()
                                             ->scalarNode('name')->end()
                                             ->scalarNode('description')->end()
                                             ->scalarNode('method')->end()
-                                            ->booleanNode('is_agent')->defaultFalse()->end()
                                         ->end()
                                         ->beforeNormalization()
                                             ->ifString()
                                             ->then(function (string $v) {
                                                 return ['service' => $v];
                                             })
                                         ->end()
+                                        ->validate()
+                                            ->ifFalse(static fn ($v) => empty($v['agent']) xor empty($v['service']))
+                                            ->thenInvalid('Either "agent" or "service" must be configured, and never both.')
+                                        ->end()
                                     ->end()
                                 ->end()
                             ->end()

src/ai-bundle/doc/index.rst

@@ -72,10 +72,9 @@ Configuration
                       method: 'foo' # Optional with default value '__invoke'
 
                     # Referencing a agent => agent in agent 🤯
-                    - service: 'ai.agent.research'
+                    - agent: 'research'
                       name: 'wikipedia_research'
                       description: 'Can research on Wikipedia'
-                      is_agent: true
             research:
                 platform: 'ai.platform.anthropic'
                 model:

src/ai-bundle/src/AIBundle.php

@@ -319,10 +319,14 @@ private function processAgentConfig(string $name, array $config, ContainerBuilde
 
                 $tools = [];
                 foreach ($config['tools']['services'] as $tool) {
+                    if (isset($tool['agent'])) {
+                        $tool['name'] ??= $tool['agent'];
+                        $tool['service'] ??= \sprintf('ai.agent.%s', $tool['agent']);
+                    }
                     $reference = new Reference($tool['service']);
                     // We use the memory factory in case method, description and name are set
                     if (isset($tool['name'], $tool['description'])) {
-                        if ($tool['is_agent']) {
+                        if (isset($tool['agent'])) {
                             $agentWrapperDefinition = new Definition(AgentTool::class, ['$agent' => $reference]);
                             $container->setDefinition('ai.toolbox.'.$name.'.agent_wrapper.'.$tool['name'], $agentWrapperDefinition);
                             $reference = new Reference('ai.toolbox.'.$name.'.agent_wrapper.'.$tool['name']);