Перед началом
В этом руководстве на примере Twitter, twitter-starter, мы создадим функцию: публикацию огромного эмодзи с текстом под ним. Вы опишете агенту, что хотите получить, проследите за его работой и проверите готовый результат. Тот же подход можно применить к другой функции или к ошибке, которую нужно исправить.
- Установите Panolayer, войдите в систему и откройте пример Twitter Clone. Если вы ещё не открывали репозиторий, см. Установка и настройка Panolayer.
- Используйте Panolayer Agent — он встроен. Можно также использовать любой другой поддерживаемый агент, но его нужно сначала установить. Настройка описана в разделе Поддерживаемые агенты.
В итоге у вас будет проверенное изменение, записанное в локальной истории Git. Отправка в удалённый репозиторий — отдельный шаг.
Запуск Panolayer Agent
- Откройте Мои агенты на боковой панели.
- Нажмите кнопку + рядом с Мониторинг агентов, чтобы открыть меню агентов.
- Для этого руководства выберите Panolayer Agent.
В меню есть Panolayer Agent и установленные вами агенты. Любой из них подойдёт, чтобы исправить ошибку или написать код.
Panolayer Agent работает так же, как агенты для написания кода, которыми вы уже пользуетесь. Попросите его создать функцию, исправить ошибку или ответить на вопрос о вашем коде. Введите запрос в поле Chat with your codebase or build something… и продолжайте диалог по ходу работы.
Начинаете с issue? В разделе Issues выберите Исправить и укажите Panolayer Agent. Panolayer перенесёт контекст issue в задачу. Об этом сценарии см. руководство по первой ошибке.
Поставьте задачу с понятным результатом
Опишите, что не так или что вы хотите создать, что должно происходить при успешной работе и что агент должен сохранить. Если знаете имя файла или функции — укажите его.
Для примера Twitter используйте тот же запрос, что на скриншоте:
add a new feature where you can share a giant emoji with text underneath
Введите запрос в поле сообщения и нажмите стрелку отправки.
Panolayer Agent может использовать карту кода, чтобы находить нужные функции и связи по ходу работы. Вы можете описывать важное для вас поведение, даже если не знаете всех имён файлов.
Если агент задаёт вопрос, ответьте в том же диалоге. Если задачу нужно сузить, сформулируйте конкретный результат, который хотите получить.
Следите за работой, не отказываясь от рабочего пространства
Когда Panolayer Agent запускает сеанс кодирования, его ход отображается в диалоге. Работа с кодом происходит в изолированном Git worktree: отдельной рабочей копии, где агент может редактировать и тестировать код, пока ваше основное рабочее пространство остаётся доступным.
Следите за задачей в диалоге
Карточка запуска показывает задачу и текущую активность, пока агент создаёт функцию гигантских эмодзи. Вы можете следить за ходом работы и видеть файлы и команды, которые он использует.
Откройте запуск, чтобы увидеть подробности
Выберите Открыть в правой части карточки, чтобы увидеть активность запуска. В разделе Поток выберите действие, чтобы изучить команду и её вывод на панели справа. Используйте Назад к агенту, чтобы вернуться в диалог.
Узнайте, когда запуск завершён
Когда работа завершается, карточка обновляется до Запуск субагента завершён. Баннер Готово содержит сводку проверок и количество изменённых файлов. Вы по-прежнему можете выбрать Открыть, чтобы изучить завершённый запуск.
Вы можете продолжать работу и вернуться к запуску позже. Используйте Мониторинг агентов, чтобы получить обзор, когда у вас работает несколько агентов. Несколько агентов могут работать с одним репозиторием в отдельных worktree; перед слиянием проверьте, как их изменения сочетаются друг с другом.
Привязывайте последующие сообщения к их задаче. Используйте ссылку на запуск, показанную в диалоге, когда отправляете последующее сообщение, чтобы было понятно, какую задачу вы имеете в виду.
Проверьте результат верификации
Проверьте изменённый код вместе с результатом верификации перед слиянием. Полное руководство по проверке изменений агента см. в разделе Проверка изменений и коммит.
Когда агент запрашивает слияние, изучите сводку верификации: Правила пройдены, Запуски верификации и Изменённые файлы. Рассматривайте новые сбои отдельно от проблем, которые уже были.
В этом запуске сводка показывает 110 из 121 правила пройдено, 1 запуск верификации и 16 изменённых файлов. Она отдельно выделяет 11 ранее существовавших сбоев и сообщает об отсутствии новых сбоев, предупреждений и непроверенных правил. Ваши итоговые значения зависят от задачи.
Откройте Details, чтобы изучить результат подробнее. Описание полей сводки и статусов см. в разделе Как читать результат верификации.
Если задача этого требует, проверьте поведение в запущенном приложении. В этом примере попробуйте создать пост с большим эмодзи и текстом под ним, а затем убедитесь, что обычные текстовые посты по-прежнему работают как ожидается.
Merge when you’re ready
You decide what moves from the agent’s worktree into your branch. Choose Not now to keep reviewing. Once you’re satisfied with the changes and results, confirm the target branch and choose Merge into main for the Twitter sample.
The Merged into main confirmation shows a commit ID. This workflow records the change in local Git history, so you don’t need to commit that same change again.
Open Changes and find the commit in History. Check for unexpected uncommitted edits. If your repository has a remote and you want to share the commit, use Git → Push.
You’ve given an agent a task, followed its work, reviewed the result, and decided what reaches your branch.