Запуск агента на Hands
Переведите первого агента Claude или Codex на Veyra Hands — от учётной записи модели до первого завершённого запуска.
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
- Откройте Agents и выберите New agent. Дайте ему имя и роль в одном предложении.
- В разделе Runtime выберите Claude.
- Подключите учётную запись, под которой он входит: войдите по подписке Claude или добавьте API-ключ Anthropic. Ключи хранятся как зашифрованные секреты.
- Выберите модель. Hands передаёт её Claude без изменений.
- Оставьте Runner в положении Automatic. Intelligence использует Hands всякий раз, когда среда агента поддерживает его для Claude; выберите Veyra Hands, чтобы сделать его обязательным.
- Задайте месячный бюджет и выберите Hire.
Запустите агента Codex
- Откройте Agents и выберите New agent. Дайте ему имя и роль в одном предложении.
- В разделе Runtime выберите Codex.
- Подключите учётную запись, под которой он входит: войдите в ChatGPT в окне браузера, которое откроет Intelligence, или добавьте API-ключ OpenAI.
- Выберите модель. Hands передаёт её Codex без изменений.
- Оставьте Runner в положении Automatic или выберите Veyra Hands, чтобы сделать его обязательным.
- Задайте месячный бюджет и выберите Hire.
Проверьте, что всё работает
- На вкладке Runtime агента выберите Test. Intelligence запускает оболочку через Hands в среде агента и проверяет, что она может войти и достучаться до модели. Тест не запускает задачу.
- Дайте агенту небольшую задачу, например «Создай файл hello.txt со словом hello и заверши задачу». Назначение задачи будит агента.
- Откройте задачу. Пока Hands выполняет ход, в ленту поступают сообщения, вызовы инструментов и изменения файлов. Оставьте комментарий во время работы — агент прочитает его на следующем шаге.
- Когда агент закончит, задача двинется дальше, а запуск сохранит сводку, расшифровку и стоимость.
Если что-то пошло не так
| Что вы видите | Что сделать |
|---|---|
| Агент остаётся на прежнем исполнителе | Среда не поддерживает Hands для этой оболочки. Сверьте её платформу с разделом где он работает. |
| Запуск останавливается с ошибкой модели | Провайдер отклонил модель. Выберите другую модель, доступную учётной записи; Hands не меняет модель за вас. |
| Не удаётся войти | Переподключите учётную запись на вкладке Runtime агента и снова запустите Test. |
Что дальше
- Hands вместе с Intelligence: переводите существующих агентов, направляйте запуски и читайте, что они сделали.
- Среды выполнения и аккаунты моделей в руководствах Intelligence.