docs: split into components

Author: chr-hertel

src/store/README.md

@@ -0,0 +1,22 @@
+# Symfony AI - Store Component
+
+The Store component provides a low-level abstraction for storing and retrieving documents in a vector store.
+
+## Installation
+
+```bash
+composer require symfony/ai-store
+```
+
+**This repository is a READ-ONLY sub-tree split**. See
+https://github.com/symfony/ai to create issues or submit pull requests.
+
+## Resources
+
+-   [Documentation](doc/index.rst)
+-   [Report issues](https://github.com/symfony/ai/issues) and
+    [send Pull Requests](https://github.com/symfony/ai/pulls)
+    in the [main Symfony AI repository](https://github.com/symfony/ai)
+
+[1]: https://symfony.com/backers
+[3]: https://symfony.com/sponsor

src/store/composer.json

@@ -1,7 +1,7 @@
 {
     "name": "symfony/ai-store",
     "type": "library",
-    "description": "PHP library for abstracting interaction with data stores in AI applications.",
+    "description": "Low-level abstraction for storing and retrieving documents in a vector store.",
     "keywords": [
         "ai",
         "mongodb",

src/store/doc/index.rst

@@ -0,0 +1,89 @@
+Symfony AI - Store Component
+============================
+
+The Store component provides a low-level abstraction for storing and retrieving documents in a vector store.
+
+Installation
+------------
+
+Install the bundle using Composer:
+
+.. code-block:: terminal
+
+    $ composer require symfony/ai-store
+
+Purpose
+-------
+
+A typical use-case in agentic applications is a dynamic context-extension with similar and useful information, for so
+called **Retrieval Augmented Generation** (RAG). The Store component implements low-level interfaces, that can be
+implemented by different concrete and vendor-specific implementations, so called bridges.
+On top of those bridges, the Store component provides higher level features to populate and query those stores with and
+for documents.
+
+Embedder
+--------
+
+One higher level feature is the ``Symfony\AI\Store\Embedder``. The purpose of this service is to populate a store with documents.
+Therefore it accepts one or multiple ``Symfony\AI\Store\Document\TextDocument`` objects, converts them into embeddings and stores them in the
+used vector store.
+
+Simple usage example:
+
+.. code-block: php
+
+    use Symfony\AI\Store\Embedder;
+    use Symfony\AI\Store\Document\TextDocument;
+
+    $embedder = new Embedder($storeBridge);
+    $document = new TextDocument('This is a sample document.');
+    $embedder->embed($document);
+
+You can find more advanced usage in combination with an Agent using the store for RAG in the examples folder:
+
+1. `Similarity Search with MongoDB (RAG)`_
+1. `Similarity Search with Pinecone (RAG)`_
+
+Supported Stores
+----------------
+
+1. Azure Search
+1. ChromaDB
+1. MongoDB
+1. Pinecone
+
+See `GitHub`_ for planned stores.
+
+
+Implementing a Bridge
+---------------------
+
+The main extension points of the Store component are
+
+1. **Symfony\AI\Store\StoreInterface**: That takes care of adding documents to the store
+1. **Symfony\AI\Store\VectorStoreInterface**: That takes care of querying the store for documents
+
+This leads to a store implementing two methods:
+
+.. code-block: php
+
+    use Symfony\AI\Store\StoreInterface;
+    use Symfony\AI\Store\VectorStoreInterface;
+
+    class MyStore implements StoreInterface, VectorStoreInterface
+    {
+        public function add(VectorDocument ...$documents): void
+        {
+            // Implementation to add a document to the store
+        }
+
+        public function query(Vector $vector, array $options = [], ?float $minScore = null): array
+        {
+            // Implementation to query the store for documents
+            return [];
+        }
+    }
+
+.. _`Similarity Search with MongoDB (RAG)`: https://github.com/symfony/ai/blob/main/examples/store/mongodb-similarity-search.php
+.. _`Similarity Search with Pinecone (RAG)`: https://github.com/symfony/ai/blob/main/examples/store/pinecone-similarity-search.php
+.. _`GitHub`: https://github.com/symfony/ai/issues/16