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

Агент је markdown датотека која одређује како се хернес понаша у
[сесији](/docs/sr/work/sessions). Ова страница обухвата датотеке агената, вештине и
начин на који сесија бира агента.

<a id="a-harness-runs-every-session"></a>

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

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

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

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

<a id="an-agent-is-two-files"></a>

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

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

- **Понашање** — markdown датотека, подразумевано `agents/<name>.md`. Њен
  frontmatter подешава модел, режим и правила дозвола. Њено тело је
  системски упит.
- **Управљање** — унос у мапи `agents` система `beeuni.yaml`, са кључем који је име агента. Он одређује чему агент може да приступи: конекторима, тајнама, вештинама, апликацијама, Beeuni дозволама и [алаткама](/docs/sr/project/tools#who-may-use-which-tool).
  Његово поље `file` наводи датотеку понашања.
  Мапа може да се налази у датотеци коју манифест наводи под
  [`imports:`](/docs/sr/project/manifest#imports); `default_agent` остаје у `beeuni.yaml`.

Манифест никада не подешава упит или режим. Датотека `.md` никада не подешава приступ платформи. Погледајте [референцу манифеста](/docs/sr/project/manifest) за
сва поља управљања.

<a id="where-the-agent-file-lives"></a>

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

```yaml
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-у.

Комплетна правила за путање налазе се у
[референци манифеста](/docs/sr/project/manifest#the-agent-file).

<a id="governance-is-deny-by-default"></a>

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

Агент без кључа `connectors`, `secrets`, `skills`, `apps` или `beeuni_permissions` нема ниједан од тих приступа. `apps` наводи [Beeuni апликације](/docs/sr/feature-flags/apps#agents-and-apps)
које агент може да отвори када је апликација ограничена или приватна. Ова додела је друга од два повезивања: агент такође има улогу као `service_account` принципал — то је његов горњи лимит — а сесија може да уради само оно што оба дозвољавају. Погледајте
[Дозволе агента](/docs/sr/project/permissions) и
[Један речник, два повезивања](/docs/sr/accounts#one-vocabulary-two-bindings). Подесите поље на `all` да бисте доделили пун приступ или наведите конкретна имена. `default_agent` у `beeuni.yaml` наводи агента који сесија покреће када не затражите агента.

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

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

<a id="skills-give-an-agent-know-how"></a>

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

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

<a id="how-a-session-picks-its-agent"></a>

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

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

Агент делује у своје име: са својим Beeuni дозволама унутар своје улоге са горњим лимитом,
без обзира на то ко га покреће. Покретање сесије не позајмљује агенту вашу сопствену улогу.
Погледајте [Дозволе агента](/docs/sr/project/permissions).

Нови или измењени агенти и вештине доступни су будућим сесијама тек након што их
[захтев за промену](/docs/sr/work/change-requests) споји у подразумевану
грану. Повежите спољне алатке пре него што агент може да их користи; погледајте
[Конекторе](/docs/sr/connect/connectors).