Zum Hauptinhalt springen

Werkzeuge

Die Werkzeuge-Seite (/admin/tools) ist die zentrale Werkzeug-Registrierung von BasePeak.AI. Hier verwalten Workspace-Administratoren den Katalog aller Werkzeuge, die Agenten zur Verfügung stehen. Nur Admin-Benutzer können auf diese Seite zugreifen.

Werkzeug-Katalog in BasePeak.AIWerkzeug-Katalog in BasePeak.AI

Überblick​

Alle verfügbaren Werkzeuge werden als Kartenraster angezeigt. Jede Karte zeigt das Symbol, den Namen und eine kurze Beschreibung des Werkzeugs sowie eine Reihe von Kennzeichnungen (Badges):

  • Aktiv / Inaktiv – ob das Werkzeug derzeit für Agenten nutzbar ist.
  • MCP – das Werkzeug wird von einem MCP-Server bereitgestellt.
  • Paket (Anzahl) – das Werkzeug ist ein Bündel aus mehreren Unterwerkzeugen. Ein Klick auf dieses Badge öffnet den Paket-Inhalt (siehe unten).
  • Offiziell – ein von BasePeak.AI bereitgestelltes Werkzeug.
  • Kategorie-Badges, die das Werkzeug einer oder mehreren Kategorien zuordnen.

Suchen und Filtern​

Über das Suchfeld Werkzeuge suchen... lässt sich der Katalog nach Name und Beschreibung durchsuchen.

Zusätzlich stehen Filter-Chips zur Verfügung:

  • Kategorie-Chips – schränken die Anzeige auf Werkzeuge einer bestimmten Kategorie ein. Ein Klick auf ein Kategorie-Badge auf einer Karte aktiviert denselben Filter.
  • Eigenschafts-Chips – filtern nach Eigenschaften wie UI oder Experimentell.

Mehrere Chips können gleichzeitig aktiv sein. Sind keine passenden Werkzeuge vorhanden, erscheint Keine Werkzeuge entsprechen den aktiven Filtern. zusammen mit der Schaltfläche Filter zurücksetzen.

Pakete einsehen​

Werkzeuge mit dem Paket-Badge bündeln mehrere zusammengehörige Unterwerkzeuge. Klicken Sie auf das Badge, um eine Übersicht zu öffnen, die alle enthaltenen Unterwerkzeuge mit deren Namen, Beschreibung und jeweiligem Aktiv- bzw. Inaktiv-Status auflistet.

Ein neues Werkzeug registrieren​

  1. Klicken Sie oben rechts auf Werkzeug registrieren.
  2. Wählen Sie unter Werkzeugtyp zwischen GPTScript-Werkzeug und MCP-Server.
  3. Füllen Sie die vom gewählten Typ abhängigen Felder aus (siehe Tabellen unten).
  4. Klicken Sie auf Werkzeug registrieren, um das Werkzeug in den Katalog aufzunehmen.

GPTScript-Werkzeug​

FeldBeschreibung
Werkzeug-Referenz-URLVerweis auf die Werkzeugdefinition (erforderlich), z. B. github.com/user/repo/tool.gpt.
Name (optional)Anzeigename des Werkzeugs.
Beschreibung (optional)Kurze Beschreibung des Werkzeugs.

MCP-Server​

FeldBeschreibung
MCP-Server-URLAdresse des MCP-Servers (erforderlich), z. B. https://mcp.example.com/sse.
AuthentifizierungsmethodeKeine, Bearer-Token, API-Key oder Basic Auth (ein gemeinsames Geheimnis für alle Benutzer), OAuth (jeder Benutzer meldet sich selbst an) oder Persönliches Token (siehe unten).
Erlaubte Werkzeuge (optional)Kommagetrennte Namen der freigegebenen Werkzeuge; leer = alle.
Name (optional)Anzeigename des Werkzeugs.

Persönliches Token​

Mit Persönliches Token registrieren Sie den MCP-Server ohne Geheimnis. Jeder Benutzer verbindet stattdessen sein eigenes Token, zum Beispiel einen persönlichen API-Schlüssel. Der Zielserver sieht damit in seinem Protokoll, welche Person eine Aktion ausgelöst hat, und nicht ein gemeinsames Konto.

  • Wählen Sie, wie das Token gesendet wird: als Authorization: Bearer <Token> oder in einem eigenen Header (zum Beispiel X-Api-Key).
  • Ruft der Agent das Werkzeug auf, bevor der Benutzer ein Token hinterlegt hat, erscheint im Chat eine Karte mit einem Feld zum Einfügen. Auf der Startseite des Agenten öffnet das Werkzeug mit dem Schlüssel-Symbol dieselbe Eingabe, dort lässt sich das Token auch ersetzen oder trennen.
  • Das Token wird nie wieder angezeigt. Lehnt der Server es ab, fordert die Karte ein neues an.
  • Das Token wird nur in den eigenen Chats des Benutzers verwendet. In Aufgaben, Workflows, Webhooks, E-Mail-Auslösern, Zeitplänen und in Chats anderer Personen steht das Werkzeug nicht zur Verfügung; der Agent erhält dort eine entsprechende Meldung.
  • Außerdem nur in Agenten, die dem Benutzer allein gehören: Er hat den Agenten selbst erstellt (oder kopiert), niemand sonst darf ihn bearbeiten, und der Chat liegt in einem eigenen Projekt, das niemand sonst bearbeitet (mit Teams: im persönlichen Bereich). Das gilt auch für Agenten, an die der Agent delegiert, und für das Wissen des Chats: Wissenssammlungen, die nicht zum Agenten oder zu den eigenen Projekten gehören, schließen das Werkzeug ebenfalls aus. In Standard-, Katalog- und Paket-Agenten, in Agenten anderer Personen sowie in Team-Projekten oder Projekten mit weiteren Bearbeitern steht das Werkzeug nicht zur Verfügung. So können fremde Anweisungen oder Wissensinhalte den Agenten nicht dazu bringen, mit dem Token des Benutzers zu handeln. Wer das Werkzeug nutzen will, zum Beispiel ein Administrator mit dem Admin-MCP-Server, kopiert den Agenten oder erstellt einen eigenen.

OAuth​

Mit OAuth meldet sich jeder Benutzer selbst beim MCP-Server an. Ruft der Agent das Werkzeug auf, bevor der Benutzer verbunden ist, erscheint im Chat eine Karte zum Verbinden.

  • Die Anmeldung des Benutzers wird, wie beim persönlichen Token, nur in Agenten verwendet, die ihm allein gehören: selbst erstellt (oder kopiert), von niemandem sonst bearbeitbar, mit eigenen delegierten Agenten und eigenem Wissen, in einem eigenen Projekt, das niemand sonst bearbeitet (mit Teams: im persönlichen Bereich). In allen anderen Agenten erhält der Agent die Meldung, dass das Werkzeug nur in eigenen Agenten funktioniert; eine Verbindungskarte erscheint dort nicht.
  • Ausgenommen sind gekoppelte BasePeak-Work-Arbeitsbereiche. Sie sind dafür gedacht, dass Administratoren sie Agenten zuordnen, die alle nutzen, und jeder arbeitet darin mit seinen eigenen Dateien.

Werkzeuge löschen​

Benutzerdefiniert registrierte Werkzeuge lassen sich über das Papierkorb-Symbol auf ihrer Karte entfernen. Nach der Bestätigung der Rückfrage Sind Sie sicher, dass Sie dieses Werkzeug löschen möchten? wird das Werkzeug aus dem Katalog entfernt.

hinweis

Eingebaute Werkzeuge und Fähigkeiten lassen sich nicht löschen; bei diesen wird kein Lösch-Symbol angezeigt.

Hinweise​

  • Das Registrieren oder Löschen eines Werkzeugs ändert nur dessen Verfügbarkeit im Katalog – ob ein Agent ein Werkzeug tatsächlich verwendet, wird beim jeweiligen Agenten festgelegt.
  • Die Konfiguration von OAuth-Anmeldedaten für Werkzeuge wird gesondert unter OAuth-Werkzeuge beschrieben.

Verfügbare Werkzeuge​

Die folgende Übersicht listet die in BasePeak.AI registrierten Werkzeuge nach Kategorie, jeweils mit einem typischen Anwendungsfall. Werkzeuge mit OAuth-Anbindung verbinden sich im Namen des Benutzers mit dem jeweiligen Dienst, ohne Zugangsdaten preiszugeben. Welche Werkzeuge ein Agent tatsächlich nutzt, wird pro Agent festgelegt.

Kommunikation​

WerkzeugAnwendungsfall
SendGridTransaktions- und Benachrichtigungs-E-Mails programmatisch versenden.
SlackIm Namen des Benutzers Slack-Kanäle durchsuchen, Verläufe lesen und Nachrichten senden.
Slack BotAls Bot (mit Bot-Token) in Slack posten – ideal für automatisierte Team-Benachrichtigungen.
DiscordAls Bot Nachrichten in Discord-Kanäle und -Threads senden.
BlueskyBeiträge auf Bluesky erstellen und durchsuchen.
LinkedIn PublishingBeiträge auf LinkedIn veröffentlichen (Text, Bild, Video, Artikel).
ZoomZoom-Meetings anlegen, aktualisieren und Aufzeichnungen bzw. KI-Zusammenfassungen abrufen.
GmailE-Mails in Gmail lesen, verfassen und versenden.
Outlook MailE-Mails in Microsoft 365 Outlook lesen, senden und verwalten.

Produktivität & Office​

WerkzeugAnwendungsfall
Google DocsGoogle-Docs-Dokumente erstellen, lesen und aktualisieren.
Google SheetsTabellen in Google Sheets erstellen, lesen und beschreiben.
Google DriveDateien in Google Drive verwalten.
Google CalendarTermine und Kalender in Google Calendar verwalten.
Google Search ConsoleSuch- und Performance-Daten aus der Google Search Console abrufen.
WordWord-Dokumente in Microsoft 365 erstellen, schreiben und lesen.
ExcelExcel-Tabellen in Microsoft 365 erstellen, lesen und aktualisieren.
OneDriveDateien in Microsoft 365 OneDrive verwalten.
Outlook CalendarTermine in Microsoft 365 Outlook verwalten.
Outlook ContactsKontakte in Microsoft 365 Outlook verwalten.
Office (lokal).docx, .xlsx, .pptx direkt im Workspace erstellen und bearbeiten – ohne Microsoft-365-Konto.
WordPressBeiträge, Medien und Kategorien auf WordPress-Seiten verwalten.
WordPress SEOWordPress-Beiträge analysieren und SEO-Empfehlungen erhalten.

Wissen & Suche​

WerkzeugAnwendungsfall
KnowledgeDie Wissenssammlung (RAG) durchsuchen und relevante Treffer abrufen.
Knowledge SearchEine Frage direkt aus der Wissenssammlung mit Quellenangaben beantworten.
Chunked ReaderBeliebige Dateitypen laden und seitenweise nach Markdown konvertieren.
Chunked PDF SearchGroße PDFs abschnittsweise durchsuchen und mit Zitaten beantworten.
Get File ContentDen vollständigen Inhalt einer zuvor zitierten Datei nachladen.
File SummarizerGroße Dateien zusammenfassen, optional mit Fokus auf ein Thema.
Search ComboDas Web per Google durchsuchen und die Ergebnisse einlesen.

Web & Daten​

WerkzeugAnwendungsfall
Browser FetchEine URL im Headless-Browser (mit JavaScript) rendern und Text sowie aufgerufene API-Endpunkte zurückgeben.
FirecrawlWebsites mit Firecrawl scrapen und in Markdown umwandeln.
Colly Website ScraperEine Webseite mit Colly auslesen.
HTTP GETEine URL per HTTP GET abrufen (z. B. JSON aus einer Web-API).

Datenbanken & Dateien​

WerkzeugAnwendungsfall
PostgresSQL-Abfragen gegen eine PostgreSQL-Datenbank ausführen.
Microsoft SQL ServerT-SQL gegen einen Microsoft SQL Server ausführen.
SMB/CIFSDateien auf SMB/CIFS-Netzwerkfreigaben mit vollem CRUD verwalten.

CRM & Vertrieb​

WerkzeugAnwendungsfall
SalesforceKontakte, Leads, Accounts und Opportunities im Salesforce-Konto verwalten.
HubSpot CRMMit Datensätzen im HubSpot CRM arbeiten.
LinkedIn SearchUnternehmen, Personen und Jobs auf LinkedIn suchen.

Medien​

WerkzeugAnwendungsfall
ImagesBilder analysieren, generieren und bearbeiten – mit dem Bildmodell Ihrer Plattform (z. B. FLUX oder GPT Image).
Audio TranscriptionAudiodateien per Whisper-API transkribieren (große Dateien werden automatisch geteilt).

Interaktive Oberflächen​

WerkzeugAnwendungsfall
Render UI SurfaceEine persistente UI-Oberfläche in der Seitenleiste erstellen oder ersetzen.
Patch UI SurfaceEine bestehende UI-Oberfläche per RFC-6902-JSON-Patch inkrementell aktualisieren.
Render Weather (Demo)Eine Wetterkarte mit Live-Daten und 5-Tage-Vorhersage anzeigen.
Render Approval Card (Demo)Eine Freigabekarte für Human-in-the-Loop-Schritte mit Genehmigen/Ablehnen anzeigen.
Render Currency Conversion (Demo)Eine Währungsumrechnung auf Basis der EZB-Referenzkurse anzeigen.

Produktivitäts-Primitive​

WerkzeugAnwendungsfall
TasksAutomatisierte Aufgaben auflisten und ausführen.
ThreadsMehrere Gesprächs-Threads auf einem Agenten anlegen.
MemoryLangzeit-Erinnerungen des Agenten speichern und abrufen.
TimeAktuelles Datum, Uhrzeit und Zeitzone abrufen.
Workspace FilesDateien im Workspace verwalten.

Deutscher Public Sector​

WerkzeugAnwendungsfall
German Laws (Gesetze)Bundesgesetze und Verwaltungsvorschriften durchsuchen und lesen.
Landesrecht NRWLandesgesetze und Rechtsverordnungen sowie Verwaltungsvorschriften von recht.nrw.de durchsuchen und ein Dokument per URL im Volltext lesen.
EU-Recht (EUR-Lex)Geltendes EU-Recht nach Titel, CELEX-Nummer oder Fundstelle durchsuchen und einen Rechtsakt oder einen einzelnen Artikel in der aktuellen konsolidierten Fassung lesen.
NeuRIS – Bundesrecht & RechtsprechungGesetze, Gerichtsentscheidungen und juristische Literatur über die offizielle NeuRIS-API durchsuchen.
OParl Parliamentary DataSitzungen, Vorlagen und Beschlüsse aus OParl-konformen Ratsinformationssystemen abfragen.
XZuFi VerwaltungsleistungenVerwaltungsleistungen und Zuständigkeiten aus dem PVOG-Suchdienst abrufen.
bund.devDeutsche Behörden-APIs nutzen (NINA-Warnungen, Autobahn, Tagesschau, DWD, Pegel, Jobsuche u. a.).
GEORG (Geosoft)Aufträge, Adressen und Vorgänge in einer GEORG-Vermessungsdatenbank abfragen (schreibgeschützt).
RIS (Ratsinformationssystem)Fragen zu kommunalen Sitzungen, Vorlagen und Beschlüssen beantworten.

Sicherheit & Smart Home​

WerkzeugAnwendungsfall
PII ServicePersonenbezogene Daten (PII) in deutschem Text erkennen (17+ Entitätstypen, z. B. IBAN, Steuer-ID).

Geschäftsprozesse​

WerkzeugAnwendungsfall
BPMN (experimentell)Geschäftsprozesse in komiq-JSON und BPMN 2.0 ansehen, analysieren, konvertieren und bearbeiten.