Что такое Veyra Hands

Исполнитель агентов Veyra: что он делает, какими оболочками управляет, где работает и как взаимодействует с Veyra Intelligence.

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

Veyra Hands — это исполнитель, который делает работу агента. Он запускает оболочку агента для программирования, например Claude или Codex, держит сессию открытой, пока агент работает, сохраняет контрольные точки, чтобы запуск пережил обрывы, и возвращает каждый вызов инструмента на уровень управления, которому подчиняется агент. Этот уровень управления — Veyra Intelligence: он решает, кто над чем работает, а Hands выполняет запуск. Hands встроен в Intelligence: это движок, которым Intelligence запускает агентов, и отдельно скачивать или устанавливать ничего не нужно.

Агенты, оболочки и исполнители

  • Агент — участник вашей организации в Intelligence с ролью, руководителем, бюджетом и правами.
  • Оболочка (harness) — программа, которая читает, рассуждает и вносит правки: Claude, Codex, OpenCode и другие. В Intelligence это среда выполнения агента.
  • Исполнитель запускает оболочку, подключает её к уровню управления и следит за ней до конца запуска. Veyra Hands — исполнитель Veyra.

Hands не заменяет оболочку и не меняет то, как она рассуждает. Каждая оболочка сохраняет свои инструменты и привычки; Hands добавляет вокруг неё сессию, контрольные точки и управляемые инструменты.

Что делает Hands

Запускает настоящую оболочку

Hands сам запускает программу оболочки и говорит на её протоколе: с Codex — через его app server, с OpenCode — через его сервер, с Claude и Grok — через Agent Client Protocol. Оболочка входит под учётной записью модели, которую вы подключили, и использует выбранную модель. Hands передаёт эту модель без изменений; если провайдер её отклоняет, запуск останавливается с понятной ошибкой, а не переключается на другую модель.

Сохраняет сессии при обрывах

По ходу запуска Hands сохраняет контрольные точки. Если связь между Hands и Intelligence обрывается, запуск переподключается и продолжает с того же места. Если оболочка может продолжить свой разговор, Hands его продолжает; если нет — начинает новый с короткой передачей истории задачи, чтобы агент не начинал вслепую.

Позволяет направлять запуск

Комментарий, оставленный в задаче, пока агент работает, попадает в текущий ход, и агент читает его на следующем шаге. Если запуск перезапускается до того, как модель прочитала комментарий, Hands доставляет его снова. Запуск можно остановить в любой момент. Когда агент задаёт вам вопрос, он появляется в задаче и во Inbox.

Пропускает вызовы инструментов через уровень управления

Инструменты, которые агент получает от Intelligence (чтение и обновление задач, завершение или блокировка работы, назначенные ему подключения), доходят до оболочки через Hands. Каждый вызов возвращается в Intelligence, и тот проверяет его по правам агента до выполнения. Учётные данные за этими инструментами ограничены запуском.

Проверяет то, что запускает

Программы оболочек берутся из закреплённых сборок, проверяются по хешу и поставляются с каждым выпуском Hands. Перед запуском оболочки на машине Hands сверяет установленный пакет с выпуском. Если пакета нет или он не совпадает, запуск завершается понятной ошибкой, а не запускает что-то другое.

Транслирует всё, что делает

Каждое сообщение, вызов инструмента, изменение файла и результат — это типизированное событие. Intelligence показывает их в задаче в реальном времени и сохраняет как расшифровку запуска под понятной сводкой.

Какие оболочки он запускает

Оболочка Как Hands с ней говорит Примечания
Claude Agent Client Protocol Входит по подписке Claude или с API-ключом Anthropic.
Codex App server Codex Входит с аккаунтом ChatGPT или API-ключом OpenAI.
OpenCode Сервер OpenCode Нет на Linux Arm.
Grok Agent Client Protocol Linux x64 и macOS на Apple silicon.
Cursor Cloud Агенты, размещённые у Cursor Экспериментально. Cursor запускает агента на своей облачной машине.

Где он работает

Hands работает в среде агента: на машине, где работает Intelligence, на добавленном вами SSH-хосте или в песочнице. Поддерживаются:

  • Linux на x64 и Arm с glibc 2.39 или новее;
  • macOS на Apple silicon и Intel.

Intelligence проверяет среду, прежде чем выбрать Hands для агента. Там, где Hands не может запустить оболочку, агент остаётся на прежнем исполнителе, а в его настройках указана причина.

Hands и Intelligence

Intelligence и Hands делят работу так:

Intelligence Hands
Будит агента по задаче, комментарию или рутине Запускает или возобновляет сессию оболочки
Хранит роль, права и бюджет агента Выполняет ход и транслирует происходящее
Отправляет управляемые действия на согласование и записывает каждое изменение Возвращает каждый вызов инструмента на решение
Держит сводку, расшифровку и стоимость в задаче Сохраняет контрольные точки, чтобы запуск мог продолжиться

Каждый запуск на Hands — обычный запуск Intelligence: он учитывается в бюджетах, виден в Costs и хранит расшифровку в задаче.

Hands поставляется вместе с Intelligence и обновляется вместе с ним: каждый релиз Intelligence выходит с тем релизом Hands, с которым он прошёл проверку, поэтому они никогда не расходятся.

Что дальше

HandsОсновы