logo
Entwicklung
Suchen
Werkzeugverwaltung

Werkzeugverwaltung

Überblick

Tools (Werkzeuge) sind die „Hände und Füße“, mit denen ein Agent Aktionen ausführt. Die App wird mit einer Reihe integrierter Werkzeuge ausgeliefert (Dateioperationen, Befehlsausführung, Browser, …) und lässt sich mit Werkzeugen aus dem Market (MCP-Server, API-Werkzeuge), von Ihrer Organisation veröffentlichten Enterprise-Werkzeugen und selbst hinzugefügten Personal-Werkzeugen erweitern.

Werkzeuge werden an zwei Stellen verwaltet:

Wo Was Sie dort tun
Linke Navigation → Tools & Skills → Tab Tools Werkzeuge aus den Quellen Market, Enterprise oder Personal installieren / entfernen
Settings → Tool Level Die Berechtigungsstufe (P0 / P1 / P2) jedes Werkzeugs festlegen, einschließlich der integrierten

Tab Tools der Seite Tools & Skills


Integrierte Werkzeuge

Integrierte Werkzeuge sind immer vorhanden und werden auf der Seite Tool Level mit dem Badge Built-in aufgeführt. Repräsentative Beispiele:

Dateioperationen

Werkzeug Funktion Standardstufe
Read file Liest Dateiinhalte von einem Pfad; unterstützt relative und absolute Pfade P0 Auto (gesperrt)
Write file Schreibt Inhalte an einen Pfad und erstellt die Datei (und übergeordnete Verzeichnisse) bei Bedarf P1 Standard
Append to file Hängt an das Ende einer bestehenden Datei an und erstellt sie bei Bedarf; überschreibt nie P0 Auto
Browse folder Listet Dateien und Unterverzeichnisse mit Größen auf; dient zum Durchsuchen der Projektstruktur P0 Auto (gesperrt)
Find files Schnelles Auffinden von Dateien nach Namensmuster (Glob), z. B. **/*.ts P0 Auto (gesperrt)
Search in files Durchsucht Dateiinhalte P0 Auto (gesperrt)

Ausführung und Browser

Werkzeug Funktion Standardstufe
Run command Führt Shell-Befehle aus: Skripte, Paketinstallation, Git-Operationen P1 Standard
Browser Surft im isolierten Browserprofil dieses Geräts: Seiten lesen, klicken, tippen P1 Standard (gesperrt)

Weitere integrierte Werkzeuge decken Aufgabenverwaltung, Subagenten-Delegation, Gedächtnisabfrage und -verwaltung sowie Konversationssuche ab. Öffnen Sie Settings → Tool Level für die vollständige Liste Ihrer Version.


Werkzeugstufen

Jedes Werkzeug hat eine Berechtigungsstufe, die bestimmt, wie oft eine Aufgabe für Ihre Bestätigung anhält:

Stufe Name Verhalten
P0 Auto Wird stillschweigend ausgeführt, keine Bestätigung
P1 Standard Eine Berechtigungskarte wird angezeigt; Sie können Always Allow wählen, damit dieselbe Art von Aktion nicht erneut abgefragt wird
P2 High-Risk Eine Berechtigungskarte wird bei jedem Aufruf angezeigt; „Always Allow“ ist deaktiviert
🔒 Gesperrt — Die Stufe ist fest (durch das System oder die Sicherheits-Leitplanken Ihrer Organisation) und kann hier nicht geändert werden

Ändern Sie Stufen unter Settings → Tool Level. Jede Zeile zeigt das Werkzeug, seine Quelle (Built-in, Name des installierten Werkzeugs) und drei Stufenschaltflächen; verwenden Sie die Filter All levels / All sources und das Suchfeld, um ein Werkzeug zu finden. Shell-Befehle mit Hochrisiko-Anweisungen (rm -rf, sudo, dd, …) werden unabhängig von der konfigurierten Stufe zwangsweise auf P2 hochgestuft.

Administratoren legen die Organisations-Untergrenze in den Sicherheits-Leitplanken fest; Einzelpersonen können ein Werkzeug in der App nur strenger, nie lockerer einstellen.


Tool Market

Der Tab Tools der Seite Tools & Skills listet Werkzeuge nach Kategorie (Efficiency, Communication, Development, …). Jede Karte zeigt den Werkzeugnamen, die Anzahl der bereitgestellten Actions und eine Schaltfläche + zum Installieren. Beispiele, die derzeit im Market sind:

Kategorie Beispiele
Efficiency Microsoft 365, Notion, Google Calendar, Google Sheets, Google Docs, Gmail, MCPs für Bild- / Videogenerierung
Communication Lark (Feishu), DingTalk, YouTube MCP, MCPs für Videogenerierung
Development TAPD, code-interpreter MCP, Langchain MCP, Code Runner MCP, Microsoft Learn MCP, Docfork MCP, Context7 MCP

Klicken Sie oben rechts auf Installed, um die bereits installierten Werkzeuge anzuzeigen und zu verwalten.

Unternehmens- und persönliche Werkzeuge

Tab Beschreibung
Enterprise Von Ihrem Workspace-Administrator über Unternehmensressourcen veröffentlichte Werkzeuge; sie sind pro Organisation isoliert
Personal Werkzeuge, die Sie selbst hinzufügen — MCP-Server oder API-Werkzeuge (OpenAPI)

MCP-Werkzeuge

MCP (Model Context Protocol) ist ein standardisiertes Protokoll, das es dem Agenten ermöglicht, externe Dienste als Werkzeuge zu verwenden. Ein MCP-Server kann sein:

Transport Beschreibung Anwendungsszenario
stdio Lokaler Unterprozess (Befehl + Argumente) Lokale CLI-Werkzeuge
SSE / HTTP Entfernter Server, erreichbar über HTTP Entfernte Dienste

Zu den Authentifizierungsoptionen gehören keine, Bearer-Token, HTTP Basic, Service-zu-Service und OAuth2.

Nachdem ein Server hinzugefügt wurde, verbindet sich die App mit ihm und erkennt die bereitgestellten Werkzeuge (Actions); diese erscheinen dann in der Liste der installierten Werkzeuge und auf der Seite Tool Level.

Sicherheit: MCP-Unterprozesse erhalten nur Umgebungsvariablen von der Positivliste. Wenn ein MCP-Werkzeug einen API-Schlüssel benötigt, deklarieren Sie ihn explizit in der Umgebungskonfiguration des Servers.


API-Werkzeuge

Werkzeuge können auch aus einer OpenAPI- / Swagger-Definition erstellt werden:

Funktion Beschreibung
Automatisches Parsen Extrahiert Endpunkte und Parameterschemata aus der Spezifikation
Authentifizierung Dieselben Optionen wie bei MCP
Vorlagenvariablen Dynamische Ersetzung von {{variable}}
HTTP-Methoden GET / POST / PUT / DELETE / PATCH

Häufige Szenarien der Werkzeugnutzung

Beispielhafte Benutzeranfrage Vom Agenten aufgerufenes Werkzeug
„Zeig mir den Inhalt von package.json“ Read file
„Erstelle eine README.md“ Write file (P1 — Berechtigungskarte)
„Welche .tsx-Dateien gibt es im Projekt?“ Find files
„Wo wird useEffect im Code verwendet?“ Search in files
„Führe npm install für mich aus“ Run command (P1 — Berechtigungskarte)
„Öffne diese Seite und fasse sie zusammen: https://…“ Browser
„Erstelle einen Termin in meinem Google Kalender“ Google Calendar (installiertes Market-Werkzeug)

Anleitung: Ein Werkzeug aus dem Market installieren

  1. Linke Navigation → Tools & Skills → Tab Tools
  2. Suchen Sie das Werkzeug (Suchfeld oder Kategorie) und klicken Sie auf +
  3. Schließen Sie die vom Werkzeug geforderte Anmeldung oder Schlüsselkonfiguration ab
  4. Das Werkzeug und seine Actions sind nun verfügbar; seine Berechtigungsstufe kann unter Settings → Tool Level angepasst werden

Auswirkung des Entfernens eines Werkzeugs

Nachdem ein Werkzeug entfernt wurde, weiß der Agent überhaupt nicht mehr, dass dieses Werkzeug existiert. Integrierte Werkzeuge können nicht entfernt werden, aber eine strenge Stufe (P2) bedeutet, dass Sie jede Verwendung bestätigen.

Empfehlung: Belassen Sie Run command und Write file auf P1 oder strenger, sofern Sie der Umgebung nicht vollständig vertrauen; die Sicherheitsbasislinie des Systems erzwingt zusätzlich eine manuelle Bestätigung vor jedem Löschvorgang.


FAQ

Der Agent fragt ständig nach Berechtigungen

Das Werkzeug ist auf P1, und Sie haben bisher auf Allow (einmalig) geklickt. Klicken Sie auf der Berechtigungskarte auf Always Allow oder senken Sie die Stufe unter Tool Level, wenn die Organisation dies erlaubt. Von Ihnen erteilte Freigaben erscheinen unter Settings → Authorization records, wo sie entfernt werden können.

Verbindungsfehler bei MCP-Werkzeugen

  1. Prüfen Sie, ob Befehl / URL des Servers korrekt sind
  2. Bei stdio prüfen Sie, ob der Befehl installiert ist (z. B. erfordert npx Node.js)
  3. Prüfen Sie, ob Umgebungsvariablen (z. B. ein API-Schlüssel) erforderlich sind
  4. Prüfen Sie die Anwendungsprotokolle (Settings → About → Protokollordner öffnen / Protokolle exportieren)

Der Agent verwendet nicht das erwartete Werkzeug

Der Agent wählt Werkzeuge eigenständig anhand der Aufgabenanforderungen aus. Geben Sie in der Konversation explizite Anweisungen: „Bitte verwende das Werkzeug Run command, um dies auszuführen.“


Verwandte Dokumente