Werkzeugverwaltung

Überblick

Werkzeuge sind die „Hände und Füße", mit denen der Agent Aktionen ausführt. Das System stellt 19 integrierte Werkzeuge bereit und unterstützt die Erweiterung des Werkzeugsatzes über das MCP-Protokoll, OpenAPI-Definitionen und Skills. Die Seite zur Werkzeugverwaltung dient zum Konfigurieren und Verwalten aller verfügbaren Werkzeuge.

19 integrierte Werkzeuge

Dateioperationen (7 Werkzeuge)

Befehlsausführung (1 Werkzeug)

Netzwerk (1 Werkzeug)

Aufgabenverwaltung (1 Werkzeug)

Skill-Aufruf (1 Werkzeug)

Benutzerinteraktion (1 Werkzeug)

Subagenten (3 Werkzeuge)

Gedächtnis (4 Werkzeuge)

Erläuterung der Sicherheitsstufen

Administratoren können in den Sicherheits-Leitplanken die Berechtigungsstufe nicht gesperrter Werkzeuge anpassen (organisationsweite Untergrenze), und einzelne Benutzer können sie zur Laufzeit in der App-Sicherheit weiter verschärfen.

MCP-Werkzeugprotokoll

MCP (Model Context Protocol) ist ein standardisiertes Kommunikationsprotokoll für KI-Werkzeuge, das die Erweiterung des Werkzeugsatzes über externe Dienste unterstützt.

Drei Übertragungsarten

Fünf Authentifizierungsmodi

MCP-Verwaltungsoberfläche

MCP-Server werden über die Komponente McpManager verwaltet:

• Server hinzufügen: Konfiguration von Name, Übertragungsart, Verbindungsparametern und Authentifizierungsmethode
• Bearbeiten/Löschen: Bestehende Konfigurationen ändern oder entfernen
• Aktivieren/Deaktivieren: Verfügbarkeitsstatus des Servers umschalten
• Werkzeugerkennung: Nach dem Verbinden werden die vom Server bereitgestellten Werkzeuge automatisch erkannt

Sicherheitsisolierung

Der MCP-Subprozess übergibt nur Umgebungsvariablen von der Whitelist, um das Durchsickern sensibler Informationen wie API-Keys zu verhindern.

API-Werkzeuge

Unterstützt das automatische Parsen und Erstellen von Werkzeugen aus OpenAPI/Swagger-Dokumenten:

Verzeichnis für benutzerdefinierte Werkzeuge NEU

Das System bringt einen neuen ToolDirectoryManager — er verwaltet die benutzerdefinierten Werkzeuge im Verzeichnis {dataDir}/TOOLs/{orgId}/_custom/ und lädt sie ohne Neustart der App.

Verzeichnisstruktur

                      
                      {dataDir}/TOOLs/{orgId}/_custom/
├── my-tool-1/
│   ├── metadata.json
│   └── ...
└── my-tool-2/
    ├── metadata.json
    └── ...

                    

Beispiel für metadata.json

                      
                      {
  "id": "my-tool-1",
  "name": "My Custom Tool",
  "description": "自定义工具说明",
  "type": "API",
  "enabled": true,
  "createdAt": 1776921208476,
  "updatedAt": 1776921208476
}

                    

Lademechanismus

• Scan-Methode: scanAndLoad(orgId)
• Typunterstützung: API / MCP
• Organisationsisolierung: getrennte Verzeichnisse pro orgId, keine gegenseitige Beeinträchtigung
• Hot-Loading: kein Neustart der App erforderlich

Werkzeug-Ladepipeline

Alle Werkzeuge werden in der folgenden Reihenfolge geladen und zusammengeführt:

                      
                      ① Integrierte Werkzeuge (19 Stück)
    ↓
② MCP-Werkzeuge (von den konfigurierten MCP-Servern erkannt)
    ↓
③ API-Werkzeuge (aus OpenAPI-Definitionen geparst)
    ↓
④ Benutzerdefinierte Werkzeuge (ToolDirectoryManager scannt das Verzeichnis _custom/)
    ↓
⑤ Skill-Werkzeuge (aus aktivierten Skills wird execute_skill_{id} injiziert)
    ↓
⑥ Zusammenführen und Deduplizieren → endgültige Werkzeugliste → an das LLM gesendet

                    

Anwendungsfälle gängiger Werkzeuge

Anleitung: MCP-Werkzeug hinzufügen

1. Öffne App → Einstellungen → Werkzeuge → Bereich MCP-Werkzeuge
2. Klicke auf MCP-Server hinzufügen
3. Konfiguration ausfüllen:
   • Name: Vergib einen erkennbaren Namen für diesen MCP-Server
   • Übertragungsart: Wähle stdio / SSE / HTTP
   • Bei stdio: Trage den Befehl (z. B. npx) und die Argumente (z. B. @anthropic/mcp-server-filesystem) ein
   • Bei SSE/HTTP: Trage die Server-URL ein
4. Falls eine Authentifizierung erforderlich ist, wähle die Authentifizierungsmethode und trage die Anmeldedaten ein
5. Klicke auf Speichern
6. Das System verbindet sich automatisch mit dem Server und erkennt die verfügbaren Werkzeuge
7. Die erkannten Werkzeuge erscheinen in der Werkzeugliste und sind standardmäßig aktiviert

Tipp: Der MCP-Subprozess übergibt nur Umgebungsvariablen von der Whitelist. Wenn ein MCP-Werkzeug Umgebungsvariablen wie API-Keys benötigt, müssen diese im konfigurierten Feld env explizit deklariert werden.

Auswirkungen der Deaktivierung von Werkzeugen

Nach dem Deaktivieren eines Werkzeugs ist dem Agenten in der Konversation die Existenz dieses Werkzeugs völlig unbekannt. Das bedeutet:

Empfehlung: Sofern kein eindeutiger Sicherheitsgrund vorliegt, ist es nicht ratsam, die zentralen Dateioperationswerkzeuge (Read / Write / Edit / Glob / Search) zu deaktivieren, da sonst die Aufgabenausführungsfähigkeit des Agenten erheblich eingeschränkt wird.

Häufig gestellte Fragen

Der Agent sagt „Ich kann keine Dateioperationen ausführen"

Prüfe, ob die Dateioperationswerkzeuge (Read File, Write File, Edit usw.) deaktiviert sind. Stelle auf der Seite zur Werkzeugverwaltung sicher, dass diese Werkzeuge aktiviert sind.

MCP-Werkzeugverbindung schlägt fehl

1. Prüfe, ob der Befehl/die URL des MCP-Servers korrekt ist
2. Bei der stdio-Methode: Stelle sicher, dass der entsprechende Befehl installiert ist (z. B. benötigt npx eine Node.js-Umgebung)
3. Prüfe, ob Umgebungsvariablen (API-Keys usw.) erforderlich sind
4. Sieh im App-Log nach, um detaillierte Fehlerinformationen zu erhalten

Der Agent verwendet nicht das von mir erwartete Werkzeug

Der Agent wählt Werkzeuge eigenständig auf Basis der Aufgabenanforderungen aus. Wenn der Agent das „falsche" Werkzeug wählt, kannst du es in der Konversation ausdrücklich anweisen: „Bitte verwende das Bash-Werkzeug, um diesen Befehl auszuführen."

Verwandte Dokumente

• Skill-Verwaltung — Skill-System
• Laufzeitsicherheit — Konfiguration von Werkzeugberechtigungen
• Sicherheits-Leitplanken — Unternehmensweite Verwaltung von Werkzeugberechtigungen