Plugin pro sub-agenty

Přibalený plugin subagent umožňuje Elowenu předat práci podřízeným konverzacím nebo spustit několik dílčích úkolů jako workflow. Jak delegování používat a jak sledovat výsledky popisuje článek Sub-agents & Workflows.

Stránka Agenti

V webovém rozhraní otevřete Agenti a procházejte vestavěné a vlastní typy agentů. Administrátoři mohou vlastní typy přidávat, upravovat a mazat. Každý typ má název v kebab-case s malými písmeny, jednořádkový popis, podle kterého se Elowen rozhoduje, kdy jej použít, instrukce a režim přístupu k nástrojům: jen pro čtení, všechny nástroje, zděděné nástroje nebo vlastní seznam oddělený čárkami. Vestavěné typy upravovat nelze. Katalog smí číst každý přihlášený účet, ale měnit jej mohou jen administrátoři. Instrukce vlastního typu se vracejí jen administrátorům; ostatní účty vidí jeho název, popis a nástroje. Popis může mít až 4 096 znaků a instrukce až 65 536 znaků.

Na stejné stránce zvolíte model pro každý vestavěný typ pro své vlastní delegace. Volba Žádný neurčuje žádný model, takže sub-agent použije model konverzace, která mu práci předává. U vlastního typu prázdná volba zní Zdědí model volajícího, takže sub-agent běží na modelu delegující konverzace. Tyto volby modelů platí pro jednotlivé účty. Úprava typu agenta vyžádá restart démona, než nové konverzace použijí aktualizovaný katalog. Administrátor tak například může přidat typ code-reviewer s jednořádkovým popisem, instrukcemi pro revizi a seznamem nástrojů Read, Search, Bash.

Otevřete skupinu Model u vestavěného agenta a změňte jeho osobní volbu modelu. U vlastních definic otevřete Nastavení agenta a nastavte přístup k nástrojům i model dané definice. Obojí používá stejné řádky nastavení a stejný výběr modelu, včetně prázdné výchozí hodnoty a viditelně nedostupných uložených modelů. Každou skupinu lze sbalit a svůj stav si pamatuje zvlášť. Uložením si ponecháte ostatní připnutí. Pokud nastavení změnila jiná karta, můžete je načíst znovu nebo sloučit: sloučení ponechá vzdálené změny u připnutí, která jste neupravovali. Model vlastní definice platí pro každého, kdo tomuto typu předává práci, kdežto volba u vestavěného agenta platí jen pro aktuální účet.

Plugin nepřidává žádný slash příkaz. Příkaz /workflow je součástí jádra a popisuje jej článek Sub-agents & Workflows.

Panel agentů a historie sub-agentů

Boční panel konverzace ukazuje delegovanou práci, na kterou čeká. Sekce Workflow nese každé běžící workflow s počtem hotových a celkových uzlů; sekce Agenti nese sub-agenty, jejichž výsledky ještě nebyly vyzvednuty. Každý řádek označuje model, na kterém sub-agent běží, pojmenuje běh a uvede jeho uplynulý čas; druhý řádek přináší nejnovější stavovou poznámku sub-agenta vedle rychlosti generování a počtu tokenů. Najetím na název si přečtete zadání delegace a výběrem řádku otevřete konverzaci sub-agenta. Tlačítko na běžícím řádku zastaví daného sub-agenta i vše, co spustil. Sbalený panel ukazuje počet, jehož bublinková nápověda nese stejné řádky.

Historie konverzace nabízí větev Sub-agenti se stejnými běhy jako strom: každý řádek pojmenuje sub-agenta nebo uzel workflow a jeho stav, název sub-agenta otevře jeho konverzaci a Rozbalit a Sbalit větev složí. Řádek, jehož větev byla zkrácena, to uvede.

Nástroje pro delegování a workflow

Chcete-li čekat na výsledky, zadejte u Delegate nebo WorkflowStart parametr background: false. Jinak práce běží asynchronně: výsledek dorazí sám před dalším krokem Elowenu, pokud stále pracuje, nebo zahájí nové kolo, pokud už skončil. Běžící nástroj se dokončí dřív, než se výsledek přidá; výsledky nástroje nepřerušují. Elowen může dál dělat nezávislou práci, aniž by čekal nebo se dotazoval. Workflow doručí jeden souhrn celého workflow, nikoli zvláštní zprávu pro každý uzel. Pokyn běžícímu sub-agentovi usměrní jeho současnou práci; nezaloží samostatnou odpověď. Nedotazujte se na práci, která výsledek doručí sama; jednorázovou kontrolu postupu udělá DelegateStatus a zmeškané doručení vyzvedne DelegateResult. Obnovený sub-agent pokračuje ve svém stávajícím kontextu. DelegateContinue přijímá také model pro pokračování a write_access: true povýší sub-agenta jen pro čtení, kterého jste spustili, na plný režim zápisu s oprávněními, která máte nyní; to je odmítnuto, dokud sub-agent pracuje na kole, nebo pokud byl jen pro čtení kvůli typu či plánovacímu režimu.

Velké výsledky sub-agentů a souhrny workflow mají stejný velikostní limit jako ostatní výstup nástrojů. Nad ním dostane Elowen krátký náhled s původním počtem bajtů a cestou k souboru místo celé odpovědi. Na tuto cestu může použít Read a vyzvednout úplný výstup. Pokud se uložení úplného výsledku nezdaří, doručení ohlásí výslovnou chybu s návodem na DelegateRead, místo aby odpověď tiše zkrátilo.

Co nový sub-agent dostane

Nový sub-agent dostane zadaný úkol, svou roli, platné instrukce účtu a projektu a sdílené technické zásady. Výsledky a chybějící rozhodnutí hlásí rodičovské konverzaci. Podklady, které potřebuje, dejte do zadání; nový sub-agent nedostane vybavené vzpomínky ani konverzaci rodiče. Fork si místo toho ponechá prompt, nástroje a historii rodiče.

Vestavěný recenzent hlásí jen konkrétní vady dosažitelné skutečnými volajícími, vstupy nebo sledy událostí. Může vrátit i nula zjištění. Dědí nástroje, aby mohl spustit povolené kontroly, a jeho instrukce mu ukládají repozitář neměnit.

Omezte přístup sub-agenta

Sub-agent nemůže dostat víc přístupu než volající. Jeho nástroje můžete zúžit pomocí read_only, tools nebo subagent_type a zvolit nakonfigurovaný model či thinkingLevel. read_only odebere nástroje pro zápis a úpravy a omezí příkazy shellu, přesměrování v shellu však stále může zapsat soubory, takže to není bezpečnostní sandbox.

Vestavěné typy explore a plan jsou jen pro čtení: explore hlásí, co našel, a plan vrací jako odpověď navržený plán implementace, který volající zapíše do svého plánovacího souboru. review dědí nástroje volajícího, ale repozitář nemění; hlásí zjištění, aniž by cokoli upravil. Shell jen pro čtení je zábradlí, nikoli bezpečnostní sandbox: přesměrování může stále zapsat soubory. Volající může svému sub-agentovi jen pro čtení rozšířit přístup pomocí DelegateContinue, a to v mezích svých aktuálních oprávnění. Sub-agent také dědí model, úroveň uvažování a pracovní adresář volajícího, pokud delegace neurčí jinak.

Absolutním cwd spustíte sub-agenta nebo uzel workflow ve zvoleném adresáři. Administrátor s přístupem k hostiteli může zvolit jakýkoli existující čitelný adresář hostitele, včetně jiného registrovaného projektu nebo propojeného Git worktree. Volající s vymezeným rozsahem zůstávají ve svém zvoleném projektu a spravovaní sub-agenti ve svém vlastním kontejneru. Zvolený adresář přežije pokračování i restart; nedostupný adresář je odmítnut. Propojený worktree používá vlastní instrukce projektu. Volbou adresáře se strop oprávnění volajícího nemění.

S fork: true sub-agent zdědí prompt, nástroje a historii aktuální konverzace. Úkol se stane pokynem, nikoli samostatným zadáním. Fork nelze zkombinovat s tools, read_only, subagent_type ani s žádným pracovním adresářem (cwd); zachová přesně sadu nástrojů volajícího. Jiný model nebo thinkingLevel je povolen, ale vzdá se sdílené mezipaměti promptu, která dělá fork levným, proto dejte přednost modelu volajícího. Forky jsou dostupné jen z konverzace vlastníka. Administrátor může nastavit fork jako výchozí pro každou delegaci pomocí Sdílet kontext konverzace v Limity a opětovné připojování v nastavení asistenta; výslovný fork ve volání stále rozhoduje.

Typová role jako explore nebo vlastní typ volí uložený prompt a režim nástrojů. Můžete také předat přesný seznam tools z nástrojů volajícího. Prázdný seznam je odmítnut. DelegateModels ukazuje platné volby provider/model a podporované úrovně uvažování. model u Delegate nebo uzlu workflow se nejprve shoduje s úplným provider/model, takže model z relaye, jehož vlastní id vypadá jako meta/<model>, nikdy nezastíní poskytovatele meta; samotné id modelu se vyřeší jen tehdy, když jej nabízí právě jeden poskytovatel, a při více nabídkách je odmítnuto s kvalifikovanými volbami. Chcete-li čekat místo pozdějšího doručení výsledku, použijte background: false; sub-agent, který nemá konverzaci, do níž by výsledek doručil, čeká standardně.

Spusťte workflow

Než zavoláte WorkflowStart, napište soubor JSON a předejte jeho cestu. Workflow je buď pole uzlů, nebo objekt s polem nodes a volitelnými title, fork a background. Každý uzel potřebuje jedinečné id a soběstačný task; volitelné závislosti určují, které výsledky dostane. Nezávislé uzly mohou běžet souběžně.

Uzel dostane krátké předání od každé přímé závislosti, nikoli plný kontext všech předchozích uzlů. Uzel by měl končit sekcí ## Handover; bez ní workflow předá konec jeho výsledku. Každé předání je omezeno na 4 000 znaků. Vše, co pozdější úkol potřebuje, dejte do řetězce závislostí. Následníci selhaného uzlu zůstanou nevyřízení a nespustí se. Workflow může mít až 128 uzlů; každý úkol je omezen na 16 000 znaků a delší úkol je odmítnut, nikoli zkrácen, a každé id na 64 znaků. Současně může běžet až 16 workflow. Uzel může nastavit také vlastní model, thinkingLevel, tools, read_only, subagent_type, fork a absolutní cwd. Výslovně prázdný seznam tools je odmítnut a fork nelze zkombinovat s užším režimem nástrojů ani s jiným pracovním adresářem.

Workflow může například jednomu uzlu zadat prozkoumání chyby a druhý uzel nechat počkat na jeho zjištění, než napíše test. Druhému uzlu dejte id toho prvního do deps; dostane předání daného uzlu, nikoli celou konverzaci.

Workflow obnovené po restartu předá svůj souhrn stejně jako živé workflow na pozadí. Běh se počítá za předaný až tehdy, když server uložený výsledek přijme, takže běh, jehož původní konverzaci nelze ověřit nebo jehož výsledek server odmítne, se hlásí jako problém s doručením, nikoli jako doručený. Výsledek je doručen, když je zapsán v rodičovské konverzaci, nikoli když byl jen zařazen do fronty.

Pokud uzel selže, jeho chyba zůstane v souhrnu workflow a jeho následníci se nespustí. Pokud workflow nedokáže připravit úplný výsledek závislosti nebo doručit svůj souhrn, ohlásí problém s doručením zvlášť. Ten vyřešte a pak použijte WorkflowResume; hotová práce uzlů zůstane zachována.

Workflow otevřete z bočního panelu konverzace a uvidíte jeho inspektor. Uzly se zobrazí jako graf ve vlnách. Vyberte uzel a uvidíte jeho stav, uzly, na kterých závisí, jeho postup a jeho výsledek nebo chybu, a můžete otevřít jeho konverzaci. Zastavit workflow po potvrzení zastaví workflow i jeho běžící uzly.

Nastavení a limity

V Nastavení → Pluginy otevřete přibalený plugin subagent a nastavte:

Uchování řídí, jak dlouho zůstávají dokončené výsledky na pozadí dostupné; výchozí hodina platí pro workflow i delegace na pozadí. Časový limit nečinnosti přeruší sub-agenta bez činnosti nástroje nebo kroku; pokračujte s ním pomocí DelegateContinue. Je to pojistka pro zaseknutou práci, proto jej u dlouhé analýzy, která se na čas zastaví bez použití nástrojů, zvyšte. Uložení těchto nastavení nebo zapnutí či vypnutí pluginu vyžádá restart Elowenu. Obrazovka nastavení oznámí, že změna je uložená a Elowen se restartuje. Nové hodnoty platí po restartu.

Plugin může mít až 64 rozpracovaných delegací na popředí nebo na pozadí; když je plno, nový sub-agent je odmítnut, dokud některý neskončí. Když jsou všichni spouštěči sub-agentů vytížení, delegace na pozadí čeká ve frontě a hlásí se jako ve frontě. Zastavení delegace ve frontě ji z fronty odebere. Dokončený sub-agent může po restartu démona pokračovat, ale živý postup už k dispozici není. Workflow může přidávat uzly jen za běhu; obnovení zkouší jen nedokončené uzly a hotové ponechá. Instance může mít až 16 běžících workflow. Pokud restart démona workflow přeruší, Elowen je obnoví z uloženého žurnálu: hotové uzly zůstanou hotové a nedokončené se zkusí znovu, v mezích aktuálních kontrol přístupu. Pokud obnovení nedokáže ověřit přístup nebo je žurnál nedostupný, neplatný nebo v nepodporovaném formátu, ohlásí, že workflow nešlo obnovit. Ostatní workflow se obnovit mohou. Výsledek workflow zůstává dostupný, dokud je uchováván. Uložená chyba sub-agenta se ořízne na 100 000 znaků od začátku; dlouhý úspěšný výsledek zůstává vyzvednutelný pomocí DelegateRead, který vrací nejvýše 50 000 znaků na volání, standardně 8 000.

Oprávnění

Zapnutí pluginu vyžádá souhlas s jeho schopností workflow-dag. Pokud souhlas odmítnete, plugin zůstane nainstalovaný, ale vypnutý. Každý účet si může zvolit vlastní model pro vestavěného agenta; volba se ukládá v nastavení daného účtu a nepotřebuje administrátora. Jen administrátoři mohou vytvářet, upravovat a mazat vlastní agenty a stránku Agenti může zobrazit každý účet. Běžná oprávnění účtu k nástrojům a omezení modelů stále platí. Uzly workflow dědí přístup volajícího, který je přidal, a nemohou jej rozšířit.

Další: Web Search & Fetch