Окружења за агенте
Сесија покреће једно окружење за агенте, стандардни harness или експериментални harness. На овој страници је наведено како пројекат бира једно од њих и шта свако од њих подржава.
Харнес је окружење за извршавање агента унутар изолованог окружења сесије. Покреће циклус модела, позива алате и прави транскрипт. Beeuni има два: стандардни harness (подразумевани) и експериментални harness. Сесија покреће тачно један.
Оба харнеса читају исти пројекат: beeuni.yaml, агентске датотеке у
agents/, вештине у skills/, коренски AGENTS.md и memory/. Клијенти (веб, CLI, TUI, мобилна апликација, SDK) читају оба преко истог API-ја сесија.
Разликују се по функцијама сесије у
матрици испод и датотекама које сваки харнес чита за сопствену конфигурацију.
Како сесија бира харнес
Beeuni одлучује када се сесија покреће, поново покреће или наставља. Покренута сесија задржава свој харнес до тада.
| Правило, редом | Харнес |
|---|---|
Заставица llm_gateway пројекта је искључена |
стандардни harness |
Заставица pi_harness пројекта је укључена |
експериментални harness |
beeuni.yaml поставља runtime: pi |
експериментални harness |
| Све остало | стандардни harness |
- експериментални harness позива моделе само преко Beeuni LLM мрежног пролаза. Пројекат са искљученим
llm_gatewayпокреће стандардни harness, без обзира на то шта кажу заставица или манифест. Погледајте Модели. runtimeје кључ манифестаbeeuni_version: 2. Наслеђени пројекатbeeuni.tomlне може да га постави. Погледајте референцу манифеста.pi_harnessје заставица функције за сваки пројекат, подразумевано искључена. Погледајте Заставице функција.
Да бисте видели који харнес сесија покреће, прочитајте harness.id у одговору GET /beeuni/health демона песковника: opencode или pi.
Шта сваки харнес подржава
Харнес наводи опционе функције сесије које пружа у низу capabilities у GET /beeuni/health.
Клијент скрива контролу када у capabilities сесије недостаје њен ID. Провера у SDK-у је
runtimeSupports.
Оба харнеса
| Функција | стандардни harness | експериментални harness |
|---|---|---|
| Размене порука, стримовање, заустављање | Да | Да |
Агент .md: упит, model, variant, mode, permission, temperature, top_p, steps |
Да | Да. експериментални harness не примењује options (опције добављача). |
Приступ алатима по агенту (agents.<name>.tools у beeuni.yaml: all, none, листа, exclude) |
Да | Да |
Правила permission по агенту и захтеви за дозволу |
Да | Да |
Питања (алат question) |
Да | Да |
Коренска датотека правила AGENTS.md пројекта или CLAUDE.md ако корен нема AGENTS.md |
Да. стандардни harness такође чита датотеку у надређеним директоријумима директоријума /workspace и чита /workspace док примењује издање конфигурације. |
Да, само коренску датотеку. Она је део системског упита сесије и сваког подагента. Када су издања конфигурације укључена, експериментални harness чита копију издања. |
Подагенти (алат task), session.subagents |
Да | Да: general, explore (само за читање) и сваки агент пројекта са mode: subagent или all. Подагент не може да покрене други подагент. |
Вештине (skills/ и управљане вештине beeuni-*), уз дозволу skills агента |
Да. Агент учитава вештину алатом skill. |
Да. Системски упит наводи сваку одобрену вештину; агент чита датотеку. |
Beeuni алати: web_search, image_search, scrape_webpage, memory, show. Свих пет ако у beeuni.yaml нема кључа tools:; ако га има, они које он наводи као beeuni:<name> |
Да | Да |
Алати пројекта (tools: у beeuni.yaml) |
Да | Да |
Издања конфигурације, config.release.v1 |
Да | Да |
Сажимање (резимирање) разговора на захтев и аутоматски када се приближи прозору контекста модела, session.compact |
Да | Да. Ако захтев моделу премаши прозор, разговор се сажима и захтев се једном поново шаље. |
Команде пројекта са косом цртом, session.commands |
Да, из commands/ у директоријуму конфигурације стандардни harness-а. |
Да, из шаблона упита у prompts/ у директоријуму конфигурације експериментални harness-ја и у пакетима експериментални harness-ја. експериментални harness не чита commands/ стандардни harness-а. |
| Терминал у песковнику (PTY) | Да | Да |
Алати bash, read, write, edit, glob, grep; тајне у љусци; CLI beeuni |
Да | Да |
Beeuni алати и алати пројекта су независни од харнеса:
демон песковника покреће по један модул за сваки алат у оба харнеса, са истим
називима, аргументима и излазом. експериментални harness их позива у процесу демона; стандардни harness
их позива преко додатка који демон уписује. Оба харнеса добијају исту листу: Beeuni алат који кључ tools: пројекта не наводи није доступан ни у једном. Пројекат који још има копије Beeuni алата у harnesses/opencode/tools/ задржава те копије у стандардни harness-у док их не избрише.
Веб алати користе кључеве дозвола websearch (web_search, image_search) и webfetch (scrape_webpage) у оба харнеса. У стандардни harness-у ови алати не могу да затраже дозволу: правило ask их одбија. У експериментални harness-ју правило ask покреће захтев за дозволу. У експериментални harness-ју команда memory која мења датотеку прати edit, а view прати read; у стандардни harness-у алат контролише само правило memory.
AGENTS.md у експериментални harness-ју
експериментални harness додаје коренски AGENTS.md пројекта у системски упит као један одељак,
<project_instructions path="AGENTS.md">, после упита агента. Ако корен нема AGENTS.md, уместо тога се користи CLAUDE.md, као у стандардни harness-у. експериментални harness не чита ниједан AGENTS.md у поддиректоријуму или надређеном директоријуму.
- Извор. Када су издања конфигурације искључена, експериментални harness чита
/workspace/AGENTS.md. Када су укључена, експериментални harness чита копију из издања, а никада ону у/workspace: измена у/workspaceстиже до сесије након што се споји у основну грану. Када су укључена, али нема издања за послуживање (config.source: image-default), експериментални harness не чита ниједанAGENTS.md, као што не чита ниједну вештину пројекта. - Када. експериментални harness чита датотеку при покретању окружења за извршавање, поновном учитавању конфигурације (ново издање,
/beeuni/envpush) и након освежавања спремишта. Не чита је пре сваке размене. Ново издање стиже у наредну размену без поновног покретања; размена која је у току задржава стару датотеку. - Прескакање. Празна датотека, датотека која није обична датотека и симболичка веза која води ван спремишта не додају ништа. За последња два случаја у евиденцију демона уписује се једно упозорење.
- Провера.
harness.details.agentsMdуGET /beeuni/healthдемона наводи датотеку коју је експериментални harness учитао:source(releaseилиworkspace),path,bytesиsha(првих 12 хексадецималних знакова њеног sha256). Вредност јеnullкада експериментални harness није учитао ниједну.
За сада само стандардни harness
| Функција | Могућност | стандардни harness | експериментални harness |
|---|---|---|---|
| Враћање на поруку и њено обнављање. Измена и поновно слање користе враћање уназад. | session.rewind |
Да | Не |
MCP сервери (mcp у opencode.jsonc) |
session.mcp |
Да | Не постоји MCP клијент. Конектори раде у оба харнеса преко CLI-ја beeuni connectors. |
Листа задатака (алат todowrite) и картица плана |
session.todo |
Да | Не. Картица плана остаје празна. |
Повезивање сопственог клијента терминала харнеса (beeuni connect, TUI Alt+o) |
session.attach |
Да | Не. Погледајте TUI. |
Документ конфигурације окружења за извршавање (/global/config) |
session.config |
Да | Не. Агенти и модели долазе из пројекта у оба харнеса. |
| Рачвање сесије на поруци | session.fork |
Да | Не |
| Команда љуске покренута као размена | session.shell |
Да | Не |
| Добављачи модела без LLM мрежног пролаза | — | Да | Не. експериментални harness захтева укључен llm_gateway. |
експериментални harness сесија на захтев за функцију коју не пружа одговара са
501 feature_not_supported, или са 404 ако нема тражени документ
(/global/config). Не игнорише захтев.
Датотеке конфигурације харнеса
Сваки харнес има један директоријум за датотеке које чита само тај харнес.
| стандардни harness | експериментални harness | |
|---|---|---|
| Директоријум | harnesses/opencode/ или opencode.config_dir |
harnesses/pi/ или pi.config_dir |
| Наслеђени директоријум | .beeuni/opencode/ |
.beeuni/pi/ |
| Садржај | opencode.jsonc, plugins/, tools/, commands/ |
settings.json, extensions/, skills/, prompts/ |
| Проширења | Додаци и алати само за стандардни harness у том директоријуму | експериментални harness пакети у harnesses.pi.packages и датотеке проширења у extensions/ |
експериментални harness сесија не чита opencode.jsonc, plugins/, tools/ нити commands/. стандардни harness сесија не чита директоријум експериментални harness-ја. Алат који су потребан оба харнеса је алат пројекта, наведен у beeuni.yaml, а не датотека у неком од тих директоријума.
експериментални harness пакети долазе са packages. Пакет може да дода алате које експериментални harness нема, на пример MCP адаптер или алат за задатке. Beeuni учитава пакет, али не тестира пакете трећих страна.