Тема
Как устроены агенты NORM
Агент NORM — программа, которая сама собирает данные, обрабатывает их моделью и показывает результат в кабинете NORM. Данные агент берёт у MCP-сервера вашей компании — встречи, людей, протоколы — или в открытых источниках в интернете. Запускается он по расписанию или по кнопке.
На этой странице — то, что одинаково у всех агентов. Что делает конкретный агент, какие данные берёт и что с ними делает, написано в «Описании агента» в кабинете и на странице агента в этом разделе, если она уже есть.
Сверено с NORM 3 ноября 2026 года
Кабинет и агенты NORM на эту дату. Если кнопка или экран в кабинете называется иначе — верьте кабинету.
Главные слова
- Шаблон — агент в «Каталоге агентов» кабинета: его описание, версии и настройки. Подключая шаблон, компания получает своего агента.
- Агент — подключённый шаблон с вашими настройками: моделью, расписанием, параметрами.
- Владелец агента — сотрудник, который подключил агента или которому агента передали.
- Прогон — один запуск агента: по расписанию, вручную или проверочный при подключении.
- Расписание — когда агент запускается сам.
- MCP-сервер компании — сервер, через который NORM получает данные вашей компании. Как его подключить и какие инструменты нужны агентам — на странице «Подключение к NORM».
- Инструмент — одно действие MCP-сервера: например, «список встреч за период» или «записать разбор встречи». Какие инструменты NORM ждёт от сервера, описывает каталог контракта MCP.
- Модель — большая языковая модель: читает данные, которые собрал агент, и пишет текст результата.
Где агенты в кабинете
- «Агенты» в меню слева — лента результатов («Всё, что агенты собрали для вас», свежие сверху) и списки «Ваши агенты» и «Со мной поделились».
- «Каталог агентов» — открывается кнопкой «Добавить агента». В каталоге — агенты, открытые вашей компании: у разных компаний набор может отличаться.
- «Описание агента» — открывается из каталога: как агент работает, кому подходит, что он видит и чего не делает, сколько стоит и что нужно для запуска; у некоторых агентов — ещё пример результата («Что вы получите»).
- Мастер подключения — кнопка «Подключить» в каталоге или в «Описании агента». Шаги: «Параметры агента», «Расписание и доставка», «Проверка»; у некоторых агентов перед расписанием есть ещё шаг «Что агент понял о вашей работе».
- «Настройки агента» — у подключённого агента: модель, параметры, расписание, версия, кому присылать результаты, кому открыт доступ.
- «Журнал выполнений» — прогоны агентов: статус, модель, длительность, стоимость. В меню слева он под «Агентами» и называется «Журнал прогонов». Владелец и администраторы компании видят в журнале прогоны всех агентов компании, остальные сотрудники — прогоны своих агентов.
- «Прогон агента» — страница одного прогона: что произошло, шаги, журнал выполнения, расход.
Кто подключает агента
Подключить агента может любой сотрудник компании. Для этого нужны три вещи:
- подходящая модель среди моделей компании;
- инструменты MCP, без которых агент не работает, — у подключённых серверов компании;
- доступ самого сотрудника к данным компании, которые нужны агенту.
Есть ли подходящая модель, показывает карточка «Что нужно для запуска» в «Описании агента». Инструменты и доступ кабинет проверяет при подключении: без обязательного инструмента агента не подключить, мастер скажет, чего не хватает. Какие инструменты MCP нужны агентам — в разделе «Агенты» страницы «Подключение к NORM» и на страницах агентов.
- Не хватает модели или инструмента — кабинет предложит отправить заявку. Она уйдёт владельцу и администраторам компании: они получат письмо и уведомление в NORM.
- Не хватает доступа к данным — кабинет откажет в подключении и скажет, что доступ выдаёт администратор в правах сотрудника.
- На карточке «Запросить подключение» вместо «Подключить» и подпись «Подключается Администратором» — такого агента сотрудник сам не подключает. Заявка уйдёт владельцу и администраторам компании.
- Второй агент того же шаблона подключается кнопкой «Подключить ещё». У каждого агента свои настройки, модель и расписание. Чтобы различать агентов в списке, второму нужно название.
От чьего имени работает агент
Агент берёт данные компании от имени своего владельца и с его доступами. Сервер, который получает личность сотрудника, отдаст агенту то же, что отдал бы владельцу.
- Доступ к данным выдаёт администратор: «Настройки компании» → «Пользователи», права сотрудника, блок «Доступ к данным компании». Ограничение действует и на агентов этого сотрудника. Поэтому агентов, которые должны видеть данные всей компании, подключает владелец или администратор компании.
- Передать агента другому сотруднику могут владелец компании и администраторы — кнопкой «Передать владение» в «Настройках агента». Владелец агента без этой роли передать его не может. Новый владелец получает агента со всеми настройками и расписаниями.
- После передачи агент, которому нужны данные компании, не запускается, пока новый владелец не разрешит ему работать от своего имени — кнопкой «Разрешить» в «Настройках агента». Если администратор передаёт агента себе, это разрешение он даёт сразу.
- Владелец ушёл из компании — администратор передаёт агента другому сотруднику.
Как проходит прогон
- Прогон запускается по расписанию, кнопкой «Запустить сейчас» или в мастере подключения — это проверочный прогон.
- Агент собирает данные. Инструменты MCP-сервера компании вызывает программа агента: NORM передаёт вызов через шлюз MCP NORM с правами владельца агента. Модель к серверу компании не обращается.
- Агент отправляет модели запрос и разбирает её ответ. Таких запросов за прогон может быть несколько.
- Результат появляется в ленте агента, а если включена почта — приходит и письмом. Некоторые агенты ещё записывают свою работу в MCP-сервер компании.
Что ещё нужно знать о прогоне:
- Расписание по умолчанию у каждого агента своё — оно в «Описании агента», строка «Как часто работает». Поменять его можно при подключении и потом — в «Настройках агента», карточка «Когда запускать». Режим «Вручную» убирает расписание: тогда агент запускается только кнопкой «Запустить сейчас».
- Запускает агента и настраивает расписание только его владелец.
- Один прогон за раз. Если по расписанию пора начинать, а прошлый прогон ещё идёт, новый пропускается.
- Предел времени. У прогона есть предел времени. Пока идёт сбор, кабинет показывает, сколько прошло и какой предел. Не уложился — прогон останавливается и завершается со статусом «Ошибка».
- Остановить. Пока идёт сбор, на месте «Запустить сейчас» стоит кнопка «Остановить». Результата у остановленного прогона нет, журнал выполнения сохраняется, расписание не меняется.
- Проверочный прогон идёт на настоящих данных, но ничего не записывает в MCP-сервер компании: права записи ему не выдаются.
- На паузе агент по расписанию не запускается, но «Запустить сейчас» работает, и пауза при этом сохраняется.
Что получает модель
- Запрос к модели — это задание и данные. Задание говорит, что сделать и в каком виде ответить. Данные — то, что агент для этого собрал: например, расшифровку встречи и список участников или новости за день.
- Данные компании модель получает только из запроса агента.
- Тексты заданий на портале не публикуются. Из каких частей состоит запрос конкретного агента и в каком порядке — на его странице.
- У некоторых агентов в «Настройках агента» есть поле «Системный промпт». Что будет, если его поменять, — на странице агента.
Модель
- Выбор. Модель агенту выбирают в мастере подключения, на шаге «Параметры агента», и меняют потом в «Настройках агента». В списке — модели, подключённые компании («Настройки компании» → «Провайдеры и модели»), и только те, что подходят этому агенту.
- Смена. Модель меняет только владелец агента. Сначала агент проходит проверку на новой модели: не прошёл — модель остаётся прежней.
- Модель стала недоступна компании — агент получает состояние «Заблокирован» и не запускается. Владелец агента и администраторы получают уведомление «Агент заблокирован». Снимает блокировку владелец: выбирает в «Настройках агента» другую модель или сохраняет прежнюю, если её вернули. Пауза и включение блокировку не снимают.
- Портал не называет модели и провайдеров: их выбирает компания. Если агенту нужна модель не слабее определённого класса, это сказано на странице агента.
Куда уходят данные
- Модели — запрос агента: задание и собранные данные. Запрос уходит провайдеру модели, которую выбрал владелец агента.
- В NORM хранятся результаты агента, журнал его прогонов — статусы, шаги, журнал выполнения, расход, — файлы, которые оставили прогоны, и настройки агента.
- В MCP-сервер компании некоторые агенты записывают свою работу — например, разборы встреч. Что именно — на странице агента и в таблице «Подключения к NORM».
- Шаги прогона. Обращения агента к MCP-серверу компании видны на странице прогона, в «Шагах»: какой инструмент, прочитано или записано, чем кончилось.
- При отключении лента результатов агента удаляется безвозвратно, а журнал прогонов и файлы прогонов в разделе «Артефакты» остаются. Записанное в MCP-сервер компании отключение не трогает: эти данные хранит ваш сервер.
Где результат и кто его видит
- Лента — раздел «Агенты»: у каждого агента своя лента, свежие результаты сверху.
- Файлы. Некоторые агенты оставляют файлы — например, протокол или дайджест. Они на странице прогона и в разделе «Артефакты» в меню слева.
- Почта — «Куда присылать» в «Настройках агента». В NORM результат есть всегда, на почту — копия выбранным сотрудникам компании. Письмо приходит о каждом результате, который агент отмечает для почты; некоторые агенты отмечают только итоги дня. Доставку настраивает владелец агента.
- Кто видит. Результаты агента видят его владелец, владелец компании и администраторы. Другому сотруднику владелец агента может открыть доступ — «Кому открыт доступ». Агент появится у сотрудника в «Со мной поделились», и тот увидит только результаты — без настроек, запуска и расходов.
- Экраны кабинета. Некоторые экраны строятся по данным, которые записали агенты, — например, раздел Align. Какие — на страницах агентов.
Состояния агента
| Состояние | Что значит |
|---|---|
| «Работает» | Агент включён: запускается по расписанию, если оно задано, и по кнопке «Запустить сейчас». |
| «На паузе» | По расписанию агент не запускается. Собранные результаты остаются, «Запустить сейчас» работает. |
| «Заблокирован» | Модель агента стала недоступна компании. Агент не запускается, пока владелец не выберет модель — см. «Модель». |
Статусы прогона
| Статус | Что значит | Что делать |
|---|---|---|
| «В очереди» | Прогон поставлен в очередь и ещё не начался. | Ничего: начнётся сам. |
| «Выполняется» | Прогон идёт. | Дождаться или остановить. |
| «Успешно» | Прогон завершился успешно. | Результат — в ленте агента. |
| «Ошибка» | Прогон завершился с ошибкой. Так же завершается прогон, который не уложился в предел времени. | Причина — на странице прогона, под «Что произошло»: таблица ниже. |
| «Нет инструментов» | Прогон не начался. На дату сверки так помечается прогон, которому не досталось модели: модель агента или модель, заданная в его расписании, стала недоступна компании. | Проверить модель в «Настройках агента», у поля «Модель»: у агента — см. «Модель»; у расписания своя модель снимается там же — «Запускать по расписанию на модели агента». |
| «Пропущен» | Срабатывание расписания пропущено: у агента уже шёл другой прогон или платформа не успела его обработать. Задним числом прогон не выполняется. | Ничего; нужен результат сейчас — «Запустить сейчас». |
| «Прерван» | Прогон прервался и не завершился — например, при остановке платформы. Сам не повторяется. | «Повторить прогон» на странице прогона или дождаться следующего по расписанию. |
| «Отменено» | Сбор остановил человек. Результата нет, журнал выполнения сохранён. | — |
Причины ошибок прогона
Причину кабинет показывает на странице прогона — отдельной карточкой под «Что произошло», с названием причины в заголовке. Повторить завершённый прогон можно кнопкой «Повторить прогон» — это может тот, кто его запустил.
| Причина | Что значит | Что делать |
|---|---|---|
| «Ошибка в шаблоне агента» | Агент завершился с ошибкой. Так помечается и прогон, который не уложился в предел времени или не справился с отказом инструмента MCP-сервера. | Посмотреть «Шаги» прогона: если инструмент отказал или не ответил — проверить MCP-сервер компании. Иначе — сообщить автору шаблона: он назван в технической сводке «Описания агента». |
| «Сбой платформы» | Сбой NORM, а не настроек и не агента. | Повторить прогон. |
| «Отказал провайдер модели» | Модель не ответила. | Повторить прогон или выбрать агенту другую модель. |
| «Агенту не хватило инструмента» | Агент не смог воспользоваться нужным инструментом. | Проверить в «Настройках компании» → «MCP-серверы», что нужный сервер подключён и в статусе «Работает». |
| «Нет доступа к данным компании» | Агенту не хватило доступа к данным от имени владельца. | Агента передали — новый владелец нажимает «Разрешить». У владельца нет доступа — его выдаёт администратор. Владелец ушёл из компании — администратор передаёт агента другому сотруднику. |
«Причина отказа» и под ней spend_limit | Исчерпан дневной лимит расходов: лимит компании на агентов или общий потолок компании. | Дождаться следующих суток (сутки считаются по UTC) или поднять лимит: «Настройки компании» → «Лимиты». Лимиты меняет сотрудник с правом «Биллинг и удаление компании», по умолчанию — владелец компании. |
Пауза и отключение
- Пауза — «Приостановить агента» в меню агента. Агент перестаёт запускаться по расписанию, собранные результаты остаются. Вернуть в работу — «Включить агента».
- Отключение — «Отключить агента». Агент исчезает из списка, его лента результатов удаляется безвозвратно, расписания перестают срабатывать. Журнал прогонов и файлы прогонов в разделе «Артефакты» остаются. Пока идёт сбор, отключить агента нельзя.
- Ставить на паузу, включать и отключать агента может его владелец, а также владелец и администраторы компании.
Версии агента
У шаблона агента есть версии. Версия вашего агента — в «Настройках агента», карточка «Версия агента», и на странице каждого прогона.
- Небольшое обновление — меняется вторая или третья цифра номера, например 2.2.0 → 2.3.0. Оно ставится само: если новая версия принимает настройки вашего агента, агент переходит на неё без вашего участия и без отдельного уведомления. Не принимает — агент остаётся на прежней версии.
- Крупное обновление — меняется первая цифра, например 1.4.0 → 2.0.0. Само оно не ставится: владелец агента получает уведомление «У шаблона агента вышла новая версия», а агент работает на прежней версии, пока владелец не перейдёт на новую.
- Перейти на другую версию — «Настройки агента» → «Версия агента» → «Перейти на …». Переход применится перед следующим запуском, вернуться на прежнюю версию можно всегда. Переходить может владелец агента и администраторы компании.
Сколько стоит
Портал цен не называет: цена зависит от модели, которую выбрала компания.
- Оценка — «Описание агента», карточка «Сколько стоит»: цена одного запуска и примерно в месяц при расписании по умолчанию. В мастере подключения — оценка для выбранной модели и расписания.
- Сколько стоил прогон на деле — в «Журнале выполнений» (столбец «Стоим.» и итог за период) и на странице прогона («Стоимость»).
- Прогон без работы бесплатный. Если агенту нечего делать — например, нет новых встреч, — он не обращается к модели, и прогон ничего не стоит. Точное условие у каждого агента своё — оно в «Описании агента», под ценой.
- Лимит. Расход агентов — расход компании. У компании есть дневной лимит на агентов: «Настройки компании» → «Лимиты». Исчерпан лимит — прогоны завершаются ошибкой, пока не начнутся следующие сутки или лимит не поднимут.
Как читать страницы агентов
- Подробно об одном агенте — на его странице в этом разделе, если она уже есть: что делает агент, где результат, что подключить, как проходит его прогон, что получает модель, куда уходят данные, пределы и правила, как читать результат, ошибки, требование к модели и частые вопросы.
- Вверху страницы агента — версия агента, с которой сверена страница, и дата сверки. Если у вашего агента другая версия или кабинет говорит иначе — верьте кабинету.
- Общее для всех агентов на их страницах не повторяется — оно здесь.