CLI

Командна линија beeuni-ја, његов модел аутентификације, развојни циклус и све команде.

beeuni interfejs komandne linije (CLI) upravlja Beeuni-jem iz terminala — na vašem laptopu ili u sandboxu sesije. Ova stranica prikazuje uobičajeni razvojni ciklus, a zatim navodi sve stabilne komande i zastavice.

Instalacija

curl -fsSL https://beeuni.ai/install | bash

Instalaciona skripta preuzima unapred izgrađenu binarnu datoteku za macOS i Linux. Windows nije podržan.

Model autentifikacije

Beeuni čuva podatke za autentifikaciju po hostu, a ne globalno. Host je jedna Beeuni API krajnja tačka. Koristite cloud da biste se povezali sa Beeuni-jem.

Konfiguraciona datoteka se nalazi na ~/.config/beeuni/config.json, sa režimom 0600. Putanju možete da promenite pomoću BEEUNI_CONFIG_FILE.

CLI prati hijerarhiju: host → nalog → projekat → sesija. Prijavite se na host, izaberete nalog na njemu, izaberete projekat u tom nalogu i otvarate sesije u projektu. beeuni hosts login prolazi prva tri koraka redom: prijavljuje vas, bira nalog, a zatim postavlja podrazumevani projekat.

Svaki token počinje sa beeuni_pat_. Korisnički token, dobijen pomoću beeuni login, prikazuje sve naloge i projekte čiji ste član. Projektni token se automatski izdaje za sandbox sesije i ograničen je na jedan projekat. Pogledajte Opseg tokena.

Razvojni ciklus

Ovaj ciklus pretpostavlja da je CLI instaliran i da ste pokrenuli beeuni login. Uputstva za podešavanje potražite u odeljku Brzi početak.

beeuni init my-app
cd my-app

beeuni projects link <project-id>

beeuni ship

beeuni sessions new --prompt "Build the login page" --wait

beeuni connect

beeuni sessions chat

beeuni tui        # or: beeuni t, or beeunit
beeunit --project <id> --new --terminal   # new session + sandbox shell, one command

beeuni sessions shell

beeuni sessions ls

beeuni cr ls
beeuni cr diff 1
beeuni cr merge 1

Референца

Команде за аутентификацију

beeuni hosts login / hosts logout / hosts whoami су канонски облици. login / logout / whoami су скраћени облици који делују на активни host.

Hostovi

URL удаљеног hosta који почиње са http:// нормализује се на https://. CLI никада не шаље токен удаљеном hostu преко обичног HTTP-а. localhost је изузетак.

Налози

Чланови

Ко припада налогу и која је њихова улога у налогу. Улоге су owner, admin и member. Власници и администратори имају имплицитну улогу Manager на сваком пројекту, па је member једина улога која захтева појединачна одобрења за пројекте.

<user> је кориснички ID или имејл адреса особе која је већ у налогу. Опције: --account <id>, --host <name>, --json, -y.

Групе

Група налога је именовани скуп људи којима једном доделите улогу. Повежите групу са опсегом помоћу beeuni access grant --group <id> --role <key>; опозовите везу помоћу beeuni access revoke <assignment-id>.

<group> је ID групе или њен тачан назив. За читање је потребан group.read. За create, set и add потребан је group.update или group.members.manage, као и ентерпрајз ентитет rbac. rm и remove служе за чишћење и никада не захтевају ентитет.

Токени

Неинтерактивни акредитиви за налог. За читање је потребан token.read. Сваки члан налога може да креира и опозове сопствене личне кључеве (token.personal.create, token.personal.revoke); лични кључ делује у ваше име и никада не носи више од ваших сопствених улога. За сервисне налоге и кључеве других особа потребан је token.create / token.revoke (власник и администратор).

Лични API кључ делује у ваше име и престаје да важи када престане ваше чланство. Сервисни налог делује у своје име и не наслеђује приступ: нови налог нема дозволе. Доделите му дозволу помоћу beeuni access grant --service-account <id> --role <key>. --expires <when> прихвата ISO-8601 или будући период: 30d, 12h, 6w, 1y.

Наплата

Прочитајте план, кредите и потрошњу активног налога. Само за читање: промене плана, допуне и начини плаћања обављају се на контролној табли.

Филтери: --project <id>, --session <id> и --owner <id> (сесије, са --by session). Опције: --account <id>, --host <name>, --json.

Пројекти

Команда одређује „пројекат“ следећим редоследом:

1. Ознака --project.
2. Променљива окружења BEEUNI_PROJECT_ID.
3. .beeuni/link.json у тачном радном директоријуму.
4. Глобални подразумевани пројекат постављен помоћу beeuni projects use.

Пројекат приказује једну икону, па уписивање --icon уклања глиф, а уписивање --glyph уклања емоџи; навођење оба одбија се. Боје глифа: grey, red, orange, yellow, lime, blue, purple, magenta. За set и features потребан је project.settings.write. Заставица коју платформа означи као недоступну остаје искључена без обзира на override пројекта.

CLI токен пројекта везан је за један пројекат — API га одбија свуда другде. Сандбокс сесије користи свој токен BEEUNI_TOKEN везан за сесију. За cli-tokens ls је потребно читање пројекта; за new и rm потребан је project.credentials.issue. Токен везан за сесију не може ни да креира ни да опозове токене пројекта (403), без обзира на то да ли пројекат декларише агенте. CLI токен пројекта прати PAT политику налога: када налог захтева истек, наведите --expires-at; истек дужи од максималног трајања враћа 400.

За beeuni projects upgrade је потребно писање у пројекат. Подразумевани агент освежава основу са маркетплејса, поново уписује манифест, покреће beeuni validate и отвара захтев за измену. Никада не врши спајање: човек прегледа разлике.

Структура пројекта

beeuni init [project-name] [options] креира нови директоријум пројекта. Почетни шаблон уписује v2 beeuni.yaml, agents/, skills/, memory/ и harnesses/opencode/. Команда може да повеже локално откривање алата за програмирање без промене cloud подразумевани агентски рантајм окружења. Команда не уписује .beeuni/link.json. beeuni ship или beeuni projects link креирају ту датотеку.

Избор локалног алата за програмирање не мења cloud подразумевани агентски рантајм окружење.

beeuni init не укључује бирач маркетплејса. Додавање вештине са маркетплејса је увоз агента: покрените сесију и затражите од агента да је увезе.

Објављивање

beeuni ship припрема, комитује и шаље вашу тренутну грану у git репозиторијум пројекта. Покрените га једном да креирате пројекат. Покрените га поново кад год желите да синхронизујете. Алијас: beeuni deploy.

Pri svakom pokretanju:

• Pokreće provere beeuni validate](#manifest-validation): beeuni.yaml se spaja sa svakom datotekom koju navede pod imports:, Dockerfile-ovima sandboxa, povezivanjem agenata i veličinom repozitorijuma (preskočite pomoću --no-verify). Greška zaustavlja objavljivanje. Upozorenje ga nikad ne zaustavlja.
• Komituje sve izmene u radnom stablu (preskočite pomoću --no-commit).
• Traži svaki nedostajući tajni podatak env (preskočite pomoću --no-env).
• Šalje trenutnu granu na udaljenu granu istog naziva.
• Povezuje svaki deklarisani konektor kome je i dalje potrebna autentifikacija (preskočite pomoću --no-connect).

Postojeći GitHub origin povezuje se preko Beeuni GitHub App. Svaki drugi postojeći origin registruje se takav kakav jeste. Ako nema origin, kreira se Beeuni git repozitorijum kojim se upravlja.

Aplikacije

Apps хостује статичке сајтове, сервере, позадинске задатке и базе података. Сваки App има стални URL. Издање садржи код и конфигурацију; неуспешно постављање не замењује активно издање.

beeuni apps list
beeuni apps show main
beeuni apps connect main
beeuni apps launch --template convex --slug main
beeuni apps deploy dist --type static --spa
beeuni apps machines main
beeuni apps volumes main

Повежите апликације помоћу uses и примера из beeuni apps connect. Не стављајте администраторске акредитиве у клијентски код.

Активни ресурси троше кредите налога. Проверите Billing и Usage. Apps нема посебан месечни буџет.

Apps

Sesije

Svaka sesija radi u jednom sandboxu na sopstvenoj grani.

sessions queue захтева project.session.start — исту дозволу као за слање поруке. Упит у реду чекања опстаје и након затварања терминала и испоручује се када сесија може да га прими. Додајте га помоћу beeuni sessions chat <id> -p "…" --queue или усмерите активни ток помоћу --steer. sessions queue ls приказује DELIVERY сваког упита (steer, queue или interrupt) и, за упит за усмеравање који се извршава као queue, разлог: unsupported (сесија не може да прима поруке усред тока), not_prompter (у току је обрада другог члана) или turn_ended.

sessions approvals су трајни: за разлику од sessions pending, опстају након поновног покретања sandbox окружења. За њих је потребно project.members.manage, или да будете човек који је покренуо сесију. Агент никада не сме да реши сопствено одобрење.

sessions attachments чита приватно складиште датотека сесије, а не њен радни простор. Датотеке се тамо смештају приликом слања, а свака датотека коју је агент приказао смешта се тамо на крају тока.

sessions files чита радно стабло које агент тренутно уређује, пре било каквог комитовања; beeuni files чита комитовани репозиторијум. Путање се разрешавају унутар /workspace, осим ако почињу са /workspace, /tmp, /home или /opt. Команда буди sandbox ако спава. Опције: --from <local path> (write чита ову датотеку уместо stdin-а), --content (find претражује садржај помоћу ripgrep-а уместо назива датотека), --limit <N> (ограничење броја датотека find) и -y за прескакање потврде rm.

sessions share је под контролом власника: API одбија менаџера пројекта који већ нема дозволу за читање сесије. Заједничка сесија се извршава само помоћу кључева провајдера који су доступни целом пројекту: модел који се извршавао помоћу ваших личних кључева прелази на кључеве пројекта за тог провајдера, а ако ниједан такав кључ није доступан, дељење се одбија (409 SHARED_SESSION_NEEDS_PROJECT_KEY).

Опције за sessions links create: --port <n> (подразумевано 3000; 22, 8000 и портови opencode се одбијају), --path <p> (подразумевано /), --preview <id> (именовани кандидат — web, vite, dev-server, api-docs — уместо --port/--path), --file <path> (дели једну датотеку из радног простора уместо прегледа; увек само за читање), --mode view\|interactive (подразумевано view; interactive дозвољава уписивање и веб-сокете и занемарује се за --file), --label <text> и --expires <iso>. За прављење везе потребан је власник сесије, јер за саму везу није потребна пријава; за навођење и опозив везе потребан је и менаџер пројекта.

Унутар sandbox окружења, BEEUNI_SESSION_ID је ID ваше сесије.

Захтеви за измену

Захтев за измену (CR) спаја једну грану у другу на било ком Git хосту. То је једини начин да агент пренесе рад из сесије у подразумевану грану. Погледајте Захтеви за измену.

request-changes бележи напомену у CR-у и доставља је сесији из које је потекао, покрећући њено sandbox окружење ако спава. Захтева project.review.act — исто овлашћење које користи Центар за преглед, а не gitops.push.

<cr> прихвата број у оквиру пројекта (3) или цео ID. Унутар sandbox окружења, CLI аутоматски чита токен — није потребна пријава ни веза.

Преглед

Пријемно сандуче за преглед пројекта — све што чека људску одлуку: захтеви за измену, позиви алата конектора чија је политика условљена одобрењем, као и резултати, одлуке и групе које агенти шаљу на потврду. Одражава Центар за преглед на контролној табли. Укључено је за сваки пројекат; project.review.read и project.review.act контролишу читање и обављање радњи.

Исходи: approve, reject, changes, answer, dismiss. Сегменти: needs_you, waiting, done. Врсте: change, approval, output, decision, batch.

Место на које се исход примењује зависи од ID-а ставке. За cr:<id>, approve спаја измену, reject је затвара, а changes шаље напомену назад агенту који ју је отворио (захтева се --message). За call:<id>, approve дозвољава извршавање позива алата, а reject га одбија; за одобрење конектора не прихвата се ниједан други исход — прво прочитајте аргументе помоћу beeuni review show. Сви остали ID-ови усмеравају се на изворну крајњу тачку за радње, која прихвата сваки исход.

bulk делује само на изворне ID-ове. Одобрење конектора захтева засебан преглед параметара, а захтев за измену приказ diff-а, па се оба пријављују и прескачу — исто правило као код вишеструког избора на контролној табли.

Опције за submit: --kind output\|decision\|batch (обавезно), --title <text> (обавезно), --summary <text>, --risk none\|low\|medium\|high (подразумевано none), --detail <json> (JSON објекат), --agent <name> и --session <id> (занемарује се ако сесија није део овог пројекта).

За читање је потребан project.review.read, за одлуке project.review.act, а за submit потребан је project.review.submit.

Тајне

Шифроване вредности сачуване у пројекту. Подразумевано, тајна се при покретању убризгава као обична променљива окружења у свако окружење сесије (изложеност окружења). Испорука са принудном контролом — када окружење чува референцу, а Beeuni замењује праву вредност ван њега (изложеност уз контролу излазног саобраћаја, и beeuni secrets call) — експериментална је. Омогућите ознаку функције secrets_egress (Settings → Feature flags) да бисте је користили; када је ознака искључена, beeuni secrets delivery … egress враћа 403 feature_disabled. Погледајте Secrets.

grant служи за исправљање ставке коју ls пријављује као недостављиву. Увек само проширује листу једног агента; да бисте је сузили или заменили, препишите цео скуп командом beeuni agents scope. There is no secrets revoke — API нема путању за уклањање једног идентификатора из одобрења. Прво одобрење у пројекту без агената покреће управљање приступом: од тада агент који није наведен у манифесту не добија тајне пројекта, а команда то наводи када се то деси.

Env

Agents

Подешавања модела за сваког агента на повезаном пројекту.

Свака опција опсега приступа замењује постојеће вредности; ниједна их не спаја. Вредност --set тумачи се као JSON ако је то могуће, а у супротном се чува као стринг. Закачени модели и scope примењују се одмах, без урезивања у beeuni.yaml; default и config урезују измене у beeuni.yaml на подразумеваној грани пројекта. За scope је потребан project.agent.write, као и за default и config.

Tools

Алати које добијају сесије овог пројекта, учитани из локалне датотеке beeuni.yaml и њених импорта. Покрените из корена пројекта. Погледајте Tools.

Ако нема кључа tools:, свака сесија добија свих пет Beeuni алата (web_search, image_search, scrape_webpage, memory, show). Ако постоји кључ tools:, сесије добијају само Beeuni алате наведене у њему. Да бисте уклонили Beeuni алат, избришите његов ред испод tools:, па покрените beeuni validate. Да бисте ограничили алате једног агента, користите agents.<name>.tools. Излазни кодови: 0 — завршено; 1 — одбијено (датотека постоји, манифест или импорт не може да се рашчлани); 2 — нема манифеста, непозната опција или назив није Beeuni алат.

Models

Које моделе пројекат нуди и који модел се подразумевано користи. Исти интерфејс као у контролној табли под Customize → Models. Пројекат чува само изузетке од подразумеваних вредности каталога (најновији модел сваке породице). Омогућавање модела утиче само на приказ: одређује шта нуде бирачи, никада шта мрежни пролаз испоручује.

ИД-ови модела су ИД-ови за пренос преко мрежног пролаза — основни управљани ИД (glm-5.3-flash) или BYOK provider/model. Копирајте неки из beeuni models ls --json. Појединачни закачени модели агената налазе се у beeuni agents model <agent> <model-id>. За уписе је потребан project.model.write.

Channels

Управља повезивањем пројекта са платформом за ћаскање. Токени се шифровано чувају у тајнама пројекта и разрешавају на страни сервера — никада се не убризгавају у окружење.

--platform slack|teams бира платформу; подразумевано је slack. Teams connect исписује URL за Microsoft административну сагласност; давање сагласности на нивоу целог tenant-а аутоматски објављује апликацију у Teams каталогу. Погледајте Конекторе.

Канал е-поште користи AgentMail и захтева заставицу функције agentmail_email. Опције email connect су: --connector <slug> (подразумевано beeuni_email), --api-key <k> (користите сопствени AgentMail кључ; - чита стандардни улаз), --display-name <n> (име пошиљаоца у одлазној пошти; подразумевано име пројекта), --username <u> и --domain <d> (ново управљано пријемно сандуче), и --inbox-id <id> са --email <addr> (приложите постојеће пријемно сандуче — оба су обавезна заједно). --allow се може навести више пута и поставља смернице у ограничени режим; вредност без @, или вредност са почетним @, тумачи се као домен. --allow-all брише листу и поново прихвата све пошиљаоце.

За уписе у е-пошту и bind потребан је project.connector.write.

Конектори

Конектори које агент позива као алате. add, rm и policy set уређују локални beeuni.yaml; покрените beeuni ship да примените измене, осим ако не проследите --apply да бисте одмах променили cloud пројекат.

policy ls, show, set, add и rm представљају површину на нивоу пројекта, па се конектор назван једним од тих глагола мора адресирати као policy <slug> ls. <match> је назив алата, glob (send_*) или /regex/.

Опције за add: --name <label>, --provider <pipedream\|mcp\|openapi\|postman\|graphql\|http>, --app <slug>, --url <url>, --transport <http\|sse>, --endpoint <url>, --base-url <url>, --spec <url\|path>, --auth-type <none\|bearer\|basic\|custom>, --credential shared.

Песковници

Управља сликама песковника пројекта. Шаблон дефинише слику или Dockerfile, као и ресурсе; изградња производи снимак из ког се покрећу сесије.

Избор провајдера захтева project.settings.write.

Опције add/update: --name <label>, --cpu <n>, --memory <n> (GiB), --disk <n> (GiB).

Бекенди

Базе података су Apps са трајним волуменима. Управљајте њима и повезујте их преко Apps.

Apps

Маркетплејс

Прегледајте Beeuni маркетплејс и инсталирајте ставку у пројекат.

Опције: --query <text>, --type <type>, --source <source>, --host <name>, --project <id>, --json.

Инсталацију обавља агент: покреће сесију пројекта која клонира ставку, чита је, обједињује делове који одговарају и отвара захтев за измену. Не постоји механизам за детерминистичку инсталацију, ажурирање или уклањање.

Системске вештине

Системске вештине Beeuni-ја су оперативни приручник платформе за људе и агенте. Обухватају сесије, сандбок окружења, подразумевани агентски рантајм, конекторе, меморију и канале. Ова јавна страница је полазна тачка; CLI са пријављеног налога преузима вештине са активног хоста. Користите beeuni system-skills list да бисте открили доступне вештине, а затим get ону која вам је потребна. API их испоручује уживо, па одговарају верзији која је распоређена на хосту. Не сматрајте локалну копију ажурном.

Опције: --host <name>, --json.

beeuni skills је трајни алијас за исту команду. Прво се пријавите на хост помоћу beeuni login; API за вештине захтева аутентификацију. Користите --host <name> када радите са другим хостом. Јавна страница документације не може да замени ова жива упутства специфична за хост.

Ова листа увек садржи само системске вештине, никада мешавину. Опционалне вештине налазе се на маркетплејсу: beeuni marketplace list --type skill. За синтаксу команди користите beeuni <command> --help; за комплетан приручник платформе прочитајте beeuni system-skills get beeuni-system --full.

Конектор

Интерфејс агента унутар сандбок окружења за сваки конектор. Сваки позив се проверава, разрешава и евидентира на серверу; CLI никада не чува акредитив треће стране. Аутентификација: BEEUNI_TOKEN. Излаз је у формату JSON.

Датотеке

Приказ репозиторијума пројекта у git-у, само за читање. Ради на подразумеваној грани, осим ако --ref зада другу грану, ознаку или комит.

Опције за сваку подкоманду: --ref <ref>, --path <p>, --limit <n>, --json. download прихвата и -o, --out <file>, што је обавезно.

Свака подкоманда захтева project.file.read. download такође одбија свако подстабло које би обухватило агента или вештину изван вашег опсега — zip архива не може да се филтрира током преузимања — зато у том случају архивирајте уже --path.

Окидачи

Окидач покреће сесију према распореду, веб-хуку, догађају апликације или монитору (експериментално). add, rm, enable, disable мењају локални манифест — покрените beeuni ship да бисте применили измене. pause/resume мењају засебни прекидач на серверу. Погледајте Окидачи.

Опције за add: --type <cron\|webhook\|event\|monitor> (подразумевано cron), --prompt <text> (обавезно), --agent <name>, --cron <expr> (са 6 поља, нпр. "0 0 9 * * 1-5"), --run-at <iso> (покрени једном у овом тренутку уместо према cron распореду), --timezone <tz> (подразумевано UTC), --secret-env <NAME>, --name <label>, --disabled.

Опције само за активне окидаче — важе за add --apply и сваки set: --model <provider/model>, --session-mode <fresh\|keyed\|pinned\|reuse>, --session-key <tmpl> (сврстава по једну сесију за сваки кључ, нпр. "{{ body.data.chat_jid }}"; подразумева keyed), --session-id <id> (сесија кроз коју кружи окидач типа pinned; мора бити сесија овог пројекта), --session-access <private\|project\|members> (подразумевано private), --member <uuid> и --group <uuid> (могу се понављати; сваки подразумева members) и --filter <path=value> (може се понављати; сваки мора да се подудара, нпр. --filter body.type=push).

set прихвата све опције само за активне окидаче, као и --name, --prompt, --cron, --run-at, --timezone, --secret-env, --agent и --enabled true|false. --cron и --run-at су међусобно искључиви: подешавање једног поништава други. Поља монитора могу само да се додају.

Подсетници

Подсетник поново шаље упит једној сесији касније, једном или уз понављање. Чува се у бази података, а не у beeuni.yaml. Унутар сесије, --session подразумевано је $BEEUNI_SESSION_ID. Погледајте Подсетници.

Опције распореда: --in <duration> или --at <iso> (прво активирање; ако се задају самостално, активира једном), --every <duration> (понављање, минимум 5m), --cron "<expr>" са --timezone <tz>. Остале опције: --name <label>, --session <id> (довољан је јединствени префикс), --project <id>, --host <name>, --json.

Опције догађаја (--type event): --connector <slug> и --event <TYPE> (обе су обавезне), --config key=value (може се понављати, вредности су ниске) и --config-json '{...}' (типизоване вредности). set прихвата исте заставице. Окидач догађаја одбија --cron, --run-at, --timezone, --secret-env и опције монитора. Упит чита {{ event.data.<field> }}; погледајте Окидачи догађаја апликације.

Опције монитора (--type monitor): --run <cmd> (команда релативна у односу на репозиторијум коју треба надзирати; обавезно), --mode <poll\|stream> (обавезно; poll поново покреће команду на --interval, stream одржава команду активном), --interval <dur> (само mode=poll, минимум 30 s, нпр. 60s, 5m) и --expect-event-within <dur> (надзор тишине; ако се током временског интервала не догоди ниједан догађај, активира се догађај животног циклуса, минимум 5 min, нпр. 24h). Монитор је команда репозиторијума коју платформа покреће 24/7, а сваки ред стандардног излаза активира окидач. Ово је експериментално: платформа покреће мониторе само тамо где је укључена заставица функције monitors.

Приступ

CLI приказ јединствене табеле додељених дозвола. Сваки ред је додела: један субјект, једна улога, један опсег, опционо сужен на један објекат. Модел је описан у одељку Налози и приступ. Улоге налога: owner, admin, member. Улоге пројекта: manager, member.

Опције за доделу: --project <id> (подразумевано: повезани пројекат), --account (цео налог), --agent <name> (сужава доделу на једног агента — додела објекта), --connection <id> (сужава употребу једног дељеног налога конектора; прва додела ограничава налог на кориснике којима је додељен, а опозив последње поново га отвара за цео пројекат), --everyone (додељује свима који имају приступ пројекту; садржи --agent или --connection, никада улогу) и --expires <iso> (временска ознака аутоматског опозива). --principal филтрира листу и прихвата user:<id>, group:<id>, service_account:<id>, project:<id> или pending:<email>; голи ИД се тумачи као корисник. Додела свима се приказује као everyone. Идентитет агента је service_account, па се улога агенту додељује помоћу --service-account <id>. --user прихвата имејл адресу и проналази одговарајућег члана у именику чланова налога.

beeuni access grant --user alice@corp.com --role manager
beeuni access grant --user alice@corp.com --role admin --account
beeuni access grant --group 8f3c… --role member --project 1a2b…
beeuni access grant --user alice@corp.com --agent support-bot
beeuni access grant --everyone --agent support-bot
beeuni access grant --group 8f3c… --connection 2b7e…
beeuni access revoke 4d5e…

Глаголи за чланове пројекта представљају модел за читање истих додела:

За сваку команду у ова два блока потребно је project.members.manage.

Особа, група или агент добија улоге од Beeuni; агент уз то има Beeuni дозволе у beeuni.yaml, а сесија може да ради само оно што обе дозвољавају. Погледајте Један речник, два повезивања.

Ревизија

Команде за ревизију читају централизовани дневник реконструкције. Листе налога и пројеката приказују се од најновијих ка најстаријим. Временска линија сесије је поређана по времену креирања (session_sequence је подешено само у редовима уписаним пре 2026-10; ти редови се приказују први). --all прати сваки курсор за наставак. ls приказује последњих 90 дана; export сеже 365 дана уназад, а догађаји старији од 90 дана долазе из архиве (погледајте Чување ревизијских података). Табела приказује наслов сваког реда (EVENT, на пример „Опозван кључ LLM мрежног пролаза“) поред његовог ACTION (gateway.key.revoke); --action филтрира по префиксу радње. Све радње и наслови: Радње у дневнику ревизије.

Веб-куке за ревизију шаљу записе у SIEM систем. За сваку команду је потребно account.write; за add и enable потребно је и пословно право коришћења. disable и rm никада га не захтевају.

Филтери: --actor, --actor-type, --project, --session, --source, --phase, --outcome, --action, --resource-type, --request-id, --correlation-id, --query, --since, --until, --cursor и --limit. За листе налога и извозе потребни су audit.read и право коришћења auditAccess за налог. За листе целог пројекта потребан је project.members.manage јер могу да садрже метаподатке приватних сесија. За реконструкцију сесије потребни су project.session.read и видљивост те сесије.

Улоге

Улога је именовани скуп дозвола. Системске улоге (owner, admin, member на нивоу налога; manager, member на нивоу пројекта; уз то и agent-user, ознака коју носи додела објекта) су референце само за читање. Можете да креирате и уређујете прилагођене улоге; за то је потребно пословно право коришћења rbac.

Повежите улогу са субјектом помоћу beeuni access grant. Старије команде beeuni roles assign / unassign / assignments и даље раде и уписују исту табелу, али beeuni access је документовани начин. beeuni roles actions је замењен командом beeuni permissions ls.

Прилагођена улога само додаје дозволе. Beeuni нема правило забране, па улога не може да ускрати дозволу менаџеру.

Дозволе

Каталог дозвола у облику података. Сваки ред представља једну крајњу радњу и садржи опсег у ком се о њој одлучује, да ли може да се делегира и шта подразумева. Улоге се праве од ових кључева — beeuni roles create --actions и beeuni roles set-actions прихватају искључиво њих. Алијас: beeuni perms.

Доделе

Додељује један објекат пројекта субјекту — додела објекта. Тајне и конектори припадају агентима, па додела агента особи даје приступ свему што тај агент декларише. Агент је подразумевано затворен: члан може да му приступи само ако га додела именује или наведе неку његову групу. beeuni access grant --agent <name> уписује исти ред.

Провера манифеста

Погледајте Референцу за манифест.

Величина репозиторијума

Сесија прави конфигурацију агента од свих датотека које Git прати у основном комиту. Нова сесија преузима те датотеке из сопствене радне копије, без обзира на величину. Покренута сесија добија промену основне гране преко снимка пројекта, који Beeuni cloud прави до величине од 512 MiB након компресије; ако је већи, сесија задржава конфигурацију коју користи све док се не покрене нова сесија. Свака сесија такође преузима сваку датотеку. beeuni validate броји датотеке које Git складишти, као и датотеке које нису праћене, а које ће beeuni ship следеће унети у Git, и приказује упозорење ако једна датотека има 10 MiB или више, или ако укупна величина прелази 512 MiB. Git LFS датотека се рачуна као њен показивач, јер издање садржи само показивач. Упозорење наводи највеће датотеке. Команда се никада не прекида због тога.

Да бисте уклонили упозорење:

• Преместите велике статичке ресурсе (видео-записе, слике, скупове података, тежине модела) у складиште објеката као што су S3, R2 или GCS, или на CDN, па их преузимајте током извршавања.
• Додајте излазне датотеке изградње (dist/, out/) у .gitignore.
• За путању која мора да остане у Git-у, али је ниједан агент не чита, додајте <path> export-ignore у .gitattributes. Издање је изоставља, као и провера; правило за директоријум обухвата све у њему. Директоријум конфигурације агента и beeuni.yaml се увек испоручују у целости.

Опсег токена

Сваки токен почиње са beeuni_pat_. Кориснички токен важи за све пројекте на вашим налозима. Токен пројекта важи за један пројекат и аутоматски се уноси у окружења тог пројекта. Погледајте комплетан преглед породица токена у одељку Извршавање сесије.

Излазни кодови