feature #837 add support for the albert platform configuration (jvancoillie)

This PR was merged into the main branch.

Discussion
----------

 add support for the albert platform configuration

| Q             | A
| ------------- | ---
| Bug fix?      |no
| New feature?  | yes <!-- please update src/**/CHANGELOG.md files -->
| Docs?         | no <!-- required for new features -->
| Issues        | Fix #836
| License       | MIT

This PR introduces support for configuring the **Albert** platform under the `ai.platforms` section, following the pattern of existing platforms (OpenAI, Mistral, Ollama, etc.).

The underlying Albert integration was already implemented, but the `albert` platform key was not recognized during configuration parsing.

```yaml
ai:
  platforms:
    albert:
      api_key: '%env(ALBERT_API_KEY)%'
      base_url: '%env(ALBERT_API_URL)%'
```

The configuration uses `base_url` because this is the parameter expected by the Albert platform factory.
Some platforms use `host` instead, which might cause confusion. If needed, I'm open to aligning naming conventions in a follow-up discussion.

I did not define a default `base_url`, but we could consider providing the known Albert endpoint (`https://albert.api.etalab.gouv.fr/v1`) if that aligns with the project’s policy on defaults.

While working on this, I also noticed that the list of Albert models may not be fully aligned with the current API. I can open a separate issue to track that, unless this work is already in progress.

Commits
-------

0e846d2 feat(aibundle): integrate Albert platform support

Author: chr-hertel

src/ai-bundle/config/options.php

@@ -29,6 +29,16 @@
         ->children()
             ->arrayNode('platform')
                 ->children()
+                    ->arrayNode('albert')
+                        ->children()
+                            ->stringNode('api_key')->isRequired()->end()
+                            ->stringNode('base_url')->isRequired()->end()
+                            ->stringNode('http_client')
+                                ->defaultValue('http_client')
+                                ->info('Service ID of the HTTP client to use')
+                            ->end()
+                        ->end()
+                    ->end()
                     ->arrayNode('anthropic')
                         ->children()
                             ->stringNode('api_key')->isRequired()->end()

src/ai-bundle/config/services.php

@@ -25,6 +25,7 @@
 use Symfony\AI\Chat\Command\SetupStoreCommand as SetupMessageStoreCommand;
 use Symfony\AI\Chat\MessageNormalizer;
 use Symfony\AI\Platform\Bridge\AiMlApi\ModelCatalog as AiMlApiModelCatalog;
+use Symfony\AI\Platform\Bridge\Albert\ModelCatalog as AlbertModelCatalog;
 use Symfony\AI\Platform\Bridge\Anthropic\Contract\AnthropicContract;
 use Symfony\AI\Platform\Bridge\Anthropic\ModelCatalog as AnthropicModelCatalog;
 use Symfony\AI\Platform\Bridge\Anthropic\TokenOutputProcessor as AnthropicTokenOutputProcessor;
@@ -88,6 +89,7 @@
 
         // model catalog
         ->set('ai.platform.model_catalog.aimlapi', AiMlApiModelCatalog::class)
+        ->set('ai.platform.model_catalog.albert', AlbertModelCatalog::class)
         ->set('ai.platform.model_catalog.anthropic', AnthropicModelCatalog::class)
         ->set('ai.platform.model_catalog.cartesia', CartesiaModelCatalog::class)
         ->set('ai.platform.model_catalog.cerebras', CerebrasModelCatalog::class)

src/ai-bundle/src/AiBundle.php

@@ -43,6 +43,7 @@
 use Symfony\AI\Chat\Chat;
 use Symfony\AI\Chat\ChatInterface;
 use Symfony\AI\Chat\MessageStoreInterface;
+use Symfony\AI\Platform\Bridge\Albert\PlatformFactory as AlbertPlatformFactory;
 use Symfony\AI\Platform\Bridge\Anthropic\PlatformFactory as AnthropicPlatformFactory;
 use Symfony\AI\Platform\Bridge\Azure\OpenAi\PlatformFactory as AzureOpenAiPlatformFactory;
 use Symfony\AI\Platform\Bridge\Cartesia\PlatformFactory as CartesiaPlatformFactory;
@@ -292,6 +293,26 @@ public function loadExtension(array $config, ContainerConfigurator $container, C
      */
     private function processPlatformConfig(string $type, array $platform, ContainerBuilder $container): void
     {
+        if ('albert' === $type) {
+            $platformId = 'ai.platform.albert';
+            $definition = (new Definition(Platform::class))
+                ->setFactory(AlbertPlatformFactory::class.'::create')
+                ->setLazy(true)
+                ->addTag('proxy', ['interface' => PlatformInterface::class])
+                ->setArguments([
+                    $platform['api_key'],
+                    $platform['base_url'],
+                    new Reference($platform['http_client'], ContainerInterface::NULL_ON_INVALID_REFERENCE),
+                    new Reference('ai.platform.model_catalog.albert'),
+                    new Reference('event_dispatcher'),
+                ])
+                ->addTag('ai.platform', ['name' => 'albert']);
+
+            $container->setDefinition($platformId, $definition);
+
+            return;
+        }
+
         if ('anthropic' === $type) {
             $platformId = 'ai.platform.anthropic';
             $definition = (new Definition(Platform::class))

src/ai-bundle/tests/DependencyInjection/AiBundleTest.php

@@ -2817,6 +2817,10 @@ private function getFullConfig(): array
                     'anthropic' => [
                         'api_key' => 'anthropic_key_full',
                     ],
+                    'albert' => [
+                        'api_key' => 'albert-test-key',
+                        'base_url' => 'https://albert.api.etalab.gouv.fr/v1',
+                    ],
                     'azure' => [
                         'my_azure_instance' => [
                             'api_key' => 'azure_key_full',

src/platform/src/Bridge/Albert/PlatformFactory.php

@@ -16,6 +16,7 @@
 use Symfony\AI\Platform\Bridge\OpenAi\Gpt;
 use Symfony\AI\Platform\Contract;
 use Symfony\AI\Platform\Exception\InvalidArgumentException;
+use Symfony\AI\Platform\ModelCatalog\ModelCatalogInterface;
 use Symfony\AI\Platform\Platform;
 use Symfony\Component\HttpClient\EventSourceHttpClient;
 use Symfony\Contracts\HttpClient\HttpClientInterface;
@@ -29,6 +30,7 @@ public static function create(
         #[\SensitiveParameter] string $apiKey,
         string $baseUrl,
         ?HttpClientInterface $httpClient = null,
+        ModelCatalogInterface $modelCatalog = new ModelCatalog(),
         ?EventDispatcherInterface $eventDispatcher = null,
     ): Platform {
         if (!str_starts_with($baseUrl, 'https://')) {
@@ -52,7 +54,7 @@ public static function create(
                 new EmbeddingsModelClient($httpClient, $apiKey, $baseUrl),
             ],
             [new Gpt\ResultConverter(), new Embeddings\ResultConverter()],
-            new ModelCatalog(),
+            $modelCatalog,
             Contract::create(),
             $eventDispatcher,
         );