Zum Hauptinhalt springen

Agenten

Ein Agent ist eine wiederverwendbare Basiskonfiguration, aus der Benutzer Projekte erstellen. Jedes Projekt in BasePeak.AI wird aus einem Agenten erstellt, der bestimmt, mit welchen Fähigkeiten, Werkzeugen und welchem Modell das Projekt startet.

Administratoren verwalten Agenten unter /admin/agents.

Der Standard-Agent​

Ein Agent kann als Standard-Agent markiert werden. Nicht-Admin-Benutzer können neue Projekte nur aus dem Standard-Agenten erstellen. Administratoren können Projekte aus jedem Agenten erstellen.

Um den Standard-Agenten zu ändern, klicken Sie auf der Agenten-Seite auf Standard-Agent festlegen und wählen Sie aus der Liste.

Agenten erstellen und löschen​

  • Erstellen — Klicken Sie auf die Schaltfläche +, um einen neuen Agenten zu erstellen. Sie werden direkt zum Agenten-Editor weitergeleitet, um ihn zu konfigurieren.
  • Löschen — Verwenden Sie das Zeilen-Aktionsmenü in der Agentenliste. Das Löschen eines Agenten löscht keine Projekte, die bereits daraus erstellt wurden.

Agentenliste​

Die Agentenliste in der Administration zeigt neben dem Namen Spalten, mit denen Sie Agenten wiederfinden:

  • Verantwortlich — die Besitzer, die in der Karte Administration des Agenten eingetragen sind (Benutzer und Gruppen). Hat ein Agent keinen Eintrag, etwa weil ihn ein Instanz-Administrator angelegt hat, steht dort „—“. Wer das Benutzerverzeichnis nicht lesen darf, sieht keinen Namen, der wie eine E-Mail-Adresse aussieht, sondern ersatzweise den Benutzernamen oder die Benutzer-ID.
  • Schlagwörter — die Schlagwörter des Agenten (siehe Schlagwörter).

Beide Spalten lassen sich filtern. Die Filter stehen in der Adresse der Seite, eine gefilterte Liste können Sie also als Lesezeichen speichern oder weitergeben. Die Freitextsuche berücksichtigt ebenfalls die Schlagwörter.

Sind Teams eingeschaltet, kommt die Spalte Teams hinzu: Sie zählt die Teams, für die der Agent freigegeben ist, und zeigt „—“, wenn es keine sind. Ein Klick auf die Zahl öffnet die Liste der Teams. Wer alle Teams verwaltet (Instanz-Administratoren und die Berechtigung space:manage), sieht jedes geteilte Team mit Namen und gelangt per Klick zu den Einstellungen des Teams; Persönliche Teams erscheinen nur als Anzahl. Alle anderen sehen nur die Teams mit Namen, in denen sie selbst Mitglied sind, und die übrigen als Anzahl. Die Spalte lässt sich nach Teamnamen filtern und nach der Anzahl sortieren. Konnten die Teamdaten nicht geladen werden, steht in der Spalte ein „?“ statt einer Zahl – das heißt nicht, dass der Agent für kein Team freigegeben ist.

Agenten-Editor​

Ein Klick auf die Zeile eines Agenten öffnet den Editor, der in folgende Abschnitte gegliedert ist.

Name und Beschreibung​

Legen Sie einen lesbaren Namen und eine optionale Beschreibung fest. Diese sind für Benutzer sichtbar, wenn sie auswählen, auf welchem Agenten sie ein Projekt basieren möchten.

Schlagwörter​

Unter der Beschreibung ordnen Sie dem Agenten Schlagwörter zu, etwa „Bauamt“ oder „Entwurf“. Drücken Sie Enter oder tippen Sie ein Komma, um ein Schlagwort hinzuzufügen. Es sind bis zu 10 Schlagwörter mit je höchstens 40 Zeichen möglich; zu viele oder zu lange Schlagwörter werden abgelehnt, nicht stillschweigend gekürzt. Groß- und Kleinschreibung spielt für Duplikate keine Rolle: Es bleibt die zuerst eingegebene Schreibweise. Beim Tippen schlägt der Editor Schlagwörter vor, die bereits an Agenten vergeben sind, die Sie sehen können.

Auf der Agenten-Seite der Benutzer erscheinen die Schlagwörter als Chips über den Listen. Wählen Sie mehrere aus, bleiben nur Agenten übrig, die alle gewählten Schlagwörter tragen; Filter zurücksetzen hebt die Auswahl auf.

Womit ein neuer Agent startet​

Agent erstellen erzeugt keinen leeren Agenten. Er startet auf derselben Grundlage wie der eingebaute Assistent: Workspace-Dateien und Aufgaben immer an, Datum und Uhrzeit sowie Wissensdatenbank durchsuchen standardmäßig an. Jeder dieser Einträge ist eine gewöhnliche Zeile, die Sie ändern oder entfernen können.

Modell​

Wählen Sie aus, welches Sprachmodell der Agent verwendet. Die Auswahl von Systemstandard verwenden bedeutet, dass der Agent das auf der Modellanbieter-Seite konfigurierte Standard-Plattformmodell übernimmt.

Werkzeuge​

Dieser Abschnitt konfiguriert, welche Werkzeuge für Projekte verfügbar sind, die aus diesem Agenten erstellt werden. Jedes Werkzeug, das hier nicht enthalten ist, ist in diesen Projekten nicht verfügbar. Schließen Sie daher beim Konfigurieren des Standard-Agenten den vollständigen Satz von Werkzeugen ein, auf die Benutzer Zugriff haben sollen.

Ein aus dem Katalog hinzugefügtes Werkzeug kommt standardmäßig an: in neuen Chats aktiv, und Nutzer können es weiterhin ausschalten.

Jedes Werkzeug verwendet die gleichen Modi wie Fähigkeiten, ohne Aus: Bei einem Werkzeug bedeutet „nicht verfügbar“ schlicht, dass es nicht zugewiesen ist — entfernen Sie es stattdessen über das Papierkorb-Symbol.

Werkzeuge, die OAuth erfordern, können auf Agenten-Ebene vorauthentifiziert werden. Dies wird im Allgemeinen nur für Agenten mit einzelnen Benutzern empfohlen, da die Zugangsdaten mit allen Benutzern geteilt werden.

Fähigkeiten​

Fähigkeiten steuern, welche eingebauten Funktionen für Projekte verfügbar sind, die aus diesem Agenten erstellt werden. Jeder Modus beantwortet zwei Fragen: Ist die Fähigkeit beim Start eines Chats oder Projekts an, und dürfen Nutzer sie ändern?

ModusBeim Start anNutzer können es ändernBedeutung
Immer anjaneinIn jedem Chat aktiv. Nutzer können sie nicht ausschalten.
Standardmäßig anjajaBeim Start eines Chats oder Projekts aktiv. Nutzer können sie ausschalten.
Standardmäßig ausneinjaAngeboten, aber aus. Nutzer können sie selbst einschalten.
AusneinneinNicht verfügbar. Nutzer sehen sie nie.

Dieselben vier Modi benennen die Verfügbarkeit im gesamten Editor — für Werkzeuge und Fähigkeiten und für die Optionen zu Datenschutz und Modell-Routing unter Erweitert.

Die konfigurierbaren Fähigkeiten sind:

FähigkeitBeschreibung
Wissensdatenbank durchsuchenErmöglicht dem Projektersteller, Dateien hochzuladen, die als durchsuchbare Wissensbasis für den Agenten dienen
Workspace-DateienErmöglicht dem Projektersteller und den Benutzern, Dateien in einen gemeinsamen Workspace hochzuladen, den der Agent lesen und schreiben kann
AufgabenErmöglicht Benutzern, Aufgaben im Projekt zu erstellen
GesprächeWenn deaktiviert, sind Benutzer auf ein einzelnes nicht löschbares Gespräch im Projekt beschränkt
ErinnerungenErmöglicht dem Agenten, Informationen über Gespräche hinweg zu behalten

Aktionen​

Aktionen sind benutzerdefinierte Verknüpfungen, die in der Projektschnittstelle erscheinen. Jede Aktion hat einen Namen, eine dem Benutzer angezeigte Beschreibung, einen Prompt, der den Agenten leitet, und eine optionale Teilmenge der Werkzeuge des Agenten. Aktionen ermöglichen es Ihnen, häufige Arbeitsabläufe als Ein-Klick-Prompts anzubieten.

Wissen​

Fügen Sie Wissensbasen direkt zum Agenten hinzu. Das hier hinzugefügte Wissen ist für alle Projekte verfügbar, die aus diesem Agenten erstellt wurden.

Dieser Abschnitt benötigt die Fähigkeit Wissensdatenbank durchsuchen. Ist sie aus, hat der Agent kein Werkzeug zum Durchsuchen — hier hinzugefügte Inhalte würden gespeichert und nie gelesen. Der Abschnitt weist darauf hin und bietet an, die Fähigkeit einzuschalten. Bereits vorhandenes Wissen bleibt in jedem Fall sichtbar und kann weiterhin gelöst werden.

Workspace-Dateien​

Anzeigen und Verwalten von Dateien im Workspace des Agenten.

Zugriffssteuerung​

Wer diesen Agenten erreichen kann. Dies ist keine reine Übersicht — hier wird Zugriff gewährt, und zwar im Dialog Veröffentlichen zusammen mit der Adresse des Agenten, denn das ist eine Entscheidung.

Ein neuer Agent hat keine Einträge, und das bedeutet niemand: Die Agentenliste eines Benutzers wird allein aus diesen Freigaben gebildet, ein Agent ohne Freigabe erscheint also in keiner Benutzerliste. Die Karte weist darauf hin, bis Sie jemanden hinzufügen. Instanz-Administratoren erreichen jeden Agenten immer, ebenso wer bereits ein Projekt darauf besitzt; beide werden hier nicht aufgeführt.

Freigaben und Entzug wirken sofort — Abbrechen im Dialog „Veröffentlichen“ verwirft nur die Adresse.

Administration pro Agent​

Wer einen Agenten verwalten darf, ist getrennt von der Frage, wer ihn nutzen darf. Die Karte Administration im Agenten-Editor vergibt dafür zwei Rollen an einzelne Benutzer oder Gruppen:

RolleDarf
Bearbeiterden Agenten ändern: Einstellungen, Werkzeuge, Wissen, Workspace-Dateien, Umgebungsvariablen, Autorisierungen
Besitzeralles, was ein Bearbeiter darf, und zusätzlich Administratoren verwalten, die Administration beschränken und den Agenten löschen. Kopieren erfordert die Berechtigung agent:create, bei einem beschränkten Agenten stattdessen die Besitzer-Rolle. Sein Wissen veröffentlichen erfordert die Berechtigung knowledgeset:publish, bei einem beschränkten Agenten zusätzlich die Besitzer-Rolle

Mit Administrator hinzufügen suchen Sie Benutzer und Gruppen und wählen die Rolle. Administratorrollen gibt es nur für einzelne Benutzer und für Gruppen, nicht für „alle“ und nicht für reine E-Mail-Einträge. Administrationsrechte entziehen macht die Person wieder zum gewöhnlichen Benutzer; sie behält den Zugriff auf den Chat. Wer den Zugriff ganz entziehen will, löscht den Eintrag unter Zugriffssteuerung. Wer einen Agenten erstellt, wird automatisch dessen Besitzer.

Zwei Änderungen reichen über den einzelnen Agenten hinaus und erfordern deshalb mehr als eine Rolle: Den Standard-Agenten festlegen darf nur, wer die globale Berechtigung agent:update hat (oder ein Super-Admin). Eine eigenständige Wissenssammlung anhängen darf ein Bearbeiter nur mit agent:update oder knowledgeset:manage. Wer eine Person schon als Bearbeiter oder Besitzer führt, wird unter Administrator hinzufügen mit seiner Rolle angezeigt; die Rolle ändern Sie in der Liste.

Administration beschränken​

Ohne Beschränkung behalten globale Agentenrechte ihre Wirkung: Wer die Berechtigung agent:update hat, darf jeden Agenten als Bearbeiter ändern. Schalten Sie Administration auf die hier genannten Personen beschränken ein, gilt für diesen Agenten nur noch, was hier steht:

  • Globale Agentenrechte (agent:update, agent:delete) reichen nicht mehr aus. Administratoren damit können den Agenten weder öffnen noch ändern, und er wird für sie nicht aufgeführt. Direkte Aufrufe antworten mit „nicht gefunden“ (404).
  • Instanz-Administratoren (Super-Admins) können jeden Agenten weiterhin verwalten. So lässt sich ein Agent wiederherstellen, dessen Besitzer das Unternehmen verlassen hat.
  • Beim Beschränken muss mindestens ein Besitzer existieren, also ein vorhandener Benutzer oder eine vorhandene Gruppe. Super-Admins sind davon ausgenommen.
  • Ein beschränkter Agent kann nur von einem Besitzer kopiert werden; die Kopie bleibt beschränkt. Auch das Veröffentlichen seiner Wissenssammlung erfordert einen Besitzer, und ihn als Standard-Agenten festzulegen ist Super-Admins vorbehalten.

Gruppen als Besitzer​

Besitzer und Bearbeiter können Gruppen sein, auch aus dem Identitätsanbieter synchronisierte, etwa aus Entra-ID-Gruppen. Die Mitgliedschaft folgt dann der Gruppe: Wer aufgenommen wird, erhält die Rolle, wer ausscheidet, verliert sie.

Letzter Besitzer​

Der letzte lebende Besitzer eines beschränkten Agenten lässt sich weder entfernen noch herabstufen (Fehler 409). Ebenso wird das Löschen eines Benutzers oder einer Gruppe abgelehnt, wenn sie der einzige Besitzer eines beschränkten Agenten ist; die Fehlermeldung nennt die betroffenen Agenten. Setzen Sie dort zuerst einen weiteren Besitzer ein. Andernfalls entfernt das Löschen eines Benutzers dessen Agenten-Rollen.

Verlauf der Administration​

Besitzer sehen im Agenten-Editor den Verlauf der Administration: wer wann Rollen vergeben, geändert oder entzogen und die Beschränkung gesetzt oder aufgehoben hat, auch das Anlegen des Agenten. Super-Admins und Auditoren (Berechtigung user:read) können dieselben Einträge über GET /api/audit-events?resourceType=agent&resourceID=<id> abrufen. Mit einem API-Schlüssel ist das nicht möglich.

API-Schlüssel​

Bearbeiter dürfen für ihre Agenten Schlüssel mit den Scopes agent:update:<id> und agent:files-write:<id> erzeugen. Ein Schlüssel mit agent:update:<id> wirkt höchstens mit der Rolle seines Eigentümers. Der Scope agent:update:* erfordert weiterhin die globale Berechtigung agent:update. Maßgeblich sind die Rechte des Eigentümers zum Zeitpunkt der Anfrage: seine Bearbeiter- oder Besitzerrolle und, auf nicht beschränkten Agenten, die globale Berechtigung agent:update. Verliert er beides, erreicht der Schlüssel den Agenten nicht mehr und lässt sich auch nicht mehr rotieren. Dasselbe gilt für Workspace-Dateien, die ein Schlüssel mit agent:files-write schreibt.

Was nicht geschützt ist​

Die Beschränkung gilt für den Agenten und seine Routen, nicht für eigenständige Wissenssammlungen. Wer die Berechtigung knowledgeset:manage hat, kann eine an den Agenten angehängte Wissenssammlung weiterhin lesen und ändern. Die Karte warnt davor, wenn eine solche Sammlung angehängt ist.

Wer die Verwaltung sieht​

Wer nur eine Besitzer- oder Bearbeiterrolle besitzt, sieht in der Admin-Konsole den Eintrag Agenten und landet unter /admin direkt dort.

Erweitert​

Zugelassene Modellanbieter​

Schränken Sie ein, welche konfigurierten Modellanbieter Benutzer beim Auswählen eines Modells für ihr Projekt wählen dürfen. Wenn leer gelassen, sind alle konfigurierten Anbieter verfügbar.

Umgebungsvariablen​

Legen Sie Schlüssel-Wert-Umgebungsvariablen fest, die an alle Werkzeuge übergeben werden, die von diesem Agenten und von Projekten aufgerufen werden, die daraus erstellt wurden. Verwenden Sie dies, um API-Schlüssel oder Konfigurationswerte bereitzustellen, die Werkzeuge zur Laufzeit benötigen.

Automatisches Modell-Routing​

Auto · Ausgewogen wählt für jede Nachricht das günstigste Modell, das für ihre Komplexität stark genug ist; in der Nachricht erwähnte Dateien zählen dabei mit. Ist der Dateischutz im Chat aktiv, behandelt Auto jede Nachricht dort als personenbezogen. Ist dann kein für personenbezogene Daten freigegebenes Modell stark genug, kann sie anonymisiert an ein stärkeres Modell gehen, das für vertrauliche Daten freigegeben ist.

Auto · Ausgewogen steht erst zur Wahl, wenn ein Administrator den Modus unter Einstellungen → Automatisches Modell-Routing aktiviert hat.

Die anonymisierte Weitergabe geschieht nur, wenn im Agenten-Editor unter Erweitert → Automatisches Modell-Routing die Option Anonymisierte personenbezogene Daten auf Modellen erlauben, die für vertrauliche Daten freigegeben sind eingeschaltet ist und der Dateischutz für den Chat aktiv ist. Solange der Dateischutz für den Agenten ausgeschaltet ist, lässt sich die Option nicht einschalten, eine bereits eingeschaltete aber noch ausschalten.

Hat der Dateischutz in einer Anfrage etwas ersetzt – erkannte personenbezogene Daten oder einen Dateinamen –, gilt die Anfrage als personenbezogen, gleich ob Auto oder der Nutzer das Modell gewählt hat. Mit der Option darf sie an Modelle gehen, die für vertrauliche Daten freigegeben sind, statt nur an Modelle, die für personenbezogene Daten freigegeben sind. Auto · Datenschutz zuerst ignoriert die Option: In Chats mit Dateischutz wählt es nur Modelle, die für personenbezogene Daten freigegeben sind. Die Option hilft Auto · Ausgewogen und der manuellen Modellwahl. Gibt es im Projekt kein Modell, das die Anfrage erhalten darf, lehnt Auto die Nachricht ab.

Wofür ein Modell freigegeben ist, gilt auch für Bilderzeugung, Bildbearbeitung, Transkription und Sprachausgabe: Der Text-Prompt und der vorzulesende Text werden wie eine Chat-Nachricht geprüft. Hochgeladene Bilder und Audiodateien lassen sich nicht klassifizieren; ein Modell, das nicht für personenbezogene Daten freigegeben ist, erhält sie nur, wenn die Durchsetzung auf „Warnen“ steht. Wo die Durchsetzung umleiten würde, werden diese Anfragen abgelehnt.

Der Dateischutz anonymisiert auch, was die Plattform den Systemanweisungen anfügt: Dateinamen im Arbeitsbereich, gespeicherte Erinnerungen, Ausgaben anderer Kontext-Werkzeuge sowie Projekt- und Thread-Prompts. Ein Dateiname im Arbeitsbereich wird als Ganzes ersetzt, sobald der PII-Dienst darin personenbezogene Daten erkennt; andere Dateinamen bleiben stehen. Nur der Prompt des Agenten selbst und die festen Anweisungen der Plattform gehen unverändert an das Modell; tragen Sie in den Prompt keine personenbezogenen Daten ein.

Die Erkennung ist nicht perfekt. Was der PII-Dienst übersieht, wird unverändert gesendet. Aufgaben, die die echten Werte brauchen, etwa eine IBAN prüfen, sehen nur Platzhalter.