Eigene Werkzeuge

Ihr Haus kann eigene Funktionen bereitstellen, die der Assistent aufrufen kann — etwa eine Berechnung oder eine Abfrage gegen ein Fachsystem. Sie werden unter Administration → Eigene Werkzeuge verwaltet.

Anlegen

Neues Werkzeug erstellen öffnet den Editor mit drei Reitern:

• Allgemein — Anzeigename, Kurz-Kennung (Slug), Beschreibung, Risikoklasse und bei „Hoch" die Annex-Referenz. Die Kurz-Kennung wird aus dem Anzeigenamen abgeleitet, solange Sie sie nicht selbst ändern: Kleinbuchstaben, Ziffern, - und _, beginnend mit einem Buchstaben. Nach dem ersten Speichern ist sie fest.
• Code — der Python-Quelltext. Verifizieren prüft ihn, ohne zu speichern, und zeigt das Ergebnis darunter.
• Berechtigungen — Geschlossen (nur ausgewählte Personen und Gruppen) oder Offen für alle Mitglieder des Arbeitsbereichs.

Die Prüfung

Jedes Werkzeug wird beim Speichern geprüft. Abgelehnt wird Code, der nicht zugelassene Bestandteile verwendet — etwa direkte Netzwerkverbindungen, Zugriffe auf das Betriebssystem oder die Programmteile der Plattform selbst. Übliche Standardbibliotheken für Textverarbeitung, Datum oder Rechnen sind erlaubt.

Beim Anlegen wird ein Werkzeug, das die Prüfung nicht besteht, gar nicht erst gespeichert. Der Editor bleibt offen und zeigt die Begründung der Prüfung; Sie korrigieren und speichern erneut.

Beim Ändern eines bestehenden Werkzeugs wird die neue Fassung gespeichert und erhält den Status Fehlerhaft; der Editor zeigt die Begründung.

Den Status sehen Sie in der Liste:

Status	Bedeutung
OK	Geprüft und einsatzbereit
Noch nicht geprüft	Tritt nur kurz nach dem Speichern auf
Fehlerhaft	Abgelehnt. Das Warnsymbol neben dem Status öffnet die Begründung, Im Editor öffnen führt zur Korrektur.

Nur ein Werkzeug mit Status OK wird verwendet. Ein fehlerhaftes steht weder im Chat noch an einem Endpunkt zur Verfügung, bis es korrigiert ist.

Ist die Kurz-Kennung schon vergeben, weist der Editor darauf hin, dass es ein Werkzeug mit dieser Kurz-Kennung im Arbeitsbereich bereits gibt. Wählen Sie eine andere.

An einen Endpunkt binden

Im Reiter Wissen & Tools des Endpunkts, Abschnitt Eigene Werkzeuge. Aktivieren, speichern, veröffentlichen.

Eigene Werkzeuge laufen immer serverseitig; das lässt sich nicht umstellen.

⚠️ Das ist die wichtigste Zeile dieser Seite: Sobald ein eigenes Werkzeug an einen Endpunkt gebunden ist, dürfen alle Nutzenden dieses Endpunkts es aufrufen — auch anonyme. Die Zugriffsregeln, die für den internen Chat gelten, greifen hier nicht, weil externe Nutzende keine Mitglieder Ihres Arbeitsbereichs sind.

Prüfen Sie deshalb vor dem Binden: Wäre es in Ordnung, wenn eine beliebige Person von außen diese Funktion auslöst?

Wie ein Aufruf abläuft

Das Werkzeug wird für die Dauer der Antwort geladen, dem Sprachmodell angeboten und danach wieder entfernt. Werkzeuge eines Endpunkts beeinflussen niemals einen anderen.

Ob es tatsächlich aufgerufen wird, entscheidet das Modell anhand der Frage. Im eingebetteten Fenster wird der Aufruf für die Nutzenden sichtbar gemacht — eine Transparenzanforderung der KI-Verordnung.

Jeder Aufruf wird protokolliert.

Worauf Sie achten sollten

Die Einstufung im Blick behalten. Bindet ein Endpunkt ein Werkzeug mit hoher Risikoeinstufung, sollte der Endpunkt selbst entsprechend eingestuft sein. Die laufende Prüfung im Editor weist auf Abweichungen hin.

Datenabfluss bei anonymen Endpunkten. Eigene Werkzeuge dürfen nach außen kommunizieren. Bei einem Endpunkt ohne Anmeldung haben Sie keine Identität auf Ihrer Seite — überlegen Sie, ob das Werkzeug personenbezogene Inhalte, etwa den Wortlaut der Frage, nach außen trägt.

Vor dem Veröffentlichen testen. Neue Bindungen lassen sich mit einem Testschlüssel ausprobieren, bevor sie im Echtbetrieb gelten.

Der Quelltext ist auf 200 kB begrenzt. Das reicht für ein sehr umfangreiches Werkzeug — übliche liegen bei wenigen Kilobyte. Ein längerer Quelltext wird schon beim Speichern mit einer Meldung abgelehnt, nicht erst später im Gespräch.

Wer das darf

Eigene Werkzeuge anlegen und binden dürfen Eigentümer und Administration. Mitglieder können sie nutzen, aber nicht anlegen.

Wenn die Funktion ausgeschaltet ist

Der Habicht-Support kann eigene Werkzeuge für einen Arbeitsbereich ausschalten. Dann fehlt der Menüpunkt Eigene Werkzeuge, und auch bereits angelegte Werkzeuge werden nicht mehr angeboten und nicht mehr ausgeführt — weder im Chat noch in Assistenten oder Endpunkten. Gelöscht wird dabei nichts: Wird die Funktion wieder eingeschaltet, stehen die Werkzeuge unverändert wieder zur Verfügung.