Zum Hauptinhalt springen

Eigenen Agenten einbinden (BYOA) mit Level CLI

Connect your coding agent to Level CLI to inspect your fleet and draft scripts, automations, and monitor policies.

Level CLI kann eine Agenten-Skill generieren, die einem kompatiblen Coding-Agenten beibringt, wie Ihre installierte Version von lvl. Sie wählen den Coding-Agenten, das Modell und den Token-Anbieter. Level stellt die CLI-Befehle und die generierte SKILL.md Referenz.

ℹ️ HINWEIS: Level hostet das Sprachmodell nicht und stellt keine Modell-Tokens bereit. Ihr Coding-Agent läuft in Ihrer Umgebung und ruft lvl mit den Berechtigungen Ihrer aktiven Level-Sitzung verwendet wird.

Bevor Sie beginnen

Sie benötigen:

  • Level CLI installiert und angemeldet.

  • Einen Coding-Agenten, der die Agenten-Skills laden kann SKILL.md Format.

  • Berechtigung, eine Skill auf Benutzer- oder Projektebene für diesen Agenten zu installieren.

Führen Sie lvl --help, dann lvl auth status um zu bestätigen, dass die CLI verfügbar und bei der vorgesehenen Level-Organisation angemeldet ist.

Die generierte Skill überprüfen

Verwenden Sie diese Befehle, um zu prüfen, was der Coding-Agent empfangen wird:

  • lvl skill show gibt die generierte Skill aus, ohne sie zu installieren.

  • lvl skill describe device list zeigt einen Befehl, seine Flags und seine JSON-Ausgabestruktur an.

  • lvl skill describe automation zeigt alle Befehle der Automatisierungsgruppe an.

  • lvl skill describe gibt die vollständige generierte Befehlsreferenz aus.

Die Skill wird aus dem Befehlsbaum Ihrer installierten CLI generiert, sodass ihre Befehle und Ausgabedefinitionen mit dieser Version von lvl.

Die Skill für Ihr Benutzerkonto installieren

Führen Sie lvl skill install.

Die kanonische Skill wird in ~/.agents/skills/level/SKILL.md. Dieser Speicherort wird von Codex, Cursor, Gemini CLI und anderen Agenten verwendet, die das Standard- ~/.agents/skills Verzeichnis.

Wenn Claude Code bereits auf dem Computer konfiguriert ist, lvl installiert oder verknüpft die Skill auch unter ~/.claude/skills/level. Wenn symbolische Links nicht verfügbar sind, kopiert das Installationsprogramm die Skill stattdessen.

Die Skill in einem Projekt installieren

Verwenden Sie eine Installation auf Projektebene, wenn die Skill ein Repository oder Arbeitsverzeichnis begleiten soll.

  1. Wechseln Sie mit cd YOUR_PROJECT_DIRECTORY.

  2. Führen Sie lvl skill install --project.

Der Befehl schreibt die kanonische Skill in ./.agents/skills/level/SKILL.md. Außerdem wird die Skill am Claude Code-Speicherort installiert oder verknüpft unter ./.claude/skills/level.

Lesen Sie die Dokumentation Ihres Coding-Agenten, um zu überprüfen, welches Agenten-Skills-Verzeichnis er liest.

⚠️ WARNUNG: Eine Skill auf Projektebene kann in die Quellcodeverwaltung eingecheckt werden. Überprüfen Sie die generierte Datei und Ihre Repository-Richtlinie, bevor Sie sie eincheck. Die generierte Skill enthält keine Ihre Level-Anmeldedaten, beschreibt jedoch Befehle, die auf Ihr Level-Konto zugreifen können, wenn sie in einer authentifizierten Umgebung ausgeführt werden.

Den Coding-Agenten anweisen, lvl zu verwenden

Starten Sie nach der Installation der Skill eine neue Coding-Agenten-Sitzung im gleichen Benutzer- oder Projektkontext. Geben Sie dem Agenten ein klares Ziel, ein erwartetes Ergebnis und eine Berechtigungsgrenze vor.

Die folgenden Eingabeaufforderungen verwenden Blockzitate, damit sie auf kleineren Bildschirmen umbrechen. Ersetzen Sie die Beispielnamen durch Ressourcen aus Ihrem Level-Konto.

Untersuchen ohne Änderungen vorzunehmen

Verwende lvl, um alle Geräte in der Gruppe „Servers" aufzulisten. Gib die Geräte-IDs, Namen, Betriebssysteme, Online-Status, aktive Warnungen und verfügbare Aktualisierungen zurück. Nimm keine Änderungen vor.

Dies zeigt, wie ein Agent Geräte-, Warn- und Aktualisierungsdaten zu einer Flottenübersicht zusammenführen kann.

Ein Diagnoseskript entwerfen

Verwende lvl, um web-01 zu untersuchen und sein Betriebssystem zu ermitteln. Erstelle ein schreibgeschütztes Speicherplatz-Skript für dieses Betriebssystem. Zeige mir das vollständige Skript, die Zielgeräte-ID, die Shell, die Ausführen-als-Einstellung, das Timeout und den genauen lvl-Befehl. Erstelle das Skript nicht und führe es nicht aus.

Nach der Überprüfung des Skripts können Sie den Agenten bitten, es mit lvl script create oder es mit lvl script run.

Eine neue Automatisierung erstellen

Verwende lvl skill describe automation um die aktuellen Automatisierungsbefehle und das Spezifikationsformat zu überprüfen. Entwerfe eine neue Automatisierung namens „Disk Space Triage", die auf die Gruppe „Servers" abzielt, eine schreibgeschützte Festplattendiagnose ausführt und die Ausgabe aufzeichnet. Schreibe die vorgeschlagene YAML-Spezifikation auf den Datenträger und erkläre jeden Trigger, jede Aktion, jede Variable und jedes Ziel. Erstelle die Automatisierung nicht.

Nach der Überprüfung der Spezifikation bitten Sie den Agenten, sie mit lvl automation create -f AUTOMATION_SPEC.

⚠️ WARNUNG: Das Erstellen einer Automatisierung aus einer Spezifikation wendet eine Abfolge von Mutationen an. Es ist nicht transaktional. Wenn ein Schritt fehlschlägt, kann die Automatisierung nur teilweise erstellt bleiben. Überprüfen Sie die vollständige Spezifikation vor der Erstellung und notieren Sie die von einem Fehler zurückgegebene Automatisierungs-ID.

Eine bestehende Automatisierung sicher ändern

Exportiere die Automatisierung „Patch Servers" mit lvl automation spec. Schlage die kleinste YAML-Änderung vor, die nötig ist, um einen Warte-auf-Genehmigung-Schritt vor der Patch-Installation hinzuzufügen. Zeige mir den Diff, dann führe lvl automation apply mit --dry-run. Wende die Änderung nicht an.

Dieser Arbeitsablauf ermöglicht es dem Agenten, die aktuelle Vollzustandsspezifikation zu prüfen, sie zu bearbeiten und eine Vorschau anzuzeigen, wie sie mit der laufenden Automatisierung abgeglichen werden würde.

⚠️ WARNUNG: Das Anwenden einer Automatisierungsspezifikation kann vorhandene Trigger oder Aktionen löschen, die in der Datei fehlen. Die Anwendung ist nicht transaktional. Überprüfen Sie stets die vollständige Datei und das Probelauf-Ergebnis, bevor Sie sie anwenden.

Eine Monitor-Richtlinie erstellen

Verwende lvl skill describe monitor policy und lvl skill describe monitor add um die aktuellen Monitor-Richtlinien- und Monitor-Nutzlastformate zu prüfen. Entwerfe eine Richtlinie „Server Health" für das Tag „Servers" mit CPU-, Arbeitsspeicher- und Festplattenplatz-Monitoren. Füge die vorgeschlagenen Schwellenwerte, Dauern, Schweregrade, Warnungsempfänger und Ziel-Tags hinzu. Schreibe die YAML-Spezifikation auf den Datenträger und erkläre jede Einstellung. Erstelle die Richtlinie nicht.

Bitten Sie nach der Überprüfung den Agenten, die Richtlinie mit lvl monitor policy create -f POLICY_SPEC.

Das Erstellen einer Monitor-Richtlinie aus einer Spezifikation ist ebenfalls eine nicht-transaktionale Abfolge. Ein Fehler kann eine teilweise erstellte Richtlinie hinterlassen. Überprüfen Sie daher die zurückgegebene Richtlinien-ID und korrigieren Sie sie mit lvl monitor policy apply -f POLICY_SPEC zu erstellen, falls nötig.

Eine bestehende Monitor-Richtlinie ändern

Exportiere die Monitor-Richtlinie „Server Health". Füge einen schreibgeschützten Skript-Monitor hinzu, der den Anwendungsgesundheits-Endpunkt prüft. Zeige mir den vorgeschlagenen Skript- und Richtlinien-Diff, dann führe lvl monitor policy apply mit --dry-run. Wende die Änderung nicht an.

Der Monitor-Richtlinien-Abgleich gleicht die aktive Richtlinie mit der Datei ab. Monitore, die in der Spezifikation fehlen, können gelöscht werden. Der Agent sollte daher die vollständig exportierte Richtlinie prüfen, anstatt ein partielles Update zu erstellen.

Überwachung und Behebung verbinden

Prüfe die Monitor-Richtlinie „Server Health" und die Automatisierung „Restart Web Service". Stelle fest, ob der aktuelle Monitor-Typ den vorgesehenen Behebungsablauf unterstützt. Entwerfe die kleinsten Richtlinien- und Automatisierungsänderungen, die nötig sind, um zuerst eine Warnung auszulösen und die vorhandene Behebung erst nach Genehmigung auszuführen. Zeige beide Diffs und Probelaufpläne. Wende keine der Änderungen an.

Diese Eingabeaufforderung veranlasst den Agenten, die aktuellen Monitor- und Automatisierungsschemata der installierten CLI zu prüfen, bevor er einen verbundenen Arbeitsablauf vorschlägt.

Wiederverwendbare Ressourcen organisieren

Verwende lvl, um Skripte, Automatisierungen, Monitor-Richtlinien, Tags, Gerätegruppen und Repository-Dateien im Zusammenhang mit dem Patching zu inventarisieren. Identifiziere doppelte Namen und mehrdeutige Verweise. Schlage einen einheitlichen Gruppierungs- und Benennungsplan vor. Benenne, verschiebe oder lösche nichts.

Ein schreibgeschütztes Inventar ist ein nützlicher erster Schritt, bevor ein Agent gemeinsam genutzte Ressourcen neu organisieren soll.

Befehle vor der Ausführung prüfen

Überprüfen Sie diese Details, bevor Sie einen vorgeschlagenen Befehl ausführen lassen:

  1. Bestätigen Sie das aktive Level-Profil und die Organisation mit lvl auth status.

  2. Bestätigen Sie jeden Geräte-, Gruppen-, Skript-, Automatisierungs-, Monitor-Richtlinien-, Tag- oder Dateiverweis.

  3. Bevorzugen Sie IDs, wenn Namen mehrdeutig sind.

  4. Überprüfen Sie das vollständige Skript oder die Vollzustandsspezifikation.

  5. Verlangen Sie --dry-run für Automatisierungs- und Monitor-Richtlinien-Anwendungsbefehle.

  6. Bestätigen Sie, ob ein Befehl auf den Abschluss wartet oder nur eine asynchrone Aufgabe anfordert.

  7. Fordern Sie den Agenten auf, vor Erstellungs-, Anwendungs-, Lösch-, Neustart-, Herunterfahren-, Aktualisierungsinstallations- oder anderen privilegierten Aktionen innezuhalten, sofern Sie nicht beabsichtigen, diese zu genehmigen.

⚠️ WARNUNG: Die Skripterstellung und Ad-hoc-Skriptausführungen verwenden standardmäßig die SYSTEM Ausführen-als-Einstellung, sofern Sie keinen anderen Wert wählen. Skripte und Automatisierungsaktionen können privilegierte Änderungen an verwalteten Geräten vornehmen. Geben Sie --run-as current_user wenn dies der beabsichtigte Umfang ist, und überprüfen Sie jedes Skript vor der Ausführung.

Permanente Löschbefehle erfordern eine Bestätigung. In einer nicht interaktiven Sitzung schlagen Befehle, die eine Bestätigung erfordern, fehl, sofern nicht --yes angegeben ist. Einige Aktionen, darunter Geräteneustart und Herunterfahren, fordern die Aktion sofort an und haben keine Bestätigungsaufforderung.

Die Skill nach einem lvl-Upgrade aktualisieren

Die Skill und die Befehlsreferenz werden aus Ihrer installierten CLI-Version generiert. Nach dem Upgrade von lvl, führen Sie lvl skill install erneut aus.

Führen Sie für eine Installation auf Projektebene lvl skill install --project.

Dadurch bleiben der Befehlsindex, die Flags und die JSON-Ausgabedefinitionen Ihres Coding-Agenten mit der installierten Binärdatei synchronisiert.

Fehlerbehebung

Der Coding-Agent findet die Skill nicht

  1. Führen Sie lvl skill install erneut aus und notieren Sie das angegebene Ziel.

  2. Bestätigen Sie, dass Ihr Coding-Agent dieses Agenten-Skills-Verzeichnis liest.

  3. Starten Sie die Coding-Agenten-Sitzung nach der Installation oder Aktualisierung der Skill neu.

  4. Verwenden Sie lvl skill show um zu bestätigen, dass die CLI die Skill generieren kann.

Ein Befehl in der Skill stimmt nicht mit lvl überein

Installieren Sie die Skill mit demselben lvl Binärdatei, die der Coding-Agent aufrufen wird. Wenn mehrere lvl Binärdateien sich in Ihrem PATH, führen Sie lvl --help, dann verwenden Sie lvl skill describe COMMAND um den aktuellen Befehl zu prüfen.

Die installierte CLI und lvl skill describe sind die maßgebliche Quelle für die verfügbaren Befehle und Flags.

Hat dies deine Frage beantwortet?