Qué es Veyra Hands
El ejecutor de agentes de Veyra: qué hace, qué harness maneja, dónde se ejecuta y cómo trabaja con Veyra Intelligence.
Veyra Hands es el ejecutor que hace el trabajo de un agente. Inicia un harness de agente de código como Claude o Codex, mantiene la sesión abierta mientras el agente trabaja, guarda puntos de control para que una ejecución resista interrupciones y devuelve cada llamada a herramientas al plano de control que gobierna al agente. Ese plano de control es Veyra Intelligence: decide quién trabaja en qué, y Hands lleva a cabo la ejecución. Hands está integrado en Intelligence: es el motor que Intelligence usa para ejecutar agentes, sin nada que descargar ni instalar por separado.
Agentes, harness y ejecutores
- Un agente es un miembro de tu organización en Intelligence, con un rol, un responsable, un presupuesto y permisos.
- Un harness es el programa que lee, razona y edita: Claude, Codex, OpenCode y otros. En Intelligence es el entorno de ejecución del agente.
- Un ejecutor inicia el harness, lo conecta al plano de control y lo supervisa hasta que termina la ejecución. Veyra Hands es el ejecutor de Veyra.
Hands no sustituye al harness ni cambia cómo razona. Cada harness conserva sus propias herramientas y costumbres; Hands añade a su alrededor la sesión, los puntos de control y las herramientas gobernadas.
Qué hace Hands
Ejecuta el harness real
Hands inicia el propio programa del harness y habla su protocolo: con Codex a través de su app server, con OpenCode a través de su servidor, y con Claude y Grok a través del Agent Client Protocol. El harness inicia sesión con la cuenta de modelo que conectaste y usa el modelo que elegiste. Hands pasa ese modelo sin cambios; si el proveedor lo rechaza, la ejecución se detiene con un error claro en lugar de cambiar a otro modelo.
Conserva las sesiones pese a las interrupciones
Hands guarda puntos de control mientras avanza la ejecución. Si se cae la conexión entre Hands e Intelligence, la ejecución se vuelve a conectar y sigue donde estaba. Cuando el harness puede reanudar su propia conversación, Hands la reanuda; cuando no, abre una nueva con un breve traspaso del historial de la tarea, para que el agente no empiece a ciegas.
Te deja guiar una ejecución
Un comentario que publiques en la tarea mientras el agente trabaja llega al turno en curso, y el agente lo lee en su siguiente paso. Si la ejecución se reinicia antes de que el modelo haya leído un comentario, Hands lo vuelve a entregar. Puedes detener una ejecución en cualquier momento. Cuando el agente te hace una pregunta, aparece en la tarea y en tu Inbox.
Hace pasar las llamadas a herramientas por el plano de control
Las herramientas que un agente recibe de Intelligence (leer y actualizar tareas, terminar o bloquear su trabajo, y los conectores que tiene asignados) llegan al harness a través de Hands. Cada llamada vuelve a Intelligence, que la revisa según los permisos del agente antes de ejecutarla. Las credenciales detrás de estas herramientas se limitan a la ejecución.
Verifica lo que inicia
Los programas de los harness vienen de builds fijados, comprobados por hash y empaquetados con cada versión de Hands. Antes de iniciar un harness en una máquina, Hands compara el paquete instalado con su versión. Un paquete que falta o no coincide falla con un error claro en lugar de ejecutar otra cosa.
Transmite todo lo que hace
Cada mensaje, llamada a herramienta, cambio de archivo y resultado es un evento tipado. Intelligence los muestra en directo en la tarea y los guarda como transcripción de la ejecución, bajo un resumen legible.
Los harness que ejecuta
| Harness | Cómo habla Hands con él | Notas |
|---|---|---|
| Claude | Agent Client Protocol | Inicia sesión con una suscripción de Claude o una clave de API de Anthropic. |
| Codex | App server de Codex | Inicia sesión con una cuenta de ChatGPT o una clave de API de OpenAI. |
| OpenCode | Servidor de OpenCode | No disponible en Linux Arm. |
| Grok | Agent Client Protocol | Linux x64 y macOS con Apple silicon. |
| Cursor Cloud | Agentes alojados por Cursor | Experimental. Cursor ejecuta el agente en su propia máquina en la nube. |
Dónde se ejecuta
Hands se ejecuta en el entorno del agente: en la máquina que ejecuta Intelligence, en un host SSH que añadas o en un sandbox. Admite:
- Linux en x64 y Arm, con glibc 2.39 o posterior;
- macOS en Apple silicon e Intel.
Intelligence comprueba el entorno antes de elegir Hands para un agente. Donde Hands no puede ejecutar un harness, el agente conserva el ejecutor anterior y su configuración indica el motivo.
Hands e Intelligence
Intelligence y Hands se reparten el trabajo:
| Intelligence | Hands |
|---|---|
| Despierta al agente por una tarea, un comentario o una rutina | Inicia o reanuda la sesión del harness |
| Guarda el rol, los permisos y el presupuesto del agente | Ejecuta el turno y transmite lo que pasa |
| Somete las acciones gobernadas a aprobación y registra cada cambio | Devuelve cada llamada a herramienta para que se decida |
| Mantiene el resumen, la transcripción y el coste en la tarea | Guarda puntos de control para que la ejecución pueda seguir |
Cada ejecución en Hands es una ejecución normal de Intelligence: cuenta para los presupuestos, aparece en Costs y conserva su transcripción en la tarea.
Hands se distribuye con Intelligence y se actualiza con él: cada versión de Intelligence incluye la versión de Hands con la que se probó, así que nunca se desalinean.
Siguientes pasos
- Ejecuta un agente en Hands con Claude o Codex.
- Usa Hands con Intelligence: pasa agentes, guía ejecuciones y lee lo que hicieron.