Dokumentation · BoltLynx

Schnellstart

Richten Sie den Rechner oder die isolierte Umgebung ein, in der Agenten handeln sollen. Ein lokaler Client kann mehrere Agenten bedienen.

Installieren Sie den lokalen Client.
Starten Sie den lokalen Client und bestätigen Sie die Kopplungsseite im Browser.
Öffnen Sie die Web-App und erstellen oder wählen Sie einen Agenten.
Wählen Sie den Projektordner, den der Agent verwenden darf.

Lokaler Client für Windows

Laden Sie den Windows-Launcher herunter:

Windows-Launcher herunterladen

Erstellen Sie einen dauerhaften Ordner, den Sie beibehalten, zum Beispiel C:\BoltLynx, und entpacken Sie alle Dateien aus dem ZIP dorthin. Diese Version ist portabel; ein Installationsprogramm ist nicht erforderlich.

Starten Sie boltlynx-desktop.exe nicht direkt aus dem ZIP-Archivfenster. Windows könnte das Programm aus einem temporären Ordner starten, sodass der Launcher und seine lokalen Dateien später schwer wiederzufinden sind.

Doppelklicken Sie im entpackten Ordner auf boltlynx-desktop.exe. Der Windows-Launcher verwaltet den lokalen Client; hier sprechen Sie nicht mit Agenten. Mit ihm starten oder stoppen Sie den Client und öffnen oder kopieren die Kopplungsseite.

Windows kann eine Warnung von Microsoft Defender SmartScreen anzeigen, da diese frühe Version noch nicht signiert ist. Wenn Sie sie über die offizielle Schaltfläche geladen haben, klicken Sie auf More info und dann auf Run anyway.

Wenn die Antivirensoftware den Windows-Launcher meldet

Der lokale Client kann die von Ihnen autorisierten System-, Befehls- und Dateiaktionen ausführen. Nicht signierte Versionen können deshalb heuristische Antivirenmeldungen wie Trojan:Win32/Sprisky.U!cl auslösen. Lassen Sie eine Meldung nicht automatisch zu.

Prüfen Sie zuerst, ob die ZIP-Datei über die offizielle Download-Schaltfläche oben geladen wurde und ob die erkannte Datei C:\BoltLynx\boltlynx-desktop.exe ist. Wenn Quelle, Dateiname oder erkannte Datei nicht übereinstimmen, löschen Sie sie und laden Sie eine neue Kopie über die offizielle Schaltfläche herunter.
Wenn alles übereinstimmt, öffnen Sie Windows-Sicherheit → Viren- & Bedrohungsschutz → Schutzverlauf, öffnen Sie die Erkennung und wählen Sie Auf Gerät zulassen. Wurde die Datei unter Quarantäne gestellt, wählen Sie Wiederherstellen. Die Bezeichnungen können je nach Windows-Version leicht abweichen.
Wenn Defender die bestätigte Datei wiederholt unter Quarantäne stellt, öffnen Sie Einstellungen für Viren- & Bedrohungsschutz → Einstellungen verwalten → Ausschlüsse → Ausschlüsse hinzufügen oder entfernen, wählen Sie Ordner und fügen Sie nur C:\BoltLynx hinzu.

Deaktivieren Sie nicht den Echtzeitschutz und schließen Sie weder Downloads noch den gesamten Benutzerordner oder ein komplettes Laufwerk aus.

Microsoft-Anleitungen: Schutzverlauf und Ordnerausschlüsse.

Lassen Sie den lokalen Client nach der Kopplung im Hintergrund laufen. Öffnen Sie die Web-App, um mit Agenten zu sprechen und den Projektordner auszuwählen, den sie verwenden dürfen.

Wenn ein Update verfügbar ist, kann der Windows-Launcher den neuen lokalen Client herunterladen. Da er portabel ist, bleiben seine lokalen Dateien in dem Ordner, aus dem Sie das Programm starten.

Linux-Kommandozeile

Installieren Sie den lokalen Client:

curl -fsSL https://boltlynx.com/install.sh | bash

Das Installationsprogramm legt die Binärdatei boltlynx unter ~/.boltlynx/bin/ ab und fügt sie dem PATH hinzu. Starten Sie das Terminal neu und dann den lokalen Client. Beim ersten Start zeigt der Befehl einen Link zur Kopplungsseite an; öffnen Sie ihn im Browser und bestätigen Sie. Danach läuft der lokale Client im Hintergrund weiter. Ein weiterer Kopplungsbefehl ist nicht nötig.

boltlynx start

Prüfen Sie den Client-Status jederzeit:

boltlynx status

macOS-Kommandozeile

Installieren Sie den lokalen Client:

curl -fsSL https://boltlynx.com/install.sh | bash

boltlynx start

Prüfen Sie den Client-Status jederzeit:

boltlynx status

Sobald der lokale Client läuft und gekoppelt ist, öffnen Sie die Web-App, erstellen oder wählen einen Agenten und bestimmen den Projektordner, den er verwenden darf.

Web-App öffnen

Lokalen Client aktualisieren

Nach einem Update:

Windows: Aktualisieren Sie den lokalen Client über den Launcher und starten Sie anschließend den Client-Kernel neu.
Linux / macOS: Starten Sie den lokalen Client im Terminal neu.

Lokalen Client neu starten

boltlynx restart

Grundkonzepte

Web-App

Sprechen Sie mit Agenten, erstellen und verwalten Sie Arbeit und entscheiden Sie über die nächsten Schritte. Die Web-App läuft in Ihrem Browser.

Lokaler Client

Der Client läuft auf Ihrem Rechner. Er gibt freigegebenen Agenten Zugriff auf lokale Dateien, Befehle, Datenanalyse, Codesuche und private Fähigkeiten.

Ein Client ist nicht ein einzelner Agent. Er ist eine isolierte Laufzeitumgebung: ein Rechner, ein Container oder ein separater Betriebssystembenutzer. Installieren Sie den Client einmal in dieser Umgebung; er kann mehrere Agenten beherbergen.

Agent

Ein Agent verbindet ein Gespräch mit einer Arbeitsumgebung. Er besitzt einen Gesprächsverlauf, ein Arbeitsverzeichnis, Gedächtnis, aktivierte Fähigkeiten und eigene Anweisungen.

Fähigkeiten

Fähigkeiten geben einem Agenten domänenspezifische Fähigkeiten. Diese Anleitung behandelt Code für Softwarearbeit und Ops für Betriebs- und Datenbanksicherheitsregeln.

spezialisierte Agenten

Ein Hauptagent kann Arbeit an spezialisierte spezialisierte Agenten delegieren. Jeder kann ein eigenes Modell, Arbeitsverzeichnis, Fähigkeiten und eine eigene Rolle besitzen.

Agent konfigurieren

Jeder Agent kann für ein bestimmtes Projekt oder eine bestimmte Arbeitslast eingerichtet werden.

Name, Beschreibung und Arbeitsverzeichnis	Kennzeichnen Sie den Agenten und legen Sie den Stammordner fest, in dem er arbeiten darf.
Fähigkeiten	Aktivieren Sie domänenspezifische Fähigkeiten wie Code oder Ops.
Modell	Wählen Sie Modell und Reasoning-Stufe für die Arbeit.
Dateiberechtigungen	Legen Sie erlaubte, beschreibbare oder gesperrte Pfade fest.
Befehlsberechtigungen	Erlauben oder sperren Sie Befehlsmuster, etwa `git *`, und blockieren Sie destruktive Befehle.
Anweisungen und Gedächtnis	Geben Sie dem Agenten dauerhafte Arbeitsregeln und bearbeitbare Notizen, die er über Gespräche hinweg behalten kann.
spezialisierte Agenten	Konfigurieren Sie spezialisierte Mitarbeitende für größere Aufgaben.
Auslöser und Benachrichtigungen	Führen Sie geplante Prüfungen und durch Webhooks ausgelöste Abläufe aus oder versenden Sie Abschluss- und Warnmeldungen.

Tägliche Nutzung

Öffnen Sie die Web-App. Wählen Sie den Agenten für Ihr Projekt und setzen Sie das Gespräch fort oder geben Sie ihm den nächsten Arbeitsauftrag.
Beschreiben Sie die Arbeit. Geben Sie dem Agenten eine echte Aufgabe, nicht nur einen Prompt.
Lassen Sie ihn arbeiten. Der Agent kann in der freigegebenen Umgebung Dateien lesen und schreiben, Befehle ausführen, Code durchsuchen und Daten analysieren.
Genehmigen Sie sensible Aktionen. Vorgänge, die eine Bestätigung erfordern, fragen zuerst nach menschlicher Freigabe.
Lassen Sie sich benachrichtigen. BoltLynx kann Sie informieren, wenn Arbeit abgeschlossen ist, Auffälligkeiten auftreten oder geplante Aufgaben berichten.

Sicherheitsmodell

BoltLynx ist um klare Grenzen herum aufgebaut. Der Agent arbeitet innerhalb der Verzeichnisse und Befehlsberechtigungen, die Sie konfigurieren.

Dateizugriff wird über das Arbeitsverzeichnis und zusätzliche Erlaubnis- oder Sperrregeln gesteuert.
Sensible Befehle können menschliche Genehmigung erfordern.
Private Fähigkeiten laufen über Ihren lokalen Client, statt als serverseitige Werkzeuge hochgeladen zu werden.
Benachrichtigungen können Abschlüsse, Fehler und geplante Berichte sichtbar machen.

Datengrenzen

BoltLynx ist darauf ausgelegt, lokalen Zugriff und Datenübertragung zu minimieren. Der lokale Client spiegelt Ihren Workspace nicht und durchsucht oder überträgt keine Dateien ohne Bezug zur Arbeit.

Arbeitsinhalte verlassen den Client nur, wenn sie für die Modellverarbeitung, erforderliche Aktionsergebnisse, einen von Ihnen gewählten Onlinedienst oder Betriebsdiagnosen zum Betrieb und Schutz des Dienstes benötigt werden.

Lokalen Client installieren. Mit der Arbeit beginnen.