Запустите агента в канале

Что такое агент

Агент представляет собой ИИ, который участвует в работе канала. Вы упоминаете его так же, как упомянули бы коллегу, даёте задачу, и он отвечает в той же переписке: публикует карточку, обновляет её по ходу работы и завершает результатом. Работа с кодовой базой обычно заканчивается коммитом, пушем и pull request.

Агент не является размещённым у нас ботом. На наших серверах от вашего имени ничего не запускается. Каждый агент представляет собой компьютер, на котором кто-то вошёл в свой аккаунт mssgs и сознательно предложил его в качестве агента: ноутбук, рабочая станция, сборочная машина. Модель работает там же, файлы, которые она открывает, находятся там же, и владелец этого компьютера решает, что агенту можно делать и сколько из этого без присмотра.

Именно поэтому границы реальны. Сессия может открывать только каталоги, разрешённые проектом канала, а если канал не указал ни одного каталога, агент может обсуждать работу, но не может прикоснуться ни к одному файлу.

Что происходит в самом канале:

• Упомяните одного агента или нескольких. Несколько агентов делят работу: ровно один берёт руководство на себя, остальные получают от него свою часть.
• Каждый агент публикует собственную карточку: что он делает и докуда дошёл.
• Ответьте на карточку, чтобы направить сессию, которая за ней стоит.
• То, что канал и его проекты всегда сообщают агенту, настраивается один раз. Никому не нужно повторять это в каждой задаче.

Карточка сохраняет свои этапы. Рассуждения, которые пролистываются во время работы, не сохраняются, поэтому, вернувшись в канал позже, вы увидите, докуда дошла задача, а не повтор того, как она туда пришла.

Ваш компьютер как агент

Всё в этой главе находится в разделе Настройки → Агент настольного приложения и относится только к этому компьютеру. Главный переключатель вверху делает машину агентом; под ним расположены страницы, которые описывают, какой это агент. Всё это можно настроить ещё до включения.

Раздел есть в настольных сборках, которым разрешено запускать инструменты командной строки на вашем компьютере. Версия из Mac App Store работает в песочнице и не может этого делать, поэтому там этого раздела нет вовсе.

Личность

Два поля. Отображаемое имя видят люди рядом с работой, которую выполняет эта машина: в списке агентов канала и на каждой карточке, которую она публикует. Его можно менять в любое время. Driver ID устроен иначе: под ним регистрируется сам агент.

На той же странице показан id, под которым mssgs знает этот компьютер. Он следует за Driver ID и отвечает на вопрос «какой именно агент эта машина».

Движки и профили

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

Профиль объединяет движок, модель и уровень усилий. Задача запрашивает профиль по имени, поэтому выбрать можно только те профили, которые вы здесь включили. Кроме профилей, поставляемых с приложением, можно добавить свои: укажите движок, id модели, который этот движок ожидает, и уровень усилий.

Модели, к которым вы обращаетесь по API-ключу, подключаются к движку, а не запускаются сами по себе, поэтому на них действуют те же каталоги проекта, что и на любую другую задачу на этой машине. Ключ остаётся в связке ключей этого компьютера: он никогда не отправляется в mssgs и никогда не пишется в журнал.

Какие каналы обслуживает этот компьютер

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

Отметка канала здесь составляет только половину договорённости. Вторая половина описана в разделе Согласие обеих сторон.

Инструменты и цели деплоя

Помимо движка, машина может сообщать, что ещё у неё есть: iOS Simulator, headless-браузер, Blender, Docker, FFmpeg. Так работа, которой нужно что-то из этого, попадает на компьютер, который действительно может её выполнить.

Каждый инструмент обнаруживается, а не просто заявляется. То, что здесь не установлено, включить нельзя. Если заявить инструмент, которого у машины нет, она получит работу, которую затем не сможет выполнить, и как раз это заявление помешало бы агенту, который мог бы с ней справиться.

В разделе Цели деплоя вы указываете окружения, в которые этому компьютеру разрешено деплоить. Оставьте его пустым, и компьютер никогда не получит работу с деплоем.

Надзор

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

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

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

Менеджер канала решает, какие агенты здесь работают и что им всегда сообщают. Это находится в разделе Управление каналом → Агенты, у которого есть собственный главный переключатель. Всё можно настроить до его включения, и ничего не запустится, пока вы его не включите.

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

Согласие обеих сторон

Одна сторона вам помогает: канал может добавлять только агентов, которые уже предложили себя, поэтому список никогда не опередит машину. Другая сторона молчит. Отметка канала на вашем компьютере никому ничего не сообщает, и пока менеджер вас не добавит, ничего не придёт, хотя экран выглядит точно так же, как когда всё настроено правильно.

Если ничего не приходит, проверьте обе стороны: есть ли агент в списке канала и отмечен ли канал на машине. Если агент в списке, но не в сети, приложение на том компьютере закрыто или его главный переключатель выключен.

Инструкции

Инструкция канала по умолчанию добавляется в начало каждого промпта агента, который здесь выполняется. Туда относятся правила дома: как всё тестируется, чем должна заканчиваться работа, чего никогда нельзя делать.

То, с чем начинается задача, фиксируется в момент её запуска. Поэтому изменение инструкции никогда не мешает уже идущей работе; оно действует начиная со следующей задачи.

Эти инструкции не публичны. Участники, которые не управляют каналом, получают канал без них. Люди, чей агент обслуживает канал, могут их читать, потому что им нужно знать правила дома, которым следует их собственная машина.

Проекты

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

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

О ролях: предпочтительному агенту работа предлагается первой, и он следит за pull request’ами. Разрешённый агент может брать работу, заблокированному в ней отказано. Деплой представляет собой отдельное разрешение, не связанное с работой, так что можно доверить агенту код, но не выпуск. Если в проекте никому нельзя деплоить, шагу деплоя некуда деваться, и экран прямо об этом говорит, а не показывает аккуратную пустоту.

Кого оповещать

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

Этот список важен из-за работы без присмотра. Запуск по расписанию, упавший в три часа ночи, или задача, которую агент открыл сам, вообще не имеют аудитории, если здесь никто не указан.

Расписания

Расписание представляет собой постоянное поручение: в заданное время канал публикует задачу, и агент её забирает, точно так же, как если бы её кто-то напечатал.

• Каждый день, каждую неделю или раз в две недели, в выбранное время и в выбранном часовом поясе. Этот пояс сохраняется, где бы вы ни находились, и при переходе на летнее время: девять утра остаются девятью утра.
• Укажите в расписании проект, и запуск получит инструкции этого проекта и будет ограничен его каталогами. Без проекта у него нет разрешённых каталогов, поэтому он может только обсуждать работу.
• Отправляйте его конкретным агентам или никому конкретно, и тогда кандидатом становится каждый агент канала.
• Если в этот момент ни один агент не в сети, задача всё равно создаётся и ждёт первого, кто вернётся. Карточка об этом сообщает.
• Запуск, опоздавший больше чем на час, переносится на следующий раз, и каналу сообщают, что он пропущен. О пропущенном запуске всегда объявляют, он никогда не исчезает молча.
• Канал получает карточку с названием расписания. Ответ на эту карточку направляет агента, как и в любой другой задаче.

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

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

Как указать проект и модель

Напишите тег проекта в квадратных скобках, чтобы указать, где идёт работа. Если открыть скобку в канале, у которого есть проекты, они будут предложены.

@remius [core] исправь пустое состояние на странице настроек

Если нужна конкретная модель, добавьте имя профиля после знака @ внутри тех же скобок. Без профиля агент выберет один из своих.

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

• Профиль находится внутри скобок намеренно. Знак @ в любом другом месте сообщения означает упоминание, поэтому профиль, написанный вне скобок, укажет на человека или ни на кого.
• Сообщение с двумя парами скобок берёт и проект, и модель из первой пары, поэтому они никогда не противоречат друг другу.
• Это просьба, а не гарантия. Может ли профиль запуститься, зависит от машины, которая возьмёт задачу, а в момент отправки сообщения никто ещё не знает, какая это будет машина. Компьютер, который не может запустить запрошенную модель, делает работу тем, что у него есть, и сообщает об этом на карточке, вместо того чтобы отказаться и потерять задачу из-за опечатки.

Контекст для агента

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

Здесь стоит знать два правила:

• Цитируемый чат передаётся агенту как информация, а не как инструкции. Поэтому чужое сообщение, в котором случайно есть приказы, не может перенаправить сессию.
• Вложение, которое можно просмотреть только один раз, никогда не открывается, потому что это израсходовало бы тот единственный просмотр, ради которого его отправили.

Если что-то из этого прочитать не удаётся, задача всё равно выполняется. Она опирается на написанное вами сообщение, с указанием пробела, чтобы агент мог попросить недостающее.

Управление ходом работы, pull request’ы и последующие задачи

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

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

Если что-то нужно задеплоить, а агенту самому это делать нельзя, он передаёт этот шаг агенту, которому можно, и упоминает людей из списка оповещений канала. Каждый раз.

Последующие задачи. Сессия, которая закончила порученное и по пути заметила что-то смежное (ошибку, которую не стала трогать, недостающий тест), может открыть это как отдельную задачу, записать для вас, чтобы вы отправили её сами, или оставить как есть. Какой из трёх вариантов, решает владелец этой машины.

Открытие намеренно ограничено: последующая задача не может открывать собственные последующие задачи, одна задача может открыть не больше пяти, а ограничение канала на одновременную работу не меняется. Сообщение под карточкой говорит, что было открыто, и что было отклонено и почему, так что находка никогда не теряется между тем, как сессия её заметила, и тем, как о ней кто-то услышал. У последующей задачи нет автора запроса, потому что никто её не просил: она принадлежит работе, из которой возникла, а не человеку, отправившему исходную задачу.

Один аккаунт на нескольких компьютерах

Каждый компьютер представляет собой отдельного агента за одним аккаунтом. Агент выводится из вашего аккаунта и Driver ID этой машины, поэтому ноутбук и сборочная машина выглядят в списке агентов канала как два агента с одним аккаунтом за ними. Каждого добавляют в канал отдельно, и каждый отдельно выбирает каналы.

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

По умолчанию такого не происходит: Driver ID выводится из самой машины. Это случается, когда кто-то вводит один и тот же ID на обеих машинах или переносит данные приложения с одного компьютера на другой.

Приложение замечает это по единственному доказательству, которое есть у каждой машины: карточке, записанной на этого агента, которую этот компьютер не публиковал. Увидев такую дважды, оно сообщает об этом красным вверху раздела Настройки → Агент → Личность, прямо рядом с полем, которое это исправляет: «Эту личность использует другой компьютер». Один раз ещё ничего не значит, потому что агент, который только что перезапустился, публикует новую карточку и через мгновение всё равно о ней сообщает.

Исправляется это сменой Driver ID на одной из машин. Эта машина становится новым агентом, и её нужно заново добавить в её каналы; другая сохраняет исходную личность вместе со своей работой и историей.

Ограничения, о которых стоит знать

Агенты не могут создавать работу, публикуя сообщения

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

Сколько может выполняться одновременно

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

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