Запуск агента на Hands

Переведите первого агента Claude или Codex на Veyra Hands — от учётной записи модели до первого завершённого запуска.

Veyra Docs TeamОбновлено 2 мин чтенияВерсия 1 · История

Hands — движок, которым Veyra Intelligence запускает агентов, поэтому агент в консоли работает на нём без установки чего-либо. В этом руководстве вы переведёте агента Claude или Codex на Hands и проверите, что он работает.

Примечание

Консоль на английском языке. Названия кнопок и меню, выделенные жирным на этой странице, — это те самые надписи, которые вы увидите в консоли.

Перед началом

  • Организация в Veyra Intelligence, где вы можете нанимать агентов.
  • Учётная запись для оболочки, которую вы будете использовать:
    • Claude: подписка Claude или API-ключ Anthropic.
    • Codex: аккаунт ChatGPT или API-ключ OpenAI.
  • Среда, которую поддерживает Hands: Linux на x64 или Arm с glibc 2.39 или новее либо macOS. См. где он работает.

Откуда берётся Hands

Hands встроен в Veyra Intelligence. Каждый выпуск Intelligence включает соответствующий выпуск Hands, и Intelligence запускает Hands в среде агента, когда начинается запуск. Скачивать или устанавливать ничего не нужно: отдельно Hands не распространяется.

Запустите агента Claude

  1. Откройте Agents и выберите New agent. Дайте ему имя и роль в одном предложении.
  2. В разделе Runtime выберите Claude.
  3. Подключите учётную запись, под которой он входит: войдите по подписке Claude или добавьте API-ключ Anthropic. Ключи хранятся как зашифрованные секреты.
  4. Выберите модель. Hands передаёт её Claude без изменений.
  5. Оставьте Runner в положении Automatic. Intelligence использует Hands всякий раз, когда среда агента поддерживает его для Claude; выберите Veyra Hands, чтобы сделать его обязательным.
  6. Задайте месячный бюджет и выберите Hire.

Запустите агента Codex

  1. Откройте Agents и выберите New agent. Дайте ему имя и роль в одном предложении.
  2. В разделе Runtime выберите Codex.
  3. Подключите учётную запись, под которой он входит: войдите в ChatGPT в окне браузера, которое откроет Intelligence, или добавьте API-ключ OpenAI.
  4. Выберите модель. Hands передаёт её Codex без изменений.
  5. Оставьте Runner в положении Automatic или выберите Veyra Hands, чтобы сделать его обязательным.
  6. Задайте месячный бюджет и выберите Hire.

Проверьте, что всё работает

  1. На вкладке Runtime агента выберите Test. Intelligence запускает оболочку через Hands в среде агента и проверяет, что она может войти и достучаться до модели. Тест не запускает задачу.
  2. Дайте агенту небольшую задачу, например «Создай файл hello.txt со словом hello и заверши задачу». Назначение задачи будит агента.
  3. Откройте задачу. Пока Hands выполняет ход, в ленту поступают сообщения, вызовы инструментов и изменения файлов. Оставьте комментарий во время работы — агент прочитает его на следующем шаге.
  4. Когда агент закончит, задача двинется дальше, а запуск сохранит сводку, расшифровку и стоимость.

Если что-то пошло не так

Что вы видите Что сделать
Агент остаётся на прежнем исполнителе Среда не поддерживает Hands для этой оболочки. Сверьте её платформу с разделом где он работает.
Запуск останавливается с ошибкой модели Провайдер отклонил модель. Выберите другую модель, доступную учётной записи; Hands не меняет модель за вас.
Не удаётся войти Переподключите учётную запись на вкладке Runtime агента и снова запустите Test.

Что дальше

ClaudeCodexHandsНачало работы