Skip to main content

​
Was sind Toolsets?

Toolsets stellen Agenten Aktionen in verbundenen Anwendungen bereit: Daten lesen, Nachrichten versenden, Vorgänge anlegen oder Inhalte aktualisieren. Ein Konnektor synchronisiert dagegen Daten in die Novaplan-AI-Suche. Wenn ein Agent erst Wissen suchen und anschließend handeln soll, können Sie im Agent Builder Knowledge-Knoten für die Suche und Tools-Knoten für Aktionen mit dem Agent Core verbinden. Toolsets können je nach Anbieter lesen, schreiben oder löschen. Autorisieren Sie nur die Rechte, die für den vorgesehenen Agenten und Anwendungsfall nötig sind. Novaplan unterstützt Sie bei der Einrichtung und der Prüfung sensibler Aktionen.

​
Verfügbare Anwendungen

Die folgenden Toolsets sind im zugänglichen Aktionskatalog beschrieben. Welche davon in Ihrem Workspace tatsächlich bereitstehen, sehen Sie unter Workspace settings → Actions. Die Zahl der Werkzeuge stammt aus diesem Katalog und kann sich mit der bereitgestellten Version ändern.

​
Google Workspace

​
Microsoft 365

​
Atlassian

​
Weitere Anwendungen und Datenbanken

Das sind 19 Katalog-Toolsets mit 342 Werkzeugen in der zugänglichen Implementierung. Für Lumos ist noch keine eigene Anleitung verfügbar. Wenn Sie diese Aktion einrichten möchten, wenden Sie sich an Novaplan Support. Weitere Implementierungen, etwa Notion, Linear, GitLab, Dropbox, Box, S3 und Zendesk, sind im zugänglichen Quellkatalog nicht als aktiv registrierte Toolsets enthalten. Ihre tatsächliche Verfügbarkeit muss im Workspace geprüft werden. Zusätzlich stehen Agenten eingebaute Fähigkeiten zur Verfügung, die nicht unter Actions eingerichtet werden: Artifact Manager (6 Werkzeuge), Internal Tools für strukturierte Rückfragen (1), Calculator für Berechnungen und Arbeitstage (5) sowie Image Generator (1). Bei angebundenem Wissen kommt Knowledge Graph mit 4 Such- und Strukturwerkzeugen hinzu. Für Bildgenerierung muss zuvor ein geeignetes Modell unter Workspace Settings → AI Models → Image Generation eingerichtet sein.
Wenn Codeausführung für Ihren Workspace aktiviert ist, können Agenten über run_code, install_packages und read_sandbox_file Code und Dateien in einer isolierten Umgebung verwenden. In der zugänglichen Implementierung ist sie standardmäßig aktiviert; prüfen Sie mit Novaplan, ob das auch für Ihren bereitgestellten Workspace gilt. Diese Werkzeuge gehören zu den eingebauten Agentenfähigkeiten; die Repository-Einträge coding_sandbox und database_sandbox werden laut technischer Quellanleitung nicht zusätzlich als Toolsets an Agenten angehängt. Klären Sie mit Novaplan, ob diese Funktion für Ihre Agenten und Daten zugelassen sein soll.

​
Toolset einrichten

  1. Öffnen Sie Workspace settings → Actions. Teamweit verwaltete Toolsets benötigen die entsprechenden Administrationsrechte. Persönliche Verbindungen finden Sie unter Your Actions.
Navigation zu Actions in den Workspace-Einstellungen
  1. Suchen Sie die Anwendung. Für Team-Aktionen können Sie nach All, Configured und Not configured filtern; für persönliche Aktionen nach All, Authenticated und Not authenticated.
Aktionskatalog und Filter für Toolsets
  1. Wählen Sie Configure und folgen Sie den anwendungsspezifischen Schritten. Je nach Toolset benötigen Sie OAuth-Zugangsdaten oder eine andere Anmeldemethode.
Konfigurationsdialog eines Toolsets
  1. Bei OAuth kopieren Sie die im Konfigurationsdialog angezeigte Redirect URI in die zugelassene Callback-Liste der externen Anwendung. Beide Werte müssen exakt übereinstimmen.
  2. Schließen Sie Authenticate und gegebenenfalls die Freigabe im Anbieterfenster ab. Prüfen Sie anschließend den Status Authenticated.
Authentifiziertes Toolset im Aktionskatalog
Die notwendigen Berechtigungen hängen von den tatsächlich genutzten Aktionen ab. Ein Toolset für E-Mails kann beispielsweise Leserechte und Senderechte benötigen; ein Toolset für Vorgänge kann Erstellen, Aktualisieren oder Löschen anbieten. Die Einzelanleitungen beschreiben die jeweiligen Zugangsdaten und Rechte. Bei Datenbank-Toolsets kann ein Administrator die Instanz anlegen, während Benutzer ihre eigenen Zugangsdaten hinterlegen.

​
Anmeldemethoden und persönliche Zugangsdaten

Bei OAuth 2.0 richtet die Workspace-Administration gegebenenfalls eine Anwendung beim Anbieter ein, hinterlegt deren Client ID und Client Secret und kopiert die Redirect URI aus Novaplan AI als zugelassene Callback-URL zum Anbieter. Anschließend bestätigt jede berechtigte Person den Zugriff mit ihrem eigenen Konto. Prüfen Sie die angeforderten Lese-, Schreib- und Löschrechte im Zustimmungsdialog; der Umfang unterscheidet sich je nach Toolset. OAuth-Tokens können von der Integration erneuert werden, sofern der Anbieter und die Workspace-Konfiguration das zulassen. Bei Toolsets mit Benutzername und Passwort, beispielsweise MariaDB, erstellt die Administration die gemeinsame Instanz mit Host, Port und Datenbank. Jede Person hinterlegt danach ihre eigenen Datenbank-Zugangsdaten unter Your actions. Verwenden Sie kein gemeinsam genutztes Datenbankkonto, und klären Sie mit Novaplan vor der Anbindung sensibler Daten, wie persönliche Zugangsdaten im bereitgestellten Workspace geschützt werden.

​
Im Agent Builder verwenden

  1. Öffnen Sie einen Agenten im Agent Builder.
  2. Suchen Sie im Bereich Tools das authentifizierte Toolset.
  3. Fügen Sie es dem Ablauf hinzu und verbinden Sie es mit dem Agent Core.
  4. Testen Sie den Agenten mit einem Konto, das die vorgesehenen Rechte besitzt. Prüfen Sie bei schreibenden Aktionen die Auswirkungen in der Zielanwendung.
Toolset im Agent Builder verwenden
Ist ein Toolset nicht nutzbar, prüfen Sie unter Actions den Authentifizierungsstatus. Über den Konfigurationsdialog können Sie Zugangsdaten aktualisieren, bei Ablauf erneut authentifizieren oder eine nicht mehr benötigte Verbindung entfernen. Nicht authentifizierte Toolsets lassen sich nicht als ausführbare Aktionen verwenden.
Konfiguration und erneute Anmeldung eines Toolsets verwalten
Weitere Schritte finden Sie unter Agent einrichten und in den jeweiligen Toolset-Anleitungen. Bei Fragen zur Freigabe von Aktionen wenden Sie sich an Novaplan Support.