Studio mit einem Browser-Agenten steuern

Damit lässt du einen KI-Agenten im Browser, etwa Gemini oder Claude in Chrome, im offenen Studio-Tab Drift prüfen, die Review-Warteschlange abarbeiten und Einträge korrigieren. Für die Projekteinrichtung oder den Fernzugriff ist das nicht gedacht.

Du brauchst:

• ein laufendes Studio über deinem Projekt (In Studio prüfen);
• Chrome 149 oder neuer mit aktiviertem chrome://flags/#enable-webmcp-testing oder einen Browser mit nativer WebMCP-Unterstützung, in einem normalen Fenster statt headless.

Die Tools einschaltenLink zu diesem Abschnitt kopieren

verbatra studio --expose-agent-tools

VERBATRA_STUDIO_AGENT_TOOLS=1 bewirkt dasselbe; wie Flag und Variable aufgelöst werden, steht unter Ausgaben und Agent-Tools. Öffne die ausgegebene URL im WebMCP-Browser, und der Agent in diesem Tab findet die Tools. In einem Browser ohne WebMCP registriert Studio nichts, und das Dashboard bleibt unverändert.

Damit der Agent deinen Provider aufrufen darf, startest du Studio zusätzlich mit --allow-spend.

Der Agent liest jeden Wert ungeschwärzt, so wie die Seite ihn zeigt, weil ein Agent im Tab die Seite ohnehin lesen kann. Ausnahmen sind die Glossar-Tools und verbatra_history_keyRevisions: Ihre Werte durchlaufen eine Geheimnis-Schwärzung, ein Wert in der Form eines API-Schlüssels kommt daher als Platzhalter zurück. Willst du Werte vor einem Agenten verbergen, nutze stattdessen den MCP-Server mit --redact-values; für ein NDA-Projekt siehe Studio und MCP.

Wissen, was der Agent aufrufen kannLink zu diesem Abschnitt kopieren

Jedes Tool ist eine Studio-Aktion mit dem Präfix verbatra_. Lese-Tools sind als nur lesend markiert, Schreib-Tools ändern nur deine lokalen Dateien, und kostenpflichtige Tools werden nur mit --allow-spend registriert.

Lese-ToolsLink zu diesem Abschnitt kopieren

Schreib-ToolsLink zu diesem Abschnitt kopieren

Kostenpflichtige ToolsLink zu diesem Abschnitt kopieren

verbatra_key_integrity liefert nur die Locales, in denen sich die Quelle des Keys geändert hat; eine leere Liste heißt also, dass nichts zu prüfen war. Seine Zeilen sind flacher als die von key.integrity im MCP-Server. Nur der MCP-Server hat project.doctor und report.provenance. verbatra_locale_values blättert wie sein locale.values, mit denselben limit und cursor (Weitere Eingaben und Ergebnisse).

Die Regeln der Tools kennenLink zu diesem Abschnitt kopieren

Jeder Aufruf läuft über den eigenen, angemeldeten Loopback-RPC des Dashboards, mit derselben Eingabeprüfung und demselben Integritäts-Gate: Ein Wert, der eine Prüfung nicht besteht, wird abgelehnt, nicht geschrieben.

Regeln je AufrufLink zu diesem Abschnitt kopieren

• Herkunft: Eine Änderung durch den Agenten wird mit der Herkunft agent festgehalten und bleibt in der Review-Warteschlange; eine Änderung im Dashboard ist human. Die Lese-Tools melden, wer welchen Wert geschrieben hat (Die Lock-Datei).
• Menschliche Arbeit: Neu übersetzen verweigert den Wert einer Person mit KEY_PROTECTED (außer bei humanEdits: "overwrite") und einen gepinnten Key mit KEY_PINNED, Bearbeiten verweigert einen gepinnten Key (Menschliche Übersetzungen behalten).
• Review-Entscheidungen: Freigeben und Ablehnen geben nur deine Entscheidung weiter. Beide brauchen reviewer, den Namen der Person, und expectedValue, den geprüften Text; ein geänderter Wert wird mit REVIEW_VALUE_CHANGED abgelehnt.
• Keine Sammel-Tools: Approve selected, Reject selected, Retranslate selected, Approve all in und Search and replace bleiben Menschen vorbehalten.
• Erst schätzen: Eine unbekannte Locale wird mit UNKNOWN_LOCALE abgelehnt, bevor etwas ausgegeben wird, und es gilt das niedrigere maxTokens von Aufruf und Konfiguration (Kosten vor einem Lauf schätzen).
• Rate-Limits: pro gleitender Minute 20 Neuübersetzungen, 20 Bearbeitungen, 20 Glossar-Schreibvorgänge, 60 Review-Entscheidungen und 5 Translate-Pending-Aufrufe, einer zur Zeit.

Einen fehlgeschlagenen Aufruf lesenLink zu diesem Abschnitt kopieren

Jedes Tool liefert den Umschlag des Dashboards, ein Fehler sieht also so aus: { "ok": false, "error": { "code": ..., "message": ... } }. Neben den Codes des SDK ergänzt die RPC-Schicht:

Eingeschränkte Tools behebenLink zu diesem Abschnitt kopieren

Lehnt der Browser eine Registrierung ab, zeigt jede Ansicht eine Warnung wie:

Agent tools degraded: 2 of the agent tool registrations failed with SecurityError. The dashboard itself is unaffected. The browser console lists every failing tool.

Die Konsole enthält eine Zeile, die jeden Fehler nennt:

Verbatra agent tools: 2 of 20 tool registrations failed. verbatra_status_diff (SecurityError: ...); verbatra_key_value (SecurityError: ...)

Lies dort zuerst den Fehlernamen und lade dann den Tab neu, damit die Registrierung erneut läuft. Ein fehlendes Flag oder ein Browser ohne WebMCP zeigt diesen Hinweis nie; dann wird stillschweigend nichts registriert. Eine Sitzung ohne --allow-spend versucht zwei Registrierungen weniger, und das ist kein Fehler.

Das Ausgabenrisiko abwägenLink zu diesem Abschnitt kopieren

Die Tools öffnen nichts Neues im Netz: Studio bindet weiterhin nur an 127.0.0.1, jede Anfrage trägt das Sitzungs-Token, und Tools, die Projekttext liefern, markieren ihn als nicht vertrauenswürdig, damit der Agent ihn als Daten behandelt.

Siehe auchLink zu diesem Abschnitt kopieren

• In Studio prüfen: derselbe Ablauf von Hand.
• verbatra studio: jedes Flag und der Startvertrag.
• Einen MCP-Client verbinden: Das Plugin bringt den Skill verbatra-studio-agent-tools mit, Studio startest du aber selbst.