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.

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.

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?

Modus	Beim Start an	Nutzer können es ändern	Bedeutung
Immer an	ja	nein	In jedem Chat aktiv. Nutzer können sie nicht ausschalten.
Standardmäßig an	ja	ja	Beim Start eines Chats oder Projekts aktiv. Nutzer können sie ausschalten.
Standardmäßig aus	nein	ja	Angeboten, aber aus. Nutzer können sie selbst einschalten.
Aus	nein	nein	Nicht 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ähigkeit	Beschreibung
Wissensdatenbank durchsuchen	Ermöglicht dem Projektersteller, Dateien hochzuladen, die als durchsuchbare Wissensbasis für den Agenten dienen
Workspace-Dateien	Ermöglicht dem Projektersteller und den Benutzern, Dateien in einen gemeinsamen Workspace hochzuladen, den der Agent lesen und schreiben kann
Aufgaben	Ermöglicht Benutzern, Aufgaben im Projekt zu erstellen
Gespräche	Wenn deaktiviert, sind Benutzer auf ein einzelnes nicht löschbares Gespräch im Projekt beschränkt
Erinnerungen	Ermö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.

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.