Address review comments and add Retriever to demo

- Remove duplicate class comment from Retriever (already on interface)
- Rename example file from with-options.php to movies.php (no options used)
- Add retriever configuration to demo application
- Add RetrieveCommand to demonstrate Retriever usage

Author: OskarStark

demo/config/packages/ai.yaml

@@ -100,6 +100,10 @@ ai:
                 - 'Symfony\AI\Store\Document\Transformer\TextTrimTransformer'
             vectorizer: 'ai.vectorizer.openai'
             store: 'ai.store.chroma_db.symfonycon'
+    retriever:
+        blog:
+            vectorizer: 'ai.vectorizer.openai'
+            store: 'ai.store.chroma_db.symfonycon'
 
 services:
     _defaults:

demo/src/Blog/Command/RetrieveCommand.php

@@ -0,0 +1,62 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace App\Blog\Command;
+
+use Symfony\AI\Store\RetrieverInterface;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Style\SymfonyStyle;
+use Symfony\Component\DependencyInjection\Attribute\Autowire;
+
+#[AsCommand('app:blog:retrieve', description: 'Retrieve blog posts using the Retriever component.')]
+final readonly class RetrieveCommand
+{
+    public function __construct(
+        #[Autowire(service: 'ai.retriever.blog')]
+        private RetrieverInterface $retriever,
+    ) {
+    }
+
+    public function __invoke(SymfonyStyle $io): int
+    {
+        $io->title('Retrieve Blog Posts');
+
+        $search = $io->ask('What do you want to search for?', 'New Symfony Features');
+        $io->comment(\sprintf('Searching for "%s" using the Retriever...', $search));
+
+        $documents = $this->retriever->retrieve((string) $search);
+
+        $count = 0;
+        foreach ($documents as $document) {
+            ++$count;
+            $title = $document->metadata->get('title') ?? 'Unknown Title';
+            $description = $document->metadata->get('description') ?? 'No description';
+
+            $io->section($title);
+            $io->block($description);
+
+            if (4 === $count) {
+                break;
+            }
+        }
+
+        if (0 === $count) {
+            $io->error('No results found!');
+
+            return Command::FAILURE;
+        }
+
+        $io->success(\sprintf('Found %d result(s) using the Retriever!', $count));
+
+        return Command::SUCCESS;
+    }
+}

docs/components/store.rst

@@ -101,7 +101,7 @@ Example Usage
 ~~~~~~~~~~~~~
 
 * `Basic Retriever Example`_
-* `Retriever with Options Example`_
+* `Movies Retriever Example`_
 
 Similarity Search Examples
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -201,7 +201,7 @@ This leads to a store implementing two methods::
 
 .. _`Retrieval Augmented Generation`: https://en.wikipedia.org/wiki/Retrieval-augmented_generation
 .. _`Basic Retriever Example`: https://github.com/symfony/ai/blob/main/examples/retriever/basic.php
-.. _`Retriever with Options Example`: https://github.com/symfony/ai/blob/main/examples/retriever/with-options.php
+.. _`Movies Retriever Example`: https://github.com/symfony/ai/blob/main/examples/retriever/movies.php
 .. _`Similarity Search with Cloudflare (RAG)`: https://github.com/symfony/ai/blob/main/examples/rag/cloudflare.php
 .. _`Similarity Search with Manticore (RAG)`: https://github.com/symfony/ai/blob/main/examples/rag/manticore.php
 .. _`Similarity Search with MariaDB (RAG)`: https://github.com/symfony/ai/blob/main/examples/rag/mariadb-gemini.php

examples/retriever/with-options.php renamed to examples/retriever/movies.php

@@ -46,8 +46,7 @@
 // create retriever
 $retriever = new Retriever($vectorizer, $store, logger());
 
-// retrieve documents with options (store-specific)
-// For InMemoryStore, you can pass options like 'limit' or 'threshold'
+// retrieve documents similar to the query
 echo "Searching for movies about 'crime family mafia'\n";
 echo "================================================\n\n";
 

src/store/src/Retriever.php

@@ -17,11 +17,6 @@
 use Symfony\AI\Store\Document\VectorizerInterface;
 
 /**
- * Retrieves documents from a vector store based on a query string.
- *
- * The opposite of Indexer - while the Indexer loads, transforms, vectorizes and stores documents,
- * the Retriever vectorizes a query and retrieves similar documents from the store.
- *
  * @author Oskar Stark <[email protected]>
  */
 class Retriever implements RetrieverInterface