Skills und Rules
Wenn Sie MCP an einen LLM-Agenten anbinden, kann der Agent die WEEGLOO API direkt aufrufen. Eine API aufrufen zu können ist jedoch etwas anderes, als diese API genau so zu nutzen, wie WEEGLOO es vorsieht. Allein anhand der Aufrufmethode lässt sich zum Beispiel nicht erkennen, in welcher Situation CMA und in welcher CDA zu verwenden ist, wie die Felder eines Content Type zu entwerfen sind oder welche Berechtigungen einem Delivery Access Token zugeordnet werden müssen, damit es sicher ist.
Skills und Rules sind die zwei Hilfen, die diese Lücke schließen. Skills sind Anleitungen, die festhalten, wie eine bestimmte Aufgabe gut ausgeführt wird, und Rules sind Regeln, die über die gesamte Arbeit hinweg einzuhalten sind. Das Installations-Tool (npx weegloo@latest) kann beide zusammen mit der MCP-Anbindung installieren.
Der Unterschied zwischen Skills und Rules
Beide haben gemeinsam, dass sie dem Agenten Informationen geben, doch ihre Rolle ist unterschiedlich.
Skills sind Anleitungen, die in Schritten und Mustern festhalten, wie eine bestimmte Aufgabe ausgeführt wird. Es gibt einen pro Aufgabe, und der Agent liest und befolgt den jeweiligen Skill, sobald er die Aufgabe beginnt. Für Aufgaben wie den Entwurf eines Content Type, die Auswahl der Servicestruktur oder die Ausstellung eines Delivery Access Token gibt es zum Beispiel jeweils einen Skill. Der Agent folgt dadurch erprobten Methoden statt Vermutungen.
Rules sind Regeln, die unabhängig von der Art der Aufgabe immer einzuhalten sind. Dazu zählen zum Beispiel die Basisadresse der WEEGLOO API, die Art und Weise, eine Ressourcenliste seitenweise abzurufen, oder die Vorgabe, beim Ändern einer Ressource die Versionsinformation mitzusenden. Der Agent wendet diese Regeln während der gesamten Arbeit im Hintergrund an.
Zusammengefasst sind Skills aufgabenspezifische Anleitungen nach dem Motto „Diese Aufgabe macht man so“, und Rules sind gemeinsame Regeln nach dem Motto „Egal welche Aufgabe, das hält man ein“.
Installieren
Skills und Rules werden vom MCP-Installations-Tool mitinstalliert. Führen Sie dazu im Terminal Folgendes aus.
npx weegloo@latestBeim Ausführen werden nacheinander die anzubindende Umgebung (Agent) und das Personal Access Token abgefragt, und zusammen mit dem MCP-Server werden Skills und Rules in der jeweiligen Umgebung installiert. Der Installationsvorgang und die Konfiguration je Umgebung werden unter Anbindung behandelt.
Mit @latest wird stets die neueste Version installiert. Wie Sie eine bereits vorhandene Installation auf den neuesten Stand bringen, wird unter Auf dem neuesten Stand halten behandelt.
Auf dem neuesten Stand halten
Mit der Installation von Skills und Rules ist es nicht getan. Immer wenn WEEGLOO neue Funktionen erhält und sich die empfohlene Vorgehensweise ändert, werden auch diese Anleitungen mit aktualisiert. Was auf Ihrem Rechner installiert ist, ist dagegen eine Kopie vom Zeitpunkt der Installation und bleibt auf diesem Stand stehen.
Wenn die Installation veraltet, geschieht zweierlei. Neu hinzugekommene Skills und Rules fehlen in der Installation vollständig, sodass der Agent nicht weiß, wie er mit diesen Funktionen umgeht. Und wenn sich der Inhalt bereits vorhandener Einträge geändert hat, folgt der Agent weiterhin der alten Anleitung. In beiden Fällen arbeitet der Agent nicht nach dem heutigen WEEGLOO, sondern nach dem WEEGLOO vom Zeitpunkt der Installation. Daran entscheidet sich die Qualität der Ergebnisse, die der Agent liefert, und deshalb halten Sie Skills und Rules am besten auf dem neuesten Stand.
Aktuell zu halten sind die auf Ihrem Rechner installierten Skills und Rules. Beim MCP-Server gibt es nichts gesondert zu aktualisieren.
Wenn eine neue Version erscheint, weist der Agent Sie darauf hin. Der Agent prüft zu Beginn einer WEEGLOO-bezogenen Aufgabe die installierte Version und zeigt nichts an, wenn sie aktuell ist. Nur wenn es etwas zu aktualisieren gibt, zeigt er einen Hinweis wie den folgenden zusammen mit dem auszuführenden Befehl an.
Diese Aktualisierung läuft nicht automatisch. Da dabei installierte Dateien neu geschrieben werden, wird sie erst nach Ihrer Bestätigung ausgeführt. Wenn der Hinweis erscheint, führen Sie den Befehl am besten gleich an Ort und Stelle aus, statt es aufzuschieben. Führen Sie den im Hinweis angezeigten Befehl unverändert im Terminal aus.
An den Stellen --agent und --location stehen die bei der Installation gewählte Umgebung und der gewählte Ort, sodass der Befehl je nach Installationsstand abweicht. Wenn Sie den im Hinweis angezeigten Befehl unverändert übernehmen, stehen dort die passenden Werte.
Statt den Befehl selbst einzugeben, können Sie dem Agenten auch sagen: „Aktualisiere weegloo“. Der Agent kennt den auszuführenden Befehl bereits, sodass Sie nicht nachschlagen müssen, welcher Befehl zu verwenden ist.
Was eine Aktualisierung beibehält und was sie ändert
Eine Aktualisierung ist keine Neuinstallation von Grund auf. Sie behält die bei der ersten Installation getroffene Auswahl bei und bringt nur die Inhalte auf den neuesten Stand.
- Die bei der Installation getroffene Auswahl an Skills und Rules bleibt unverändert erhalten. Wenn Sie nur einen Teil installiert haben, bleibt es dabei.
- Skills und Rules, die seit der letzten Installation neu hinzugekommen sind, werden automatisch mitinstalliert. Einträge, die Sie bei der Installation bewusst ausgeschlossen haben, bleiben weiterhin ausgeschlossen.
- Einträge, die im Repository gelöscht wurden, werden auch von Ihrem Rechner entfernt.
- Die bei der Installation gewählte Version bleibt bestehen.
- Die Konfiguration des MCP-Servers wird nicht angetastet. Deshalb ist für eine Aktualisierung kein Personal Access Token nötig.
Wenn Sie eine installierte Skill- oder Rule-Datei von Hand gelöscht haben, installiert die Aktualisierung diese Datei erneut. Um einen Eintrag zu entfernen, löschen Sie die Datei nicht, sondern führen Sie den Installationsbefehl erneut aus und wählen ihn im Auswahlbildschirm ab.
Die aktualisierten Inhalte gelten ab einer neuen Unterhaltung. Der Agent liest Skills und Rules zu Beginn einer Unterhaltung ein, sodass eine laufende Unterhaltung weiterhin die bisherigen Inhalte verwendet.
Selbst nachschauen
Skills und Rules liegen in einem öffentlichen Repository. Wenn Sie die installierten Inhalte selbst öffnen oder prüfen möchten, welche Anleitung es für welche Aufgabe gibt, können Sie das Repository heranziehen.
- Repository: github.com/weeglooapi/weegloo-mcp-plugin
Skills und Rules liegen im Repository unter plugins/weegloo/ jeweils in den Verzeichnissen skills/ und rules/.
- Skills-Verzeichnis: plugins/weegloo/skills
- Rules-Verzeichnis: plugins/weegloo/rules
Auch wenn Sie ohne das Installations-Tool direkt anbinden, können Sie die Dateien aus dem obigen latest-Pfad unverändert übernehmen.