Документация / Как создать ИИ-ассистента с нуля
Как создать ИИ-ассистента с нуля
Для администратораПервая автоматизация на платформеСемь шагов
Ассистент отвечает сотрудникам на вопросы по документам вашей компании и показывает, откуда взял ответ. В ваши системы он ничего не записывает, поэтому его обычно запускают первым. Собрать такого ассистента администратор может сам, из кабинета, не обращаясь в БизнесМатику.
Термины этой страницы. Автоматизация - это набор объявлений, по которым платформа делает для вас одну работу. В автоматизации собраны маршрут работы, тексты инструкций для языковой модели, роли, экраны сотрудников и правила обращения с данными. Хранится она на вашей платформе и обновляется целиком. Рабочее место - это экран сотрудника, на котором он пользуется автоматизацией. Скелет - это установленная автоматизация-образец, с которой начинается сборка своей.
Что делает ассистент и чем отличается от агента
Ассистент и агент устроены по-разному, и путь сборки у них тоже разный.
| Признак | Ассистент | Агент |
|---|---|---|
| Что делает | Отвечает на вопрос по вашим документам | Ведет дело по маршруту от начала до результата |
| Пишет ли в ваши системы | Нет | Да, там, где это разрешено маршрутом |
| Кто начинает работу | Сотрудник, задавший вопрос | Событие в вашей системе или расписание |
| Что задается при сборке | Документы, роли, пороги, тексты | То же плюс маршрут и подключения к системам |
| Сколько занимает сборка | Дни, если выгрузка документов готова | Недели, потому что нужны доступы к системам |
Дальше разобран путь ассистента по шагам. Путь агента и подробная сборка маршрута описаны на соседней странице.
Откуда берется автоматизация
Автоматизация на вашей платформе появляется одним из двух путей.
- Готовая автоматизация БизнесМатики. Ее собрали мы, она прошла нашу приемку и приезжает вместе с обновлением платформы. В каталоге такие автоматизации видно по пометке, что их можно подключить.
- Своя автоматизация. Вы собираете ее в кабинете сами, от описания словами до выпуска сотрудникам. Обращаться в БизнесМатику для этого не нужно, доступ к файлам сервера тоже не нужен.
У каждой автоматизации платформа хранит происхождение и показывает его словами «собрана вами» или «поставлена БизнесМатикой». Пометка видна в карточке автоматизации, в записи каждого прогона, в журнале аудита и в перечне автоматизаций на экране лицензии. Задать это поле руками нельзя, платформа проставляет его сама.
Правила у своей и поставочной автоматизации разные, и об этом стоит знать заранее. Часть проверок, описанных ниже (отрасль автоматизации, основание остановки на человеке, разрешенные классы данных), включается только для автоматизаций, собранных вами. Поставочных автоматизаций эти правила не касаются. Отрасль у них проставляем мы, и состав проходит нашу приемку до поставки.
Шаг 1. Начать сборку
Сборка начинается на экране «Каталог автоматизаций платформы». Он показывает, что платформа умеет в восьми отраслях и что уже подключено на вашей платформе. Там же стоит действие «Собрать свою автоматизацию».
Действие видно не всем. Его показывают тому, у кого есть роль «автор автоматизаций». Роль платформенная, выдается на экране доступа, и право у нее ровно одно, создавать автоматизации. Права менять конфигурацию платформы, применять изменения схемы данных, устанавливать новые версии и распоряжаться бюджетами моделей эта роль не дает. Как раздаются роли, описано на странице доступа и ролей.
Если действия на экране нет, дело в роли. Попросите администратора платформы выдать вам роль автора автоматизаций и вернитесь в каталог.
Шаг 2. Описать автоматизацию словами
Первый экран сборки - это одно большое поле описания, до 4 000 знаков. Пишите обычными словами и отвечайте в описании на следующие вопросы.
- Что должно происходить и в ответ на что.
- С какими документами или данными это происходит.
- Кто этим пользуется и что он видит в результате.
Рядом с полем стоят три примера формулировок. Примеры берутся из самих скелетов, поэтому они соответствуют тому, что платформа умеет.
Пример описания для ассистента. «Сотрудники поддержки ищут ответы в регламентах и инструкциях. Нужен экран, где сотрудник задает вопрос обычными словами, а платформа отвечает по нашим документам и показывает, из какого документа взят ответ. Писать никуда не нужно, только отвечать».
Какой скелет выбрать
Скелет вы выбираете из списка на первом экране сборки, там же, где поле описания.
| Скелет | Что в нем уже есть | Когда его берут |
|---|---|---|
| Пустой | Минимальный каркас без маршрута работы | Автоматизация не похожа ни на ассистента, ни на агента |
| Ассистентский | Корпус документов, канал сотрудника, поиск по документам и ответ без записи куда-либо, рабочее место поиском, обезличивание, аудит, заполненная таблица маршрутов данных | Ответы по документам |
| Агентский | Маршрут с остановкой на человеке, обезличивание, рабочее место очередью | Ведение дела до результата |
Скелетом может быть и уже установленная автоматизация. Тогда платформа делает копию с новым именем и ссылкой на образец. Ссылка справочная, обновления образца в копию не приезжают, и платформа предупреждает об этом прямо при копировании.
Шаг 3. Проверить черновик автоматизации
Черновик автоматизации собирается из выбранного скелета. На экране сборки видны разделы автоматизации и состояние каждого. Раздел, который вы не трогали, помечен «как в образце», заполненный вами помечен «заполнено вами», а раздел, где проверка нашла замечания, помечен «есть замечания».
Проверка та же, которой платформа проверяет любую автоматизацию перед установкой. Строка раздела, у которого есть свой экран, ведет на этот экран, и замечания к разделу исправляют там. Замечания к частям автоматизации, у которых нет своего экрана, платформа показывает в отдельной строке без ссылки.
Черновик хранится на платформе, а не в браузере. Сборку можно прервать, закрыть кабинет и вернуться позже, набранное не теряется.
Шаг 4. Пройти по разделам автоматизации
Черновик правится по разделам. Каждый раздел - это отдельный экран с одним предметом и своей проверкой.
| Раздел | Что в нем задается | Кто заполняет |
|---|---|---|
| Об автоматизации | Имя, тип автоматизации, каналы, пределы, подписи экранов | Вы |
| Документы автоматизации | Корпус документов и профиль нарезки, то есть на какие куски документ режется для поиска | Вы |
| Данные автоматизации | Свои сущности и поля, конструктором полей | Вы |
| Правила автоматизации | Доступ, аудит, согласия, маршруты данных, обезличивание, сроки хранения, правила передачи дела человеку | Вы, выбором из перечней |
| Рабочие места | Экраны сотрудников, вид берется из перечня видов | Вы |
| Подключения | Ваши системы из числа подключенных к платформе | Вы |
| Маршруты | Порядок шагов работы | Вы в редакторе маршрутов |
| Происхождение, отрасль, совместимость | Служебные поля автоматизации | Платформа |
У ассистента маршрут приезжает со скелета и обычно не правится. Если он все же нужен, его собирают в редакторе маршрутов, и разобран редактор на странице агента.
Правила, общие для всех разделов
- Перечни закрыты. Там, где платформа допускает значение из справочника (вид шага, правило передачи дела человеку, категория данных, класс модели, профиль нарезки документов, вид рабочего места, назначение маршрута данных), стоит выбор понятными названиями, а не поле ввода с кодом. Так снимается класс ошибок, которые иначе нашлись бы уже при установке автоматизации.
- Отсутствие правил написано словами. Семь разделов правил автоматизации существуют у любой автоматизации. Раздел, в котором правил нет, так и подписан словами «правил нет, это осознанное состояние». Пропасть с экрана раздел не может, потому что тогда отсутствие правил было бы неотличимо от недоделанной настройки.
- Маршруты данных обязательны. Для каждого класса данных автоматизации названо, можно ли передавать его языковой модели и только ли после маскирования. У скелета ИИ-ассистента маршруты данных приезжают заполненными, но прочитать их стоит, потому что именно они отвечают на вопрос «уйдут ли наши данные наружу».
Шаг 5. Создать автоматизацию
Когда разделы заполнены, автоматизация создается одним действием. В этот момент платформа делает следующее, и каждый шаг может закончиться отказом с названной причиной.
Имя автоматизации и отказ на занятом имени
Платформа выводит служебное имя автоматизации из вашего названия и резервирует его за черновиком. Занятое имя дает отказ «Автоматизация с таким именем уже есть. Измените имя.» Подбирать суффикс за вас платформа не будет, имя выбираете вы.
Тип автоматизации и его проверка по составу
Тип выбираете вы из перечня типов, а платформа проверяет выбор по составу автоматизации. Проверка работает по следующим признакам.
- Объявлен корпус документов, объявлен канал сотрудника, и шаги в ваши системы не пишут - это ассистент по документам.
- Объявлено подключение с операциями записи и на пути к решению стоит действующая остановка на человеке - это документный агент.
Если признак сработал, а вы объявили тип без лестницы потребления, создание отклоняется. Если признаки не сработали, тип принимается таким, как вы его назвали. Спорный случай решается в пользу человека, а не машины.
Отрасль автоматизации и отрасль платформы
Если платформа объявила отрасль, своя автоматизация обязана объявить ту же. Иное значение, в том числе пустое, дает отказ «Платформа работает в отрасли «...». Автоматизация должна быть объявлена для нее же.» Правило нужно затем, что к отрасли привязаны проверки, обязательные в регулируемых отраслях, и автоматизация с пустой отраслью проходила бы мимо них.
Происхождение и номер первой версии
Происхождение проставляет платформа. Присланное в запросе поле она отклоняет как ошибку в запросе. Первая версия автоматизации получает номер 1.0.0.
Роль автора и группа под нее
Вместе с автоматизацией платформа делает следующее:
- Объявляет роль автора этой автоматизации.
- Заводит под нее группу в вашей системе входа.
- Записывает привязку роли к этой группе.
Ходить к администратору системы входа руками не нужно.
Владелец автоматизации - это справочное поле карточки. На права оно не влияет и нужно сотруднику затем, чтобы знать, к кому идти с вопросом.
Шаг 6. Настроить автоматизацию
Созданная автоматизация появляется на экране «Настройка автоматизаций» рядом с поставочными. Дальше все автоматизации настраиваются одинаково, и это сделано намеренно. Настроив одну автоматизацию, вы настроите остальные тем же способом.

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

Шаг 6.1. Загрузить документы, на которых автоматизация работает
На первом шаге загружается выгрузка документов, на которых автоматизация работает. Это регламенты, инструкции, техническая документация, накопленные ответы поддержки. Принимаются файлы xlsx и csv. Порядок такой, что сначала платформа проверяет файл, а потом вы принимаете данные.

Колонка, которой в файле нет, помечается прямо в таблице. Поле, заполненное ниже порога автоматизации, тоже. Это ответ на вопрос «хватит ли данных для работы», и получить его лучше здесь, чем на первом обращении сотрудника.
Шаг 6.2. Раздать роли автоматизации группам сотрудников
Роли автоматизации раздаются группам сотрудников. Список ролей задает сама автоматизация, и он закрытый, новую роль на этом экране не завести. Люди и группы заводятся в вашей системе входа и приходят сюда готовыми.

Часть изменений применяет второй администратор автоматизации, а не тот, кто их подготовил. Такие изменения следующие:
- Правка порога, по которому дело уходит на решение человеку.
- Смена тех, кто решает.
- Выдача роли администратора.
- Разрешение работы на неполной настройке.
- Правка текста, от которого зависит соответствие требованиям регулятора.

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

Все пороги разом возвращаются к значениям поставки одной кнопкой. Это выручает, когда после нескольких правок работа стала хуже, а какая именно правка виновата, неясно.
Шаг 6.4. Тексты инструкций
Тексты инструкций приезжают в автоматизации и работают сразу. Свои формулировки обычно добавляют после первого прогона на реальных вопросах, когда видно, где ответ расходится с принятым у вас языком.

Каждому запуску задано правило отвечать по вашим данным и не додумывать. Текстами инструкций это правило не отменяется.
Шаг 6.5. Очередь подтверждения
Шаг есть у автоматизаций, которые разрешили донастройку очереди. Здесь задается, как называется очередь на экране сотрудника и в каком порядке идут колонки списка.

Не переименовывается следующее:
- Заголовки блоков.
- Строки со значениями, которые автоматизация переводит в слова.
- Содержимое блока «Объяснение».
- То, что закрепил автор автоматизации.
Это запись о том, что платформа решила и почему, и читают ее потом аудитор и проверяющий от регулятора.
Готовность к работе и история настройки
Две вкладки не настраивают ничего, а показывают. «Готовность» отвечает на вопрос, чего не хватает для работы, по каждому разделу отдельно и словами, а не значками.

«История настройки» показывает, кто и когда менял настройку и что именно поменялось.
Шаг 7. Выпустить автоматизацию сотрудникам
Выпуск - это отдельное действие, а не следствие настройки. Платформа пропускает его, когда выполнено следующее.
- Автоматизация прошла проверку целиком, включая правила отрасли и проверку типа.
- В отчете готовности нет незакрытых обязательных пунктов.
- Хотя бы один пробный запуск дошел до конца. Без этого платформа отвечает «Сначала пробный запуск. Автоматизация открывается сотрудникам после того, как хотя бы один пробный запуск дошёл до конца.»
Пробный запуск проходит автоматизацию на ваших данных и останавливается перед первой записью в рабочую систему. Ассистент так устроен, что никуда не пишет, поэтому проба проходит целиком и показывает готовый ответ с источниками.
Как выпуск идет разрешением с причиной
Набор оценок - это подготовленные заранее примеры с правильными ответами, на которых платформа проверяет автоматизацию. Результат этой проверки на выпуск не влияет. Автоматизацию, собранную в кабинете, открывают только разрешением с причиной. Причина обязательна и попадает в журнал вместе с автором и временем.
Второго администратора это разрешение не требует. Исключение одно. На платформе с объявленной регулируемой отраслью открытие автоматизации подтверждает второй человек, и платформа отвечает «В вашей отрасли открытие автоматизации подтверждает второй человек.» Там разделение обязанностей - это требование регулятора, а не удобство.
После выпуска автоматизация появляется на рабочих местах у тех, кому розданы роли. Проверьте ее сами на десятке реальных вопросов до того, как позовете сотрудников. Если у ответа не видно источника, возвращайтесь к выгрузке документов, а не к текстам инструкций.
Как автоматизация правится дальше
Платформа сама решает, применится правка сразу или потребует новой версии. Группу правки она показывает у поля до того, как вы его тронули, а не после.
| Легкая правка, применяется сразу | Тяжелая правка, выпускается новой версией с планом перехода |
|---|---|
| Значения порогов, тексты заданий, привязки ролей, подписи и порядок на экранах, подтверждение значений поставки, редакция маршрута | Состав сущностей и полей, миграции, каналы, тип автоматизации, подключения, схема поиска по документам, правила автоматизации, вид рабочих мест |
Экран «Об автоматизации» несет оба вида сразу. Имя и подписи правятся легко, каналы и тип тяжело. Поэтому предупреждение стоит у поля, а не на входе в экран.
Смена типа автоматизации предупреждается отдельно, потому что меняет лицензионные последствия. Смена автора автоматизации - это легкая правка, перепривязка человека. Появление новой роли - это тяжелая правка, потому что меняется сама автоматизация. Смешанная правка целиком идет тяжелым путем.
Смена отрасли платформы или смена лицензии запускает перепроверку всех ваших автоматизаций и объявленных подключений. Автоматизация, переставшая удовлетворять правилу, помечается и попадает в список на экране платформы. Работа при этом не останавливается, но пометка сама не снимается.
Как снять автоматизацию
Снятие идет следующими действиями, и последнее отделено от первых двух намеренно.
- Отключение автоматизации. Рабочие места пропадают у сотрудников, новые дела не заводятся.
- Удаление записи автоматизации из перечня.
- Снос данных автоматизации. Отдельное явное решение, с подтверждением и после резервной копии.
Вместе с автоматизацией данные не удаляются ни при каких условиях. Снятая автоматизация, на которую ссылаются другие, дает отказ со списком ссылающихся. Снимите ссылки и повторите.
Сколько своих автоматизаций входит в лицензию
Экран лицензии показывает конфигурацию, срок поддержки, перечень ваших автоматизаций с типом и потреблением и счетчик вида «столько-то из включенных». Считается это так.
- Лестница потребления - это шкала, по которой ступень лицензии на автоматизацию зависит от объема работы (числа дел, которые автоматизация обработала за месяц). В число включенных автоматизаций входят ваши автоматизации тех типов, которые по лестнице потребления не лицензируются. До пяти автоматизаций включено, а сверх этого они идут пакетами по пять. На конфигурации «Базовая» включена одна.
- Автоматизации типов, лицензируемых по лестнице потребления, показываются отдельным списком и в число включенных автоматизаций не входят. Они считаются по своей лестнице независимо от того, кто их собрал.
Предупреждение о выходе за включенное платформа выдает до создания автоматизации и с числами. Создать при этом дает. Лицензия считает, показывает и предупреждает, но работу не останавливает.
Отказы и что они значат
Отказ на любом шаге называет причину и не теряет набранного. Ниже те, что встречаются на пути сборки чаще других.
| Что говорит платформа | Что делать |
|---|---|
| Автоматизация с таким именем уже есть. Измените имя. | Выбрать другое название |
| Черновик изменился в другом окне. Обновите страницу, чтобы не потерять правки. | Обновить страницу и повторить правку |
| Черновик не найден: он был удален или истек срок хранения. | Начать сборку заново, описание сохранить себе |
| Автоматизация не собрана: проверка нашла столько-то. Ниже - что именно и где. | Пройти по находкам, каждая указывает на свой раздел |
| Хранилище автоматизаций недоступно. Правки не сохранены. | Не продолжать, звать администратора платформы |
Что смотреть дальше
- Расход на языковую модель. Каждый ответ стоит обращений к модели. Расход автоматизации виден на экране «Модели и маршрутизация», там же ставится предел. Подробнее об этом на странице языковых моделей.
- Журнал аудита. Кто и о чем спрашивал, какой ответ получил и на каких документах он построен.
- Пороги. Обычно через пару недель работы видно, правильно ли выбрана граница между автоматом и человеком, и пороги двигают один раз.
- Маршрут. Если ассистенту понадобилось не только отвечать, но и что-то делать, то следующими идут маршрут и подключения, разобранные на странице агента.