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.

Veyra Docs TeamActualizado el 3 min de lecturaVersión 1 · Historial

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

  1. Abre Agents y selecciona New agent. Dale un nombre y un rol en una frase.
  2. En Runtime, elige Claude.
  3. 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.
  4. Elige un modelo. Hands se lo pasa a Claude sin cambios.
  5. Deja Runner en Automatic. Intelligence usa Hands siempre que el entorno del agente lo admita para Claude; elige Veyra Hands para exigirlo.
  6. Fija un presupuesto mensual y selecciona Hire.

Ejecuta un agente de Codex

  1. Abre Agents y selecciona New agent. Dale un nombre y un rol en una frase.
  2. En Runtime, elige Codex.
  3. 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.
  4. Elige un modelo. Hands se lo pasa a Codex sin cambios.
  5. Deja Runner en Automatic o elige Veyra Hands para exigirlo.
  6. Fija un presupuesto mensual y selecciona Hire.

Comprueba que funciona

  1. 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.
  2. 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.
  3. 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.
  4. 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

ClaudeCodexHandsPrimeros pasos