Správa inštancie

Používatelia a prístup

Administrátori spravujú účty, roly, projekty, prístup k modelom, pridelenie pluginov a prístup k nástrojom v časti Používatelia (/users). Každý účet má navyše vlastné pravidlá oprávnení na schvaľovanie nástrojov a behy bez dohľadu.

Po vytvorení prvého účtu vyžadujú chránené API trasy bearer token. Webové rozhranie namiesto toho používa httpOnly session cookie; JavaScript v prehliadači jeho token prečítať nemôže.

Verejné vstupné body zahŕňajú kontroly stavu a prvého nastavenia, prihlasovacie trasy, trasy Microsoft SSO, podklady motívu a vzhľadu, verejný kľúč Web Push, podpísané adresy avatarov, trasy párovania a registrácie CLI a webhooky pluginov, ktoré sa overujú u svojho poskytovateľa. Kým neexistuje žiadny používateľ, režim nastavenia dovolí sprievodcovi vytvoriť prvého administrátora. Overovanie sa vynucuje od chvíle, keď tento účet existuje.

Úplne prvý administrátor — vytvorený prvým nastavením alebo bezobslužnou cestou ELOWEN_BOOTSTRAP_USER/ELOWEN_BOOTSTRAP_PASS — začína so všetkými základnými nástrojmi, všetkými nástrojmi zapnutého pluginu, rodinou mcp__* pre nástroje MCP, všetkými pluginmi, ktoré možno prideľovať, a s voľbou Všetky modely, pretože zatiaľ neexistuje iný administrátor, ktorý by ich mohol otvoriť v časti Používatelia. Každý ďalší ľudský účet, vrátane administrátorov, dostane predvoľbu zvolenú v Používatelia → Možnosti → Predvolené nastavenia používateľov → Predvoľba pre nové účty. Bez zvolenej predvoľby začína bez prístupu k modelom, nástrojom aj pluginom vyžadujúcim pridelenie. Úpravy predvoľby aktualizujú aj účty, ktoré sú k nej už pripojené.

Prihlasovacie tokeny platia predvolene 30 dní. Administrátor môže platnosť zmeniť v časti Nastavenia → Systém. CLI ukladá údaje spárované z prehliadača podľa pôvodu do ~/.config/elowen/cli-instances.json; ELOWEN_TOKEN prebíja zvolený token. Nastavte ELOWEN_URL na verejnú adresu inštancie alebo jej základ /api, alebo nastavte iba ELOWEN_DAEMON_URL na priamy prístup k démonovi. Staršie cli.json sa po overení migruje; staršia prihlasovacia relácia vyžaduje skutočnú priamu adresu démona.

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

Prihlásenie je obmedzené na 10 pokusov za päť minút z jednej IP adresy. Heslá musia mať aspoň 8 znakov a zmena hesla vyžaduje to súčasné. Pre bezobslužné prvé nastavenie nastavte ELOWEN_BOOTSTRAP_USER aj ELOWEN_BOOTSTRAP_PASS.

Roly administrátora a člena

Elowen má dve roly účtu:

Administrátor môže spravovať používateľov, projekty na hostiteľovi aj spravované projekty, konfiguráciu a pridelenia účtov. Spárovaný počítač spravuje iba účet, ktorý ho spároval. Administrátori môžu počítač iného účtu použiť až potom, čo ho s nimi jeho vlastník zdieľa, a nemôžu meniť jeho členov, premenovať ho ani ho odpojiť.
Člen má prístup iba k projektom priradeným jeho účtu.

Oprávnenie prevádzkovateľa inštancie nie je tretia rola účtu: každý administrátorský účet Elowen ho má pre akcie vyhradené vlastníkovi. Rola administrátora pridelená iba v miestnosti platformy toto oprávnenie nedáva.

Iba administrátori môžu otvoriť Používateľov. Členom je prístup k stránke aj k jej API zamietnutý.

Vytvorte a spravujte účty

Otvorte Používateľov a zvoľte Nový používateľ. Zadajte používateľské meno a heslo dlhé aspoň osem znakov, potom zvoľte Predvoľbu účtu a jeho Projekty — nový osobný projekt alebo existujúce — a vyberte Vytvoriť. Ľudský účet vždy potrebuje aspoň jeden projekt.

Vyberte účet a vpravo sa otvorí jeho panel s detailom; na telefóne zaberie celú obrazovku. Karty pod názvom prepínajú jeho časti a panel sa otvára na Oprávneniach, kde nájdete pridelenia projektov, prístup k hlasu, limit výdavkov, povolené modely, pluginy, ktoré možno prideľovať, a oprávnenia nástrojov. Projekty priraďujú projekty a Účet obsahuje zobrazované meno a používateľské meno, ktoré sa samy uložia krátko po tom, čo prestanete písať, a ukazuje predvoľbu, rolu a využitie účtu. Pluginy, ktoré pridávajú panely účtu, dostanú vlastnú kartu. Ponuka vedľa názvu mení rolu, odstraňuje účet alebo pomocou Prihlásiť sa ako zobrazí aplikáciu ako tento účet kvôli podpore.

Zoznam Nástroje ukazuje každý nástroj ako zapnutý, vypnutý alebo nedostupný, pretože jeho plugin nie je pridelený; posledný prípad nesie odznak nepridelené a nemožno ho zapnúť, kým plugin nepridelíte. Nástroj, ktorý už pokrýva existujúci vzor, napríklad mcp__*, nesie označenie Povolené vzorom a samostatne ho vypnúť nemožno.

Resetujte dvojfázové overenie iného účtu

Karta Účet ukazuje stav dvojfázového overenia pri ľudských účtoch. Pri inom účte so zapnutým faktorom zvoľte Resetovať dvojfázové overenie až potom, čo danú osobu nezávisle overíte. Potvrďte uvedený cieľ a preukážte vlastné oprávnenie: súčasným heslom a novým nepoužitým kódom z autentifikátora, ak má Váš účet faktor, alebo prihlásením Microsoft z posledných piatich minút. Ak je tento dôkaz starší, prihláste sa znova cez Microsoft. Reset nemôže vykonať relácia, v ktorej ste prihlásený ako niekto iný.

Úspešný reset vypne faktor cieľa, zruší čakajúce overenie a odhlási všetky jeho relácie v prehliadači. Jeho ďalšie prihlásenie heslom už kód nevyžaduje; faktor musí znova zaregistrovať v Účte → Zabezpečenie. Jeho API tokeny a spárované počítače zostávajú bez zmeny. Chyba o neaktuálnom stave znamená znova načítať účet a pokus zopakovať. Neistý výsledok nie je potvrdený reset.

Záložné kódy, samoobslužný reset, skryté príkazy ani obnova z CLI neexistujú. Osamotený administrátor, ktorý stratí autentifikátor a nemá iného administrátora ani použiteľné prihlásenie Microsoft, nemá podporovanú obnovu. Zariaďte si jednu z týchto možností skôr, než overenie zapnete.

Zmažte účet

Účet zmažete v jeho ponuke akcií. Elowen zastaví jeho bežiace procesy a odstráni jeho relácie a údaje chatu, nastavenia účtu, súkromné spomienky a kategórie spomienok, odbery oznámení push, API tokeny, priradenia projektov, prepojenia externých identít a údaje účtu vlastnené pluginmi. Spomienky v zdieľanom fonde Projektu sa nemažú, iba sa prepíše ich priradenie. Administrátorov zmazať nemožno; najprv jednému zmeňte rolu na člena. Posledného administrátora znížiť nemožno a posledný účet inštalácie zmazať nemožno.

Účty chatbotov

Účet chatbota je neinteraktívny účet. Nemá heslo ani samoobslužné prihlásenie, ale prihlásený administrátor ho môže otvoriť pomocou Prihlásiť sa ako. Nikdy sa nemôže stať administrátorom, nemožno ho prepojiť s externou identitou a nemôže mať osobné API tokeny. Je viazaný na jeden Projekt a inštrukčné súbory tohto Projektu sú jeho personou (pozrite Context Files). Účet chatbota dostane plugin chatbota pri vytvorení.

Priraďte členovi projekty

Priradenia projektov určujú, ktoré projekty člen vidí:

Otvorte Používateľov a vyberte člena.
V časti Projekty zvoľte Spravovať.
Zvoľte projekty a uložte.

Člen bez priradení nevidí žiadne údaje projektov. Administrátori nepotrebujú jednotlivé priradenia pre projekty na hostiteľovi ani spravované Projekty. Spárovaný počítač s nimi musí byť výslovne zdieľaný, inak sa neobjaví a nemožno ho použiť. Zoznamy a počty v správe používateľov vynechávajú počítače vlastnené iným účtom, aj keď je administrátor ich členom. Zdieľanie počítača spravujte v jeho vlastnom Projekte ako jeho vlastník párovania. Zmazaním účtu vlastníka párovania sa odstránia jeho počítače aj ich Projekty; zmazaním zdieľaného člena sa odstránia iba jeho priradenia. Člen musí mať vždy aspoň jeden aktívny Projekt: Elowen odmietne zmenu, ktorá by účet nechala bez neho, a zníženie roly vyžaduje, aby účet nejaký mal.

Priame konverzácie na platformách

Priama konverzácia 1:1 na platforme je osobná iba vtedy, keď odosielateľ má overenú externú identitu prepojenú s účtom Elowen. Skupiny a kanály sú zdieľané konverzácie, aj keď je odosielateľ v danej platforme administrátor. V zdieľanej konverzácii Elowen pre daný ťah používa stav overeného odosielateľa viazaný na jeho účet; nepreberá účet, ktorý miestnosť otvoril.

Priama konverzácia vytvorená pred prepojením odosielateľa môže spočiatku patriť prevádzkovateľovi inštancie. Keď je odosielateľ overený, Elowen si konverzáciu môže prevziať bez presúvania jej prepisu, využitia alebo súborov.

Ovládajte modely, pluginy a nástroje

Model alebo nástroj musí prejsť každou platnou kontrolou prístupu, kým sa môže spustiť.

Obmedzte modely

V ovládacom prvku Povolené modely daného používateľa zvoľte, ktoré nastavené modely smie účet používať, alebo zapnite Všetky modely a povoľte každý model, ktorý inštalácia ponúka, vrátane modelov pridaných neskôr. Bez voľby a s vypnutou voľbou Všetky modely nesmie účet použiť žiadny model. Nový ľudský účet začína s prideleniami zvolenej predvoľby pre nové účty, alebo bez prístupu k modelom, ak predvoľba zvolená nie je; prvý administrátor začína s voľbou Všetky modely. Pridelenie nemôže pridať model, ktorý inštalácia nevie spustiť. Osobný model na skrátenie kontextu a dočasné modely pre obrázky používajú rovnaké pridelenie. Ak je zvolený model na skrátenie kontextu neskôr odvolaný, zhrnutie použije povolený model konverzácie; zaraďovanie použije tento model iba počas aktívneho ťahu toho istého účtu a inak klasifikáciu vynechá.

Prideľte pluginy

Niektoré pluginy možno prideľovať a dovtedy, kým ich administrátor pridelí v časti Povolené pluginy, zostávajú nedostupné každému účtu. Administrátori môžu upravovať svoje vlastné pridelenia, ale nepridelený plugin použiť nemôžu.

Pridelenie sprístupní strážené nástroje, API trasy, rozhranie a dodané skilly pluginu pre daný účet. Neobchádza kontroly projektov, súborového systému ani oprávnenia nástrojov. Fragmenty promptov, platformové prompty, lomítkové príkazy a háčiky pridelenie pluginu nestráži.

Nastavte oprávnenia jednotlivých nástrojov

Sekcia Nástroje daného používateľa spravuje kladné pridelenie pre vstavané aj pluginové nástroje. Prázdny zoznam neprideľuje žiadne nástroje, a to ani administrátorom — jedinou výnimkou je úplne prvý administrátor inštancie, ktorý pri vytvorení dostane plné pridelenie, ako je uvedené vyššie, a nový ľudský účet dostane pridelenie nástrojov svojej predvoľby. Vzory ako mcp__* môžu pokryť zodpovedajúce nástroje. Nástroj nedostupný preto, že jeho plugin nie je pridelený, treba najprv sprístupniť pridelením pluginu.

Uložené pridelenie nástroja môže zostať, aj keď je plugin vypnutý alebo osobný server MCP offline; dovtedy nezodpovedá žiadnemu nástroju. Neznáme mená nástrojov nemajú žiadny účinok.

Pridelenie terminálu automaticky nedáva neobmedzený prístup k hostiteľovi. Predvolene sú príkazy od bežných účtov obmedzené na ich dostupné projekty a domovský adresár účtu; administrátor to vypne voľbou Izolovať príkazy bežných účtov v nastaveniach pluginu Prostredia. Súborové nástroje si držia vlastné hranice ciest a príkazy v spravovanom projekte bežia v prostredí tohto projektu.

Nastavte pravidlá oprávnení

Otvorte Účet → Modely → Oprávnenia príkazov a zvoľte, čo sa stane pri volaní dostupného nástroja. Zmeny sa ukladajú okamžite.

Každé pravidlo má jednu akciu:

allow prebehne bez schválenia.
ask vyžiada schválenie, ak je dostupné miesto na schválenie človekom.
deny volanie odmietne.

Vzor tools zodpovedá názvu nástroja, napríklad Write. Vzor bash zodpovedá reťazcu príkazu shellu, takže git * a rm * môžu mať rôzne rozhodnutia, aj keď oba používajú nástroj Bash.

Pravidlá sa vyhodnocujú v poradí a vyhráva posledné zodpovedajúce pravidlo. Pravidlá používateľa nasledujú po vstavaných predvolených hodnotách, takže pravidlo používateľa môže predvolenú hodnotu prepísať. Ak volanie nástroja nezodpovedá žiadnemu pravidlu, výsledkom je ask.

Riadok shellu s viacerými jednoduchými príkazmi, napríklad cd app && rm -rf build, sa rozdelí na ;, nové riadky, &&, ||, | a & a na vnútorný príkaz každej substitúcie, napríklad $(…) alebo spätných apostrofov. Každý príkaz sa kontroluje samostatne. Platí najprísnejší výsledok: akékoľvek deny zablokuje celý riadok, inak sa uplatní akékoľvek ask.

Použite režim YOLO

Režim YOLO v Účte → Modely mení rozhodnutia ask na allow bez otázky. Nepreberá výslovné deny ani nesprístupní nedostupný nástroj. Predvolene je vypnutý; prepínač nastavuje predvolenú hodnotu pre nové relácie a /yolo v elowen chat mení iba aktuálnu reláciu.

Zvoľte správanie otázok pri behoch bez dohľadu

Naplánované úlohy, delegovaní sub-agenti a chatovacie platformy nemajú nikoho, kto by volanie nástroja schválil. Účet → Modely → Behy bez dohľadu určuje, ako sa tam správajú pravidlá ask:

Povoliť je predvolené a zaobchádza s ask ako s povolením.
Blokovať odmietne volania ask v ťahoch bez dohľadu.

Toto nastavenie je nezávislé od YOLO; YOLO nepreberá odmietnutie pri behu bez dohľadu. Delegovaní sub-agenti iba na čítanie vždy odmietnu volania ask, nech toto nastavenie hovorí čokoľvek.

Nastavte predvolené hodnoty pre používateľov

Otvorte Používateľov, zvoľte Možnosti a potom Predvolené nastavenia používateľov. Nastavte modely, pamäť, automatické učenie skillov, štýl a pokyny, jazyk, pravidlá nástrojov a YOLO, ktoré majú ľudské účty používať, kým nemajú vlastnú hodnotu. Model konverzácie používa existujúcu predvolenú hodnotu inštalácie. Sekcia Pluginy upravuje osobné predvolené hodnoty pluginov; tajné prihlasovacie údaje zostávajú osobné.

Každé nastavenie ukazuje, koľko účtov má vlastnú hodnotu. Prepísať všetkým Vás požiada o potvrdenie zmazania týchto prepisov, potom účty nasledujú predvolenú hodnotu. Zmena samotnej predvolenej hodnoty zachová voľbu každého účtu. Účty chatbotov si držia vlastné nastavenia.

Predvoľba pre nové účty vyberá pomenovanú predvoľbu účtu alebo Žiadnu, aj pre Microsoft SSO. Dialog vytvorenia začína touto voľbou a dovolí zvoliť inú predvoľbu alebo žiadnu. Prvý administrátor si ponecháva plný prístup; účty chatbotov predvoľby používať nemôžu.

Použite predvolby účtov

Otvorte Používatelia → Možnosti → Predvolby účtov a zvoľte Nová predvoľba. Dajte jej názov, napríklad Prevádzka alebo Obchod, potom nastavte jej Práva, Správanie a Projekty. Priraďte ju pomocou Predvoľba v detaile účtu alebo pri vytváraní ľudského účtu. Každý účet môže mať jednu predvoľbu; zoznam účtov aj detail ukazujú jej názov vedľa roly účtu.

Zmena predvoľby okamžite aktualizuje každý pripojený účet. Pridelenia zahŕňajú modely, nástroje, pluginy, hlas, oprávnenia k Projektom a mesačné výdavky. Polia správania sú voliteľné: účet najprv použije vlastnú voľbu, potom predvoľbu a nakoniec predvolené hodnoty inštalácie. Prepísať všetkým v predvolbe vymaže osobné voľby vybraného poľa iba u pripojených účtov. Osobné zmeny vykonané v Účte ponechávajú predvoľbu pripojenú. Predvolený model konverzácie a osobné nastavenia pluginov zostávajú mimo predvolieb.

Skôr než ručne zmeníte oprávnenie pripojeného účtu, Elowen Vás požiada o potvrdenie odpojenia. Ručná zmena zostane a budúce úpravy predvoľby sa na tento účet už neprejavia. Voľba žiadnej predvoľby ho tiež odpojí, ale pridelenia aj členstvá v Projektoch zostanú.

Projekty v predvolbe sú minimálne členstvá. Ďalšie členstvá zostávajú a odobratie Projektu z predvoľby odoberie aj toto členstvo, ledaže by tým člen zostal bez aktívneho Projektu. V takom prípade si účet Projekt ponechá a odpoveď ho uvedie.

Zmazanie predvoľby Vás požiada o potvrdenie počtu pripojených účtov. Tieto účty si ponechajú pridelenia, osobné nastavenia aj členstvá v Projektoch; správanie bez osobnej voľby sa znova riadi predvolenými hodnotami inštancie. Pri upgrade sa existujúce pridelenia modelov, pluginov a nástrojov pre nové účty stanú predvoľbou Nový účet, zvolenou pre nové účty.

Prechod z predvolených hodnôt Microsoft SSO. Nastavenia zriaďovania cez Microsoft SSO pre predvolené modely, predvolené pluginy, povolené nástroje, preferovaný model a YOLO sa pri upgrade presunú do predvolených hodnôt inštancie. Každá hodnota vyplní iba prázdne miesto, takže hodnota, ktorú ste už nastavili, zostane. Ak mal Microsoft Teams predtým zapnuté ssoDefaultYolo a nie je uložená žiadna zdieľaná predvolená hodnota oprávnení, stane sa YOLO predvoleným pre každý ľudský účet bez vlastných pravidiel, vrátane existujúcich účtov a účtov vytvorených mimo Microsoft SSO. Účty s vlastným nastavením oprávnení si ich ponechajú. Pred upgradom skontrolujte pôvodné nastavenie a potom zdieľanú sekciu Pravidlá a YOLO v Používatelia → Možnosti → Predvolené nastavenia používateľov.

Čítajte prehľad Aktivity

Prehľad Aktivity je prevádzkový náhľad, nie úplný audítorský záznam. Zaznamenáva aktivitu ťahov, udalosti SSO a udalosti pluginov, ktoré ich výslovne publikujú. Aktivita sa zoskupuje do krátkych časových okien a uchováva sa po nastavený čas, predvolene 30 dní.

Tímový prehľad ukazuje obmedzené informácie o aktérovi, povrchu, počte a súhrne nástrojov, nie text správ, príkazy, cesty ani každú požiadavku. Niektorá staršia, nepriradená, neúspešná alebo inak nezaznamenaná práca môže chýbať. Zmeny pamäte účtu majú samostatný audítorský záznam viazaný na používateľa.

Delegovaní sub-agenti

Delegovaný sub-agent dostane od rodiča rozsah prístupu, vrátane stavu administrátora, prístupu k projektom, politiky nástrojov, oprávnení a režimu iba na čítanie. Delegovanie môže prístup zúžiť, ale nemôže udeliť širší prístup, než má volajúci.

Režim iba na čítanie odoberá nástroje na zápis a obmedzuje príkazy shellu, ale nie je sandboxom súborového systému: presmerovanie v shelli môže zapisovať všade, kam to oprávnenie k cestám dovolí. Pokračovanie potomka je odmietnuté, ak jeho uložený rozsah presahuje aktuálne oprávnenie volajúceho. Sub-agentovi iba na čítanie môže prístup na zápis udeliť iba ten, kto ho vyžiadal, a iba vtedy, keď to aktuálny prístup volajúceho dovoľuje.

Spravujte používateľov cez API

Webové rozhranie je odporúčaná plocha na správu. Administrátori môžu použiť aj overené CLI:

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

Trasy pre administrátorov zahŕňajú GET /users, POST /users, PATCH /users/:id, DELETE /users/:id, trasy na priradenie projektov a trasy nástrojov a štatistík používateľa. API používa rovnaký bearer token ako CLI.

Prepojte externé identity a nastavte SSO

Externá identita je jednoznačne viazaná poskytovateľom, tenantom a subjektom. Identita môže patriť iba jednému účtu Elowen a účet nemôže mať dva subjekty pre toho istého poskytovateľa a tenanta. E-mail je iba kontrolovaná pomôcka na prepojenie; účet určuje externý subjekt.

Microsoft SSO funguje iba vtedy, keď je zapnutý plugin Microsoft a jeho prepínač SSO. Je obmedzené na nastaveného tenanta. Zhoda jedinečného e-mailu môže predvolene účet prepojiť, ale nejednoznačné zhody sa odmietajú a existujúca väzba subjektu má prednosť. Automatické vytváranie účtov je vypnuté, kým nie je ssoProvision výslovne nastavené na tenant. Zriadené účty začínajú ako účty bez hesla a bez roly administrátora a vznikajú rovnako ako účet vytvorený v Používateľoch: ich Projekt pochádza z nastavení pluginu ssoNewPersonalProject a ssoDefaultProjects a ich pridelenia aj členstvá v Projektoch z predvoľby pochádzajú z Predvoľba pre nové účty v Používatelia → Možnosti → Predvolené nastavenia používateľov. Bez zvolenej predvoľby začínajú s uzavretými prideleniami. Správanie sa dedí z predvoľby a predvolených hodnôt inštancie, nekopíruje sa do osobného nastavenia.

Zriaďovanie tiež vyžaduje, aby Microsoft Graph potvrdil zapnutý členský účet. Hostia, vypnuté účty a účty bez členstva aj nedostupné kontroly adresára sa odmietajú. SSO nemôže vytvoriť prvého administrátora inštalácie; tento účet vytvorte v prvom nastavení.

Ďalší: Riešenie problémov