[AI Bundle][Platform] Add ModelCatalog

This PR revolutionizes model configuration in the Symfony AI bundle by simplifying
the way models are configured and eliminating the need for explicit class definitions
in most use cases. The changes make model configuration more intuitive and maintainable
while providing full backwards compatibility.

- **Added platform-specific ModelCatalog classes** for OpenAI, Anthropic, Mistral, Perplexity, Gemini, and Cerebras
- **Automatic model class inference** based on platform and capabilities
- **Eliminates need for explicit class configuration** in most scenarios
- Each platform now provides its own model catalog with predefined capabilities

- **Direct model string support**: `model: 'gpt-4o-mini?temperature=0.5&max_tokens=1000'`
- **Query parameter parsing** embedded directly in model names
- **Traditional name/options structure** still supported for backwards compatibility
- **Validation prevents conflicting configurations** (query string + options object)

- **New `PlatformInterface::getModelCatalog()` method** for accessing platform model catalogs
- **Enhanced `AbstractModelCatalog`** with validation for empty model names
- **New `AutoDiscoveryModelCatalog`** for automatic capability detection
- **Updated platform factories** to create bridge-specific model catalogs

- **Updated AI Bundle configuration** (`config/options.php`) to support direct model strings
- **Enhanced bundle class** (`AiBundle.php`) to handle new model configuration patterns
- **Removed hardcoded model class assumptions** throughout the bundle

- **Updated 40+ test files** to use Model objects instead of raw strings
- **Enhanced InputProcessor tests** to validate new configuration patterns
- **Added comprehensive test coverage** for all new ModelCatalog implementations
- **Updated agent tests** to use proper Model instances

```yaml
ai:
    model:
        openai:
            custom-gpt-4:
                class: OpenAi\Gpt
                capabilities:
                    - input_messages
                    - output_text
                    - tool_calling
```

```yaml
ai:
    agent:
        my_agent:
            platform: openai
            model: 'gpt-4o-mini?temperature=0.5&max_tokens=1000'

ai:
    agent:
        my_agent:
            platform: openai
            model:
                name: gpt-4o-mini
                options:
                    temperature: 0.5
                    max_tokens: 1000

ai:
    model:
        openai:
            custom-gpt-4:
                capabilities:
                    - !php/const Symfony\AI\Platform\Capability::INPUT_MESSAGES
                    - !php/const Symfony\AI\Platform\Capability::OUTPUT_TEXT
                    - !php/const Symfony\AI\Platform\Capability::TOOL_CALLING
    agent:
        my_agent:
            platform: openai
            model: 'custom-gpt-4?temperature=0.3'
```

1. **Dramatically Simplified Configuration**: No more need to specify model classes for standard platform models
2. **Enhanced Developer Experience**: Intuitive query parameter syntax for model options
3. **Type Safety**: Enum constants ensure valid capability values
4. **Automatic Model Discovery**: Platform-specific catalogs automatically infer appropriate model classes
5. **Validation**: Built-in prevention of conflicting configuration patterns
6. **Full Backwards Compatibility**: Existing configurations continue to work unchanged

- **ModelCatalog Interface**: Each platform now implements its own model catalog
- **Query String Parser**: Parses model options from URL-style query parameters
- **Capability Auto-Detection**: Automatically determines model capabilities based on platform standards
- **Configuration Validation**: Prevents invalid combinations of configuration approaches
- **Seamless Migration**: Existing model configurations work without modification

This change significantly reduces configuration complexity while maintaining the full power and flexibility of the Symfony AI platform integration.

Author: OskarStark

demo/config/packages/ai.yaml

@@ -4,34 +4,27 @@ ai:
             api_key: '%env(OPENAI_API_KEY)%'
     agent:
         blog:
-            model:
-                class: 'Symfony\AI\Platform\Bridge\OpenAi\Gpt'
-                name: !php/const Symfony\AI\Platform\Bridge\OpenAi\Gpt::GPT_4O_MINI
+            model: 'gpt-4o-mini'
             tools:
                 - 'Symfony\AI\Agent\Toolbox\Tool\SimilaritySearch'
                 - service: 'clock'
                   name: 'clock'
                   description: 'Provides the current date and time.'
                   method: 'now'
         stream:
-            model:
-                class: 'Symfony\AI\Platform\Bridge\OpenAi\Gpt'
-                name: !php/const Symfony\AI\Platform\Bridge\OpenAi\Gpt::GPT_4O_MINI
+            model: 'gpt-4o-mini'
             prompt: |
                 You are an example chat application where messages from the LLM are streamed to the user using
                 Server-Sent Events via `symfony/ux-turbo` / Turbo Streams. This example does not use any custom
                 javascript and solely relies on the built-in `live` & `turbo_stream` Stimulus controllers.
                 Whatever the user asks, tell them about the application & used technologies.
             tools: false
         youtube:
-            model:
-                class: 'Symfony\AI\Platform\Bridge\OpenAi\Gpt'
-                name: !php/const Symfony\AI\Platform\Bridge\OpenAi\Gpt::GPT_4O_MINI
+            model: 'gpt-4o-mini'
             tools: false
         wikipedia:
             model:
-                class: 'Symfony\AI\Platform\Bridge\OpenAi\Gpt'
-                name: !php/const Symfony\AI\Platform\Bridge\OpenAi\Gpt::GPT_4O_MINI
+                name: 'gpt-4o-mini'
                 options:
                     temperature: 0.5
             prompt:
@@ -40,9 +33,7 @@ ai:
             tools:
                 - 'Symfony\AI\Agent\Toolbox\Tool\Wikipedia'
         audio:
-            model:
-                class: 'Symfony\AI\Platform\Bridge\OpenAi\Gpt'
-                name: 'gpt-4o-mini?temperature=1.0'
+            model: 'gpt-4o-mini?temperature=1.0'
             prompt: 'You are a friendly chatbot that likes to have a conversation with users and asks them some questions.'
             tools:
                 # Agent in agent 🤯
@@ -55,9 +46,7 @@ ai:
                 collection: 'symfony_blog'
     vectorizer:
         openai:
-            model:
-                class: 'Symfony\AI\Platform\Bridge\OpenAi\Embeddings'
-                name: !php/const Symfony\AI\Platform\Bridge\OpenAi\Embeddings::TEXT_ADA_002
+            model: 'text-embedding-ada-002'
     indexer:
         blog:
             loader: 'Symfony\AI\Store\Document\Loader\RssFeedLoader'

examples/aimlapi/chat.php

@@ -9,21 +9,19 @@
  * file that was distributed with this source code.
  */
 
-use Symfony\AI\Platform\Bridge\AiMlApi\Completions;
 use Symfony\AI\Platform\Bridge\AiMlApi\PlatformFactory;
 use Symfony\AI\Platform\Message\Message;
 use Symfony\AI\Platform\Message\MessageBag;
 
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('AIMLAPI_API_KEY'), http_client());
-$model = new Completions(Completions::GEMINI_2_0_FLASH);
 
 $messages = new MessageBag(
     Message::forSystem('You are a pirate and you write funny.'),
     Message::ofUser('What is the Symfony framework?'),
 );
-$result = $platform->invoke($model, $messages, [
+$result = $platform->invoke('gemini-2.0-flash', $messages, [
     'max_tokens' => 500, // specific options just for this call
 ]);
 

examples/aimlapi/image-input-binary.php

@@ -9,20 +9,14 @@
  * file that was distributed with this source code.
  */
 
-use Symfony\AI\Platform\Bridge\AiMlApi\Completions;
 use Symfony\AI\Platform\Bridge\AiMlApi\PlatformFactory;
-use Symfony\AI\Platform\Capability;
 use Symfony\AI\Platform\Message\Content\Image;
 use Symfony\AI\Platform\Message\Message;
 use Symfony\AI\Platform\Message\MessageBag;
 
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('AIMLAPI_API_KEY'), http_client());
-$model = new Completions(
-    name: Completions::GOOGLE_GEMMA_3_27B_IT,
-    capabilities: [...Completions::DEFAULT_CAPABILITIES, Capability::INPUT_IMAGE]
-);
 
 $messages = new MessageBag(
     Message::forSystem('You are an image analyzer bot that helps identify the content of images.'),
@@ -31,6 +25,6 @@
         Image::fromFile(dirname(__DIR__, 2).'/fixtures/image.jpg'),
     ),
 );
-$result = $platform->invoke($model, $messages);
+$result = $platform->invoke('google/gemma-3-27b-it', $messages);
 
 echo $result->getResult()->getContent().\PHP_EOL;

examples/aimlapi/toolcall.php

@@ -13,24 +13,18 @@
 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\Completions;
 use Symfony\AI\Platform\Bridge\AiMlApi\PlatformFactory;
-use Symfony\AI\Platform\Capability;
 use Symfony\AI\Platform\Message\Message;
 use Symfony\AI\Platform\Message\MessageBag;
 
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('AIMLAPI_API_KEY'), http_client());
-$model = new Completions(
-    name: Completions::GOOGLE_GEMINI_2_5_FLASH,
-    capabilities: [...Completions::DEFAULT_CAPABILITIES, Capability::TOOL_CALLING]
-);
 
 $wikipedia = new Wikipedia(http_client());
 $toolbox = new Toolbox([$wikipedia], logger: logger());
 $processor = new AgentProcessor($toolbox);
-$agent = new Agent($platform, $model, [$processor], [$processor], logger: logger());
+$agent = new Agent($platform, 'google/gemini-2.5-flash', [$processor], [$processor], logger: logger());
 
 $messages = new MessageBag(Message::ofUser('Who is the current chancellor of Germany?'));
 $result = $agent->call($messages);

examples/aimlapi/vectorizing.php

@@ -9,18 +9,14 @@
  * file that was distributed with this source code.
  */
 
-use Symfony\AI\Platform\Bridge\AiMlApi\Embeddings;
 use Symfony\AI\Platform\Bridge\AiMlApi\PlatformFactory;
 use Symfony\AI\Store\Document\Vectorizer;
 
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('AIMLAPI_API_KEY'), http_client());
-$embeddings = new Embeddings(
-    name: Embeddings::TEXT_EMBEDDING_3_SMALL
-);
 
-$vectorizer = new Vectorizer($platform, $embeddings);
+$vectorizer = new Vectorizer($platform, 'text-embedding-3-small');
 
 $string = 'Hello World';
 $vector = $vectorizer->vectorize($string);

examples/albert/chat.php

@@ -10,16 +10,13 @@
  */
 
 use Symfony\AI\Platform\Bridge\Albert\PlatformFactory;
-use Symfony\AI\Platform\Bridge\OpenAi\Gpt;
 use Symfony\AI\Platform\Message\Message;
 use Symfony\AI\Platform\Message\MessageBag;
 
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('ALBERT_API_KEY'), env('ALBERT_API_URL'), http_client());
 
-$model = new Gpt('gpt-4o');
-
 $documentContext = <<<'CONTEXT'
     Document: AI Strategy of France
 
@@ -42,6 +39,6 @@
     Message::ofUser('What are the main objectives of France\'s AI strategy?'),
 );
 
-$result = $platform->invoke($model, $messages);
+$result = $platform->invoke('llama-3.3-70b-instruct', $messages);
 
 echo $result->getResult()->getContent().\PHP_EOL;

examples/anthropic/chat.php

@@ -9,20 +9,18 @@
  * file that was distributed with this source code.
  */
 
-use Symfony\AI\Platform\Bridge\Anthropic\Claude;
 use Symfony\AI\Platform\Bridge\Anthropic\PlatformFactory;
 use Symfony\AI\Platform\Message\Message;
 use Symfony\AI\Platform\Message\MessageBag;
 
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('ANTHROPIC_API_KEY'), httpClient: http_client());
-$model = new Claude(Claude::SONNET_37);
 
 $messages = new MessageBag(
     Message::forSystem('You are a pirate and you write funny.'),
     Message::ofUser('What is the Symfony framework?'),
 );
-$result = $platform->invoke($model, $messages);
+$result = $platform->invoke('claude-3-5-sonnet-20241022', $messages);
 
 echo $result->getResult()->getContent().\PHP_EOL;

examples/anthropic/image-input-binary.php

@@ -9,7 +9,6 @@
  * file that was distributed with this source code.
  */
 
-use Symfony\AI\Platform\Bridge\Anthropic\Claude;
 use Symfony\AI\Platform\Bridge\Anthropic\PlatformFactory;
 use Symfony\AI\Platform\Message\Content\Image;
 use Symfony\AI\Platform\Message\Message;
@@ -18,7 +17,6 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('ANTHROPIC_API_KEY'), httpClient: http_client());
-$model = new Claude(Claude::SONNET_37);
 
 $messages = new MessageBag(
     Message::forSystem('You are an image analyzer bot that helps identify the content of images.'),
@@ -27,6 +25,6 @@
         'Describe this image.',
     ),
 );
-$result = $platform->invoke($model, $messages);
+$result = $platform->invoke('claude-3-5-sonnet-20241022', $messages);
 
 echo $result->getResult()->getContent().\PHP_EOL;

examples/anthropic/image-input-url.php

@@ -9,7 +9,6 @@
  * file that was distributed with this source code.
  */
 
-use Symfony\AI\Platform\Bridge\Anthropic\Claude;
 use Symfony\AI\Platform\Bridge\Anthropic\PlatformFactory;
 use Symfony\AI\Platform\Message\Content\ImageUrl;
 use Symfony\AI\Platform\Message\Message;
@@ -18,7 +17,6 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('ANTHROPIC_API_KEY'), httpClient: http_client());
-$model = new Claude(Claude::SONNET_37);
 
 $messages = new MessageBag(
     Message::forSystem('You are an image analyzer bot that helps identify the content of images.'),
@@ -27,6 +25,6 @@
         'Describe this image.',
     ),
 );
-$result = $platform->invoke($model, $messages);
+$result = $platform->invoke('claude-3-5-sonnet-20241022', $messages);
 
 echo $result->getResult()->getContent().\PHP_EOL;

examples/anthropic/pdf-input-binary.php

@@ -9,7 +9,6 @@
  * file that was distributed with this source code.
  */
 
-use Symfony\AI\Platform\Bridge\Anthropic\Claude;
 use Symfony\AI\Platform\Bridge\Anthropic\PlatformFactory;
 use Symfony\AI\Platform\Message\Content\Document;
 use Symfony\AI\Platform\Message\Message;
@@ -18,14 +17,13 @@
 require_once dirname(__DIR__).'/bootstrap.php';
 
 $platform = PlatformFactory::create(env('ANTHROPIC_API_KEY'), httpClient: http_client());
-$model = new Claude(Claude::SONNET_37);
 
 $messages = new MessageBag(
     Message::ofUser(
         Document::fromFile(dirname(__DIR__, 2).'/fixtures/document.pdf'),
         'What is this document about?',
     ),
 );
-$result = $platform->invoke($model, $messages);
+$result = $platform->invoke('claude-3-5-sonnet-20241022', $messages);
 
 echo $result->getResult()->getContent().\PHP_EOL;