Навыки

Что такое навык агента llmagent, как включить его отдельному боту, как загрузить свой навык архивом .skill и что умеет стандартный набор.

Навык расширяет агента за пределы «ответить на вопрос»: с ним бот готовит документы и таблицы, собирает презентации и коммерческие предложения, выполняет сценарии, настроенные под процессы вашей компании. Управление навыками — в разделе «Навыки» кабинета app.llmagent.ru.

Раздел открыт владельцу и администратору организации.

Что вы видите в разделе

Слева — список навыков организации, разбитый на полки:

«Стандартные» — подготовка документов Word, PDF, PowerPoint и Excel.
«Для сотрудников» — прикладные навыки по просьбе сотрудника: коммерческие предложения.
«В разговорах с клиентами» — навыки для внешнего собеседника в Telegram, МАКС и открытых линиях; у них есть инструменты и настройки.
«Ваши навыки» — то, что загрузили вы.

Откуда навык — из набора платформы или ваш — показывает метка в карточке.

Справа открывается карточка выбранного навыка: описание, блок «Когда бот его применяет», «Что бот сможет делать», если навык приносит боту дополнительные инструменты, и поле «Сценарий навыка».

Переключатель — у каждого бота свой

Переключатель в карточке относится к текущему боту, а не ко всей организации: подпись над списком так и говорит — «Бот «Имя»». Другого бота выбирают переключателем ботов в боковой панели, и набор включённых навыков у него будет свой. Это осознанно: у бота для клиентов и внутреннего помощника разная работа.

Стандартные навыки тоже можно выключить — организация не обязана пользоваться всем набором.

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

Метки в карточке

Метка	Что означает
«Стандартный» / «Ваш»	откуда навык: набор платформы или ваша загрузка
«Выключен»	навык выключен у текущего бота
«Нужен запуск кода»	навык делает результат, выполняя код
«не работает»	навык загружен, но применить его сейчас нечем
«Нужна настройка»	у навыка есть обязательные поля, и они пусты или инструменты не включены; в списке — шестерёнка

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

Стандартный набор

Пять навыков подготовки документов:

Навык	Что делает
Документы Word	текстовые документы `.docx`
Таблицы Excel	таблицы `.xlsx` с формулами и форматированием
Презентации PowerPoint	слайды `.pptx`
Документы PDF	документы `.pdf`
Коммерческие предложения	КП по вашим данным — на основе четырёх навыков выше

Все пять делают результат, выполняя код, поэтому у всех стоит метка «Нужен запуск кода».

Свои навыки

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

Ограничения архива: один файл — до 5 МБ, файлов — до 50, весь архив — до 20 МБ.

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

Сценарий навыка

У каждого навыка в карточке есть поле «Сценарий навыка» — что бот должен уточнить, в каком порядке и что сказать, как объяснили бы новому сотруднику. Например, для навыка, который выдаёт бланк заявления: «Сначала уточни, за какой год нужна справка, потом ФИО пациента. Если за 2023 год и раньше — заявление не нужно, справку подготовим по данным из разговора».

Три вещи, которые стоит знать:

Это часть навыка, а не общая инструкция бота. Бот читает сценарий вместе с инструкцией навыка и только тогда, когда взялся за подходящую задачу. Выключили навык — сценарий перестал действовать. В системный промпт бота переносить его не нужно.
Он общий для организации. Сценарий действует у всех ботов компании, которым включён этот навык, как и остальные настройки навыка. Есть он и у стандартных навыков: сам архив вы не правите, а свой порядок вопросов к нему добавить вправе.
Объём — до 4 000 символов. Пустое поле означает «как в архиве»: бот ничего не уточняет сверх инструкции навыка.

Сохраняет сценарий владелец или администратор.

Как навык срабатывает

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

Запуск бывает только по смыслу разговора. Запуска по расписанию или по событию у навыков нет — для повторяющейся работы по CRM есть Автоматизации.

Файлы и документы в разговоре

Попросите бота в чате кабинета: «оформи это КП в PDF», «сведи цифры в таблицу», «собери презентацию по тезисам» — он подготовит файл и покажет его карточкой под ответом. Карточку можно открыть в предпросмотре (картинки, PDF и текстовые файлы) или скачать. Работает и в обратную сторону: приложите файл к сообщению — бот прочитает его и использует в работе.

Подготовка файлов — инструмент внутренней работы. Она действует в чате кабинета и в переписке сотрудников с ботом внутри Битрикс24 — в личном диалоге или в групповом чате, но не в открытых линиях.

Ограничения: вложение — до 20 МБ, до 10 файлов на сообщение из канала, до 4 картинок за один ответ; созданных файлов — до 30 на диалог. Содержимое файлов хранится 30 дней, после чего в ленте остаётся запись о файле.

Навык «Документ по бланку»

Навык, который приносит боту не только инструкцию, но и инструменты. Сценарий один для любой отрасли: собеседник просит бланк, бот отправляет файл, собеседник присылает заполненный документ фотографией, сканом или файлом, бот передаёт его сотрудникам в Битрикс24 вместе с короткой сводкой того, что человек сообщил словами. Клинике это заявление на справку, магазину — форма возврата, сервисному центру — акт приёма.

Настройка

В карточке навыка два поля, общие для всей организации, а не для каждого бота:

Бланк для собеседника — файл, который бот отправляет по просьбе: PDF, Word, Excel, JPG или PNG до 5 МБ. Загружается прямо в карточке навыка и сразу вступает в силу. Убрать файл при включённых инструментах нельзя — сначала выключите их.
Заголовок записи в карточке — строка, с которой начинается запись, которую увидит сотрудник.

Пока бланк не загружен, карточка показывает «Нужна настройка», и бот навыком не пользуется. Карточка честно предупреждает: «записывает данные в вашу CRM», и называет права, которые нужны приложению в Битрикс24. Если Битрикс24 у организации не подключён, карточка говорит об этом прямо: включить навык можно, бот будет отправлять бланк, но передавать документы ему некуда. Если приложению на портале не хватает прав, карточка называет каких — обновите приложение в Битрикс24.

Что уточнить у собеседника до бланка — за какой период, на кого оформлять, как получить результат, — напишите в поле «Сценарий навыка» в той же карточке обычным текстом, вопросы по порядку. Бот задаёт их по одному и не выдумывает своих.

Куда попадает документ

Где идёт разговор	Что делает бот
Открытая линия Битрикс24	отправляет бланк; сводку и файлы пишет комментарием в контакт диалога, а если контакта нет — в его лид. Если линия не ведёт CRM, бот сам сохраняет диалог в CRM: портал заводит лид и привязывает к нему чат, как при кнопке «Сохранить в CRM». Если разговор уже передан оператору, бот заводит лид без привязки и оставляет в нём ссылку на диалог
Telegram или МАКС, подключённые в кабинете, при подключённом Битрикс24	отправляет бланк; под разговор заводит лид с именем собеседника, сводка и файлы уходят в ленту этого лида, следующие документы — туда же
Telegram или МАКС без Битрикс24, чат кабинета, чат сотрудника	только отправляет бланк

Сводку бот пишет своими словами и помечает «со слов клиента, не подтверждена сотрудником»: номера документов со скана он не перепечатывает, обещаний и скидок не записывает. Уже переданный файл второй раз не уезжает.

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

Проверить навык можно в чате кабинета: попросите бота прислать бланк.

Запуск кода: что это и где границы

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

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

Управлять навыками можно только в кабинете: из переписки навык не включить и не отключить.

Смежные статьи

Как агент готовит ответ — путь сообщения от вопроса до ответа.
Автоматизации — роботы, которые работают с CRM по расписанию.
База знаний — документы, по которым бот отвечает.
Тарифы и оплата — что входит в тарифы.