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 Docs TeamActualizado el 4 min de lecturaVersión 1 · Historial

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

ConceptosHands