feat: knowledge base functionality for the voice agent (#120)

* feat: upload file and store embedding

* feat: add documents in nodes

* feat: add openai embedding service

api/services/filesystem/base.py

@@ -85,3 +85,16 @@ class BaseFileSystem(ABC):
             Optional[str]: Presigned PUT URL if successful, None otherwise
         """
         pass
+
+    @abstractmethod
+    async def adownload_file(self, source_path: str, local_path: str) -> bool:
+        """Download a file from storage to local path.
+
+        Args:
+            source_path: Path to the file in storage
+            local_path: Local path where file should be downloaded
+
+        Returns:
+            bool: True if file was downloaded successfully, False otherwise
+        """
+        pass

api/services/filesystem/minio.py

@@ -170,3 +170,15 @@ class MinioFileSystem(BaseFileSystem):
         except Exception as e:
             logger.error(f"Error generating MinIO upload URL: {e}")
             return None
+
+    async def adownload_file(self, source_path: str, local_path: str) -> bool:
+        """Download a file from MinIO to local path."""
+        try:
+
+            def _fget():
+                self.client.fget_object(self.bucket_name, source_path, local_path)
+
+            await asyncio.to_thread(_fget)
+            return True
+        except S3Error:
+            return False

api/services/filesystem/s3.py

@@ -126,3 +126,14 @@ class S3FileSystem(BaseFileSystem):
             return url
         except ClientError:
             return None
+
+    async def adownload_file(self, source_path: str, local_path: str) -> bool:
+        """Download a file from S3 to local path."""
+        try:
+            async with self.session.client(
+                "s3", region_name=self.region_name
+            ) as s3_client:
+                await s3_client.download_file(self.bucket_name, source_path, local_path)
+            return True
+        except ClientError:
+            return False