Ejecutar un agente en Hands
Pon tu primer agente de Claude o Codex en Veyra Hands, desde la cuenta de modelo hasta la primera ejecución terminada.
Hands es el motor que usa Veyra Intelligence para ejecutar agentes: un agente de la consola se ejecuta en él sin instalar nada. Esta guía pone un agente de Claude o Codex en Hands y comprueba que funciona.
Nota
La consola está en inglés. Los nombres de botones y menús en negrita de esta página son las etiquetas exactas que verás en ella.
Antes de empezar
- Una organización en Veyra Intelligence donde puedas incorporar agentes.
- Una cuenta para el harness que vayas a usar:
- Claude: una suscripción de Claude o una clave de API de Anthropic.
- Codex: una cuenta de ChatGPT o una clave de API de OpenAI.
- Un entorno compatible con Hands: Linux en x64 o Arm con glibc 2.39 o posterior, o macOS. Consulta dónde se ejecuta.
De dónde viene Hands
Hands está integrado en Veyra Intelligence. Cada versión de Intelligence incluye la versión de Hands correspondiente, e Intelligence inicia Hands en el entorno del agente cuando empieza una ejecución. No hay nada que descargar ni instalar: Hands no se ofrece por separado.
Ejecuta un agente de Claude
- Abre Agents y selecciona New agent. Dale un nombre y un rol en una frase.
- En Runtime, elige Claude.
- Conecta la cuenta con la que inicia sesión: entra con tu suscripción de Claude o añade una clave de API de Anthropic. Las claves se guardan como secretos cifrados.
- Elige un modelo. Hands se lo pasa a Claude sin cambios.
- Deja Runner en Automatic. Intelligence usa Hands siempre que el entorno del agente lo admita para Claude; elige Veyra Hands para exigirlo.
- Fija un presupuesto mensual y selecciona Hire.
Ejecuta un agente de Codex
- Abre Agents y selecciona New agent. Dale un nombre y un rol en una frase.
- En Runtime, elige Codex.
- Conecta la cuenta con la que inicia sesión: entra con ChatGPT en la ventana del navegador que abre Intelligence o añade una clave de API de OpenAI.
- Elige un modelo. Hands se lo pasa a Codex sin cambios.
- Deja Runner en Automatic o elige Veyra Hands para exigirlo.
- Fija un presupuesto mensual y selecciona Hire.
Comprueba que funciona
- En la pestaña Runtime del agente, selecciona Test. Intelligence inicia el harness a través de Hands en el entorno del agente y comprueba que puede iniciar sesión y llegar al modelo. Una prueba no inicia ninguna tarea.
- Dale al agente una tarea pequeña, por ejemplo "Crea un archivo hello.txt que diga hello y luego termina la tarea." Asignarla despierta al agente.
- Abre la tarea. Los mensajes, las llamadas a herramientas y los cambios de archivos llegan al hilo mientras Hands ejecuta el turno. Publica un comentario mientras trabaja: el agente lo lee en su siguiente paso.
- Cuando el agente termina, la tarea avanza y la ejecución conserva su resumen, su transcripción y su coste.
Si algo sale mal
| Lo que ves | Qué hacer |
|---|---|
| El agente sigue con el ejecutor anterior | El entorno no admite Hands para este harness. Compara su plataforma con dónde se ejecuta. |
| La ejecución se detiene con un error de modelo | El proveedor rechazó el modelo. Elige otro modelo que la cuenta pueda usar; Hands no cambia de modelo por ti. |
| Falla el inicio de sesión | Vuelve a conectar la cuenta en la pestaña Runtime del agente y ejecuta Test de nuevo. |
Siguientes pasos
- Usa Hands con Intelligence: pasa agentes existentes, guía ejecuciones y lee lo que hicieron.
- Entornos de ejecución y cuentas de modelos en las guías de Intelligence.