Запустіть першого агента

Що ви створите

Наприкінці цього посібника у вас буде:

• Агент, якого ви створили й налаштували самі
• Простір, де ви й цей агент спілкуєтеся
• Один завершений запуск із закоміченою роботою в ізольованому worktree та рядком у журналі запусків агента

Передумова: завершено Ваш перший робочий простір, тож у цьому робочому просторі зареєстровано репозиторій і підключено щонайменше одного провайдера моделей.

Крок 1: Створіть агента

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

Агент без адаптера працює на вбудованому циклі

Коли поле «Адаптер» не задано, диспетчеризація переходить до Control Center (вбудований) — циклу агента всередині сервера, тож на хості нічого встановлювати не треба. Модель йому все одно потрібна: якщо її не встановлено, він запитує в Anthropic її типову — це працює, якщо ви підключили обліковий запис Anthropic, а інакше завершується помилкою No credential for provider "anthropic". Утім, задайте обидва явно, інакше ви працюватимете на моделі, якої не вибирали.

Контрольна точка. Рядок у списку агентів показує назву вашого агента та порожнисте кільце статусу.

Крок 2: Розпочніть простір

1. На бічній панелі знайдіть розділ Простори й натисніть кнопку +
2. Дайте простору назву
3. У розділі Додати агентів виберіть агента, якого щойно створили
4. Якщо в робочому просторі є репозиторії, виберіть, над якими з них має працювати цей простір
5. Натисніть Створити

Простір відкривається. У фоновому режимі Control Center готує для цієї розмови copy-on-write worktree вибраних репозиторіїв на окремій гілці. Ваш вихідний checkout ніколи не змінюється.

Крок 3: Надішліть завдання

Введіть одне конкретне невелике завдання щодо репозиторію, який ви зареєстрували. Найкраще підходить щось із перевірюваним результатом — додати тест, виправити помилку лінтера, перейменувати символ.

Натисніть Enter. Нікого не треба згадувати через @: якщо в просторі лише один агент, його будить звичайне повідомлення. У просторі з кількома агентами @name вибирає одного з них.

Control Center збирає промпт з інструкцій агента, персони, навичок і контексту простору, а потім диспетчеризує запуск.

Контрольна точка. Кнопка надсилання в композері перетворюється на кнопку зупинки — у цій розмові працює агент — і починає надходити текст.

Крок 4: Спостерігайте за роботою

Розмова відображає запуск у міру його перебігу:

• Міркування, показані в тексті, поки агент думає
• Виклики інструментів: читання й запис файлів, пошук, shell-команди — кожен зі своїм результатом
• Текст: підсумки, пояснення та запитання до вас

Якщо агент щось запитує, дайте відповідь у розмові, і він продовжить.

Щоб побачити власні метрики запуску та його елементи керування «призупинити», «продовжити» й «зупинити», знайдіть агента, що працює, у розділі Агенти на панелі «Загальні» цього простору й виберіть Відкрити активність.

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

Що обмежує запуск: власний copy-on-write 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, не торкаючись вашого checkout.

Далі: Перевірте свій перший pull request, щоб опанувати процес перевірки.

Більше про агентів: Модель агента. Про деталі диспетчеризації: Життєвий цикл запуску агента.