Что умеет агент

Vrio — собеседник внутри 1С. У него две особенности, из которых следует всё остальное.

Он знает состав вашей базы. Какие есть справочники и документы, какие у них реквизиты, как они связаны между собой. Объяснять, где что лежит, не требуется — достаточно назвать вещи своими именами.

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

Права у агента ровно те же, что у вас. Он не видит и не может сделать ничего сверх того, что разрешено вашей учётной записи 1С. Если у вас нет доступа к разделу учёта, у агента его тоже нет.

Как выглядит работа с ним

Разговор ведётся обычными словами. Вы пишете вопрос — агент разбирается сам:

Вы: Сколько израсходовано по заявкам на кассовый расход (сокращенным) за 2022 год в разрезе КФО? Ответь таблицей: КФО, количество заявок, сумма, доля в итоге.

Выполняю запрос…

Агент: таблица по трём КФО — количество заявок, сумма, доля в итоге — и строка «Итого».

Таблица приходит прямо в переписку: её видно целиком, не открывая отдельного окна. Если агент сослался на конкретный документ или элемент справочника, ссылка открывает его карточку в 1С.

Обратите внимание на последний абзац ответа. Агент сам оговорил, что заявка на кассовый расход — это заявка на оплату, а не факт списания, и предложил пересчитать по факту исполнения. Такие оговорки он делает по своей инициативе, и читать их стоит: они про смысл цифр, а не про их получение.

Между вопросом и ответом агент выполняет несколько шагов: находит, в каких объектах хранятся нужные сведения, составляет запрос, выполняет его на сервере и разбирает результат. Шаги видны в чате пометками «Читаю объект…», «Выполняю запрос…» — по ним понятно, что работа идёт.

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

Ответить на вопрос по данным

Основной сценарий, ради которого всё и делалось. Вопрос задаётся без указания объектов, реквизитов и регистров:

Деньги и расчёты

• «какая задолженность у контрагента Ромашка»
• «покажи неоплаченные счета за сентябрь»
• «сколько мы должны поставщикам на конец квартала»

Документы

• «сколько документов поступления за этот год»
• «найди все документы по договору 47-А»
• «какие документы не проведены за август»

Склад и материалы

• «остатки материалов на основном складе»
• «что списывали в прошлом месяце»

Кадры

• «кто принят в этом квартале»
• «сколько сотрудников в подразделении Бухгалтерия»

Это не список поддерживаемых команд: агент не работает по шаблонам. Примеры показывают уровень формулировки, а не её обязательную форму.

Если сомневаетесь в цифре — попросите её разложить: «покажи, из каких документов сложилась эта сумма». Агент перечислит составляющие, и ответ станет проверяемым.

Объяснить, как устроена база

Отдельный класс вопросов — не про данные, а про саму конфигурацию:

• «какие реквизиты у справочника Контрагенты»
• «где хранится информация о договорах»
• «чем отличается документ Поступление от документа Приобретение»
• «найди все объекты, связанные с закупками»

Ответ приходит из описания конфигурации, которое служба хранит у себя. Ваш сервер при этом не нагружается, и ответ приходит быстро.

Вопросы такого рода полезны не только программистам. Ими удобно выяснять, откуда вообще может взяться нужная цифра, прежде чем просить её посчитать.

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

Найти, где что-то упоминается

Когда неизвестно даже, в каком объекте искать, работает полнотекстовый поиск: агент ищет слово или фразу сразу по всем данным — в наименованиях, комментариях, текстовых полях.

• «найди, где упоминается Ромашка»
• «где в базе встречается номер 47-А»

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

Поиск опирается на индекс полнотекстового поиска 1С. Если в вашей базе он не заполнен, агент об этом скажет; обновляется индекс средствами самой 1С, это делает администратор.

Построить отчёт или выгрузку

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

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

Форма 1С — открывается отдельной вкладкой и ведёт себя как обычная форма: сортировка по колонкам, отбор, печать по Ctrl+P, сохранение в файл. Подходит для настоящей работы с результатом.

Диаграмма — если попросить показать соотношение или динамику, агент строит форму, где диаграмма и таблицы с теми же числами лежат рядом. Так видно и картину целиком, и точные значения:

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

Отчёт в окне — готовый отчёт прямо в 1С: ключевые цифры, диаграммы, графики и таблицы с итогами в едином стиле. Его можно сразу показать руководителю или распечатать. Номера документов и контрагенты в отчёте открываются по клику: один щелчок, и перед вами сам документ или карточка. Попросите несколько отчётов — каждый откроется в своём окне.

Нужен особый вид — просто опишите его, агент сделает и такой. Просить «сделай в HTML» не нужно.

Две особенности, о которых стоит знать:

• Окно только показывает. 1С отображает отчёт как документ и ничего в нём не выполняет, поэтому подтверждение здесь не запрашивается и в базе ничего не меняется. Это способ показать, а не сделать.
• Окно перерисовывается на месте. Скажете «добавь колонку с ИНН» или «отсортируй по сумме» — тот же отчёт обновится, второе окно не откроется.

Задачу формулируйте так же, как поставили бы её человеку — с указанием, что должно получиться:

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

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

Изменить данные

Агент может создавать и изменять данные, но не делает этого молча. Перед выполнением в чате появляется окно «Подтверждение»: в нём описано, что именно будет сделано, и две кнопки — «Разрешить» и «Отклонить».

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

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

После «Разрешить» агент отчитывается тем же разговором: что создано и с какими реквизитами, а в конце ответа — ссылки на карточки. Ссылка открывает объект в 1С, искать его в справочнике не нужно. Там же агент называет сделанное сверх просьбы: контрагент в этой конфигурации ссылается на запись справочника «Юридические лица», поэтому она создана тоже.

Это правило не зависит от того, как сформулирована просьба: уговорить агента обойтись без подтверждения нельзя. Отключить подтверждения может только сотрудник, которому администратор выдал роль «Автономный режим агента», и только сам, выбрав в чате автономный режим. Тогда агент выполняет действия сразу, но каждое по-прежнему записывается в журнал действий. В Telegram и MAX подтверждения остаются всегда.

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

Читайте предложенное перед подтверждением. Это единственная точка, где изменение можно остановить, и потратить на неё несколько секунд дешевле, чем потом искать последствия.

Работать с документами и изображениями

К сообщению можно приложить файл — кнопкой с плюсом слева в поле ввода. Агент прочитает содержимое и учтёт его в ответе.

Что прикладывается	Что с этим происходит
PDF	извлекается текст
Таблицы XLSX, CSV	читаются как данные, с ними можно сравнивать
Документы Word (DOCX)	читается текст и таблицы; колонтитулы и картинки внутри не читаются
Изображения PNG, JPEG	распознаётся текст — годится скан или фотография документа
TXT, Markdown, HTML, XML	читаются как есть

Это набор, доступный сразу после установки. Администратор меняет его в обе стороны: сверх этого списка открываются JSON, YAML, TSV, журналы и исходные тексты, а сузить набор можно вплоть до полного запрета вложений. Файл вне разрешённого набора агент не примет и скажет об этом прямо — это настройка, а не неполадка. Старый формат Word (DOC) не читается — сохраните файл как DOCX. Что именно можно открыть — в разделе «Форматы файлов» веб-консоли.

Размер одного файла — до 25 МБ. Файлы чата хранятся, пока существует чат: к файлу, приложенному месяц назад, агент вернётся так же, как к вчерашнему. Удалите чат — удалятся и его файлы.

Файл можно отправить и без текста. Агент откроет его, коротко скажет, что в нём, и спросит, что с ним сделать.

Агент тоже может отдать вам файл — отчёт в Excel, счёт или акт в PDF. Попросите прямо: «выгрузи остатки по складу в Excel». Файл появится в чате карточкой с названием и размером; нажмите на неё, и 1С предложит место для сохранения. Формирование файла — это выполнение кода в 1С, поэтому перед ним придёт запрос подтверждения. Долгую выгрузку агент может запустить в фоне — файл придёт, когда она закончится. Размер одного файла — до 10 МБ. Файлы от агента хранятся столько же, сколько загруженные, пока существует чат.

Таблицу Excel агент может изменить. Приложите книгу XLSX и попросите: «добавь лист с итогами по месяцам», «сделай шапку жирной и закрепи первую строку», «переименуй второй лист». Агент может и собрать новую книгу из данных базы. Правка идёт без кода в 1С и без запроса подтверждения: меняется копия файла, а не данные базы. Ваш исходный файл остаётся как был, а исправленный приходит новой карточкой. Макросы, срезы и некоторые фигуры при правке не сохраняются; если в книге было что-то такое, агент скажет, что пропало. Правятся только книги XLSX: старый формат XLS и книги с макросами (XLSM) сохраните как XLSX.

Приложенный файл агент может загрузить в 1С. Попросите: «загрузи эту выписку в документы», «сверь этот прайс с номенклатурой и обнови цены». Агент пишет код, который получает сам файл и разбирает его в 1С: выписку из клиент-банка, XML, таблицу. Данные из файла агент не перепечатывает, поэтому суммы и реквизиты доходят до базы ровно такими, как в файле. Это выполнение кода, так что придёт запрос подтверждения, и в нём будут названы файлы, которые получит код. За один раз можно передать до 10 файлов общим размером до 10 МБ. Нужна обновлённая версия расширения Vrio в базе: со старой агент скажет, что расширение пора обновить. Обновляет его администратор через Конфигуратор.

Типичные применения:

• «вот счёт от поставщика, проверь, есть ли такой документ в базе» — с фотографией счёта;
• «сверь эту таблицу с остатками на складе» — с приложенным XLSX;
• «добавь в эту книгу лист со сводкой по контрагентам» — с приложенным XLSX;
• «загрузи эту выписку в документы» — с выгрузкой из клиент-банка;
• «занеси реквизиты из этого договора в карточку контрагента» — с PDF (изменение потребует подтверждения).

Помнить сказанное ранее

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

Память принадлежит вам: она общая для всех ваших диалогов, сохраняется между сеансами и не видна другим сотрудникам.

Память компании

Кроме вашей личной памяти у агента есть общая — память компании. В ней то, что касается всех: ваши сокращения («ОС», «ЦБС»), ваши названия («Центральный склад» — это «Склад №1» в базе), правила работы («новых физлиц заводим в группу "Читатели"»). Её ведёт администратор в консоли, и агент учитывает её у любого сотрудника — в 1С, в Telegram и в MAX. Благодаря ей агент понимает вопрос «сколько синих заявок провели в сентябре?» так же, как понял бы его ваш коллега.

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

Как добавить запись. Сами вы её не добавите, но можете предложить. Напишите агенту, например:

Запомни для всех: «касса» у нас — это лицевой счёт в казначействе, счёт 201.11.

Агент сформулирует запись, покажет её вам и отправит администратору только после вашего согласия. Запись заработает, когда администратор её примет. До этого она ни на что не влияет, даже в вашем собственном разговоре. Агент может и сам предложить отправить что-то в память компании, если вы рассказали правило, касающееся всех, но без вашего «да» ничего не отправит.

Что сказать	Куда попадёт
«Запомни, что я предпочитаю отчёты в Excel»	в вашу личную память, сразу
«Запомни для всех: …», «Добавь в память компании …»	администратору на утверждение

Запоминать, как сделана задача (скиллы)

Если агент хорошо справился с задачей, попросите его запомнить, как он это сделал:

Запомни, как ты это сделал.

Агент запишет скилл: порядок действий, с которым справился, — что спросить у вас, какие шаги и в каком порядке, какие проверки, на какие ошибки наткнулся и как их обошёл. Код и запросы 1С, которые сработали, он сохранит рядом без изменений: в скилл попадает только то, что в этом диалоге выполнилось без ошибок. Если скрипт для скилла ещё не запускался, агент сначала выполнит его (подтвердите, как обычно) и только потом сохранит. Перед сохранением агент своими словами покажет черновик: название, когда скилл применять, и шаги, без кода. Сохранит только после вашего согласия, поэтому, если шаг записан неверно, скажите об этом сразу.

В следующий раз, когда вы попросите похожее, агент найдёт свой скилл и будет действовать по нему: не станет заново искать нужные справочники и подбирать код. Можно и прямо попросить: «сделай по скиллу "Акт сверки"».

Код из скилла агент не перепечатывает, а запускает как есть, подставляя данные вашего случая — контрагента, период, организацию. Подтверждение остаётся: перед выполнением агент, как обычно, опишет, что сделает, и подождёт вашего «Разрешить».

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

Прошлая версия скилла хранится: если обновление оказалось хуже, напишите «верни прошлую версию скилла». Хранится одна прошлая версия; повторная просьба вернёт то, что было до возврата.

Чей скилл. Ваш: другие сотрудники его не видят. Скилл работает в той базе, где записан: в нём названия объектов именно этой базы.

Как отдать скилл всем. Напишите «отдай этот скилл всем». Скилл уйдёт администратору, и после того как он его примет, скилл появится у всех сотрудников, а ваша личная копия заменится общей. Если администратор отклонит скилл, он останется у вас. Улучшение общего скилла агент тоже предложит, но оно уйдёт администратору и заработает после его принятия.

Что сказать	Что произойдёт
«Запомни, как ты это сделал», «Сохрани как скилл»	агент покажет черновик и сохранит после вашего «да»
«Какие у меня скиллы?»	агент перечислит ваши и общие скиллы этой базы
«Обнови скилл "…": теперь ещё …»	агент скажет, что изменится, и обновит скилл
«Верни прошлую версию скилла "…"»	вернётся версия до последнего обновления
«Удали скилл "…"»	ваш скилл удалится; общий удаляет только администратор
«Отдай этот скилл всем»	скилл уйдёт администратору на утверждение

Скиллы есть в редакции Pro.

Выполнять долгие задачи

Работа, требующая много времени, выполняется в фоне. Агент сообщает, что задача запущена, и чат остаётся свободным — можно продолжать разговор, заниматься другим или закрыть окно. Когда задача завершится, результат придёт в чат сам.

Ход выполнения виден пометками «Выполняется», «идёт шаг N», «обработано».

Задавать вопросы вам

Если сведений для ответа не хватает, агент спрашивает сам: в чате появляется форма с вариантами и кнопкой «Далее». Например, при нескольких организациях в базе он уточнит, какая имеется в виду.

Это не сбой, а нормальная часть работы: лучше один вопрос, чем ответ по неверному предположению.

Работать из мессенджера

Если администратор настроил Telegram или MAX, те же вопросы можно задавать боту — например, из поездки, не открывая 1С. Права остаются прежними: мессенджер — другой вход, а не другой доступ. Подтверждение изменений приходит в чат кнопками, как и в 1С.

Файлы можно присылать и боту в Telegram — подпись к файлу агент прочтёт как вопрос к нему. Форматы те же, что в 1С, но Telegram отдаёт боту файлы только до 20 МБ. Бот в MAX принимает файлы по тем же правилам. Агент может и сам прислать готовый документ — счёт, акт, выгрузку — в чат с ботом. Подробнее — в разделе «Файлы» главы про мессенджеры.

Возможность платная и требует настройки. Обратитесь к администратору.

Обращаться к другой базе

Если вы работаете в нескольких информационных базах и администратор связал их с вашей учётной записью, из одной базы можно спрашивать про данные другой: «сколько сотрудников в ЗКГУ».

Запрос выполнится в той базе под вашими правами в ней, а ответ придёт сюда.

Возможность платная и требует настройки. Обратитесь к администратору.

Что записывается

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

Журнал защищён от изменения задним числом и доступен администратору. Переписку в чате он не содержит — там видно, что выполнялось, а не то, что вы писали.

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

Куда попадают ваши данные

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

Если для вас это существенно, уточните у администратора, какая модель используется. Полная картина — какие соединения установка открывает наружу и что именно видит модель — в разделе Как устроена безопасность.

Чего агент не делает

Не изменяет конфигурацию. Он работает с данными, а не с устройством базы: новых справочников, документов и реквизитов от него не появится.

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

Не обходит права. Отсутствующий у вас доступ он не получит.

Не работает с внешними системами — если только администратор не подключил их отдельно.

Не заменяет проверку. Агент может ошибиться: неверно понять вопрос, выбрать не тот регистр, не учесть особенность вашего учёта. Числа, на основании которых принимаются решения, проверяйте. Под полем ввода об этом написано прямо, и это не формальная оговорка.

Как формулировать, чтобы ответ был точнее

Называйте период. «За сентябрь», «на конец года», «с начала квартала». Без периода агент выберет его сам и может выбрать не тот.

Называйте организацию и склад, если их несколько.

Хуже	Лучше
«сколько мы должны»	«сколько мы должны поставщикам на 1 сентября по организации Альфа»
«покажи продажи»	«покажи продажи за август по неделям, с суммой и количеством»
«сделай отчёт»	«собери отчёт по остаткам на основном складе, колонки: номенклатура, количество, сумма»

Задавайте по одному вопросу. Три просьбы в одном сообщении агент выполнит, но разбирать ответ будет труднее, а ошибку в одной из трёх — заметить.

Продолжайте в том же диалоге, пока тема одна. Уточнение «а теперь то же самое за август» будет понято. При смене темы начинайте новый диалог: накопившийся контекст начнёт мешать. Как это сделать — в разделе Работа в чате.

Частые вопросы

Агент увидит зарплаты и другие закрытые данные? Только если их видите вы. Он работает под вашими правами.

Может ли он что-то испортить? Любое изменение проходит через подтверждение, и до нажатия «Разрешить» ничего не выполняется. Чтения данных подтверждения не требуют. Исключение — автономный режим: его включает сам сотрудник с отдельной ролью, и тогда подтверждений нет.

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

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

Откуда агент знает наши сокращения и правила? Из памяти компании, которую ведёт администратор. Предложить туда запись может любой сотрудник — см. Память компании.

Агент неправильно понимает наш термин. Что делать? Предложите запись: «запомни для всех: …». Если запись уже есть, но агент её не учитывает, сообщите администратору — в консоли видно, сколько раз каждая запись применялась.

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