Прескачане към съдържанието

КАК ДА

Run an agent on your repository

Дайте на Panolayer Agent задача във вашата кодова база, следете работата му и прегледайте резултата, преди да го внесете в клона си. Вие запазвате контрол върху това какво се слива.

Последна актуализация

Прочети като Markdown

Преди да започнете

Това ръководство използва примера с Twitter, twitter-starter, за да изгради функция: споделяне на гигантско емоджи с текст под него. Ще опишете какво искате директно на агента, ще следите работата му и ще прегледате готовия резултат. Можете да използвате същия работен процес за друга функция или за бъг, който искате да поправите.

  • Инсталирайте Panolayer, влезте в профила си и отворете примера Twitter Clone. Вижте Инсталиране и настройка на Panolayer, ако още не сте отворили хранилище.
  • Използвайте Panolayer Agent, който е вграден. Можете да използвате и всеки друг поддържан агент, който трябва да инсталирате преди употреба. Вижте Поддържани агенти за настройка.

Ще завършите с прегледана промяна, записана в локалната ви Git история. Изпращането ѝ към отдалечено хранилище е отделна стъпка.

Стартирайте Panolayer Agent

  1. Отворете Моите агенти в страничната лента.
  2. Кликнете върху бутона + до Мониторинг на агенти, за да отворите менюто на агентите.
  3. Изберете Panolayer Agent за това ръководство.

Менюто включва Panolayer Agent и агентите, които сте инсталирали. Можете да изберете всеки от тях, за да поправите бъг или да изградите код.

Кликнете + до „Мониторинг на агенти“, след което изберете Panolayer Agent или друг инсталиран агент.

Panolayer Agent работи като агентите за код, които вече използвате. Помолете го да изгради функция, да поправи бъг или да отговори на въпрос за вашия код. Въведете заявката си в Пишете на кодовата си база или изградете нещо… и продължете разговора, докато работите.

Започвате от проблем? В Проблеми изберете Поправи и посочете Panolayer Agent. Panolayer пренася контекста на проблема в задачата. Следвайте ръководството за първи бъг за този подход.

Дайте му задача с ясен резултат

Опишете какво не е наред или какво искате да изградите, какво трябва да се случи, когато работи, и всичко, което агентът трябва да запази. Посочете файл или функция, когато ги знаете.

За примера с Twitter използвайте същата заявка, показана на екранната снимка:

add a new feature where you can share a giant emoji with text underneath

Въведете заявката в полето за съобщение и след това щракнете върху стрелката за изпращане.

Опишете функцията, която искате да изградите. Тази заявка иска гигантско емоджи с текст под него.

Panolayer Agent може да използва картата на кода, за да намери съответните функции и връзки, докато работи. Можете да се позовавате на поведението, което ви интересува, дори когато не знаете всяко име на файл.

Ако агентът зададе въпрос, отговорете му в същия разговор. Ако трябва да стесните задачата, посочете конкретния резултат, който искате.

Следете работата, без да се лишавате от работното си пространство

Когато Panolayer Agent стартира изпълнение на код, напредъкът му се показва в разговора. Работата по кода се извършва в изолирано Git worktree: отделно работно копие, където агентът може да редактира и тества кода, докато основното ви работно пространство остава достъпно.

Наблюдавайте задачата в разговора

Картата на изпълнението показва задачата и текущата ѝ дейност, докато агентът изгражда функцията с гигантското емоджи. Можете да следите напредъка му и да виждате файловете и командите, които използва, докато работи.

Отворете изпълнението за повече подробности

Изберете Отвори от дясната страна на картата, за да видите дейността на изпълнението. В Поток изберете дейност, за да прегледате командата и изхода ѝ в десния панел. Използвайте Назад към агента, за да се върнете към разговора.

Отвори показва задачата „Добавяне на гигантско емоджи с надпис“ в ход. Избирането на запис ви позволява да прегледате какво е било изпълнено и какво е върнало.

Вижте кога изпълнението е завършено

Когато работата приключи, картата се обновява до Изпълнението на подизпълнителя е завършено. Банерът Готово обобщава проверките и броя на променените файлове. Все още можете да изберете Отвори, за да прегледате завършеното изпълнение.

Завършената задача с гигантското емоджи се показва в разговора, с резултата и доказателствата за променените файлове, готови за преглед.

Можете да продължите да работите и да се върнете към изпълнението по-късно. Използвайте Наблюдение на агенти за общ преглед, когато имате повече от един работещ агент. Няколко агента могат да работят по едно и също хранилище в отделни worktree-та; прегледайте как промените им се съчетават, преди да ги обедините.

Поддържайте последващото запитване свързано със задачата му. Използвайте референцията на изпълнението, показана в разговора ви, когато изпращате последващо запитване, за да е ясно коя задача имате предвид.

Прегледайте резултата от проверката

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

Когато агентът поиска обединяване, прочетете обобщението на проверката: Преминати правила, Изпълнения на проверката и Променени файлове. Прегледайте новите неуспехи отделно от проблемите, които вече са били налични.

Функцията с гигантските емоджита е завършена и чака одобрението ви за обединяване. Подробности обяснява какво се е променило и как агентът го е проверил.

В това изпълнение обобщението показва 110 от 121 преминати правила, 1 изпълнение на проверката и 16 променени файла. То отделно идентифицира 11 неуспеха, съществували преди това, и не отчита нови неуспехи, предупреждения или непроверени правила. Общите ви числа ще зависят от задачата ви.

Отворете Подробности, за да проучите резултата по-подробно. Вижте Разбиране на резултат от проверка за полетата и статусите в обобщението.

Проверете поведението в работещото приложение, когато задачата го изисква. За този пример опитайте да създадете публикация с гигантско емоджи и текст под него, след което проверете дали обикновените текстови публикации все още работят както се очаква.

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.