Kisyntra/Agent_Sudo

Was macht Agent_Sudo?

Lokale Berechtigungs-Gateway für KI-Agenten mit Genehmigungen, Delegation, Audit-Protokollierung und MCP-Integration.

Übersicht

Agent_Sudo bietet eine zentrale, lokale Sicherheitsschicht für KI-Agenten. Es ermöglicht, den Zugriff auf kritische Systemaktionen (z. B. Dateioperationen, Netzwerkzugriffe, Befehlsausführung) zu kontrollieren. Statt jedem Agenten Vollzugriff zu gewähren, definieren Sie Berechtigungsstufen, die mit menschlichen Genehmigungen oder automatisierten Delegationsregeln verknüpft sind.

Funktionen

• Genehmigungs-Workflow: Aktionen können explizit von einem menschlichen Benutzer genehmigt werden müssen.
• Delegation: Bestimmten Agenten oder in bestimmten Kontexten können Aktionen automatisch delegiert werden (z. B. basierend auf dem Kontext oder der Vertrauensstufe).
• Audit-Protokollierung: Jede angeforderte, genehmigte oder abgelehnte Aktion wird mit Zeitstempel, Agenten-ID und Kontext protokolliert.
• MCP-Integration: Nahtlose Anbindung an das Model Context Protocol, sodass Agenten über standardisierte Schnittstellen Berechtigungen anfragen und erhalten.

Verwendung

1. Installation (Beispiel):

   pip install agent-sudo
   

2. Konfiguration (Beispiel): Erstellen Sie eine agent_sudo.yml-Konfigurationsdatei:

   permissions:
     - action: "file:write"
       approval: required
     - action: "network:connect"
       approval: required
   delegation:
     - agent: "code-assistant"
       actions: ["file:read", "command:list"]
   audit:
     enabled: true
     path: "./agent_audit.log"
   mcp:
     enabled: true
     port: 8765
   

3. Integration in einen Agenten:

   from agent_sudo import AgentSudo
   
   sudo = AgentSudo()
   response = sudo.request_permission(action="file:write", context={"path": "/etc/config"})
   if response.approved:
       # Führen Sie die Aktion aus
       pass
   

Befehlszeilen-Schnittstelle (CLI)

Das Skill enthält auch ein sudo-ähnliches CLI-Tool:

# Genehmigung anfordern
agent-sudo request --action "file:delete" --path "/tmp/test"

# Protokolle anzeigen
agent-sudo logs --recent 10

Plattformkompatibilität

• Claude Code: Funktioniert mit dem claude_code-Tool, um Genehmigungen vor kritischen Aktionen zu erhalten.
• Cursor: Nahtlose Integration über das MCP-Protokoll.
• Codex: Unterstützt standardisierte Anfragen über MCP.

Lizenz

MIT-Lizenz. Weitere Informationen finden Sie in der LICENSE-Datei.