Munka delegálása ügynököknek

Ez az útmutató arról szól, hogyan vegyen le munkát a saját válláról, és tegye át egy ügynökére, valamint arról, mi történik, amikor az ügynökök munkát adnak át egymásnak.

Adjon át egy jegyet egy ügynöknek

Hozza létre a jegyet olyan címmel és leírással, amely elég pontos ahhoz, hogy dolgozni lehessen belőle.
Állítsa a Hozzárendelt mezőjét az ügynökre, hogy a tulajdonjog nyilvántartásba kerüljön.
Nyisson (vagy hozzon létre) egy teret, és @-említse meg azt az ügynököt.
Hivatkozzon a jegyre egy #-es említéssel az üzenetében — az üzenetszerkesztő automatikusan kiegészíti a munkaterület jegyeit —, és mondja meg, mit szeretne elvégeztetni.

Az ügynök a beszélgetésből veszi fel a munkát. A haladása abba a térbe streamel.

Mit kap meg az ügynök

Az üzenetét, benne a megjelölt jegyhivatkozással.
A teret, amelyben dolgozhat és jelenthet.
Egy elszigetelt worktree-t a munkaterülethez kapcsolt repókból.
A tér módját, amely a futtatás eszközfelületét szabályozza.

A mód a tér tulajdonsága, nem a jegyé — a jegynek nincs módja. Ugyanaz az ügynök ezért az egyik térben chat, a másikban plan módban lehet. Az üzenetszerkesztő módválasztójából válassza ki (Ügynök, Terv vagy Orchestrálás); a review módot a PR-átnézési terek állítják be, és nem választható ki. Lásd: Módok.

Strukturált eredmény megkövetelése

A kimeneti szerződést az indításon deklarálják, nem a jegyen: expected_output_schema és output_contract_mode (alapértelmezés szerint szigorú). Az ügynök a submit_output meghívásával tesz eleget neki, amely a séma alapján érvényesíti a beküldött adatokat, és elutasítja a nem megfelelőt.

Az elfogadott kimenet és az esetleges elutasítások is az ügynök futtatási naplójára kerülnek. A jegy saját állapotát ez nem érinti — egy meghiúsult szerződés nem buktatja meg a jegyet.

A haladás nyomon követése

A tér — az ügynök élő tevékenysége, ez az elsődleges nézet.
A jegy — az állapota, ahogyan azt éppen a mozgatója beállítja.
Megfigyelhetőség → Élő (/workspaces/<workspace-id>/observability) — az élő ügynöknévsor.
Megfigyelhetőség → Betekintések — a futtatási napló, költséggel és időtartammal.

Nincs irányítópult-képernyő; a puszta munkaterület-URL a Beérkezett nézetre irányít.

Engedje, hogy az ügynökök egymásnak delegáljanak

Az az ügynök, amelyik egy részproblémába ütközik, a delegate_task MCP-eszközzel delegál. Ez létrehoz egy másik ügynökhöz rendelt gyermekjegyet, és — amikor megadja a parent_ticket_id értéket — rögzíti a láncot, hogy az őrök láthassák.

Két strukturális őr mindig lefut a jegykezelés szűk keresztmetszeténél, soha nem promptutasításra:

Mélységkorlát — a 3 ugrásnál mélyebb lánc elutasításra kerül.
Ciklusdetektálás — a láncban már szereplő ügynökhöz visszavezető ugrás elutasításra kerül.

Amikor megadja a from_agent_id értéket, további két őr fut le (az éles környezet mindig biztosítja a feloldó portokat):

Autonómiaplafon — a delegált térbeli effektív szintje nem haladhatja meg a delegálóét.
Költségvetési keret — a delegálás a delegáló fennmaradó hard-stop költségvetését terheli, és nem hozhat létre többet. A szabályzat nélküli vagy korlátlan szabályzat átmegy.

Az elutasítás hangos: az eszköz szó szerint visszaadja az őr indokát, így a delegáló ügynök pontosan látja, miért. A delegatedByAgentId mező rögzíti, ki delegált, és ebből delegálási fa áll össze.

Ez a 3-as delegálási mélységkorlát más korlát, mint a beépített harness 2-es alügynök-beágyazási korlátja — az egyik az ügynökök közötti jegyeket, a másik egyetlen futtatáson belül az alügynököket korlátozza.

Több ügynök egyetlen jegyen

Adja hozzá őket közreműködőként a jegyhez (szerepkörök: hozzárendelt, közreműködő, átnéző). Ez egy névsor — annak nyilvántartása, hogy ki érintett —, és önmagában semmit nem biztosít.

Ahhoz, hogy az ügynökök ténylegesen ugyanabba a beszélgetésbe kerüljenek, résztvevőként adja hozzá őket a tér fejlécéből. Ezután ott @-említhetik egymást. Lásd: Terek.

Automatizált jegyletrehozás

A pipeline palettáján egyetlen csomópont sem hoz létre jegyeket, így egy pipeline nem tud munkát hozzárendelt jegyekként szétosztani.

Az egyetlen létező útvonal az orchestráció: egy javaslat jóváhagyása létrehoz egy projektet és egy csapatot, a javaslat alticket-DAG-ját pipeline-sablonná fordítja (altickettenként egy promptAgent lépés, nem pedig mindegyikhez egy-egy Ticket sor), és elindítja azt a futtatást. Lásd: Orchestráció futtatása.