[AiBundle] Add Perplexity platform configuration support

Author: matyo91

src/ai-bundle/CHANGELOG.md

@@ -5,6 +5,7 @@ CHANGELOG
 ---
 
  * Add Symfony bundle for integrating Platform, Agent, and Store components
+ * Add Perplexity platform support with API key configuration
  * Add service configuration:
    - Agent services with configurable platforms and system prompts
    - Tool registration via `#[AsTool]` attribute and `ai.tool` tag

src/ai-bundle/config/options.php

@@ -101,6 +101,11 @@
                             ->scalarNode('api_key')->isRequired()->end()
                         ->end()
                     ->end()
+                    ->arrayNode('perplexity')
+                        ->children()
+                            ->scalarNode('api_key')->isRequired()->end()
+                        ->end()
+                    ->end()
                 ->end()
             ->end()
             ->arrayNode('agent')

src/ai-bundle/doc/index.rst

@@ -34,7 +34,7 @@ Configuration
                     class: 'Symfony\AI\Platform\Bridge\OpenAi\Gpt'
                     name: !php/const Symfony\AI\Platform\Bridge\OpenAi\Gpt::GPT_4O_MINI
 
-**Advanced Example with Anthropic, Azure, ElevenLabs, Gemini, Vertex AI, Ollama multiple agents**
+**Advanced Example with Anthropic, Azure, ElevenLabs, Gemini, Perplexity, Vertex AI, Ollama multiple agents**
 
 .. code-block:: yaml
 
@@ -56,6 +56,8 @@ Configuration
                 output_path: '%env(ELEVEN_LABS_OUTPUT_PATH)%'
             gemini:
                 api_key: '%env(GEMINI_API_KEY)%'
+            perplexity:
+                api_key: '%env(PERPLEXITY_API_KEY)%'
             vertexai:
                 location: '%env(GOOGLE_CLOUD_LOCATION)%'
                 project_id: '%env(GOOGLE_CLOUD_PROJECT)%'
@@ -93,6 +95,12 @@ Configuration
                 tools: # If undefined, all tools are injected into the agent, use "tools: false" to disable tools.
                     - 'Symfony\AI\Agent\Toolbox\Tool\Wikipedia'
                 fault_tolerant_toolbox: false # Disables fault tolerant toolbox, default is true
+            search_agent:
+                platform: 'ai.platform.perplexity'
+                model:
+                    class: 'Symfony\AI\Platform\Bridge\Perplexity\Perplexity'
+                    name: !php/const Symfony\AI\Platform\Bridge\Perplexity\Perplexity::SONAR
+                tools: false
             audio:
                 platform: 'ai.platform.eleven_labs'
                 model:
@@ -131,7 +139,7 @@ Configuration
             default:
                 vectorizer: 'ai.vectorizer.openai_embeddings'
                 store: 'ai.store.chroma_db.default'
-                
+
             research:
                 vectorizer: 'ai.vectorizer.mistral_embeddings'
                 store: 'ai.store.memory.research'
@@ -355,13 +363,13 @@ Vectorizers are defined in the ``vectorizer`` section of your configuration:
                     name: !php/const Symfony\AI\Platform\Bridge\OpenAi\Embeddings::TEXT_EMBEDDING_3_SMALL
                     options:
                         dimensions: 512
-                        
+
             openai_large:
                 platform: 'ai.platform.openai'
                 model:
                     class: 'Symfony\AI\Platform\Bridge\OpenAi\Embeddings'
                     name: !php/const Symfony\AI\Platform\Bridge\OpenAi\Embeddings::TEXT_EMBEDDING_3_LARGE
-                    
+
             mistral_embed:
                 platform: 'ai.platform.mistral'
                 model:
@@ -379,19 +387,19 @@ Once configured, vectorizers can be referenced by name in indexer configurations
             documents:
                 vectorizer: 'ai.vectorizer.openai_small'
                 store: 'ai.store.chroma_db.documents'
-                
+
             research:
                 vectorizer: 'ai.vectorizer.openai_large'
                 store: 'ai.store.chroma_db.research'
-                
+
             knowledge_base:
                 vectorizer: 'ai.vectorizer.mistral_embed'
                 store: 'ai.store.memory.kb'
 
 **Benefits of Configured Vectorizers**
 
 * **Reusability**: Define once, use in multiple indexers
-* **Consistency**: Ensure all indexers using the same vectorizer have identical embedding configuration  
+* **Consistency**: Ensure all indexers using the same vectorizer have identical embedding configuration
 * **Maintainability**: Change vectorizer settings in one place
 
 Profiler

src/ai-bundle/src/AiBundle.php

@@ -40,6 +40,7 @@
 use Symfony\AI\Platform\Bridge\Ollama\PlatformFactory as OllamaPlatformFactory;
 use Symfony\AI\Platform\Bridge\OpenAi\PlatformFactory as OpenAiPlatformFactory;
 use Symfony\AI\Platform\Bridge\OpenRouter\PlatformFactory as OpenRouterPlatformFactory;
+use Symfony\AI\Platform\Bridge\Perplexity\PlatformFactory as PerplexityPlatformFactory;
 use Symfony\AI\Platform\Bridge\VertexAi\PlatformFactory as VertexAiPlatformFactory;
 use Symfony\AI\Platform\Bridge\Voyage\PlatformFactory as VoyagePlatformFactory;
 use Symfony\AI\Platform\Exception\RuntimeException;
@@ -419,7 +420,7 @@ private function processPlatformConfig(string $type, array $platform, ContainerB
             return;
         }
 
-        if ('cerebras' === $type && isset($platform['api_key'])) {
+        if ('cerebras' === $type) {
             $platformId = 'ai.platform.cerebras';
             $definition = (new Definition(Platform::class))
                 ->setFactory(CerebrasPlatformFactory::class.'::create')
@@ -436,7 +437,7 @@ private function processPlatformConfig(string $type, array $platform, ContainerB
             return;
         }
 
-        if ('voyage' === $type && isset($platform['api_key'])) {
+        if ('voyage' === $type) {
             $platformId = 'ai.platform.voyage';
             $definition = (new Definition(Platform::class))
                 ->setFactory(VoyagePlatformFactory::class.'::create')
@@ -453,6 +454,24 @@ private function processPlatformConfig(string $type, array $platform, ContainerB
             return;
         }
 
+        if ('perplexity' === $type) {
+            $platformId = 'ai.platform.perplexity';
+            $definition = (new Definition(Platform::class))
+                ->setFactory(PerplexityPlatformFactory::class.'::create')
+                ->setLazy(true)
+                ->addTag('proxy', ['interface' => PlatformInterface::class])
+                ->setArguments([
+                    $platform['api_key'],
+                    new Reference('http_client', ContainerInterface::NULL_ON_INVALID_REFERENCE),
+                    new Reference('ai.platform.contract.perplexity'),
+                ])
+                ->addTag('ai.platform');
+
+            $container->setDefinition($platformId, $definition);
+
+            return;
+        }
+
         throw new InvalidArgumentException(\sprintf('Platform "%s" is not supported for configuration via bundle at this point.', $type));
     }
 

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

@@ -623,6 +623,31 @@ public function testOpenAiPlatformWithInvalidRegion()
         ]);
     }
 
+    public function testPerplexityPlatformConfiguration()
+    {
+        $container = $this->buildContainer([
+            'ai' => [
+                'platform' => [
+                    'perplexity' => [
+                        'api_key' => 'pplx-test-key',
+                    ],
+                ],
+            ],
+        ]);
+
+        $this->assertTrue($container->hasDefinition('ai.platform.perplexity'));
+
+        $definition = $container->getDefinition('ai.platform.perplexity');
+        $arguments = $definition->getArguments();
+
+        $this->assertCount(3, $arguments);
+        $this->assertSame('pplx-test-key', $arguments[0]);
+        $this->assertInstanceOf(Reference::class, $arguments[1]);
+        $this->assertSame('http_client', (string) $arguments[1]);
+        $this->assertInstanceOf(Reference::class, $arguments[2]);
+        $this->assertSame('ai.platform.contract.perplexity', (string) $arguments[2]);
+    }
+
     public function testVectorizerConfiguration()
     {
         $container = $this->buildContainer([