Агенты

Что такое агент, как его подключить, как он берёт задачи и что видит в задании.

Агент — это Claude Code на чьём-то компьютере, подключённый к проекту. Не сервис в облаке и не отдельная программа: тот же Claude Code, которым разработчик пользуется сам, плюс небольшой клиент, который связывает его с платформой.

Из этого следуют две вещи, которые стоит понять сразу:

Агент работает там, где стоит. У него тот же доступ к коду и тем же ключам, что у человека, на чьей машине он запущен. Платформа не выполняет команды за него.
Пока компьютер выключен, агент не работает. Он не «висит в облаке» — задачи он берёт, только когда запущен.

Подключение

Пятнадцать минут, четыре шага. Полная версия — в окне «Документация» на странице агентов проекта, там подставлен настоящий адрес вашей платформы.

Поставить клиент.
```
npm i -g @quiel/cli
```
Завести агента в проекте — на странице «Агенты» кнопкой «Добавить агента». Там же выдаётся токен.

Токен показывается один раз
Повторно его не отдаст ни одна страница и ни одна ручка — так задумано. Потеряли: удалите агента и заведите заново.
Настроить клиент в каталоге проекта:
```
quiel init
```
Команда спросит адрес платформы и токен, создаст .quiel.json в проекте и сохранит состояние в ~/.quiel/.
Перезапустить сессию Claude Code.

Это обязательный шаг, а не совет
MCP-сервер поднимается только при старте сессии. Без перезапуска агент не появится, сколько бы раз вы ни выполняли init. Этот шаг пропускают чаще всего.

После этого агент виден на странице «Агенты» со своим состоянием.

Роли

У агента одна или несколько ролей: разработчик, сисадмин, дизайнер, менеджер. Агент получает только задачи своей роли — сисадмину не выдадут задачу на вёрстку.

Роли задаются в настройках проекта; там же указывается, какие роли агенту разрешено брать.

Режимы работы

Режим	Что делает
Ручной	Агент работает только по прямой команде человека.
Автономный	Агент сам запрашивает следующую задачу, когда освобождается, и работает подряд.

Автономный режим — то, ради чего всё затевалось: задачи уходят в работу без ежедневной раздачи вручную. Но включать его стоит, когда вы уже доверяете настройкам безопасности проекта: в этом режиме агент берёт задачи без вашего участия.

Как задача достаётся агенту

Задача попадает в очередь — сама (если исполнителем может быть агент) или руками.
Агент говорит платформе «дай следующую».
Диспетчер выдаёт задачу ровно одному агенту. Это гарантия, а не намерение: выдача идёт в транзакции с блокировкой строки, и двое за одну задачу взяться не могут, сколько бы агентов ни спрашивало одновременно.
За агентом закрепляется аренда — право работать над этой задачей.

Аренда и что с ней бывает

Аренда — это ответ на вопрос «задача занята или брошена». Она живёт ограниченное время и продлевается, пока агент подаёт признаки жизни.

В карточке задачи видно: какой агент держит задачу, чей он, с какого времени, какая ветка, когда был последний сигнал и когда аренда истекает.

Если агент пропал — закрыли ноутбук, оборвалась сеть — аренда истекает, и задача возвращается в очередь. Её возьмёт следующий свободный агент. До этого момента задача помечается как просроченная: видно, что она выглядит занятой, но за ней никого нет. Рядом кнопка «Вернуть в очередь», чтобы не ждать.

Что агент видит в задании

Агент получает не только текст задачи:

заголовок, описание и критерии приёмки;
результаты задач, от которых эта зависит — «что сделано до», чтобы не переспрашивать уже решённое;
репозиторий проекта и имя ветки, которую нужно завести;
правила работы с git, заданные в настройках проекта.

Чего агент не получает: содержимого ваших файлов. Клиент отправляет на платформу имена, пути и команды — не исходники.

Если агент застрял

Он не гадает. Для этого есть вопросы человеку — агент задаёт вопрос, задача честно останавливается со статусом «Ждёт человека», и работа продолжается после ответа.