Sub-agenti a workflow
Elowen vie odovzdať zameranú úlohu sub-agentovi alebo rozdeliť nadväzujúcu prácu na workflow. Sub-agenta použite na nezávislé skúmanie alebo stručný výsledok. Workflow použite, keď kroky závisia jeden od druhého.
Odovzdajte jednu úlohu
Vo webovom chate úlohu opíšte a požiadajte Elowen, aby ju odovzdala. Sub-agent začína s vlastnou konverzáciou, preto uveďte celé zadanie aj všetok kontext, ktorý potrebuje. Výsledok vráti konverzácii, ktorá ho spustila. Odovzdanie štandardne beží na pozadí a Elowen Vám výsledok prinesie, keď skončí. Blokujúci beh použite iba vtedy, keď bez odpovede nemôžete pokračovať.
Nezávislé úlohy možno odovzdať spoločne a bežia paralelne. Podriadený agent štandardne používa model a prístup volajúceho; môžete zvoliť iný dostupný model alebo obmedziť jeho nástroje. Podriadený agent nemôže získať prístup k Projektom, nástrojom ani oprávneniam, ktoré volajúci nemá. Odovzdanie iba na čítanie odoberie nástroje na zápis a obmedzí príkazy shellu, ale nie je to sandbox súborového systému. Vstavané typy explore a plan pracujú iba na čítanie; plan vráti navrhnutý plán ako odpoveď, namiesto toho, aby zapísal súbor. review preberá nástroje volajúceho, ale nemení repozitár. Pred použitím vlastného typu skontrolujte jeho vlastné obmedzenia.
Bežný podriadený agent začína novú konverzáciu a prepis rodičovskej konverzácie nevidí. Fork použite iba vtedy, keď podriadený agent tento celý kontext potrebuje. Fork zdieľa prompt a nástroje rodiča a vyrovnávaciu pamäť poskytovateľa zdieľa iba vtedy, keď beží na rovnakom poskytovateľovi a modeli. Administrátor môže nastaviť fork ako predvolený pre odovzdanie, ktoré fork neuvedie, voľbou Zdieľať kontext konverzácie v Nastavenia → <assistant name> AI → Limity a opätovné pripájanie → Upraviť limity. Odovzdanie, ktoré fork uvádza výslovne, to neovplyvní.
CLI zobrazuje bežiacich podriadených agentov a ich aktivitu. Klávesom Ctrl+O prejdete na podriadeného agenta a klávesom Esc sa vrátite k rodičovi. Zobrazenie podriadeného agenta v CLI aj vo webe drží pole pre správu na obvyklom mieste a v rovnakej veľkosti, zamknuté s upozornením iba na čítanie. Zoznam úloh a agenti zostávajú viditeľní nad ním; úlohy podriadeného agenta slúžia iba na prezeranie. Pokračovanie posielajte v rodičovskej konverzácii a požiadajte Elowen, aby podriadeného agenta viedla ďalej. Rozpísaná správa a správy vo fronte rodiča zostávajú v zobrazení rodiča. Riadok bežiaceho podriadeného agenta v paneli agentov ukazuje uplynutý čas, rýchlosť generovania a poslednú stavovú poznámku. Zastavíte ho voľbou Zastaviť sub-agenta na jeho riadku vo webe alebo v CLI klávesmi Ctrl+X a k, čo zastaví agenta, ktorého prezeráte, alebo najnovšieho bežiaceho. Zastavenie nezabije príkaz v popredí, na ktorý podriadený agent stále čaká: v CLI ho zastaví Ctrl+X a s a opätovným stlačením v okne prerušenia príkaz ukončí. Klávesové skratky zmeníte v /keybinds. Klávesa Ctrl+B presunie prácu v popredí na pozadie, bez toho, aby ju zrušila.
Sledovanie úloh v konverzácii
Zoznam úloh drží konkrétne kroky jednej konverzácie na očiach; je to kontrolný zoznam, nie práca, ktorá beží sama. Poskytuje ho voliteľný plugin todo, ktorý nainštalujete v Nastavenia → Pluginy → Dostupné pluginy. Nie je súčasťou vstavaných pluginov. Je oddelený od naplánovaných úloh, ktoré bežia podľa časovača. Úlohy vytvárajte s krátkym predmetom a opisom a podľa vývoja práce ich prepínajte na čakajúce, prebiehajúce alebo dokončené. Môžete pridať závislosti, aby úloha zostala blokovaná, kým nie je jej predpoklad dokončený. Panel úloh ukazuje priebeh iba tejto konverzácie.
Nadväzujúcu prácu spustite ako workflow
Vo webovom chate otvorte v poli pre správu Možnosti a v časti Režim práce zvoľte Postup. V CLI použite /workflow. Tento režim vedie Elowen k orchestrácii, jednoduchú požiadavku však môže spracovať aj priamo. Nezávislé kroky môžu bežať paralelne; krok s predpokladmi na ne počká.
Vytvorte súbor JSON nástrojom Write a jeho cestu odovzdajte nástroju WorkflowStart ako file_path. V spravovanom Projekte súbor zapíšte do projektu, napríklad ako workflow.json, pretože cesta hostiteľa tam nie je viditeľná. Súbor obsahuje buď pole uzlov, alebo objekt s poľom nodes, a môže nastaviť aj title, fork a background. Každý uzol potrebuje jedinečné id a úplné task; pomocou deps vypíšte ID predpokladov. Aspoň jeden uzol nesmie mať žiadnu závislosť. Workflow môže mať až 128 uzlov, každý s úlohou do 16 000 znakov; neznáme závislosti, cykly a dlhšie úlohy sa odmietnu. Uzly môžu nastaviť aj model, úroveň uvažovania, zoznam povolených nástrojov, režim iba na čítanie, typ sub-agenta, pracovný adresár (cwd, absolútna cesta) alebo fork konverzácie, z ktorej workflow vzišlo — fork nemožno skombinovať s možnosťami zužujúcimi prístup. Pre nadväzujúce uzly napíšte časť ## Handover iba s poznatkami, ktoré potrebujú; Elowen odovzdá túto časť, nie celý výsledok.
[
{ "id": "inspect", "task": "Inspect the relevant files and report findings." },
{ "id": "change", "task": "Make the agreed change.", "deps": ["inspect"] }
]Každý uzol je nový sub-agent alebo fork konverzácie, z ktorej workflow vzišlo. Preberá pracovný adresár tejto konverzácie, ak jeho cwd neuvádza iný, takže workflow spustené z worktree beží tam. Nadväzujúci uzol dostane od každého priameho predpokladu odovzdávku do 4 000 znakov, nie všetky skoršie výsledky. Uzol, ktorý žiadnu odovzdávku nenapíše, odovzdá koniec svojho výsledku. Ak potrebuje skorší poznatok, uveďte aj ten uzol ako závislosť. WorkflowStart vráti ukazovateľ a zhrnutie doručí, keď workflow na pozadí skončí. Ak potrebujete celý výsledok skôr, než budete pokračovať, nastavte background: false. Výslovné argumenty title, fork alebo background pri WorkflowStart prebijú rovnaké kľúče v súbore.
Kontrola a pokračovanie práce
Nástrojom WorkflowStatus uvidíte stav uzlov, závislosti, uplynutý čas a priebeh. WorkflowAddNodes pridá nadväzujúce kroky do bežiaceho workflow. WorkflowResume zopakuje nedokončené uzly bez opätovného spúšťania dokončených. WorkflowStop bežiaci workflow zastaví; dokončené uzly si ponechajú výsledky. Uzol, ktorého závislosť zlyhala, zostane čakať a nespustí sa.
Výsledok dokončeného sub-agenta na pozadí Elowen doručí automaticky. Na bežiaci úkol použite DelegateStatus, dokončený výsledok prečítate nástrojom DelegateResult, dlhý výsledok prelistujete nástrojom DelegateRead, konverzáciu sub-agenta rozšírite nástrojom DelegateContinue a zastavíte ho nástrojom DelegateStop. Pokračovanie si drží prepis aj prístup tohto podriadeného agenta; nezačína nového. Ak sú všetky miesta pre sub-agentov obsadené, sub-agent na pozadí čaká vo fronte a zobrazuje sa ako vo fronte, kým sa miesto neuvoľní. Zastavením sa z fronty odoberie a už sa nespustí. Úlohu na pozadí opakovane neoverujte.
Správa procesov na pozadí
Dlho bežiace príkazy terminálu spustené na pozadí majú ukazovatele platné pre aktuálnu konverzáciu. Nástroj ListProcesses ich vypíše, ProcessOutput počká na výstup alebo ho prezrie a KillProcess proces okamžite zastaví. ProcessOutput štandardne čaká na proces; na rýchly náhľad použite block: false, na uchovanú vyrovnávaciu pamäť all: true. Výstup prichádza po častiach a uchováva sa v kruhovej vyrovnávacej pamäti. KillProcess proces okamžite zastaví a jeho uchovaný výstup zahodí, preto si ho najskôr prečítajte, ak ho potrebujete. Ukazovatele platia iba pre túto konverzáciu a účet; úlohy v popredí ani úlohy iných konverzácií sa nevypisujú. Plugin terminal štandardne povoľuje 16 súbežných procesov na pozadí. Limit nastavuje voľba maxBackgroundProcesses v jeho konfigurácii, od 1 do 64.
Inštalácia pluginu subagent
Sub-agentov a workflow poskytuje plugin subagent. V Nastavenia → Pluginy → Dostupné pluginy môže administrátor zvoliť Inštalovať. Skontrolujte jeho schopnosti a schváľte požadované oprávnenia. Pri vypnutom nainštalovanom plugine použite jeho prepínač v časti Pluginy.
Zapnutie, vypnutie alebo odobratie pluginu reštartuje Elowen. Bežiaca práca sa uloží a po reštarte pokračuje; iba práca, ktorá pokračovať nemôže, dostane obmedzený čas na dokončenie. Odobratý vstavaný plugin možno obnoviť v časti Dostupné pluginy. Elowen sa tiež po reštarte pokúša obnoviť odovzdanú prácu a zastaví ju alebo pozastaví, ak nemožno bezpečné obnovenie overiť.