Lokalen Agenten einrichten

Voraussetzungen

• Node.js 20 oder neuer
• npm/npx für den aktuellen Benutzer
• ein lokales Playwright-Repository
• keine Administratorrechte
• kein npm install -g
• kein sudo

Anmelden und starten

npx @xyva/agent login
npx @xyva/agent start --port 7900

Der Standard-Listener ist 127.0.0.1:7900 und dadurch nicht im LAN oder öffentlichen Internet erreichbar. Das Portal prüft den lokalen Health-Endpunkt und öffnet eine authentifizierte lokale Bridge.

Chrome fragt beim ersten Verbindungsversuch, ob xyva.ai auf Geräte in deinem lokalen Netzwerk zugreifen darf. Erlaube diese Abfrage, damit das Portal den Agenten auf 127.0.0.1 erreichen kann. Der Agent wird dadurch nicht für andere Rechner im LAN freigegeben.

Kopiere den Agent-Verbindungstoken nicht in Tickets, Chats oder Screenshots. Beende den Prozess unter macOS mit Cmd+C, unter Windows/Linux mit Ctrl+C.

Fehlerbehebung

• Nicht erreichbar: Terminalprozess und Port prüfen.
• Browser blockiert die Verbindung: Lokalen Netzwerkzugriff für xyva.ai in den Website-Einstellungen erlauben.
• Authentifizierung erforderlich: npx @xyva/agent login erneut ausführen.
• Protokollversion abweichend: Agent aktualisieren und neu starten.
• Browser fehlt: Chromium über die Agent-Einrichtung in den Benutzer-Cache installieren.