Docs / Guías
Página traducida automáticamente
Maneja Studio con un agente del navegador
Registra las acciones de revisión de Verbatra Studio como herramientas WebMCP para que un agente de IA del navegador trabaje en tu panel abierto.
Úsalo para que un agente de IA del navegador, como Gemini o Claude en Chrome, revise el desfase, trabaje la cola de revisión y corrija entradas en la pestaña de Studio que tienes abierta. No sirve para configurar el proyecto ni para el acceso remoto.
Necesitas:
- Studio en marcha sobre tu proyecto (Revisar en Studio);
- Chrome 149 o posterior con
chrome://flags/#enable-webmcp-testingactivado, o un navegador con soporte nativo de WebMCP, en una ventana normal y no headless.
Experimental
WebMCP es una capacidad nueva del navegador detrás de un flag, y su superficie aún puede cambiar.
Activa las herramientas
verbatra studio --expose-agent-toolsVERBATRA_ hace lo mismo; Gasto y herramientas de agente explica cómo se resuelven el flag y la variable. Abre la URL impresa en el navegador con WebMCP y el agente de esa pestaña encontrará las herramientas. En un navegador sin WebMCP, Studio no registra nada y el panel no cambia.
Para que el agente pueda llamar a tu proveedor, arranca Studio también con --allow-spend.
El agente lee cada valor sin ocultar, tal como lo muestra la página, porque un agente en la pestaña puede leer la página de todos modos. Las excepciones son las herramientas de glosario y verbatra_: sus valores pasan por una redacción de secretos, así que un valor con forma de clave de API vuelve como marcador. Para ocultar los valores a un agente, usa en su lugar el servidor MCP con --redact-values; para un proyecto bajo NDA, consulta Studio y MCP.
Conoce lo que puede llamar el agente
Cada herramienta es una acción de Studio con el prefijo verbatra_. Las de lectura se marcan como de solo lectura, las de escritura solo cambian tus archivos locales y las de gasto solo se registran con --allow-spend.
Herramientas de lectura
| Herramienta | Qué hace |
|---|---|
verbatra_ | la configuración cargada, las capacidades y, en capabilities.limits, los límites de frecuencia de retranslate, reviewDecision y los dos métodos de reemplazo de valores |
verbatra_ | la cobertura por locale |
verbatra_ | las claves faltantes, cambiadas y huérfanas por locale |
verbatra_ | el glosario resuelto, con los secretos ocultos |
verbatra_ | el estado del archivo de bloqueo por locale |
verbatra_ | los commits recientes en los archivos de locale, con el nombre del autor (nunca el correo) |
verbatra_ | los commits de una clave en un locale, con diferencias por palabra, claves ocultas nuevo |
verbatra_ | las comprobaciones de placeholders, markup e ICU de una clave, en los locales donde cambió su origen |
verbatra_ | cada valor escrito por una máquina que nadie ha aprobado, según los archivos del repositorio |
verbatra_ | el origen y el destino de una clave, con quién escribió el destino |
verbatra_ | la descripción, los términos del glosario y el maxLength de una clave, y la comprobación de un draft opcional |
verbatra_ | valores de clave por locale de destino, 200 por página por defecto, acotados con locales, keys o query |
verbatra_ | cada traducción que no supera las comprobaciones de integridad |
verbatra_ | lo que enviaría y costaría una llamada translate-pending, sin llamar a ningún proveedor |
verbatra_ | el uso de tokens y el presupuesto de la última ejecución |
verbatra_ | las ejecuciones registradas, la más reciente primero, con tokens, coste y cobertura, solo como cifras nuevo |
Herramientas de escritura
| Herramienta | Qué hace |
|---|---|
verbatra_ | cambia un término de un glosario en archivo |
verbatra_ | registra la aprobación de un valor por una persona con nombre |
verbatra_ | registra el rechazo de una persona con nombre y elimina el valor |
verbatra_ | escribe un valor a través del control de integridad |
Herramientas de gasto
| Herramienta | Qué hace |
|---|---|
verbatra_ | vuelve a traducir una clave en un locale |
verbatra_ | traduce todo lo pendiente, opcionalmente solo para algunos locales y con un tope de maxTokens |
verbatra_ solo devuelve los locales donde cambió el origen de la clave, así que una lista vacía significa que no había nada que comprobar. Sus filas son más planas que las de key.integrity en el servidor MCP. Solo el servidor MCP tiene project.doctor y report.provenance. verbatra_ pagina como su locale.values, con los mismos limit y cursor (Más entradas y resultados).
Conoce las reglas de las herramientas
Cada llamada pasa por el RPC de loopback autenticado del propio panel, con la misma validación de entrada y el mismo control de integridad: un valor que falla una comprobación se rechaza, no se escribe.
Reglas por llamada
- Procedencia: una edición del agente se registra con el origen
agenty sigue en la cola de revisión; una edición desde el panel eshuman. Las herramientas de lectura indican quién escribió cada valor (El archivo de bloqueo). - Trabajo humano: volver a traducir rechaza el valor de una persona con
KEY_(salvo conPROTECTED humanEdits: "overwrite") y una clave fijada conKEY_, y editar rechaza una clave fijada (Conserva las traducciones humanas).PINNED - Decisiones de revisión: aprobar y rechazar solo transmiten tu decisión. Ambas necesitan
reviewer, el nombre de la persona, yexpectedValue, el texto revisado; un valor cambiado se rechaza conREVIEW_.VALUE_ CHANGED - Sin herramientas en lote: Approve selected, Reject selected, Retranslate selected, Approve all in y Search and replace quedan para personas.
- Estima primero: un locale desconocido se rechaza con
UNKNOWN_antes de gastar nada, y se aplica elLOCALE maxTokensmás bajo entre la llamada y la configuración (Estima el coste antes de una ejecución). - Límites de frecuencia: por minuto móvil, 20 retraducciones, 20 ediciones, 20 escrituras del glosario, 60 decisiones de revisión y 5 llamadas translate-pending, de una en una.
Lee una llamada fallida
Cada herramienta devuelve el envoltorio del panel, así que un fallo se lee { "ok": false, "error": { "code": ..., "message": ... } }. Además de los códigos del SDK, la capa RPC añade:
| Código | Significado |
|---|---|
REQUEST_ | la petición o la respuesta no era un envoltorio legible |
METHOD_ | el método no existe en esta versión de Studio |
SPEND_ | un método de gasto con el gasto desactivado: Studio corre sin --allow-spend, o el proveedor es none; el mensaje dice cuál |
PARAMS_ | un parámetro no pasó la validación; issues nombra cada campo |
METHOD_ | se superó el límite; retryAfterSeconds indica cuándo cabe la llamada |
BATCH_ | un lote supera una ventana entera del límite; envía menos entradas |
ALREADY_ | una segunda llamada para una entrada que aún está en curso (HTTP 409) |
SESSION_ | Studio se reinició con un token nuevo; abre la URL que imprimió |
INTERNAL | un handler falló con un error inesperado (HTTP 500); el mensaje es genérico |
Arregla las herramientas degradadas
Si el navegador rechaza un registro, cada vista muestra un aviso como:
Agent tools degraded: 2 of the agent tool registrations failed with SecurityError. The dashboard itself is unaffected. The browser console lists every failing tool.
La consola tiene una línea que nombra cada fallo:
Verbatra agent tools: 2 of 20 tool registrations failed. verbatra_status_diff (SecurityError: ...); verbatra_key_value (SecurityError: ...)Lee primero ahí el nombre del error y luego recarga la pestaña, que vuelve a ejecutar el registro. Un flag que falta o un navegador sin WebMCP nunca muestran este aviso; no registran nada, en silencio. Una sesión sin --allow-spend intenta dos registros menos, y eso no es un fallo.
Sopesa el riesgo de gasto
Las herramientas no añaden exposición de red: Studio sigue escuchando solo en 127.0.0.1, cada petición lleva el token de sesión y las herramientas que devuelven texto del proyecto lo marcan como no fiable, para que el agente lo trate como datos.
Advertencia
Con --allow-spend y --expose-agent-tools a la vez, un agente puede gastar en tu proveedor sin confirmación por llamada, hasta los límites de frecuencia. Studio no distingue la llamada de un agente de tu clic, así que no añade un diálogo de aprobación. Para solo leer y editar, deja --allow-spend desactivado.
Relacionado
- Revisar en Studio: el mismo flujo, a mano.
verbatra studio: cada flag y el contrato de arranque.- Conectar un cliente MCP: el plugin trae la skill
verbatra-studio-agent-tools, pero Studio lo arrancas tú.