Skip to main content
Wenn ein Agent innerhalb einer Sandbox ausgeführt wird, sind seine exec-Befehle auf die Sandbox-Umgebung beschränkt. Im erweiterten Modus kann der Agent stattdessen die Sandbox verlassen und Befehle außerhalb der Sandbox ausführen, wobei konfigurierbare Genehmigungsschranken gelten.
Der erweiterte Modus ändert das Verhalten nur, wenn der Agent in einer Sandbox ausgeführt wird. Bei Agenten ohne Sandbox wird exec bereits auf dem Host ausgeführt.

​
Direktiven

Steuern Sie den erweiterten Modus sitzungsbezogen mit Slash-Befehlen: Auch als /elev on|off|ask|full verfügbar. Senden Sie /elevated ohne Argument, um die aktuelle Stufe anzuzeigen.

​
Funktionsweise

1

Verfügbarkeit prüfen

Elevated muss in der Konfiguration aktiviert sein und der Absender muss auf der Zulassungsliste stehen:
2

Stufe festlegen

Senden Sie eine Nachricht, die ausschließlich eine Direktive enthält, um den Sitzungsstandard festzulegen:
Oder verwenden Sie sie inline (gilt nur für diese Nachricht):
3

Befehle außerhalb der Sandbox ausführen

Wenn Elevated aktiv ist, verlassen exec-Aufrufe die Sandbox. Der effektive Host ist standardmäßig gateway oder node, wenn das konfigurierte bzw. sitzungsbezogene exec-Ziel node ist. Im Modus full werden exec-Genehmigungen übersprungen, wenn die aufgelöste Genehmigungsrichtlinie für exec- Modus/Host bereits vollständig permissiv ist (Sicherheit full, Abfrage off); andernfalls gilt weiterhin die normale Genehmigungsrichtlinie. Im Modus on/ask gelten die konfigurierten Genehmigungsregeln immer.

​
Auflösungsreihenfolge

  1. Inline-Direktive in der Nachricht (gilt nur für diese Nachricht)
  2. Sitzungsüberschreibung (wird durch Senden einer Nachricht festgelegt, die ausschließlich eine Direktive enthält)
  3. Globaler Standard (agents.defaults.elevatedDefault in der Konfiguration)

​
Verfügbarkeit und Zulassungslisten

  • Globale Schranke: tools.elevated.enabled (muss true sein)
  • Absender-Zulassungsliste: tools.elevated.allowFrom mit kanalspezifischen Listen
  • Agentenspezifische Schranke: agents.entries.*.tools.elevated.enabled (kann nur weiter einschränken; sowohl die globale als auch die agentenspezifische Schranke müssen true sein)
  • Agentenspezifische Zulassungsliste: agents.entries.*.tools.elevated.allowFrom (der Absender muss sowohl der globalen als auch der agentenspezifischen Liste entsprechen)
  • Vom Kanal bereitgestellte Fallback-Zulassungsliste: Kanal-Plugins können optional über einen SDK-Adapter-Hook eine Fallback-Zulassungsliste bereitstellen, die verwendet wird, wenn tools.elevated.allowFrom.<provider> nicht konfiguriert ist. Derzeit implementiert kein gebündelter Kanal diesen Hook, daher benötigt heute in der Praxis jeder Provider einen expliziten tools.elevated.allowFrom.<provider>-Eintrag.
  • Alle Schranken müssen passiert werden; andernfalls gilt Elevated als nicht verfügbar
Formate für Einträge in der Zulassungsliste:

​
Was Elevated nicht steuert

  • Tool-Richtlinie: Wenn exec durch die Tool-Richtlinie verweigert wird, kann Elevated dies nicht außer Kraft setzen.
  • Hostauswahlrichtlinie: Elevated macht auto nicht zu einer uneingeschränkten hostübergreifenden Überschreibung. Es verwendet die konfigurierten bzw. sitzungsbezogenen Regeln für das exec-Ziel und wählt node nur aus, wenn das Ziel bereits node ist.
  • Unabhängig von /exec: Die Direktive /exec passt für autorisierte Absender die sitzungsbezogenen exec-Standardwerte (Host, Sicherheit, Abfrage, Node) an und erfordert den erweiterten Modus nicht.
Der Bash-Chatbefehl (Präfix !; Alias /bash) ist eine separate Schranke, für die zusätzlich zu ihrem eigenen Flag tools.bash.enabled auch tools.elevated aktiviert sein muss. Durch das Deaktivieren von Elevated werden auch !-Shell-Befehle gesperrt.

​
Verwandte Themen

Exec-Tool

Ausführung von Shell-Befehlen durch den Agenten.

Exec-Genehmigungen

Genehmigungs- und Zulassungssystem für exec.

Sandboxing

Sandbox-Konfiguration auf Gateway-Ebene.

Sandbox, Tool-Richtlinie und Elevated im Vergleich

Wie die drei Schranken während eines Tool-Aufrufs zusammenwirken.