Pinataas na Mode (/elevated mga direktiba)¶
Ano ang ginagawa nito¶
/elevated onay tumatakbo sa host ng Gateway at pinananatili ang mga approval ng exec (kapareho ng/elevated ask)./elevated fullay tumatakbo sa host ng Gateway at awtomatikong ina-approve ang exec (nilalaktawan ang mga approval ng exec)./elevated askay tumatakbo sa host ng Gateway ngunit pinananatili ang mga approval ng exec (kapareho ng/elevated on).on/askay hindi pinipilit angexec.security=full; umiiral pa rin ang naka-configure na security/ask policy.- Binabago lamang ang pag-uugali kapag ang agent ay sandboxed (kung hindi, ang exec ay tumatakbo na sa host).
- Mga anyo ng direktiba:
/elevated on|off|ask|full,/elev on|off|ask|full. - Tanging
on|off|ask|fulllamang ang tinatanggap; anumang iba pa ay magbabalik ng hint at hindi magbabago ng estado.
Ano ang kinokontrol nito (at ano ang hindi)¶
- Mga panuntunan sa availability:
tools.elevatedang pandaigdigang baseline. Maaaring higit pang higpitan ngagents.list[].tools.elevatedang elevated bawat agent (parehong dapat pumayag). - Per-session state: Itinatakda ng
/elevated on|off|ask|fullang antas ng elevated para sa kasalukuyang session key. - Inline directive: Ang
/elevated on|ask|fullsa loob ng isang mensahe ay nalalapat lamang sa mensaheng iyon. -
- Mga Grupo: Sa mga group chat, ang mga elevated directive ay sinusunod lamang kapag nabanggit ang agent. Command-only messages that bypass mention requirements are treated as mentioned.
- Host execution: Pinipilit ng elevated ang
execpapunta sa host ng Gateway; itinatakda rin ngfullangsecurity=full. - Mga approval: Nilalaktawan ng
fullang mga approval ng exec; iginagalang ngon/askang mga ito kapag hinihingi ng mga patakaran ng allowlist/ask. - Mga unsandboxed na agent: no-op para sa lokasyon; naaapektuhan lamang ang gating, logging, at status.
- Umiiral pa rin ang tool policy: kung ang
execay tinanggihan ng tool policy, hindi maaaring gamitin ang elevated. - Hiwalay sa
/exec: Ina-adjust ng/execang mga per-session default para sa mga awtorisadong sender at hindi nangangailangan ng elevated.
Pagkakasunod-sunod ng resolusyon¶
- Inline directive sa mensahe (nalalapat lamang sa mensaheng iyon).
- Session override (itinakda sa pamamagitan ng pagpapadala ng direktiba-only na mensahe).
- Global default (
agents.defaults.elevatedDefaultsa config).
Pagtatakda ng session default¶
-
- Magpadala ng mensaheng tanging ang directive lamang (pinapayagan ang whitespace), hal.
/elevated full.
- Magpadala ng mensaheng tanging ang directive lamang (pinapayagan ang whitespace), hal.
- Ipapadala ang kumpirmasyon na tugon (
Elevated mode set to full.../Elevated mode disabled.). - Kung naka-disable ang elevated access o wala ang sender sa naaprubahang allowlist, ang direktiba ay sasagot ng actionable na error at hindi babaguhin ang estado ng session.
- Ipadala ang
/elevated(o/elevated:) na walang argumento upang makita ang kasalukuyang antas ng elevated.
Availability + mga allowlist¶
- Feature gate:
tools.elevated.enabled(maaaring naka-off ang default sa pamamagitan ng config kahit suportado ito ng code). - Sender allowlist:
tools.elevated.allowFromna may per-provider na mga allowlist (hal.discord,whatsapp). - Per-agent gate:
agents.list[].tools.elevated.enabled(opsyonal; maaari lamang pang higpitan). - Per-agent allowlist:
agents.list[].tools.elevated.allowFrom(opsyonal; kapag itinakda, dapat tumugma ang sender sa parehong global + per-agent allowlists). - Discord fallback: if
tools.elevated.allowFrom.discordis omitted, thechannels.discord.dm.allowFromlist is used as a fallback. Settools.elevated.allowFrom.discord(even[]) to override. Per-agent allowlists do not use the fallback. - Lahat ng gate ay dapat pumasa; kung hindi, ituturing na hindi available ang elevated.
Pagla-log + katayuan¶
- Ang mga elevated exec call ay nilolog sa antas na info.
- Kasama sa session status ang elevated mode (hal.
elevated=ask,elevated=full).