Plugin pre sub-agentov

Pribalený plugin subagent umožňuje Elowenu odovzdať prácu podriadeným konverzáciám alebo spustiť niekoľko čiastkových úloh ako workflow. Ako delegovanie používať a ako sledovať výsledky opisuje článok Sub-agents & Workflows.

Stránka Agenti

V webovom rozhraní otvorte Agenti a prechádzajte vstavané a vlastné typy agentov. Administrátori môžu vlastné typy pridávať, upravovať a mazať. Každý typ má názov v kebab-case s malými písmenami, jednoriadkový popis, podľa ktorého sa Elowen rozhoduje, kedy ho použiť, inštrukcie a režim prístupu k nástrojom: len na čítanie, všetky nástroje, zdedené nástroje alebo vlastný zoznam oddelený čiarkami. Vstavané typy upravovať nemožno. Katalóg smie čítať každý prihlásený účet, ale meniť ho môžu iba administrátori. Inštrukcie vlastného typu sa vracajú iba administrátorom; ostatné účty vidia jeho názov, popis a nástroje. Popis môže mať až 4 096 znakov a inštrukcie až 65 536 znakov.

Na tej istej stránke zvolíte model pre každý vstavaný typ pre svoje vlastné delegácie. Voľba Žiadny neurčuje žiadny model, takže sub-agent použije model konverzácie, ktorá mu prácu odovzdáva. Pri vlastnom type prázdna voľba znie Zdedí model volajúceho, takže sub-agent beží na modeli delegujúcej konverzácie. Tieto voľby modelov platia pre jednotlivé účty. Úprava typu agenta vyžiada reštart démona, kým nové konverzácie použijú aktualizovaný katalóg. Administrátor tak napríklad môže pridať typ code-reviewer s jednoriadkovým popisom, inštrukciami na revíziu a zoznamom nástrojov Read, Search, Bash.

Otvorte skupinu Model pri vstavanom agentovi a zmeňte jeho osobnú voľbu modelu. Pri vlastných definíciách otvorte Nastavenia agenta a nastavte prístup k nástrojom aj model danej definície. Oboje používa rovnaké riadky nastavení a rovnaký výber modelu vrátane prázdnej predvolenej hodnoty a viditeľne nedostupných uložených modelov. Každú skupinu možno zbaliť a svoj stav si pamätá osobitne. Uložením si ponecháte ostatné pripnutia. Ak nastavenia zmenila iná karta, môžete ich načítať znova alebo zlúčiť: zlúčenie ponechá vzdialené zmeny pri pripnutiach, ktoré ste neupravovali. Model vlastnej definície platí pre každého, kto tomuto typu odovzdáva prácu, kým voľba pri vstavanom agentovi platí iba pre aktuálny účet.

Plugin nepridáva žiadny slash príkaz. Príkaz /workflow je súčasťou jadra a opisuje ho článok Sub-agents & Workflows.

Panel agentov a história sub-agentov

Bočný panel konverzácie ukazuje delegovanú prácu, na ktorú čaká. Sekcia Workflow nesie každé bežiace workflow s počtom hotových a celkových uzlov; sekcia Agenti nesie sub-agentov, ktorých výsledky ešte neboli vyzdvihnuté. Každý riadok označuje model, na ktorom sub-agent beží, pomenuje beh a uvedie jeho uplynulý čas; druhý riadok prináša najnovšiu stavovú poznámku sub-agenta vedľa rýchlosti generovania a počtu tokenov. Prejdením na názov si prečítate zadanie delegácie a výberom riadku otvoríte konverzáciu sub-agenta. Tlačidlo na bežiacom riadku zastaví daného sub-agenta aj všetko, čo spustil. Zbalený panel ukazuje počet, ktorého bublinová nápoveda nesie rovnaké riadky.

História konverzácie ponúka vetvu Sub-agenti s rovnakými behmi ako strom: každý riadok pomenuje sub-agenta alebo uzol workflow a jeho stav, názov sub-agenta otvorí jeho konverzáciu a Rozbaliť a Zbaliť vetvu zloží. Riadok, ktorého vetva bola skrátená, to uvedie.

Nástroje na delegovanie a workflow

Ak chcete čakať na výsledky, zadajte pri Delegate alebo WorkflowStart parameter background: false. Inak práca beží asynchrónne: výsledok dorazí sám pred ďalším krokom Elowenu, ak stále pracuje, alebo spustí nové kolo, ak už skončil. Bežiaci nástroj sa dokončí skôr, než sa výsledok pridá; výsledky nástroje neprerušujú. Elowen môže ďalej robiť nezávislú prácu bez čakania alebo dotazovania. Workflow doručí jeden súhrn celého workflow, nie osobitnú správu pre každý uzol. Pokyn bežiacemu sub-agentovi usmerní jeho súčasnú prácu; nezaloží samostatnú odpoveď. Nedotazujte sa na prácu, ktorá výsledok doručí sama; jednorazovú kontrolu postupu urobí DelegateStatus a zmeškané doručenie vyzdvihne DelegateResult. Obnovený sub-agent pokračuje vo svojom existujúcom kontexte. DelegateContinue prijíma aj model pre pokračovanie a write_access: true povýši sub-agenta len na čítanie, ktorého ste spustili, na plný režim zápisu s oprávneniami, ktoré máte teraz; to je odmietnuté, kým sub-agent pracuje na kole, alebo ak bol len na čítanie kvôli typu či plánovaciemu režimu.

Veľké výsledky sub-agentov a súhrny workflow majú rovnaký veľkostný limit ako ostatný výstup nástrojov. Nad ním dostane Elowen krátky náhľad s pôvodným počtom bajtov a cestou k súboru namiesto celej odpovede. Na túto cestu môže použiť Read a vyzdvihnúť úplný výstup. Ak sa uloženie úplného výsledku nepodarí, doručenie ohlási výslovnú chybu s návodom na DelegateRead namiesto tichého skrátenia odpovede.

Čo nový sub-agent dostane

Nový sub-agent dostane zadanú úlohu, svoju rolu, platné inštrukcie účtu a projektu a zdieľané technické zásady. Výsledky a chýbajúce rozhodnutia hlási rodičovskej konverzácii. Podklady, ktoré potrebuje, dajte do zadania; nový sub-agent nedostane vybavené spomienky ani konverzáciu rodiča. Fork si namiesto toho ponechá prompt, nástroje a históriu rodiča.

Vstavaný recenzent hlási iba konkrétne chyby dosiahnuteľné skutočnými volajúcimi, vstupmi alebo sledmi udalostí. Môže vrátiť aj nula zistení. Dedičí nástroje, aby mohol spustiť povolené kontroly, a jeho inštrukcie mu ukladajú repozitár nemeniť.

Obmedzte prístup sub-agenta

Sub-agent nemôže dostať viac prístupu než volajúci. Jeho nástroje môžete zúžiť pomocou read_only, tools alebo subagent_type a zvoliť nakonfigurovaný model či thinkingLevel. read_only odoberie nástroje na zápis a úpravy a obmedzí príkazy shellu, presmerovanie v shelli však stále môže zapísať súbory, takže to nie je bezpečnostný sandbox.

Vstavané typy explore a plan sú len na čítanie: explore hlási, čo našiel, a plan vracia ako odpoveď navrhnutý plán implementácie, ktorý volajúci zapíše do svojho plánovacieho súboru. review dedí nástroje volajúceho, ale repozitár nemení; hlási zistenia bez toho, aby čokoľvek upravil. Shell len na čítanie je zábradlie, nie bezpečnostný sandbox: presmerovanie môže stále zapísať súbory. Volajúci môže svojmu sub-agentovi len na čítanie rozšíriť prístup pomocou DelegateContinue, a to v medziach svojich aktuálnych oprávnení. Sub-agent tiež dedí model, úroveň uvažovania a pracovný adresár volajúceho, ak delegácia neurčí inak.

Absolútnym cwd spustíte sub-agenta alebo uzol workflow vo zvolenom adresári. Administrátor s prístupom k hostiteľovi môže zvoliť ktorýkoľvek existujúci čitateľný adresár hostiteľa vrátane iného registrovaného projektu alebo prepojeného Git worktree. Volajúci s vymedzeným rozsahom zostávajú vo svojom zvolenom projekte a spravovaní sub-agenti vo svojom vlastnom kontajneri. Zvolený adresár prežije pokračovanie aj reštart; nedostupný adresár je odmietnutý. Prepojený worktree používa vlastné inštrukcie projektu. Voľbou adresára sa strop oprávnení volajúceho nemení.

S fork: true sub-agent zdedí prompt, nástroje a históriu aktuálnej konverzácie. Úloha sa stane pokynom, nie samostatným zadaním. Fork nemožno skombinovať s tools, read_only, subagent_type ani so žiadnym pracovným adresárom (cwd); zachová presne súpravu nástrojov volajúceho. Iný model alebo thinkingLevel je povolený, ale vzdá sa zdieľanej vyrovnávacej pamäte promptu, ktorá robí fork lacným, preto dajte prednosť modelu volajúceho. Forky sú dostupné iba z konverzácie vlastníka. Administrátor môže nastaviť fork ako predvolený pre každú delegáciu pomocou Zdieľať kontext konverzácie v Limity a opätovné pripájanie v nastaveniach asistenta; výslovný fork vo volaní stále rozhoduje.

Typová rola ako explore alebo vlastný typ volí uložený prompt a režim nástrojov. Môžete tiež odovzdať presný zoznam tools z nástrojov volajúceho. Prázdny zoznam je odmietnutý. DelegateModels ukazuje platné voľby provider/model a podporované úrovne uvažovania. model pri Delegate alebo uzle workflow sa najprv zhoduje s úplným provider/model, takže model z relayu, ktorého vlastné id vyzerá ako meta/<model>, nikdy nezastrie poskytovateľa meta; samotné id modelu sa vyrieši len vtedy, keď ho ponúka práve jeden poskytovateľ, a pri viacerých ponukách je odmietnuté s kvalifikovanými voľbami. Ak chcete čakať namiesto neskoršieho doručenia výsledku, použite background: false; sub-agent, ktorý nemá konverzáciu, do ktorej by výsledok doručil, čaká predvolene.

Spustite workflow

Skôr než zavoláte WorkflowStart, napíšte súbor JSON a odovzdajte jeho cestu. Workflow je buď pole uzlov, alebo objekt s poľom nodes a voliteľnými title, fork a background. Každý uzol potrebuje jedinečné id a sebestačnú task; voliteľné závislosti určujú, ktoré výsledky dostane. Nezávislé uzly môžu bežať paralelne.

Uzol dostane krátke odovzdanie od každej priamej závislosti, nie plný kontext všetkých predchádzajúcich uzlov. Uzol by mal končiť sekciou ## Handover; bez nej workflow odovzdá koniec jeho výsledku. Každé odovzdanie je obmedzené na 4 000 znakov. Všetko, čo neskoršia úloha potrebuje, dajte do reťazca závislostí. Nasledovníci zlyhaného uzla zostanú nevybavení a nespustia sa. Workflow môže mať až 128 uzlov; každá úloha je obmedzená na 16 000 znakov a dlhšia úloha je odmietnutá, nie skrátená, a každé id na 64 znakov. Súčasne môže bežať až 16 workflow. Uzol môže nastaviť aj vlastný model, thinkingLevel, tools, read_only, subagent_type, fork a absolútny cwd. Výslovne prázdny zoznam tools je odmietnutý a fork nemožno skombinovať s užším režimom nástrojov ani s iným pracovným adresárom.

Workflow môže napríklad jednému uzlu zadať preskúmanie chyby a druhý uzol nechať počkať na jeho zistenia, kým napíše test. Druhému uzlu dajte id toho prvého do deps; dostane odovzdanie daného uzla, nie celú konverzáciu.

Workflow obnovené po reštarte odovzdá svoj súhrn rovnako ako živé workflow na pozadí. Beh sa počíta za odovzdaný až vtedy, keď server uložený výsledok prijme, takže beh, ktorého pôvodnú konverzáciu nemožno overiť alebo ktorého výsledok server odmietne, sa hlási ako problém s doručením, nie ako doručený. Výsledok je doručený, keď je zapísaný v rodičovskej konverzácii, nie keď bol iba zaradený do frontu.

Ak uzol zlyhá, jeho chyba zostane v súhrne workflow a jeho nasledovníci sa nespustia. Ak workflow nedokáže pripraviť úplný výsledok závislosti alebo doručiť svoj súhrn, ohlási problém s doručením osobitne. Ten vyriešte a potom použite WorkflowResume; hotová práca uzlov zostane zachovaná.

Workflow otvoríte z bočného panela konverzácie a uvidíte jeho inšpektora. Uzly sa zobrazia ako graf vo vlnách. Vyberte uzol a uvidíte jeho stav, uzly, na ktorých závisí, jeho postup a jeho výsledok alebo chybu, a môžete otvoriť jeho konverzáciu. Zastaviť workflow po potvrdení zastaví workflow aj jeho bežiace uzly.

Nastavenia a limity

V Nastavenia → Pluginy otvorte pribalený plugin subagent a nastavte:

Uchovanie riadi, ako dlho zostávajú dokončené výsledky na pozadí dostupné; predvolená hodina platí pre workflow aj delegácie na pozadí. Časový limit nečinnosti preruší sub-agenta bez činnosti nástroja alebo kroku; pokračujte s ním pomocou DelegateContinue. Je to poistka pre zaseknutú prácu, preto ho pri dlhej analýze, ktorá sa na čas zastaví bez použitia nástrojov, zvýšte. Uloženie týchto nastavení alebo zapnutie či vypnutie pluginu vyžiada reštart Elowenu. Obrazovka nastavení oznámi, že zmena je uložená a Elowen sa reštartuje. Nové hodnoty platia po reštarte.

Plugin môže mať až 64 rozpracovaných delegácií na popredí alebo na pozadí; keď je plno, nový sub-agent je odmietnutý, kým niektorý neskončí. Keď sú všetci spúšťači sub-agentov vyťažení, delegácia na pozadí čaká vo fronte a hlási sa ako vo fronte. Zastavenie delegácie vo fronte ju z frontu odoberie. Dokončený sub-agent môže po reštarte démona pokračovať, ale živý postup už k dispozícii nie je. Workflow môže pridávať uzly iba za behu; obnovenie skúša iba nedokončené uzly a hotové ponechá. Inštancia môže mať až 16 bežiacich workflow. Ak reštart démona workflow preruší, Elowen ho obnoví z uloženého žurnálu: hotové uzly zostanú hotové a nedokončené sa skúsia znova, v medziach aktuálnych kontrol prístupu. Ak obnovenie nedokáže overiť prístup alebo je žurnál nedostupný, neplatný alebo v nepodporovanom formáte, ohlási, že workflow nešlo obnoviť. Ostatné workflow sa obnoviť môžu. Výsledok workflow zostáva dostupný, kým je uchovávaný. Uložená chyba sub-agenta sa oreže na 100 000 znakov od začiatku; dlhý úspešný výsledok zostáva vyzdvihnuteľný pomocou DelegateRead, ktorý vracia najviac 50 000 znakov na volanie, predvolene 8 000.

Oprávnenia

Zapnutie pluginu vyžiada súhlas s jeho schopnosťou workflow-dag. Ak súhlas odmietnete, plugin zostane nainštalovaný, ale vypnutý. Každý účet si môže zvoliť vlastný model pre vstavaného agenta; voľba sa ukladá v nastaveniach daného účtu a nepotrebuje administrátora. Iba administrátori môžu vytvárať, upravovať a mazať vlastných agentov a stránku Agenti môže zobraziť každý účet. Bežné oprávnenia účtu k nástrojom a obmedzenia modelov stále platia. Uzly workflow dedia prístup volajúceho, ktorý ich pridal, a nemôžu ho rozšíriť.

Ďalej: Web Search & Fetch