feat(ai-bundle): add semantic_ratio to meilisearch store config

Author: ahmed-bhs

examples/rag/meilisearch.php

@@ -33,6 +33,8 @@
     endpointUrl: env('MEILISEARCH_HOST'),
     apiKey: env('MEILISEARCH_API_KEY'),
     indexName: 'movies',
+    // Optional: configure hybrid search ratio (0.0 = keyword, 1.0 = semantic)
+    // semanticRatio: 0.5, // 50/50 hybrid search
 );
 
 // create embeddings and documents

src/ai-bundle/config/options.php

@@ -525,6 +525,14 @@
                                 ->stringNode('embedder')->end()
                                 ->stringNode('vector_field')->end()
                                 ->integerNode('dimensions')->end()
+                                ->floatNode('semantic_ratio')
+                                    ->info('The ratio between semantic (vector) and keyword (BM25) search (0.0 to 1.0). Default: 1.0 (100% semantic)')
+                                    ->defaultValue(1.0)
+                                    ->validate()
+                                        ->ifTrue(fn ($v) => $v < 0.0 || $v > 1.0)
+                                        ->thenInvalid('The semantic ratio must be between 0.0 and 1.0.')
+                                    ->end()
+                                ->end()
                             ->end()
                         ->end()
                     ->end()

src/ai-bundle/src/AiBundle.php

@@ -919,6 +919,10 @@ private function processStoreConfig(string $type, array $stores, ContainerBuilde
                     $arguments[6] = $store['dimensions'];
                 }
 
+                if (\array_key_exists('semantic_ratio', $store)) {
+                    $arguments[7] = $store['semantic_ratio'];
+                }
+
                 $definition = new Definition(MeilisearchStore::class);
                 $definition
                     ->addTag('ai.store')

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

@@ -2904,6 +2904,7 @@ private function getFullConfig(): array
                             'embedder' => 'default',
                             'vector_field' => '_vectors',
                             'dimensions' => 768,
+                            'semantic_ratio' => 0.5,
                         ],
                     ],
                     'memory' => [
@@ -3060,4 +3061,28 @@ private function getFullConfig(): array
             ],
         ];
     }
+
+    #[TestDox('Meilisearch store with custom semantic_ratio can be configured')]
+    public function testMeilisearchStoreWithCustomSemanticRatioCanBeConfigured()
+    {
+        $container = $this->buildContainer([
+            'ai' => [
+                'store' => [
+                    'meilisearch' => [
+                        'test_store' => [
+                            'endpoint' => 'http://127.0.0.1:7700',
+                            'api_key' => 'test_key',
+                            'index_name' => 'test_index',
+                            'semantic_ratio' => 0.5,
+                        ],
+                    ],
+                ],
+            ],
+        ]);
+
+        $this->assertTrue($container->hasDefinition('ai.store.meilisearch.test_store'));
+        $definition = $container->getDefinition('ai.store.meilisearch.test_store');
+        $arguments = $definition->getArguments();
+        $this->assertSame(0.5, $arguments[7]);
+    }
 }