Worker in background

Lo stack predefinito non avvia i worker. La ricerca e l'acquisizione di siti web continuano con funzionalità ridotte.

Senza il worker del grafo, Knowledge utilizza il recupero vettoriale e lessicale. Senza Crawl4AI, Ciele utilizza il suo crawler di recupero integrato.

I worker sono un file Compose separato, deploy/docker-compose.workers.yml. Lo stack legge quel file solo quando COMPOSE_FILE lo elenca.

Abilita i worker

Esegui lo script di bootstrap con l'opzione --workers:

./deploy/bootstrap.sh --workers

Lo script aggiunge il file a COMPOSE_FILE in deploy/.env. Genera inoltre tre delle quattro credenziali:

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

Il worker del grafo necessita inoltre di una chiave per il proprio provider di modelli. Lo script non può generare questa chiave. Imposta GRAPH_LLM_API_KEY in deploy/.env, quindi esegui nuovamente il comando.

L'opzione --workers e l'opzione --images sono indipendenti. Nessuna delle due opzioni disabilita l'altra.

I due worker possono richiedere circa 8 GiB di memoria. Misura l'utilizzo effettivo sull'host selezionato.

Controlla lo stato del worker

Includi il file workers in ogni comando:

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

Non esporre le porte o i token dei worker alla rete pubblica.

Disabilita i worker

Rimuovi docker-compose.workers.yml da COMPOSE_FILE in deploy/.env. Quindi rimuovi i due container:

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

Job di memoria a lungo termine

La memoria a lungo termine utilizza il registro dei job durevoli integrato. Non richiede i worker opzionali.

Ogni turno connesso pianifica un job promote_memories dopo una finestra di inattività di 15 minuti. Il profilo cron scarica questi lavori attraverso il percorso pianificato esistente.

Mantieni cron in COMPOSE_PROFILES quando la memoria a lungo termine è abilitata. La configurazione self-host predefinita lo include già.

Il job salta l'estrazione quando la memoria è disabilitata o il budget giornaliero di token è esaurito. Viene saltato anche quando non esiste una connessione al modello adatta.