Запустите первого агента

Что вы создадите

К концу этого руководства у вас будет:

• агент, которого вы создали и настроили сами;
• пространство, в котором вы и этот агент общаетесь;
• один завершённый запуск с закоммиченной работой в изолированном worktree и строкой в журнале запусков агента.

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

Шаг 1. Создайте агента

1. Перейдите в Настройки → Рабочее пространство → Агенты
2. Нажмите Новый агент. Сразу создаётся агент с именем «Безымянный агент», и он выбирается в списке агентов — никакого диалога создания нет, и подтверждать нечего. Вы настраиваете его на месте.
3. На вкладке Настройки заполните:
   • Имя: что-то короткое и запоминающееся, например alice. Именно это вы набираете после @.
   • Название: чем он занимается, например «Бэкенд-инженер»
   • Адаптер: Control Center (built-in). Выберите его осознанно — только встроенный раннер можно направлять по ходу запуска и приостанавливать на границе хода, и ему не нужен установленный CLI на хосте сервера.
   • Модель: выберите из списка, который обслуживает подключённый провайдер
   • Навыки: прикрепите подходящие, например testing или architecture
4. Нажмите Сохранить изменения

Агент без адаптера работает на встроенном цикле

Если поле «Адаптер» не задано, запуск переключается на Control Center (built-in) — цикл агента внутри сервера, поэтому на хост ничего устанавливать не нужно. Но модель ему всё равно нужна: если она не задана, он запрашивает у Anthropic модель по умолчанию — это сработает, если вы подключили аккаунт Anthropic, а в противном случае завершится ошибкой No credential for provider "anthropic". Так или иначе задайте и то, и другое явно, иначе запуск пойдёт на модели, которую вы не выбирали.

Контрольная точка. В строке списка агентов отображаются имя вашего агента и пустое кольцо статуса.

Шаг 2. Запустите пространство

1. На боковой панели найдите раздел Пространства и нажмите кнопку +
2. Дайте пространству имя
3. В разделе Добавить агентов выберите агента, которого только что создали
4. Если в рабочем пространстве есть репозитории, выберите, с какими из них должно работать это пространство
5. Нажмите Создать

Пространство открывается. В фоне Control Center подготавливает для этого разговора worktree с копированием при записи по выбранным репозиториям, на отдельной ветке. Ваша исходная рабочая копия никогда не изменяется.

Шаг 3. Отправьте задачу

Введите одну конкретную, небольшую задачу для репозитория, который зарегистрировали. Лучше всего подойдёт что-то с проверяемым результатом — добавить тест, исправить замечание линтера, переименовать символ.

Нажмите Enter. Упоминать кого-либо через @ не нужно: когда в пространстве один агент, его будит обычное сообщение. В пространстве с несколькими агентами @name выбирает нужного.

Control Center собирает промпт из инструкций агента, его персоны, навыков и контекста пространства, а затем выполняет запуск.

Контрольная точка. Кнопка отправки в композере превращается в кнопку остановки — в этом разговоре работает агент — и начинает поступать текст.

Шаг 4. Наблюдайте за работой

Разговор отображает запуск по мере его выполнения:

• Рассуждения — показываются по ходу размышлений агента
• Вызовы инструментов: чтение и запись файлов, поиск, команды оболочки — каждый со своим результатом
• Текст: сводки, пояснения и вопросы к вам

Если агент о чём-то спрашивает, ответьте в разговоре — и он продолжит.

Метрики самого запуска и элементы управления паузой, продолжением и остановкой находятся там же: найдите выполняющегося агента в разделе Агенты панели «Общие» пространства и выберите Открыть активность.

На панели активности значок статуса показывает Выполняется, а затем Успешно, когда запуск завершается. Запуск, который завис или зациклился, показывает Заблокирован; запуск с ошибкой — Не удалось. В реестре агентов кольцо в списке пустое до первого запуска и заполненное, как только агент снова простаивает.

Что ограничивает запуск: его собственный worktree с копированием при записи, учётные данные, выданные через брокер при запуске и отозванные при завершении, очищенное окружение, набор инструментов, разрешённый его режимом, и ограничения действий. Такие эффекты, как отправка ветки или открытие pull request, ограничиваются отдельно — см. Ограничения.

Шаг 5. Проверьте результат

1. Откройте Настройки → Рабочее пространство → Агенты и выберите своего агента
2. Откройте вкладку Журнал

Контрольная точка. Одна строка запуска с его статусом, длительностью, временем начала и окончания и адаптером, на котором он выполнялся.

Изменения агента закоммичены в ветке разговора, в его worktree. Автором коммитов указан агент, а вы упомянуты в трейлере Co-Authored-By:.

Как получить pull request

Ничто не открывает pull request само по себе. Если он вам нужен, попросите об этом в том же разговоре:

Отправьте эту ветку и откройте pull request против ветки по умолчанию.

Отправка (gitPush) и создание PR (prCreate) по умолчанию запрашивают ваше подтверждение, так что перед каждым ждите подтверждения. Если к моменту запроса ни один утверждающий не подключён, действие отклоняется, а не разрешается — ограничения срабатывают в пользу отказа.

PR открывается под идентификацией GitHub, чей токен использовал запуск — вашей, если вы сохранили персональный токен, — а не под именем агента. Авторство агента видно в коммитах.

Вы можете открыть его и сами: в панели Управление исходным кодом пространства есть кнопка Создать pull request, которая переносит ветку разговора на экран создания, а Pull requests → Новый PR открывает тот же экран пустым. Отсюда продолжает следующее руководство.

Итоги

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

Далее: Проверьте свой первый pull request, чтобы изучить процесс проверки.

Подробнее об агентах: Модель агента. О деталях запуска: Жизненный цикл запуска агента.