crewai checkpoint în CrewAI & Sisteme Multi-Agent

crewai checkpoint [--location CALE] [list | info | resume | diff | prune]

Ce face crewai checkpoint

Checkpoint-urile sunt instantanee ale stării unei rulări, scrise automat după evenimente (implicit task_completed). Le activezi cu checkpoint=True pe Crew, Flow sau Agent; se scriu în ./.checkpoints/.

Fără subcomandă, crewai checkpoint deschide un TUI. În stânga, checkpoint-urile sunt grupate pe ramuri, cu fork-urile sub părintele lor. Selectând unul, vezi metadatele, starea și progresul task-urilor. Resume continuă rularea, iar Fork pornește o ramură nouă. Poți edita intrările inițiale și ieșirile task-urilor terminate; după o editare și un Fork, task-urile de după se rulează din nou.

list și info inspectează checkpoint-urile fără TUI. resume, diff și prune au fost adăugate în 1.14.2; opțiunile lor de mai jos vin din crewai checkpoint --help.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
--location CALE	Directorul (JsonProvider) sau fișierul SQLite (SqliteProvider). Implicit ./.checkpoints.
list [CALE]	Listează checkpoint-urile dintr-o locație.
info [CALE]	Detaliile unui checkpoint. Cu un director sau o bază SQLite, arată cel mai recent.
resume [ID]	Reia de la un checkpoint; implicit de la cel mai recent.
diff ID1 ID2	Compară două checkpoint-uri unul lângă altul.
prune [--keep N] [--older-than DURATĂ] [--dry-run]	Șterge checkpoint-urile vechi: păstrează ultimele N sau le șterge pe cele mai vechi decât 7d, 24h, 30m. --dry-run doar arată ce s-ar șterge.

Exemple practice

Exemplul 1: TUI pe locația implicită sau pe alta

crewai checkpoint
crewai checkpoint --location ./my_checkpoints
crewai checkpoint --location ./.checkpoints.db

Exemplul 2: Inspectare fără TUI

crewai checkpoint list ./my_checkpoints
crewai checkpoint info ./.checkpoints.db

Exemplul 3: Activarea în cod

crew = Crew(agents=[...], tasks=[...], checkpoint=True)

Greșeli frecvente și bune practici

• Rulezi comanda într-un proiect fără checkpoint=True (sau CheckpointConfig). Nu există nimic de afișat.
• Alegi evenimente foarte frecvente, ca llm_call_completed, fără max_checkpoints. Se scriu foarte multe fișiere; folosește prune sau limita din configurație.

Comenzi înrudite

• crewai-replay
• crewai-run
• crewai-crew-kickoff