smart_ide/docs/features/initial-rag-sync-4nkaiignore.md
Nicolas Cantu b21ac2cf64 feat: anythingllm-devtools service, builazoo project, ssh-config example, docs
- Add services/anythingllm-devtools HTTP API (repos + AnythingLLM + RAG)
- Rename gitea-issues to git-issues across smart_ide agents and docs
- Add projects/builazoo, builazoo README, cron fragment, ssh-config.example
- Add ensure-ia-dev-project-link.sh; wrapper delegates smart_ide id
- Bump ia_dev submodule (git-issues rename, project symlinks)
- Align 4nkaiignore templates; update API index and project docs
2026-04-03 19:06:19 +02:00

2.1 KiB
Raw Blame History

Synchronisation RAG initiale et .4nkaiignore

Author: 4NK

Objectif

À la création du clone (ou chargement sync), disposer dun workspace AnythingLLM aligné sur le dépôt et importer une première vague de fichiers utiles au RAG, en excluant le bruit via un fichier .4nkaiignore (syntaxe identique à .gitignore).

Comportement

  1. Serveur repos-devtools-server : après git clone réussi, copie templates/4nkaiignore.default vers <repo>/.4nkaiignore si absent.
  2. Service anythingllm-devtools (ou extension héritée) : après /repos-clone-sync, /repos-load-sync, ou sur /workspace-sync <nom>, si la synchro initiale nest pas désactivée (ANYTHINGLLM_INITIAL_SYNC_AFTER_CLONE côté service, ou anythingllm.initialSyncAfterClone côté extension) :
    • assure .4nkaiignore depuis le template si toujours absent ;
    • parcourt le dépôt, applique règles de base + .4nkaiignore ;
    • envoie chaque fichier accepté via POST /api/v1/document/upload avec addToWorkspaces = slug du workspace.

Fichier type

  • services/anythingllm-devtools/templates/4nkaiignore.default (référence)
  • services/repos-devtools-server/templates/4nkaiignore.default (même contenu ; à maintenir en parité)
  • extensions/anythingllm-workspaces/templates/4nkaiignore.default (copie héritée)

Lutilisateur renomme / copie en .4nkaiignore à la racine du projet et adapte les règles.

Prérequis AnythingLLM

Le collecteur / processeur de documents doit être joignable par linstance AnythingLLM ; sinon lupload API échoue avec le message renvoyé par le serveur.

Modalités danalyse

  • Compter les champs uploaded, skipped, errors, capped, dotfileCreated dans la section Initial RAG sync du panneau Dev tools.
  • Vérifier les logs AnythingLLM / collector en cas déchec systématique des uploads.

Modalités de déploiement

  • Rebuild et redémarrage de repos-devtools-server et de anythingllm-devtools ; repackaging / réinstallation de lextension uniquement si vous conservez encore la surface IDE.