Как поделиться агентом с клиентом

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

Такую схему мы рекомендуем агентствам, фрилансерам и всем, чьи клиенты хотят «узнать, как идут дела» чаще, чем позволяет еженедельный созвон.

Как это устроено

Один клиент, одна комната, один агент, одна директория.

• Одна директория. ~/clients/acme содержит проект только этого клиента. Привязанный к ней агент не видит ни ~/clients/beta, ни папку вашей компании, ни ваши ключи.
• Один агент, названный в честь клиента, чтобы никто не перепутал: acme.
• Одна комната, где находитесь только вы и клиент. Другие ваши комнаты ему не видны.
• Режим Plan для агента: на вопросы даются ответы, а на диске ничего не меняется, пока вы сами этого не решите.

Клиент видит комнату; комната видит одну директорию; все остальное на машине недосягаемо.

Что клиент может делать

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

Чего клиент делать не может

• Изменять код в режиме plan. Даже если на определенном этапе вы переключите агента в acceptEdits, клиентские правки все равно не смогут отправить push, удалить файлы, потратить средства или затронуть учетные данные без вашего подтверждения.
• Просматривать файлы. daemon загружает события timeline, а не рабочее дерево. Подробнее см. в статье что загружает daemon.
• Видеть другие комнаты, других клиентов или ваших собственных агентов.
• Одобрять собственные опасные действия. Они направляются вам.

Ограничение по времени

Выдайте клиенту постоянное разрешение на время проекта и поставьте напоминание на дату завершения. Отзыв разрешения, удаление клиента из комнаты или остановка daemon вступают в силу мгновенно: стоящие в очереди запросы клиента отменяются, а все, что выполнялось в данный момент, завершается и сохраняется в истории. Сами ссылки-приглашения (Invite) могут иметь срок действия и лимит по числу использований.

Результаты работы и согласования

Когда клиент просит агента «запушить исправление», операция упирается в push в общую ветку и ожидает вашего решения. Так и должно быть: вы решаете, когда передавать готовый результат. Нажмите Approve, отклоните или ответьте «продолжить только для чтения» и отправьте изменения позже самостоятельно. Ваша заметка к решению сохранится в истории.

Что это заменяет

Чек-лист

1. Создайте ~/clients/<name> и клонируйте проект туда.
2. Создайте агента, привязанного к этой папке, в режиме plan, назвав его именем клиента.
3. Создайте комнату; добавьте агента; пригласите клиента по ссылке со сроком действия.
4. Подтвердите его первый запрос; затем выберите «всегда разрешать» на срок проекта, если хотите, чтобы ему не приходилось ждать вас каждый раз.
5. Установите daemon как службу, чтобы комната работала, даже когда вас нет за компьютером.
6. По завершении проекта: отзовите разрешение и удалите участника. История останется у вас.

Часто задаваемые вопросы

Нужен ли клиенту аккаунт? Он входит по коду из письма или через Google, чтобы принять приглашение. Ничего устанавливать не нужно.

Могут ли два клиента использовать одного агента? Не стоит. Отдельная директория под каждого клиента обеспечивает физическую, а не только логическую границу.

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

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

Создайте для проекта комнату и позвольте клиенту задавать вопросы напрямую. Начать.