Clasa Crew & Metoda kickoff(inputs=…) în CrewAI & Sisteme Multi-Agent

Containerul de orchestrare care reunește agenții și sarcinile într-o echipă funcțională, pornită prin metoda .kickoff() cu parametri dinamici.

Sintaxă & invocare Python
from crewai import Crew, Process

echipa = Crew(
    agents=[cercetator, redactor],
    tasks=[task_cercetare, task_redactare],
    process=Process.sequential,
    verbose=True
)
rezultat = echipa.kickoff(inputs={"subiect": "Model Context Protocol (MCP)"})
print(rezultat.raw)

Descriere & Utilizare

Clasa Crew reprezintă echipa propriu-zisă: aduce împreună lista de agenți (agents), lista de sarcini (tasks), strategia de colaborare (process), memoria partajată și sursele de cunoștințe.

Execuția echipei este declanșată prin apelul metodei echipa.kickoff(inputs={...}). Dicționarul inputs interpolază automat toate variabilele {cheie} prezente în definițiile agenților și ale sarcinilor.

Metoda returnează un obiect bogat de tip CrewOutput, care conține atât răspunsul final în text (rezultat.raw), cât și obiectul Pydantic validat (rezultat.pydantic), lista rezultatelor intermediare pe fiecare task (rezultat.tasks_output) și consumul total de tokeni (rezultat.token_usage).

Cum să o reții ușor

💡 Dacă Agenții sunt jucătorii și Task-urile sunt fazele de joc din regulament, Crew este terenul pe care se dispută meciul, iar .kickoff() este fluierul de start al arbitrului.

Opțiuni și parametri tehnici

  • agents & tasks: listele ordonate de agenți și sarcini care compun echipa.
  • process: modul de orchestrare — Process.sequential (implicit, în ordine) sau Process.hierarchical (cu un agent Manager).
  • verbose=True: afișează în consolă, colorat și structurat, gândurile, apelurile de unelte și răspunsurile fiecărui agent.
  • output_log_file=" jurnal.txt": salvează întregul istoric de execuție într-un fișier text sau JSON pe disc.

Exemple practice și cazuri de utilizare

  • Verificarea costului în tokeni după execuție: print(rezultat.token_usage) (afișează total_tokens, prompt_tokens, completion_tokens).
  • Inspectarea livrabilului primului task din echipă: print(rezultat.tasks_output[0].raw).
  • Rularea aceleiași echipe pe alt subiect fără reinițializare: apelează din nou echipa.kickoff(inputs={"subiect": "Securitate Docker"}).

Sfaturi de configurare & capcane

Activează întotdeauna verbose=True în faza de dezvoltare pentru a urmări exact cum raționează fiecare agent și ce argumente trimite către unelte.

Comenzi și ghiduri înrudite