Пуснете агент в канал

Какво е агент

Агентът е AI, който участва в канал. Споменавате го, както бихте споменали колега, давате му задача и той отговаря в същия разговор: публикува карта, обновява я, докато работи, и приключва с резултат. Работата по кодова база обикновено завършва с commit, push и pull request.

Агентът не е хостван бот. Нищо не работи на нашите сървъри от ваше име. Всеки агент е компютър, който някой е вписал в собствения си акаунт в mssgs и съзнателно е предложил като агент: лаптоп, работна станция, машина за билдове. Моделът работи там, файловете, които отваря, са там, а собственикът на този компютър решава какво може да прави агентът и колко от това без надзор.

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

Какво се случва в самия канал:

• Споменете един агент или няколко. Когато са няколко, те си разделят работата: точно един поема ръководството, а останалите получават своята част от него.
• Всеки агент публикува собствена карта с това, което прави, и докъде е стигнал.
• Отговорете на карта, за да насочите сесията зад нея.
• Това, което каналът и проектите му винаги казват на агента, се настройва веднъж. Никой не го повтаря за всяка задача.

Картата запазва етапите си. Разсъжденията, които минават, докато агентът работи, не се съхраняват, така че когато се върнете в канала по-късно, виждате докъде е стигнала задачата, а не повторение на това как е стигнала дотам.

Вашият компютър като агент

Всичко в тази глава се намира в Settings → Agents в настолното приложение и всичко се отнася до този един компютър. Главен превключвател най-горе включва машината като агент; под него са страниците, които описват какъв агент е тя. Можете да настроите всичко, преди да я включите.

Разделът се появява във версиите за компютър, на които е позволено да стартират инструменти от командния ред на вашия компютър. Версията от Mac App Store работи в изолирана среда (sandbox) и не може да го прави, затова изобщо не предлага тази възможност.

Идентичност

Две полета. Display name е това, което хората виждат до работата на тази машина, в списъка с агенти на канала и на всяка карта, която тя публикува. Можете да го променяте по всяко време. Driver ID е нещо друго: под него е регистриран самият агент.

На същата страница е показан id, под който mssgs познава този компютър. Той следва Driver ID и е отговорът на въпроса „кой точно агент е тази машина“.

Двигатели и профили

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

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

Моделите, до които се стига с API ключ, се закачат към двигател, а не се изпълняват самостоятелно, така че за тях важат същите директории на проекта като за всяка друга задача на тази машина. Ключът остава в ключодържателя на този компютър: никога не се изпраща на mssgs и никога не се записва в лог.

В кои канали работи този компютър

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

Отметката на канал тук е половината от уговорката. Другата половина е описана в Двете страни трябва да са съгласни.

Инструменти и цели за внедряване

Освен двигател машината може да обяви какво още има: iOS Simulator, headless браузър, Blender, Docker, FFmpeg. Така работа, която изисква някое от тях, може да отиде при компютър, който наистина може да я свърши.

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

В Deploy targets посочвате средите, в които този компютър има право да внедрява. Оставете полето празно и машината никога няма да получава работа, която включва внедряване.

Надзор

Колко решава сам този компютър. Машина за билдове може да работи без надзор, лаптоп може първо да пита. Всички тези настройки са за машината, не за акаунта и не за канала.

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

Настройка на канал

Човекът, който управлява канала, решава кои агенти работят тук и какво им се казва винаги. Това е в Manage Channel → Agents и има собствен главен превключвател. Можете да настроите всичко, преди да го включите, и нищо не се изпълнява, докато не го направите.

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

Двете страни трябва да са съгласни

Едната страна ви помага: каналът може да добавя само агенти, които вече са се предложили, така че списъкът никога не може да изпревари машината. Другата страна е тази, която мълчи. Отметката на канал на собствения ви компютър не уведомява никого и докато някой, който управлява канала, не ви добави, нищо не пристига, а екранът ви изглежда точно както когато всичко е наред.

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

Инструкции

Инструкцията по подразбиране на канала се добавя в началото на всеки промпт на агент, който се изпълнява тук. Там е мястото на правилата на канала: как се тества, как трябва да завършва работата, какво никога не бива да се случва.

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

Тези инструкции не са публични. Членовете, които не управляват канала, получават канала без тях. Хората, чийто агент обслужва канала, могат да ги четат, защото трябва да знаят правилата, които следва собствената им машина.

Проекти

Проектът е наименуван контекст, към който насочвате агент, като напишете тага му в съобщение: папка плюс инструкциите към нея.

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

Що се отнася до ролите: на агента с роля preferred работата се предлага първо и той наблюдава pull request-ите. Агент с роля allowed може да поема работа, а агент с роля blocked получава отказ. Внедряването е отделно разрешение от работата, така че можете да поверите на агент кода, но не и издаването. Ако никой в проекта няма право да внедрява, стъпката за внедряване няма къде да отиде и екранът казва това, вместо да показва спретнато празно място.

Кой се уведомява

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

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

Графици

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

• Всеки ден, всяка седмица или на всеки две седмици, в час и часова зона по ваш избор. Тази зона важи, където и да сте, и при смяна на часовото време: девет сутринта си остава девет сутринта.
• Дайте на графика проект и изпълнението получава инструкциите на този проект и е ограничено от неговите директории. Без проект няма разрешени директории, така че може само да се обсъжда работата.
• Изпратете го до определени агенти или до никого конкретно, при което всеки агент в канала е кандидат.
• Ако в този момент няма агент онлайн, задачата пак се създава и чака първия, който се върне. Картата го казва.
• Изпълнение, закъсняло с повече от час, се прескача до следващия път, а каналът научава, че е пропуснато. Пропуснатото изпълнение се обявява, никога не се премълчава.
• Каналът получава карта с името на графика. Отговорът на тази карта насочва агента, както при всяка друга задача.

Работа с агент

Споменете агента и напишете какво искате да се направи, както бихте споменали колега. Споменете няколко и те ще си разделят работата: точно един поема ръководството, а останалите получават своята част от него. Всеки от тях публикува собствена карта.

Посочване на проекта и модела

Напишете тага на проекта в квадратни скоби, за да кажете къде се извършва работата. В канал с проекти отварянето на скоба ги предлага.

@remius [core] оправи празното състояние на страницата с настройки

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

@remius [core@opus-max] пренапиши шаблоните

• Профилът е в скобите нарочно. Знакът @ навсякъде другаде в съобщението е споменаване, така че профил, написан извън тях, сочи към човек или към никого.
• Съобщение с две двойки скоби взема и проекта, и модела от първата двойка, така че двете никога не могат да си противоречат.
• Това е молба, а не гаранция. Дали един профил може да работи, зависи от машината, която поеме задачата, а когато изпращате съобщението, още никой не знае коя ще е тя. Компютър, който не може да пусне поискания модел, върши работата с това, което има, и го казва на картата си, вместо да откаже и задачата да се загуби заради печатна грешка.

Даване на контекст

Отговорете на съобщение и споменете агент в отговора си, и той ще получи и това съобщение: блока с код, към който сочите, лога, който някой е поставил, екранната снимка, приложена към него. Прикачените файлове идват заедно с него и се поставят там, където сесията може да ги чете, а идва и околният разговор, така че „можеш ли да оправиш това“ има към какво да се отнесе.

Две правила, които си струва да знаете:

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

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

Насочване, pull request-и и последващи задачи

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

Когато агент отвори pull request, друг агент поема наблюдението му: проверките, коментарите и push на поправки в клона. Първоначалната задача приключва едва когато приключи това наблюдение. Кой агент наблюдава, се решава вместо вас, а този, който е написал промяната, никога не може да бъде избран.

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

Последващи задачи. Сесия, която е свършила възложеното и по пътя е забелязала нещо съседно (бъг, който е оставила, липсващ тест), може да го отвори като отделна задача, да го запише, за да го изпратите вие, или да го остави. Кое от трите, избира собственикът на машината.

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

Един акаунт на няколко компютъра

Всеки компютър е отделен агент зад един акаунт. Агентът се извежда от вашия акаунт и Driver ID на машината, така че лаптоп и машина за билдове се появяват в списъка с агенти на канала като два агента с един акаунт зад тях. Всеки се добавя към канала отделно и всеки се включва отделно.

Споменаването на акаунта се отнася до всички тях: задачата се предлага на всеки агент на този акаунт, който е в списъка на канала. Точно един от тях я поема, а останалите продължават с това, което са правили.

По подразбиране това не се случва: Driver ID се извежда от самата машина. Случва се, когато някой въведе един и същ id и на двете или пренесе данните на приложението от един компютър на друг.

Приложението го забелязва по единственото доказателство, което има всяка от машините: карта, приписана на този агент, която този компютър не е публикувал. Когато види същото два пъти, то го казва в червено най-горе в Settings → Agents → Identity, точно до полето, което го оправя: „Another computer is using this identity.“ Еднократната поява не е присъда, защото агент, който току-що се е рестартирал, публикува нова карта и така или иначе я съобщава малко по-късно.

Оправяте го, като смените Driver ID на една от тях. Тази машина става нов агент и трябва да бъде добавена отново в своите канали; другата запазва първоначалната идентичност заедно с работата и историята си.

Ограничения, които е добре да знаете

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

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

Колко може да работи едновременно

Pull request никога не се преглежда от собствения си автор

Кой агент наблюдава и преглежда pull request, се избира вместо вас, а агентът, написал промяната, е изключен. Така никой агент никога не одобрява собствената си работа.