Claude Code hap modalitetin e luftës së ekipit! Ekipet e Agjentëve që duhet t'i përdorni!

Claude Code ka lëshuar një goditje tjetër të madhe: Ekipet e Agjentëve, mund të kuptohet si një version super i përforcuar i Nën-Agjentëve～ Figura më poshtë është një krahasim midis Ekipeve të Agjentëve dhe Nën-Agjentëve:

Unë jam "i pari që e përdor"! (Shumë kënaqësi! Shumë kënaqësi! Shumë kënaqësi!)

Kushtet për të aktivizuar Ekipet e Agjentëve: 
1. Përditësoni Claude Code në versionin më të ri (claude update) 

2. Në settings.json shtoni një rresht:

"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 

3. Rinisni Claude Code～  

4. Pastaj përdorni drejtpërdrejt gjuhën natyrore për t'i kërkuar Claude Code të krijojë një Ekip Agjentësh (sigurisht, duhet të shpjegoni qartë çfarë duhet të bëjë Ekipi i Agjentëve)  

Përveç kësaj, modelet e tjera nuk ndikojnë në punën e Ekipeve të Agjentëve (unë përdor KIMi për kodim)

Më shumë rreth Ekipeve të Agjentëve specifikisht shihni më poshtë (artikull zyrtar nga Anthropic)!

Ekipet e Agjentëve ju lejojnë të koordinoni disa instanca të Claude Code që të punojnë së bashku. Një seancë vepron si kryetar, duke koordinuar punën, duke shpërndarë detyrat, duke sintetizuar rezultatet. Anëtarët e tjerë punojnë në mënyrë të pavarur, secili në dritaren e tyre të kontekstit, dhe mund të komunikojnë drejtpërdrejt mes vete.

Ndryshe nga nën-agjentët (nën-agjentët funksionojnë brenda një seance të vetme dhe mund të raportojnë vetëm te agjenti kryesor), ju gjithashtu mund të ndërveproni drejtpërdrejt me anëtarët individualë, pa kaluar nëpër kryetar.

Ky dokument mbulon:

• • Kur të përdorni Ekipet e Agjentëve, duke përfshirë rastet më të mira të përdorimit dhe krahasimin me nën-agjentët

• • Nisja e ekipit

• • Kontrollimi i anëtarëve, duke përfshirë mënyrat e shfaqjes, shpërndarjen e detyrave dhe delegimin

• • Praktikat më të mira për punë paralele

Kur të përdorni Ekipet e Agjentëve

Ekipet e Agjentëve janë më efektive në detyra ku eksplorimi paralel mund të shtojë vlerë të vërtetë. Rastet më të forta të përdorimit përfshijnë:

• • Kërkime dhe rishikime —— Disa anëtarë mund të hetojnë aspekte të ndryshme të një problemi njëkohësisht, pastaj të ndajnë dhe sfidojnë zbulimet e njëri-tjetrit

• • Module ose funksione të reja —— Anëtarët mund të kenë pjesë të pavarura, pa ndërhyrje reciproke

• • Debug me hipoteza konkurruese —— Anëtarët testojnë teori të ndryshme paralelisht, duke gjetur përgjigjen më shpejt

• • Koordinim ndërshtresor —— Ndryshime që kalojnë front-end, back-end dhe testime, secila e përgjegjshme nga një anëtar i ndryshëm

Ekipet e Agjentëve shtojnë overhead koordinimi (A do të guxonit të përdorni Opus4.6 për të hapur Ekipet e Agjentëve🤣), duke rritur ndjeshëm konsumin e tokenëve krahasuar me përdorimin e një seance të vetme. Ato funksionojnë më mirë kur grupet e vogla mund të operojnë në mënyrë të pavarur. Për detyra sekuenciale, redaktim të të njëjtit skedar ose punë me shumë varësi, një seancë e vetme ose nën-agjentë janë më efektivë.

Krahasim me Nën-Agjentët

Ekipet e Agjentëve dhe nën-agjentët të dyja ju lejojnë të punoni paralelisht, por operojnë ndryshe. Zgjidhni bazuar në nevojën e punëtorëve tuaj për të komunikuar mes vete:

Nën-Agjentët

Ekipet e Agjentëve

Konteksti

Dritarja e tyre e kontekstit; rezultatet kthehen te thirrësi

Dritarja e tyre e kontekstit; plotësisht të pavarur

Komunikimi

Raportohen vetëm rezultatet te agjenti kryesor

Anëtarët dërgojnë mesazhe drejtpërdrejt mes vete

Koordinimi

Agjenti kryesor menaxhon të gjithë punën

Lista e përbashkët e detyrave, koordinim i vetë

Më i përshtatshëm për

Detyra të fokusuara ku interesoheni vetëm për rezultatin

Punë komplekse që kërkojnë diskutim dhe bashkëpunim

Kostoja e Tokenëve

Më e ulët: rezultatet përmblidhen në kontekstin kryesor

Më e lartë: çdo anëtar është një instancë e pavarur Claude

Përdorni nën-agjentë kur keni nevojë për punëtorë të shpejtë, të fokusuar që raportojnë rezultate. Përdorni Ekipet e Agjentëve kur grupi ka nevojë të ndajë zbulime, t'i sfidojë njëri-tjetrin dhe të koordinohet vetë.

Aktivizimi i Ekipeve të Agjentëve

Ekipet e Agjentëve janë të çaktivizuara si parazgjedhje. Aktivizoni duke vendosur variablin e mjedisit CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS në 1, mund të bëhet në mjedisin shell ose përmes settings.json:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Nisja e Ekipit tuaj të Parë të Agjentëve

Pasi të aktivizoni Ekipet e Agjentëve, i thoni Claudes të krijojë një Ekip Agjentësh, duke përdorur gjuhën natyrore për të përshkruar detyrën dhe strukturën e ekipit që dëshironi. Claude krijon ekipin, gjeneron anëtarët dhe koordinon punën bazuar në udhëzimet tuaja.

Ky shembull funksionon mirë, sepse tre rolet janë të pavarura dhe mund të eksplorojnë problemin pa pritur njëri-tjetrin:

Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
(Krijoni një Ekip Agjentësh për ta eksploruar këtë nga kënde të ndryshme: një anëtar përgjegjës për UX, një për arkitekturën teknike, një që luan rolin e avokatit të djallit.)

Prej andej, Claude krijon një ekip me një listë të përbashkët detyrash, gjeneron anëtarë për çdo perspektivë, i lë ata të eksplorojnë problemin, sintetizon zbulimet dhe përpiqet të pastrojë ekipin pas përfundimit.

Terminali i kryetarit liston të gjithë anëtarët dhe përmbajtjen e punës së tyre. Përdorni Shift+Up/Down për të zgjedhur anëtarët dhe për t'u dërguar mesazhe drejtpërdrejt.

Kontrollimi i Ekipit tuaj të Agjentëve

Përdorni gjuhën natyrore për t'i treguar kryetarit çfarë dëshironi. Ai përpunon koordinimin e ekipit, shpërndarjen e detyrave dhe delegimin sipas udhëzimeve tuaja.

Zgjedhja e Mënyrës së Shfaqjes

Ekipet e Agjentëve mbështesin dy mënyra shfaqjeje:

• • Mënyra brenda-procesit —— Të gjithë anëtarët funksionojnë brenda terminalit tuaj kryesor. Përdorni Shift+Up/Down për të zgjedhur anëtarët dhe për të futur drejtpërdrejt mesazhe për t'u dërguar. I përshtatshëm për çdo terminal, pa konfigurim shtesë.

• • Mënyra me dritare të ndara —— Çdo anëtar ka panelin e vet. Ju mund të shihni prodhimin e të gjithëve njëkohësisht, klikoni në panel për të ndërvepruar drejtpërdrejt. Kërkon tmux ose iTerm2.

Parazgjedhja është "auto", e cila përdor mënyrën me dritare të ndara nëse tashmë jeni duke ekzekutuar në një seancë tmux, përndryshe përdor mënyrën brenda-procesit.

Për të detyruar përdorimin e mënyrës brenda-procesit për një seancë të vetme, kaloni flamurin:

claude --teammate-mode in-process

Specifikimi i Anëtarëve dhe Modeleve

Claude vendos sa anëtarë të gjenerojë bazuar në detyrën tuaj, ose mund të specifikoni saktësisht çfarë dëshironi:

Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
(Krijoni një ekip me 4 anëtarë për të ristrukturuar këto module paralelisht. Përdorni Sonnet për çdo anëtar.)

Kërkesa për Miratim të Planit nga Anëtarët

Për detyra komplekse ose me rrezik, mund të kërkoni që anëtarët të planifikojnë përpara zbatimit. Anëtarët punojnë në mënyrën e vetëm-leximit të planifikimit, derisa kryetari të miratojë metodën e tyre:

Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes.
(Gjeneroni një anëtar arkitekt për të ristrukturuar modulin e autentikimit. Kërkoni miratim plani përpara se të bëjnë ndonjë ndryshim.)

Kur anëtari përfundon planin, ai dërgon një kërkesë miratimi plani te kryetari. Kryetari rishikon planin dhe miraton ose refuzon dhe ofron feedback.

Përdorimi i Mënyrës Deleguese

Pa mënyrën deleguese, ndonjëherë kryetari fillon vetë të zbatojë detyrat, në vend që të presë që anëtarët të përfundojnë. Mënyra deleguese e parandalon këtë duke e kufizuar kryetarin vetëm në mjetet e koordinimit. Shtypni Shift+Tab për të kaluar në mënyrën deleguese.

Biseda Direkte me Anëtarët

Çdo anëtar është një seancë e plotë, e pavarur e Claude Code. Ju mund t'i dërgoni mesazhe drejtpërdrejt çdo anëtari:

• • Mënyra brenda-procesit: Përdorni Shift+Up/Down për të zgjedhur anëtarët, pastaj shkruani për të dërguar mesazhe. Shtypni Enter për të parë seancën e anëtarit, pastaj shtypni Escape për ta ndërprerë raundin e tyre aktual. Shtypni Ctrl+T për të ndërruar listën e detyrave.

• • Mënyra me dritare të ndara: Klikoni në panelin e anëtarit për të ndërvepruar drejtpërdrejt me seancën e tij.

Caktimi dhe Marrja e Detyrave

Lista e përbashkët e detyrave koordinon punën e ekipit. Kryetari krijon detyrat, anëtarët i përfundojnë. Detyrat kanë tre gjendje: në pritje, në progres, të përfunduara. Detyrat gjithashtu mund të kenë varësi nga detyra të tjera.

Kryetari mund t'u caktojë detyra në mënyrë eksplicite, ose anëtarët mund t'i marrin vetë pasi të përfundojnë detyrat e tyre.

Mbyllja e Anëtarëve

Për të përfunduar me hijeshi seancën e një anëtari:

Ask the researcher teammate to shut down
(Kërkoni nga anëtari kërkues të mbyllet)

Kryetari dërgon një kërkesë mbylljeje. Anëtari mund të miratojë dhe të dalë me hijeshi, ose të refuzojë dhe të shpjegojë arsyen.

Pastrimi i Ekipit

Pas përfundimit, kërkoni nga kryetari të pastrojë:

Clean up the team
(Pastroni ekipin)

Kjo heq burimet e përbashkëta të ekipit. Kur kryetari ekzekuton pastrimin, ai kontrollon për anëtarë aktivë, dhe dështon nëse ka ende anëtarë që funksionojnë, prandaj mbyllini ata së pari.

Si Funksionojnë Ekipet e Agjentëve

Arkitektura

Një Ekip Agjentësh përfshin:

• • Kryetari: Seanca kryesore e Claude Code që krijon ekipin, gjeneron anëtarët dhe koordinon punën

• • Anëtarët: Instanca të pavarura të Claude Code që përpunojnë detyrat e caktuara

• • Lista e detyrave: Lista e përbashkët e artikujve të punës që anëtarët marrin dhe përfundojnë

• • Kutia postare: Sistemi i mesazheve për komunikim midis agjentëve

Sistemi menaxhon automatikisht varësitë e detyrave. Ekipi dhe detyrat ruhen lokal:

• • Konfigurimi i ekipit: ~/.claude/teams/{team-name}/config.json

• • Lista e detyrave: ~/.claude/tasks/{team-name}/

Konteksti dhe Komunikimi

Çdo anëtar ka dritaren e vet të kontekstit. Kur gjenerohen, anëtarët ngarkojnë të njëjtin kontekst projekti si një seancë e rregullt: CLAUDE.md, serverat MCP dhe aftësitë. Historia e bisedës së kryetarit nuk transferohet.

Si ndajnë informacion anëtarët:

• • Transmetimi automatik i mesazheve: Kur një anëtar dërgon një mesazh, ai transmetohet automatikisht te marrësi

• • Njoftimi i boshllekut: Kur një anëtar përfundon dhe ndalon, njoftohet automatikisht kryetari

• • Lista e përbashkët e detyrave: Të gjithë agjentët mund të shohin gjendjen e detyrave dhe të marrin punë të disponueshme

Përdorimi i Tokenëve

Ekipet e Agjentëve konsumojnë ndjeshëm më shumë tokenë sesa një seancë e vetme. Çdo anëtar ka dritaren e vet të kontekstit, dhe përdorimi i tokenëve rritet me numrin e anëtarëve aktivë. Për punë kërkimore, rishikimi dhe funksione të reja, tokenët shtesë zakonisht ia vlejnë. Për detyra të rregullta, një seancë e vetme është më kosto-efektive.

Shembuj të Rasteve të Përdorimit

Ekzekutimi i Rishikimeve Paralele të Kodit

Një rishikues i vetë tenton të fokusohet në një lloj problemi në një kohë. Ndarja e kritereve të rishikimit në fusha të pavarura do të thotë që siguria, performanca dhe mbulimi i testeve merren parasysh plotësisht njëkohësisht.

Create an agent team to review PR #142. Spawn three reviewers: one focused on security implications, one checking performance impact, one validating test coverage. Have them each review and report findings.
(Krijoni një Ekip Agjentësh për të rishikuar PR #142. Gjeneroni tre rishikues: një i fokusuar në implikimet e sigurisë, një që kontrollon ndikimin në performancën, një që vërteton mbulimin e testeve. Lërini secilin të rishikojë dhe raportojë zbulimet.)

Hulumtimi me Hipoteza Konkurruese

Kur shkaku rrënjësor nuk është i qartë, një agjent i vetë tenton të gjejë një shpjegim të dukësisë dhe të ndalet nga kërkimi i mëtejshëm.

Users report the app exits after one message instead of staying connected. Spawn 5 agent teammates to investigate different hypotheses. Have them talk to each other to try to disprove each other's theories, like a scientific debate. Update the findings doc with whatever consensus emerges.

Praktikat Më të Mira

Jepja e Kontekstit të Mjaftueshëm Anëtarëve

Anëtarët ngarkojnë automatikisht kontekstin e projektit, por nuk trashëgojnë historinë e bisedës së kryetarit. Përfshini detaje specifike të detyrës në udhëzimet e gjenerimit.

Përshtatja e Madhësisë së Detyrave siç duhet

• • Shumë e vogël: Overhead-i i koordinimit tejkalon përfitimet

• • Shumë e madhe: Anëtarët punojnë shumë kohë pa kontroll, duke rritur rrezikun e përpjekjeve të humbura

• • E përshtatshme: Njësi e vetme, që prodhon një produkt të qartë

Pritja që Anëtarët të Përfundojnë

Ndonjëherë kryetari fillon vetë të zbatojë detyrat, në vend që të presë që anëtarët të përfundojnë. Nëse vëreni këtë:

Wait for your teammates to complete their tasks before proceeding
(Prisni që anëtarët tuaj të përfundojnë detyrat e tyre përpara se të vazhdoni)

Shmangia e Konflikteve të Skedarëve

Dy anëtarë që redaktojnë të njëjtin skedar mund të çojnë në mbishkrim. Ndani punën në mënyrë që çdo anëtar të ketë një grup të ndryshëm skedarësh.

Monitorimi dhe Drejtimi

Kontrolloni progresin e anëtarëve, ridrejtoni metodat që nuk funksionojnë dhe sintetizoni zbulimet ndërsa përparoni.

Kufizimet

Ekipet e Agjentëve janë eksperimentale. Kufizimet aktuale:

• • Anëtarët brenda-procesit nuk mbështesin rikthimin e seancës: /resume dhe /rewind nuk do të rikthejnë anëtarët brenda-procesit

• • Gjendja e detyrave mund të vonohet: Anëtarët ndonjëherë nuk mund të shënojnë detyrat si të përfunduara

• • Mbyllja mund të jetë e ngadaltë: Anëtarët përfundojnë kërkesën aktuale përpara se të mbyllen

• • Një ekip për seancë: Një kryetar mund të menaxhojë vetëm një ekip në një kohë

• • Nuk mbështeten ekipet e mbivendosur: Anëtarët nuk mund të gjenerojnë ekipet e tyre

• • Kryetari i fiksuar: Seanca që krijon ekipin mbetet kryetar gjatë jetës së saj

• • Dritaret e ndara kërkojnë tmux ose iTerm2: Nuk mbështesin terminalin e integruar të VS Code, Windows Terminal ose Ghostty