Compagnon multimodal RAG-Anything

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Español · Deutsch

<!-- translations:end -->

RAG-Anything est un framework RAG multimodal (basé sur LightRAG) qui parse PDF, documents Office, images et équations via MinerU/Docling/PaddleOCR. Tesserae l'intègre à la fois comme pipeline d'ingestion multimodale (projection native de graphe à la manière UA) et comme backend de mémoire d'exécution aux côtés de Cognee.

Pourquoi utiliser les deux ?

• Tesserae — mémoire d'agent durable, compilation wiki, projection de graphe.
• RAG-Anything — ingestion multimodale + récupération d'exécution LightRAG.

Les deux se complètent : RAG-Anything apporte la compréhension PDF/Office/images que les chargeurs de sources orientés texte de Tesserae ne fournissent pas ; Tesserae conserve la mémoire durable et interrogeable qui survit aux sessions.

Workflow actuel à faible friction

Le chemin recommandé est l'assistant de configuration :

tesserae init

RAG-Anything est désormais une invite interactive de l'assistant plutôt qu'un ensemble de flags CLI. Lorsque l'assistant s'exécute, répondez aux invites d'intégration :

• activez RAG-Anything lorsqu'on vous le demande ;
• installez-le lorsqu'on vous le demande (installe raganything + docling) ;
• choisissez le parseur mineru ;
• activez l'exécution de rafraîchissement après l'installation lorsqu'elle est proposée.

Puis compilez :

tesserae compile

Pour une automatisation non interactive (CI), exécutez l'assistant avec les valeurs par défaut (toutes les intégrations optionnelles DÉSACTIVÉES), puis activez RAG-Anything dans .tesserae/config.json — l'assistant écrit la configuration de l'intégration sous la clé external_tools / memory_backends — et exécutez le rafraîchissement géré :

tesserae init --yes
# activer raganything dans .tesserae/config.json (clé external_tools)
tesserae integrations refresh raganything --parser mineru
tesserae compile

Tesserae stocke une commande de rafraîchissement gérée plutôt que de demander aux utilisateurs d'en inventer une :

tesserae integrations refresh raganything --parser mineru

Pendant la compilation, Tesserae :

1. vérifie si .tesserae/external/raganything/manifest.json existe et correspond au commit git courant (via le meta.json#gitCommitHash stocké) ;
2. exécute le wrapper de rafraîchissement géré s'il est manquant/périmé ou si --refresh-external-tools est passé ;
3. découvre les sources non-code (PDF, documents Office, images, markdown) et les parse via le parser configuré ;
4. écrit manifest.json + meta.json ;
5. poursuit la compilation normale de la mémoire.

Vous pouvez forcer toutes les commandes de rafraîchissement externes configurées avant une compilation :

tesserae compile --refresh-integrations

Équivalent manuel

pip install 'raganything[all]'
python -m tesserae.raganything_refresh --project . --parser mineru
tesserae compile

Synchronisation native du graphe

Tesserae importe nativement le manifest parsé pendant compile lorsque l'outil configuré utilise sync_mode: native_graph.

L'adaptateur natif lit .tesserae/external/raganything/manifest.json, projette chaque document parsé dans un SourceFile node avec des métadonnées de blocs multimodaux, et écrit un sync manifest :

.tesserae/external/raganything-sync.json

Mapping actuel :

La provenance est préservée sur chaque nœud :

{"system": "rag-anything", "id": "doc-<sha256>", "type": "document", "artifact": ".tesserae/external/raganything/manifest.json"}

Backend de mémoire d'exécution

memory_backends.raganything (valeur par défaut produite par default_raganything_backend_config) coexiste avec Cognee. project ask essaie les backends dans l'ordre de priorité ; la priorité par projet peut être définie via memory_backends.priority. RAG-Anything est opt-in (par défaut enabled: false) ; le flag de configuration --with-raganything l'active.

Prérequis système

• Python 3.10+ (exigence de RAG-Anything ; Tesserae lui-même cible 3.9+).
• LibreOffice pour parser .doc/.docx/.ppt/.pptx/.xls/.xlsx — installez-le séparément via le gestionnaire de paquets de votre plateforme. RAG-Anything ignore les documents Office avec un avertissement quand LibreOffice est manquant.
• Les poids du modèle MinerU sont téléchargés au premier parsing et mis en cache (~Go). Les exécutions suivantes réutilisent le cache.
• Clés LLM/embedding/vision compatibles OpenAI (OPENAI_API_KEY, OPENAI_BASE_URL) pour le backend de mémoire d'exécution. Le mode parser-only ne nécessite pas de clés.

Principe de collaboration

Tesserae reste le memory compiler. RAG-Anything reste un compagnon indépendant : parser multimodal + moteur de récupération LightRAG.