Správa instance

Uživatelé a přístup

Administrátoři spravují účty, role, projekty, přístup k modelům, přidělení pluginů a přístup k nástrojům v části Uživatelé (/users). Každý účet má navíc vlastní pravidla oprávnění pro schvalování nástrojů a běhy bez dohledu.

Po vytvoření prvního účtu vyžadují chráněné API trasy bearer token. Webové rozhraní místo toho používá httpOnly session cookie; JavaScript v prohlížeči jeho token přečíst nemůže.

Veřejné vstupní body zahrnují kontroly stavu a prvního nastavení, přihlašovací trasy, trasy Microsoft SSO, podklady motivu a vzhledu, veřejný klíč Web Push, podepsané adresy avatarů, trasy párování a registrace CLI a webhooky pluginů, které se ověřují u svého poskytovatele. Dokud žádný uživatel neexistuje, režim nastavení dovolí průvodci vytvořit prvního administrátora. Ověřování se vynucuje od chvíle, kdy tento účet existuje.

Úplně první administrátor — vytvořený prvním nastavením nebo bezobslužnou cestou ELOWEN_BOOTSTRAP_USER/ELOWEN_BOOTSTRAP_PASS — začíná se všemi základními nástroji, všemi nástroji zapnutého pluginu, rodinou mcp__* pro nástroje MCP, všemi pluginy, které lze přidělovat, a s volbou Všechny modely, protože zatím neexistuje jiný administrátor, který by je mohl otevřít v části Uživatelé. Každý další lidský účet, včetně administrátorů, dostane předvolbu zvolenou v Uživatelé → Možnosti → Výchozí nastavení uživatelů → Předvolba pro nové účty. Bez zvolené předvolby začíná bez přístupu k modelům, nástrojům i pluginům vyžadujícím přidělení. Úpravy předvolby aktualizují i účty, které k ní už jsou připojené.

Přihlašovací tokeny platí ve výchozím stavu 30 dní. Administrátor může platnost změnit v Nastavení → Systém. CLI ukládá údaje spárované z prohlížeče podle původu do ~/.config/elowen/cli-instances.json; ELOWEN_TOKEN přebíjí zvolený token. Nastavte ELOWEN_URL na veřejnou adresu instance nebo její základ /api, nebo nastavte jen ELOWEN_DAEMON_URL pro přímý přístup k démonovi. Starší cli.json se po ověření migruje; starší přihlašovací relace vyžaduje skutečnou přímou adresu démona.

elowen login
elowen chat
elowen run "Summarize the current project"

Přihlášení je omezené na 10 pokusů za pět minut z jedné IP adresy. Hesla musí mít alespoň 8 znaků a změna hesla vyžaduje to současné. Pro bezobslužné první nastavení nastavte ELOWEN_BOOTSTRAP_USER i ELOWEN_BOOTSTRAP_PASS.

Role administrátora a člena

Elowen má dvě role účtu:

Administrátor může spravovat uživatele, projekty na hostiteli i spravované projekty, konfiguraci a přidělení účtů. Spárovaný počítač spravuje jen účet, který jej spároval. Administrátoři mohou počítač jiného účtu použít až poté, co jej s nimi jeho vlastník nasdílí, a nemohou měnit jeho členy, přejmenovat jej ani jej odpojit.
Člen má přístup jen k projektům přiřazeným jeho účtu.

Oprávnění provozovatele instance není třetí role účtu: každý administrátorský účet Elowen je má pro akce vyhrazené vlastníkovi. Role administrátora přidělená jen v místnosti platformy toto oprávnění nedává.

Jen administrátoři mohou otevřít Uživatele. Členům je přístup ke stránce i k jejímu API odepřen.

Vytvořte a spravujte účty

Otevřete Uživatele a zvolte Nový uživatel. Zadejte uživatelské jméno a heslo dlouhé alespoň osm znaků, potom zvolte Předvolbu účtu a jeho Projekty — nový osobní projekt nebo existující — a vyberte Vytvořit. Lidský účet vždy potřebuje alespoň jeden projekt.

Vyberte účet a vpravo se otevře jeho panel s detailem; na telefonu zabere celou obrazovku. Karty pod názvem přepínají jeho části a panel se otevírá na Oprávněních, kde najdete přidělení projektů, přístup k hlasu, limit útraty, povolené modely, pluginy, které lze přidělovat, a oprávnění nástrojů. Projekty přiřazují projekty a Účet obsahuje zobrazované jméno a uživatelské jméno, které se samy uloží krátce poté, co přestanete psát, a ukazuje předvolbu, roli a využití účtu. Pluginy, které přidávají panely účtu, dostanou vlastní kartu. Nabídka vedle názvu mění roli, odstraňuje účet nebo pomocí Přihlásit se jako zobrazí aplikaci jako tento účet kvůli podpoře.

Seznam Nástroje ukazuje každý nástroj jako zapnutý, vypnutý nebo nedostupný, protože jeho plugin není přidělen; poslední případ nese odznak nepřiděleno a nelze jej zapnout, dokud plugin nepřidělíte. Nástroj, který už pokrývá existující vzor, například mcp__*, nese označení Povoleno vzorem a samostatně jej vypnout nelze.

Resetujte dvoufázové ověření jiného účtu

Karta Účet ukazuje stav dvoufázového ověření u lidských účtů. U jiného účtu se zapnutým faktorem zvolte Resetovat dvoufázové ověření až poté, co danou osobu nezávisle ověříte. Potvrďte uvedený cíl a prokažte vlastní oprávnění: současným heslem a novým nepoužitým kódem z autentikátoru, pokud má Váš účet faktor, nebo přihlášením Microsoft z posledních pěti minut. Pokud je tento důkaz starší, přihlaste se znovu přes Microsoft. Reset nemůže provést relace, ve které jste přihlášeni jako někdo jiný.

Úspěšný reset vypne faktor cíle, zruší čekající ověření a odhlásí všechny jeho relace v prohlížeči. Jeho další přihlášení heslem už kód nevyžaduje; faktor musí znovu zaregistrovat v Účtu → Zabezpečení. Jeho API tokeny a spárované počítače zůstávají beze změny. Chyba o neaktuálním stavu znamená znovu načíst účet a pokus zopakovat. Nejistý výsledek není potvrzený reset.

Záložní kódy, samoobslužný reset, skryté příkazy ani obnova z CLI neexistují. Osamocený administrátor, který ztratí autentikátor a nemá jiného administrátora ani použitelné přihlášení Microsoft, nemá podporovanou obnovu. Zařiďte si jednu z těchto možností dřív, než ověření zapnete.

Smažte účet

Účet smažete v jeho nabídce akcí. Elowen zastaví jeho běžící procesy a odstraní jeho relace a data chatu, nastavení účtu, soukromé vzpomínky a kategorie vzpomínek, odběry oznámení push, API tokeny, přiřazení projektů, propojení externích identit a data účtu vlastněná pluginy. Vzpomínky ve sdíleném fondu Projektu se nemažou, jen se přepíše jejich přiřazení. Administrátory smazat nelze; nejprve jednomu změňte roli na člena. Posledního administrátora snížit nelze a poslední účet instalace smazat nelze.

Účty chatbotů

Účet chatbota je neinteraktivní účet. Nemá heslo ani samoobslužné přihlášení, ale přihlášený administrátor jej může otevřít pomocí Přihlásit se jako. Nikdy se nemůže stát administrátorem, nelze jej propojit s externí identitou a nemůže mít osobní API tokeny. Je vázaný na jeden Projekt a instrukční soubory tohoto Projektu jsou jeho personou (viz Context Files). Účet chatbota dostane plugin chatbota při vytvoření.

Přiřaďte členovi projekty

Přiřazení projektů určuje, které projekty člen vidí:

Otevřete Uživatele a vyberte člena.
V části Projekty zvolte Spravovat.
Zvolte projekty a uložte.

Člen bez přiřazení nevidí žádná data projektů. Administrátoři nepotřebují jednotlivá přiřazení pro projekty na hostiteli ani spravované Projekty. Spárovaný počítač s nimi musí být výslovně nasdílen, jinak se neobjeví a nelze jej použít. Seznamy a počty ve správě uživatelů vynechávají počítače vlastněné jiným účtem, i když je administrátor jejich členem. Sdílení počítače spravujte v jeho vlastním Projektu jako jeho vlastník párování. Smazáním účtu vlastníka párování se odstraní jeho počítače i jejich Projekty; smazáním sdíleného člena se odstraní jen jeho přiřazení. Člen musí mít vždy alespoň jeden aktivní Projekt: Elowen odmítne změnu, která by účet nechal bez něj, a snížení role vyžaduje, aby účet nějaký měl.

Přímé konverzace na platformách

Přímá konverzace 1:1 na platformě je osobní jen tehdy, když odesílatel má ověřenou externí identitu propojenou s účtem Elowen. Skupiny a kanály jsou sdílené konverzace, i když je odesílatel v dané platformě administrátor. Ve sdílené konverzaci Elowen pro daný tah používá stav ověřeného odesílatele vázaný na jeho účet; nepřebírá účet, který místnost otevřel.

Přímá konverzace vytvořená před propojením odesílatele může zpočátku patřit provozovateli instance. Jakmile je odesílatel ověřený, Elowen si konverzaci může převzít, aniž by přesouval její přepis, využití nebo soubory.

Ovládejte modely, pluginy a nástroje

Model nebo nástroj musí projít každou platnou kontrolou přístupu, než se může spustit.

Omezte modely

V ovládacím prvku Povolené modely daného uživatele zvolte, které nastavené modely smí účet používat, nebo zapněte Všechny modely a povolte každý model, který instalace nabízí, včetně modelů přidaných později. Bez volby a s vypnutou volbou Všechny modely nesmí účet použít žádný model. Nový lidský účet začíná s přiděleními zvolené předvolby pro nové účty, nebo bez přístupu k modelům, pokud předvolba zvolená není; první administrátor začíná s volbou Všechny modely. Přidělení nemůže přidat model, který instalace neumí spustit. Osobní model pro zkrácení kontextu a dočasné modely pro obrázky používají stejné přidělení. Pokud je zvolený model pro zkrácení kontextu později odvolán, shrnutí použije povolený model konverzace; zařazování použije tento model jen během aktivního tahu téhož účtu a jinak klasifikaci vynechá.

Přidělte pluginy

Některé pluginy lze přidělovat a do té doby, než je administrátor přidělí v části Povolené pluginy, zůstávají nedostupné každému účtu. Administrátoři mohou upravovat svá vlastní přidělení, ale nepřidělený plugin použít nemohou.

Přidělení zpřístupní hlídané nástroje, API trasy, rozhraní a dodané skilly pluginu pro daný účet. Neobchází kontroly projektů, souborového systému ani oprávnění nástrojů. Fragmenty promptů, platformní prompty, lomítkové příkazy a háčky přidělení pluginu nehlídá.

Nastavte oprávnění jednotlivých nástrojů

Sekce Nástroje daného uživatele spravuje kladné přidělení pro vestavěné i pluginové nástroje. Prázdný seznam nepřiděluje žádné nástroje, a to ani administrátorům — jedinou výjimkou je úplně první administrátor instance, který při vytvoření dostane plné přidělení, jak je uvedeno výše, a nový lidský účet dostane přidělení nástrojů své předvolby. Vzory jako mcp__* mohou pokrýt odpovídající nástroje. Nástroj nedostupný proto, že jeho plugin není přidělen, je nutné nejprve zpřístupnit přidělením pluginu.

Uložené přidělení nástroje může zůstat, i když je plugin vypnutý nebo osobní server MCP offline; do té doby neodpovídá žádnému nástroji. Neznámá jména nástrojů nemají žádný účinek.

Přidělení terminálu automaticky nedává neomezený přístup k hostiteli. Ve výchozím stavu jsou příkazy od běžných účtů omezené na jejich dostupné projekty a domovský adresář účtu; administrátor to vypne volbou Izolovat příkazy běžných účtů v nastavení pluginu Prostředí. Souborové nástroje si drží vlastní hranice cest a příkazy ve spravovaném projektu běží v prostředí tohoto projektu.

Nastavte pravidla oprávnění

Otevřete Účet → Modely → Oprávnění příkazů a zvolte, co se stane při volání dostupného nástroje. Změny se ukládají okamžitě.

Každé pravidlo má jednu akci:

allow proběhne bez schválení.
ask vyžádá schválení, pokud je dostupné místo pro schválení člověkem.
deny volání odmítne.

Vzor tools odpovídá názvu nástroje, například Write. Vzor bash odpovídá řetězci příkazu shellu, takže git * a rm * mohou mít různá rozhodnutí, i když oba používají nástroj Bash.

Pravidla se vyhodnocují v pořadí a vyhrává poslední odpovídající pravidlo. Pravidla uživatele následují po vestavěných výchozích hodnotách, takže pravidlo uživatele může výchozí hodnotu přepsat. Pokud volání nástroje neodpovídá žádnému pravidlu, výsledkem je ask.

Řádek shellu s více jednoduchými příkazy, například cd app && rm -rf build, se rozdělí na ;, nové řádky, &&, ||, | a & a na vnitřní příkaz každé substituce, například $(…) nebo zpětných apostrofů. Každý příkaz se kontroluje samostatně. Platí nejpřísnější výsledek: jakékoli deny zablokuje celý řádek, jinak se uplatní jakékoli ask.

Použijte režim YOLO

Režim YOLO v Účtu → Modely mění rozhodnutí ask na allow bez dotazu. Nepřebíjí výslovné deny ani nezpřístupní nedostupný nástroj. Ve výchozím stavu je vypnutý; přepínač nastavuje výchozí hodnotu pro nové relace a /yolo v elowen chat mění jen aktuální relaci.

Zvolte chování dotazů při bězích bez dohledu

Naplánované úlohy, delegovaní sub-agenti a chatovací platformy nemají nikoho, kdo by volání nástroje schválil. Účet → Modely → Běhy bez dohledu určuje, jak se tam chovají pravidla ask:

Povolit je výchozí a zachází s ask jako s povolením.
Blokovat odmítne volání ask v tazích bez dohledu.

Toto nastavení je nezávislé na YOLO; YOLO nepřebíjí odmítnutí při běhu bez dohledu. Delegovaní sub-agenti pouze pro čtení vždy odmítnou volání ask, ať toto nastavení říká cokoli.

Nastavte výchozí hodnoty pro uživatele

Otevřete Uživatele, zvolte Možnosti a potom Výchozí nastavení uživatelů. Nastavte modely, paměť, automatické učení skillů, styl a pokyny, jazyk, pravidla nástrojů a YOLO, které mají lidské účty používat, dokud nemají vlastní hodnotu. Model konverzace používá stávající výchozí hodnotu instalace. Sekce Pluginy upravuje osobní výchozí hodnoty pluginů; tajné přihlašovací údaje zůstávají osobní.

Každé nastavení ukazuje, kolik účtů má vlastní hodnotu. Přepsat všem Vás požádá o potvrzení smazání těchto přepsání, potom účty následují výchozí hodnotu. Změna samotné výchozí hodnoty zachová volbu každého účtu. Účty chatbotů si drží vlastní nastavení.

Předvolba pro nové účty vybírá pojmenovanou předvolbu účtu nebo Žádnou, i pro Microsoft SSO. Dialog vytvoření začíná touto volbou a dovolí zvolit jinou předvolbu nebo žádnou. První administrátor si ponechává plný přístup; účty chatbotů předvolby používat nemohou.

Použijte předvolby účtů

Otevřete Uživatelé → Možnosti → Předvolby účtů a zvolte Nová předvolba. Dejte jí název, například Provoz nebo Obchod, potom nastavte její Práva, Chování a Projekty. Přiřaďte ji pomocí Předvolba v detailu účtu nebo při vytváření lidského účtu. Každý účet může mít jednu předvolbu; seznam účtů i detail ukazují její název vedle role účtu.

Změna předvolby okamžitě aktualizuje každý připojený účet. Přidělení zahrnují modely, nástroje, pluginy, hlas, oprávnění k Projektům a měsíční útratu. Pole chování jsou volitelná: účet nejprve použije vlastní volbu, potom předvolbu a nakonec výchozí hodnoty instalace. Přepsat všem v předvolbě vymaže osobní volby vybraného pole jen u připojených účtů. Osobní změny provedené v Účtu ponechávají předvolbu připojenou. Výchozí model konverzace a osobní nastavení pluginů zůstávají mimo předvolby.

Než ručně změníte oprávnění připojeného účtu, Elowen Vás požádá o potvrzení odpojení. Ruční změna zůstane a budoucí úpravy předvolby se na tento účet už neprojeví. Volba žádné předvolby jej také odpojí, ale přidělení i členství v Projektech zůstanou.

Projekty v předvolbě jsou minimální členství. Další členství zůstávají a odebrání Projektu z předvolby odebere i toto členství, ledaže by tím člen zůstal bez aktivního Projektu. V takovém případě si účet Projekt ponechá a odpověď jej uvede.

Smazání předvolby Vás požádá o potvrzení počtu připojených účtů. Tyto účty si ponechají přidělení, osobní nastavení i členství v Projektech; chování bez osobní volby se znovu řídí výchozími hodnotami instance. Při upgradu se stávající přidělení modelů, pluginů a nástrojů pro nové účty stanou předvolbou Nový účet, zvolenou pro nové účty.

Přechod z výchozích hodnot Microsoft SSO. Nastavení zřizování přes Microsoft SSO pro výchozí modely, výchozí pluginy, povolené nástroje, preferovaný model a YOLO se při upgradu přesunou do výchozích hodnot instance. Každá hodnota zaplní jen prázdné místo, takže hodnota, kterou jste už nastavili, zůstane. Pokud měl Microsoft Teams dřív zapnuté ssoDefaultYolo a není uložená žádná sdílená výchozí hodnota oprávnění, stane se YOLO výchozím pro každý lidský účet bez vlastních pravidel, včetně stávajících účtů a účtů vytvořených mimo Microsoft SSO. Účty s vlastním nastavením oprávnění si je ponechají. Před upgradem zkontrolujte původní nastavení a potom sdílenou sekci Pravidla a YOLO v Uživatelé → Možnosti → Výchozí nastavení uživatelů.

Čtěte přehled Aktivity

Přehled Aktivity je provozní náhled, nikoli úplný auditní záznam. Zaznamenává aktivitu tahů, události SSO a události pluginů, které je výslovně publikují. Aktivita se seskupuje do krátkých časových oken a uchovává se po nastavenou dobu, ve výchozím stavu 30 dní.

Týmový přehled ukazuje omezené informace o aktérovi, povrchu, počtu a souhrnu nástrojů, nikoli text zpráv, příkazy, cesty ani každý požadavek. Některá starší, nepřiřazená, neúspěšná nebo jinak nezaznamenaná práce může chybět. Změny paměti účtu mají samostatný auditní záznam vázaný na uživatele.

Delegovaní sub-agenti

Delegovaný sub-agent dostane od rodiče rozsah přístupu, včetně stavu administrátora, přístupu k projektům, politiky nástrojů, oprávnění a režimu pouze pro čtení. Delegování může přístup zúžit, ale nemůže udělit širší přístup, než má volající.

Režim pouze pro čtení odebírá nástroje pro zápis a omezuje příkazy shellu, ale není sandboxem souborového systému: přesměrování v shellu může zapisovat všude, kam to oprávnění k cestám dovolí. Pokračování potomka je odmítnuto, pokud jeho uložený rozsah přesahuje aktuální oprávnění volajícího. Sub-agentovi pouze pro čtení může přístup pro zápis udělit jen ten, kdo jej vyžádal, a jen tehdy, když to aktuální přístup volajícího dovoluje.

Spravujte uživatele přes API

Webové rozhraní je doporučená plocha pro správu. Administrátoři mohou použít i ověřené CLI:

elowen api GET /users
elowen api GET /users/12/projects
elowen api POST /users/12/projects '{"projectId":3}'

Trasy pro administrátory zahrnují GET /users, POST /users, PATCH /users/:id, DELETE /users/:id, trasy pro přiřazení projektů a trasy nástrojů a statistik uživatele. API používá stejný bearer token jako CLI.

Propojte externí identity a nastavte SSO

Externí identita je jednoznačně vázaná poskytovatelem, tenantem a subjektem. Identita může patřit jen jednomu účtu Elowen a účet nemůže mít dva subjekty pro stejného poskytovatele a tenanta. E-mail je jen kontrolovaná pomůcka pro propojení; účet určuje externí subjekt.

Microsoft SSO funguje jen tehdy, když je zapnutý plugin Microsoft a jeho přepínač SSO. Je omezené na nastaveného tenanta. Shoda jedinečného e-mailu může ve výchozím stavu účet propojit, ale nejednoznačné shody se odmítají a existující vazba subjektu má přednost. Automatické vytváření účtů je vypnuté, dokud není ssoProvision výslovně nastaveno na tenant. Zřízené účty začínají jako účty bez hesla a bez role administrátora a vznikají stejně jako účet vytvořený v Uživatelích: jejich Projekt pochází z nastavení pluginu ssoNewPersonalProject a ssoDefaultProjects a jejich přidělení i členství v Projektech z předvolby pocházejí z Předvolba pro nové účty v Uživatelé → Možnosti → Výchozí nastavení uživatelů. Bez zvolené předvolby začínají s uzavřenými přiděleními. Chování se dědí z předvolby a výchozích hodnot instance, nekopíruje se do osobního nastavení.

Zřizování také vyžaduje, aby Microsoft Graph potvrdil zapnutý členský účet. Hosté, vypnuté účty a účty bez členství i nedostupné kontroly adresáře se odmítají. SSO nemůže vytvořit prvního administrátora instalace; tento účet vytvořte v prvním nastavení.

Další: Řešení potíží