Dieser Leitfaden beschreibt, wie sich ein bestehender KI-Skill ändern lässt, ohne die Version zu beschädigen, die das Team täglich nutzt. Er richtet sich an Organisationsadministratoren. Für den Einstieg in Skills empfiehlt sich zuerst der Artikel KI Skills.
Warum der Prozess wichtig ist
Ein Skill ist keine Liste unabhängiger Einstellungen. Er ist eine zusammenhängende Workflow-Beschreibung in natürlicher Sprache. Eine geänderte Formulierung am Ende eines Skills kann beeinflussen, wie sich der Agent am Anfang verhält. Und da das Team den Skill bereits produktiv nutzt, ist eine ungetestete Änderung sofort für alle sichtbar.
Die folgenden vier Schritte halten die funktionierende Version unangetastet, während die neue Version entsteht und getestet wird.
Skills finden sich in Bliro unter Einstellungen > Organisation > Skills. Nur Organisationsadministratoren können Skills erstellen, bearbeiten oder deaktivieren, und jede Änderung gilt für die gesamte Organisation.
Schritt 1: Ein Backup anlegen
Ein aktiver Skill sollte nie direkt bearbeitet werden. Gearbeitet wird immer an einer Kopie. Wie diese Kopie entsteht, hängt von der Art des Skills ab.
Von Bliro bereitgestellte Skills. System-Skills, die mit Bliro ausgeliefert werden, haben oben rechts im Skill die Schaltfläche Duplizieren. Ein Klick darauf erzeugt eine vollständige Kopie.
Eigene Skills. Selbst erstellte Skills haben keine Schaltfläche zum Duplizieren. Die Kopie entsteht manuell:
Den zu bearbeitenden Skill öffnen und den vollständigen Inhalt von Titel, Beschreibung und Anweisungen markieren.
Oben rechts auf + klicken, um einen neuen Skill zu erstellen.
Einen neuen Namen vergeben, zum Beispiel den alten Namen mit angehängtem
-v1, dazu eine künstliche Triggerphrase und einen Platzhaltertext als Anweisung. Nach dem Erstellen den vollständigen Anweisungstext des zu ändernden Skills in den Anweisungstext des neuen Skills einfügen.
Unabhängig davon, wie die Kopie entstanden ist: sie so benennen, dass sich die Versionen unterscheiden lassen, zum Beispiel durch ein angehängtes -v1. Die Kopie deaktiviert lassen oder ihr direkt einen Testtrigger geben, wie in Schritt 3 beschrieben, damit sie während der Bearbeitung nicht mit dem aktiven Skill konkurriert.
Damit läuft der funktionierende Skill weiter für das Team, und daneben steht eine Kopie zum Experimentieren. Geht eine Änderung schief, wird die Kopie einfach gelöscht und nichts ist verloren.
Schritt 2: Änderungen vornehmen
Nun die Anweisungen der neuen Version bearbeiten. Zwei Dinge sind vorher wichtig zu wissen.
Ein KI-Assistent hilft, den Skill stimmig zu halten. Da ein Skill ein zusammenhängender Workflow ist, erfordert eine Änderung an einer Stelle oft eine passende Änderung an einer anderen. Bewährt hat sich, den vollständigen Skill-Text in einen KI-Assistenten wie Claude, Gemini oder ChatGPT zu kopieren, die gewünschte Änderung zu beschreiben und den Assistenten zu bitten, sie überall dort anzuwenden, wo sie nötig ist. Ein gut instruierter Assistent erkennt Widersprüche zwischen den Schritten und hält den gesamten Skill konsistent.
Die referenzierten Tools prüfen. Skills arbeiten, indem sie Tools aufrufen, zum Beispiel ein Tool, das ein neues Account-Objekt im CRM anlegt. Tools werden über ihre ID referenziert und in den Anweisungen in Backticks geschrieben, etwa crm:create_account. Eine Tool-ID, die es nicht gibt, erhöht die Wahrscheinlichkeit, dass der Agent beim Aufruf dieses Tools Fehler macht. Am Ende jedes Skills steht eine kurze Checkliste der erwähnten Tools. Vor dem Testen anhand dieser Checkliste prüfen, ob jede Tool-ID gültig ist.
Schritt 3: Die neue Version testen
Jeder Skill hat eine Beschreibung. Anhand der Beschreibung entscheidet der Bliro-Assistent, wann der Skill ausgelöst werden soll. Behält die neue Version dieselbe Beschreibung wie das Original, konkurrieren beide Skills um dieselbe Anfrage und es bleibt unklar, welcher geantwortet hat.
Der neuen Version deshalb eine vorläufige Beschreibung mit einem eng gefassten, selbst erfundenen Trigger geben, zum Beispiel:
Diesen Skill auslösen, wenn "Hakuna Matata" gesagt wird.
So bedient der ursprüngliche Skill weiterhin das Team über seinen normalen Trigger, während die neue Version über die Testphrase erreichbar ist. Den Skill mehrfach ausführen, auch mit den Randfällen, die für den eigenen Prozess wichtig sind, und das Ergebnis durchgängig im Zielsystem prüfen.
Schritt 4: Live gehen
Sobald sich die neue Version wie gewünscht verhält:
Den alten Skill über seinen Schalter deaktivieren.
Die vorläufige Testbeschreibung der neuen Version durch die echte Trigger-Beschreibung ersetzen.
Die neue Version auf den eigentlichen Skill-Namen umbenennen.
Einen letzten Test mit einer normalen Anfrage durchführen und bestätigen, dass der Skill wie erwartet auslöst.
Die alte Version eine Zeit lang deaktiviert behalten, statt sie sofort zu löschen. Zeigt sich im Alltag etwas Unerwartetes, ist die Rückkehr in Sekunden möglich.
Quick Checklist
Step | What to do |
1. Backup | Einen Bliro-System-Skill über die Schaltfläche Duplizieren kopieren oder einen eigenen Skill manuell in einen neuen Skill übertragen. Die Kopie umbenennen, zum Beispiel mit der Endung |
2. Bearbeiten | Die Anweisungen ändern, den gesamten Workflow stimmig halten und jede Tool-ID anhand der Checkliste am Ende des Skills prüfen. |
3. Testen | Der neuen Version eine eng gefasste, vorläufige Triggerphrase geben, damit sie ohne Konflikt neben dem Original läuft. |
4. Live gehen | Den alten Skill deaktivieren, die echte Beschreibung und den echten Namen setzen und die alte Version als Rückfalloption behalten. |
Kontakt und Hilfe
Fragen zur Änderung eines Skills oder Unterstützung bei einer größeren Überarbeitung? Eine Nachricht an [email protected] oder an den zuständigen Customer Success Manager genügt.