Processus de fond

La pile par défaut ne démarre pas les workers. La recherche et l'ingestion de sites Web se poursuivent avec des capacités réduites.

Sans le worker graphique, Knowledge utilise la recherche vectorielle et lexicale. Sans Crawl4AI, Ciele utilise son robot d'indexation Fetch intégré.

Les workers sont un fichier Compose distinct, deploy/docker-compose.workers.yml. La pile ne lit ce fichier que lorsque COMPOSE_FILE le répertorie.

Activez les workers

Exécutez le script de démarrage avec l'option --workers :

./deploy/bootstrap.sh --workers

Le script ajoute le fichier à COMPOSE_FILE dans deploy/.env. Il génère également trois des quatre identifiants :

COMPOSE_FILE=docker-compose.yml:docker-compose.workers.yml
GRAPH_WORKER_API_TOKEN=<generated>
CRAWL4AI_API_TOKEN=<generated>
CRAWL4AI_SECRET_KEY=<generated>

Le worker graphique a également besoin d'une clé pour son propre fournisseur de modèles. Le script ne peut pas générer cette clé. Définissez GRAPH_LLM_API_KEY dans deploy/.env, puis exécutez à nouveau la commande.

L'option --workers et l'option --images sont indépendantes. Aucune des deux options ne désactive l'autre.

Les deux workers peuvent nécessiter environ 8 GiB de mémoire. Mesurez l'utilisation réelle sur l'hôte que vous avez sélectionné.

Vérifiez l'état du worker

Incluez le fichier workers dans chaque commande :

docker compose -f deploy/docker-compose.yml -f deploy/docker-compose.workers.yml ps
docker compose -f deploy/docker-compose.yml -f deploy/docker-compose.workers.yml logs -f graph-worker crawl4ai

N'exposez pas les ports ou les jetons des processus de travail au réseau public.

Désactivez les workers

Supprimez docker-compose.workers.yml de COMPOSE_FILE dans deploy/.env. Supprimez ensuite les deux conteneurs :

docker compose -f deploy/docker-compose.yml up -d --remove-orphans

Tâches de mémoire à long terme

La mémoire à long terme utilise le registre de tâches durable intégré. Elle ne requiert pas les workers optionnels.

Chaque tour connecté planifie une tâche promote_memories après une fenêtre de repos de 15 minutes. Le profil cron achemine ces tâches via le chemin planifié existant.

Conservez cron dans COMPOSE_PROFILES lorsque la mémoire à long terme est activée. La configuration d'auto-hébergement par défaut l'inclut déjà.

La tâche ignore l'extraction lorsque la mémoire est désactivée ou que le budget quotidien de jetons est épuisé. Elle est également ignorée lorsqu'il n'existe aucune connexion de modèle appropriée.