Агенти

Агент је Markdown датотека коју извршава session harness; манифест само управља његовим приступом.

Агент је markdown датотека која одређује како се хернес понаша у сесији. Ова страница обухвата датотеке агената, вештине и начин на који сесија бира агента.

Хернес покреће сваку сесију

Сесија покреће један хернес агента: стандардни harness (подразумевано) или експериментални harness. Хернеси наводе како пројекат бира један од њих и шта сваки подржава.

Оба читају агенте пројекта из agents/, а његове вештине из skills/. стандардни harness такође чита датотеке које само он користи из harnesses/opencode/. експериментални harness чита своје из harnesses/pi/.

Пројекти креирани пре 2026-09 чувају агенте и вештине у директоријуму .beeuni/opencode/. Beeuni чита оба распореда.

Агент се састоји од две датотеке

Сваки агент има два дела:

• Понашање — markdown датотека, подразумевано agents/<name>.md. Њен frontmatter подешава модел, режим и правила дозвола. Њено тело је системски упит.
• Управљање — унос у мапи agents система beeuni.yaml, са кључем који је име агента. Он одређује чему агент може да приступи: конекторима, тајнама, вештинама, апликацијама, Beeuni дозволама и алаткама. Његово поље file наводи датотеку понашања. Мапа може да се налази у датотеци коју манифест наводи под imports:; default_agent остаје у beeuni.yaml.

Манифест никада не подешава упит или режим. Датотека .md никада не подешава приступ платформи. Погледајте референцу манифеста за сва поља управљања.

Где се налази датотека агента

agents:
  support:
    file: agents/support.md

• file је путања релативна у односу на репозиторијум. Мора се завршавати са .md.
• Не сме почињати са /. Не сме садржати сегмент . или ...
• Без file, Beeuni чита agents/<name>.md, а затим .beeuni/opencode/agents/<name>.md.
• Када контролна табла сачува агента који има .md, уписује file са том путањом.
• API одбија промену file. Да бисте преместили агента, преместите његов .md и ажурирајте file у beeuni.yaml у истом commit-у.

Комплетна правила за путање налазе се у референци манифеста.

Управљање подразумевано одбија приступ

Агент без кључа connectors, secrets, skills, apps или beeuni_permissions нема ниједан од тих приступа. apps наводи Beeuni апликације које агент може да отвори када је апликација ограничена или приватна. Ова додела је друга од два повезивања: агент такође има улогу као service_account принципал — то је његов горњи лимит — а сесија може да уради само оно што оба дозвољавају. Погледајте Дозволе агента и Један речник, два повезивања. Подесите поље на all да бисте доделили пун приступ или наведите конкретна имена. default_agent у beeuni.yaml наводи агента који сесија покреће када не затражите агента.

Подесите сваку доделу на контролној табли — Customize → Agents → агент, по једна страница за сваки скуп додела на траци Access: Skills, Connectors, Secrets, Apps, Beeuni permissions — или из CLI-ја помоћу beeuni agents scope <agent> (--secrets, --connectors, --apps). Страница Apps се приказује само када пројекат има укључену заставицу функције Apps. Свака путања уписује исти блок agents.<name> у beeuni.yaml.

Застарели пројекти beeuni.toml (v1) наводе агенте у низу, а не у мапи, и подразумевано додељују пун приступ. Подесите конкретне доделе да бисте ограничили приступ. Погледајте референцу манифеста.

Вештине агенту дају знање

Вештина је markdown датотека на skills/<name>/SKILL.md. Хернес учитава вештину на захтев — Beeuni не убацује садржај вештине у сваки упит. На стандардни harness-у агент позива алатку skill. На експериментални harness-ју системски упит наводи назив и опис сваке вештине, а агент чита датотеку. Додела skills агента у beeuni.yaml одређује које вештине сме да учита.

Како сесија бира агента

Приликом креирања сесије прихвата се agent_name. Beeuni покреће тог агента за сесију. Ако изоставите agent_name, Beeuni користи default_agent пројекта. Подразумеваног агента подесите преко контролне табле, API-ја или SDK-а. Сваки од њих уписује default_agent у beeuni.yaml и шаље промену у подразумевану грану пројекта.

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

Нови или измењени агенти и вештине доступни су будућим сесијама тек након што их захтев за промену споји у подразумевану грану. Повежите спољне алатке пре него што агент може да их користи; погледајте Конекторе.