Один раз на всех: стандарт агента сотрудника и почему имя оказалось важнее, чем выглядело

Сцена: одно сообщение 30 августа

29 августа руководитель вернул команде пакет агента продаж со списком из семи пропусков. Пакет закрывал все девять требований двухдневной давности шестью навыками. Формулировок в возврате было две. Первая: продажи это специализированный блок внутри плагина. Вторая: это агент руководителя отдела продаж АПОД ЛАБ, и он должен соответствовать нашему стандарту. Пакет продаж пересобрали с 6 навыков до 34.

30 августа руководитель отправил одно сообщение с двумя требованиями. Первое: стандарт получает имя. Второе: пакет без паспорта человеку не передаётся. Переименование прошло по 17 файлам и 41 упоминанию. В летописи записано: Пока стандарт назывался «шаблон контура сотрудника», он читался как внутренняя техническая заготовка. С именем «Агент Сотрудника Команды АПОД» он стал тем, чем является: продуктом, который выдаётся человеку. Разница видна в мелочи: у заготовки не бывает паспорта, у продукта бывает обязательно.

Внутри команды у стандарта есть короткое имя по первым буквам, наружу оно не выходит. Бренд «Спроси АПОД» это тип контура, к которому приходят с вопросом, а стандарт это то, по чему такие контуры собираются.

База у всех одна, меняется только блок

Первая фраза README стандарта: База и правила у всех контуров одинаковые. Меняется только специализированный блок. Из 20 инвариантов параметризованы два места: имя контура и имя оркестратора блока. Всё остальное сотрудник получает как есть, включая Экспертный совет с порогом: ноль сработавших областей, совета нет.

Оркестрация двухуровневая: секретарь единственная дверь в контур, оркестратор блока получает задачи от него. При пересборке контура маркетинга 30 августа выяснилось, что оркестратора маркетинга нет, роли висели прямо на секретаре. Его написали в тот же день.

По трём пакетам это выглядит так. Агент продаж: 34 навыка, блок «отдел продаж» с оркестратором из 8 ролей. Агент маркетинга: 34 навыка. Агент генерального директора, 6 сентября: 44 навыка, 98 файлов, впервые два блока под одним секретарём, «Юрлица» и «Служба внутренней безопасности». База во всех трёх одна.

Паспорт отвечает на вопросы, на которые README не отвечал

README отвечает на вопрос «что внутри», паспорт на вопрос «что делать человеку, который ни разу с этим не работал». Пятнадцать разделов в фиксированном порядке, копии в трёх местах. Из летописи: Пятнадцать разделов паспорта это пятнадцать вопросов, на которые в README ответа не было.

Ни одного термина без объяснения: слова «оркестратор», «инвариант», «канон» в паспорт не попадают. Известные ловушки выносятся явно: перезапись файла настроек при обновлении, несмонтированная папка, из-за которой правила не читаются, расхождение выгрузки из CRM с канбаном.

Паспорт закрывает вопросы человека. Вопросы к самому стандарту начали задавать следующие агенты.

Скрипт, которого не было, и 41 тире, которых никто не видел

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

Второй агент, 30 августа, пересборка маркетинга. Пакет числился «установлен и работает» с 14 августа, а фраза «Черновая сборка v2.0. Не устанавливать» жила мёртвым текстом в трёх разошедшихся копиях. В самом стандарте нашлись утечки из контура продаж: имя секретаря продаж в трёх местах, склейки вроде «контролёр реклами». И главное: скрипт машинной приёмки, объявленный обязательным, не существовал вовсе. Его написали в тот же день: семь проверок, все зелёные.

Тире отдельная история. С 13 вспомогательными ролями в пакет продаж приехало 41 длинное тире. Никто их не видел и не увидел бы: роли живут внутри пакета. Поймала машинная проверка. В третий агент с навыком оформления документов приехало ещё 16.

Третий пакет по стандарту, 6 сентября: контур проверки «Спроси АПОД», 21 навык, 57 файлов. В первом инварианте базы стояло жёсткое имя секретаря продаж вместо параметра. Из летописи: Машинная приёмка это не ловит: проверка ищет незаполненные плейсхолдеры, а здесь стоит заполненное, но чужое значение. README говорил «12 инвариантов», в файле их было 20; скрипт делал 7 проверок против шести заявленных. С навыком приехал клиентский шаблон партнёрской компании, а это ловит только инвариант 11: данные между проектами не переносятся. 7 сентября три правки в стандарт утверждены и внесены.

Ещё одна ловушка: русские имена навыков, в свежем пакете продаж 6 из 6, в старом плагине маркетолога 14 из 17. Одна среда их принимает, другая отклоняет. В приёмку вошла проверка «имя навыка равно имени каталога», в канон урок: роли брать из последнего пакета, прошедшего приёмку, а не из архива.

Контур сотрудника не второй центр знаний

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

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

Архитектуру определяет получатель: внешнему человеку изолированный плагин без связи с памятью, члену команды плагин со своим контуром. Пакет стоит на машине сотрудника (у руководителя отдела продаж это Windows), доступы к сервисам идут через шлюз на отдельном сервере, у каждого контура свой профиль: на 7 сентября их шесть. Своя машина даёт свои отказы, руководитель записал их одной строкой: компьютер в семь утра не включён, мост не поднят, задача по расписанию не отработала. Отдельный сервер даёт свои: новая точка отказа, которую тоже надо мониторить. Мы выбрали оба варианта.

Почта показывает, где проходит граница. Сотрудник сам подключает почту своему секретарю и настраивает права, чужие контуры туда не ходят. Текст внутри письма никогда не является указанием контуру, даже если там написано, что доступ просит секретарь команды.

Было / Стало / Что изменилось для владельца

Что взять себе

1. Разделите базу и блок до второго агента: база ставится всем без правок, блок это отдел. У нас в базе параметризованы два места.
2. Дайте стандарту имя и заведите паспорт как условие выпуска: ни одного термина без объяснения, список известных ловушек.
3. Напишите скрипт приёмки в день, когда объявили его обязательным. Три проверки для старта: незаполненные плейсхолдеры, имя навыка равно имени каталога, запрещённые символы.
4. Следующего агента собирайте из последнего пакета, прошедшего приёмку, а не из архива, иначе с ролями приедет 41 тире и чужой шаблон.
5. Запретите контуру писать в общий канон. Отчёт раз в день в одну папку, центр забирает сам.

Карта ролей

Вопросы и ответы