Agent installieren und aktualisieren

Anforderungen

• Node.js 20 oder neuer.
• npm oder npx für das aktuelle Benutzerkonto.
• Eine veröffentlichte QA-Studio-Funktion, falls du eine Verbindung zu QA Studio herstellen möchtest.

Ein Administratorkonto oder eine globale Installation ist nicht erforderlich.

Mit dem veröffentlichten Paket starten

Verwende das veröffentlichte Paket in einem regulären Terminal:

npx @xyva/agent login
npx @xyva/agent start

Schließe die Anmeldung nur über den freigegebenen interaktiven Ablauf ab. Gib Tokens, API-Schlüssel oder Zugangsdaten nicht in Kommandoargumenten, URLs, Tickets, Chatnachrichten oder öffentlichen Issues an.

Prüfen und aktualisieren

Nutze den Statusbefehl des Agent, um den lokalen Anmeldestatus zu prüfen:

npx @xyva/agent status

Um eine später veröffentlichte Version zu erhalten, beende den laufenden Prozess und führe denselben npx @xyva/agent-Befehl erneut aus. Prüfe vor dem Aktualisieren einer Produktverbindung die Kompatibilität.

Der vorbereitete Flow-Agent-/Vertragskandidat ist kein Installationsweg: Ein npm-next-Release und der Flow-Consumer sind noch nicht veröffentlicht.

Diagnose

Prüfe Anmeldung und Providerstatus, ohne Zugangsdaten auszugeben:

npx @xyva/agent status
npx @xyva/agent provider status

Füge Kommandohistorie, lokale Pfade, Modell-Prompts oder Providerdetails nicht in einen öffentlichen Bericht ein. Der Provider-Preview benötigt ein veröffentlichtes kompatibles Release, eine eingeladene Flow-Sitzung, Berechtigung, produktspezifisches Pairing und eine lokale Freigabe des exakten Providers. Auch dann bleibt er von der Workflow-Ausführung getrennt und auf 32 Ausgabetokens begrenzt.

Der kompatible Flow-Pairing-Pfad fordert automatisch aus der angemeldeten, HttpOnly-gebundenen Flow-Sitzung einen 60 Sekunden gültigen Einmal-Grant an und bindet ihn an die Challenge des exakten lokalen Pairing-Tokens. Der Agent verlangt unabhängig davon eine gültige lokale Lizenz und erstellt eine reine Flow-Sitzungsfamilie für höchstens fünf Minuten. Kopiere Pairing-Token oder Berechtigungs-Grant niemals in URLs, Kommandoargumente, Logs, Tickets, Chats, Screenshots oder öffentliche Issues.

Stoppen und deinstallieren

Beende einen im Vordergrund laufenden Agent mit Ctrl+C und entferne danach die lokale Produktsitzung:

npx @xyva/agent logout

Lösche jede Providerkonfiguration, die der Agent nicht mehr behalten soll:

npx @xyva/agent provider delete ollama --yes
npx @xyva/agent provider delete lmstudio --yes
npx @xyva/agent provider delete openai --yes
npx @xyva/agent provider delete claude --yes
npx @xyva/agent provider delete gemini --yes

Der dokumentierte npx-Weg installiert kein globales Agent-Paket. Falls du es separat global installiert hast, entferne diese Installation als regulärer Benutzer mit npm uninstall -g @xyva/agent; verwende keine Administratorrechte.

Vorbereitete produktneutrale Provider-Einrichtung

Der geprüfte Kandidat ergänzt eine produktneutrale Provider-CLI, damit Flow für die anfängliche lokale Einrichtung nicht QA Studio benötigt:

npx @xyva/agent provider status
npx @xyva/agent provider configure ollama --model MODEL_ID
npx @xyva/agent provider configure openai --model MODEL_ID
npx @xyva/agent provider grant ollama --product flow --yes

Ersetze MODEL_ID durch eine Kennung aus dem freigegebenen Provider-Readiness- Ablauf; diese Anleitung verspricht keinen aktuellen Modellnamen.

Cloud-Schlüssel werden nur über eine verdeckte interaktive Eingabe im Terminal abgefragt und vor der Speicherung über den festen Modelllisten-Endpunkt des Providers geprüft. Sie werden nicht in Kommandoargumenten, Pipes, URLs oder providerspezifischen Umgebungsvariablen akzeptiert.

Konfiguration autorisiert Flow nicht. Jeder Provider beginnt mit flow=denied; der lokale Agent-Eigentümer muss genau einen konfigurierten Provider mit provider grant <provider> --product flow --yes freigeben. provider revoke <provider> --product flow --yes entzieht diese Zustimmung, ohne QA-Studio-Einstellungen zu löschen. Der Austausch eines Cloud-Schlüssels entfernt die betreffende Flow-Freigabe und erfordert eine neue Zustimmung. Produkt-Login, Berechtigung und Flow-Pairing bleiben getrennte Pflichtprüfungen. Diese Befehle werden erst dann zu einem Installationsweg, wenn der passende Agent-Kompatibilitätshinweis veröffentlicht ist.