Документация Enums

Чат с ИИ-агентом: опишите задачу обычными словами — агент сам обратится к вашей подключённой системе (1С или iiko), выполнит запросы и ответит понятным текстом, графиком или файлом

Что это и зачем

Ассистент — это диалоговый ИИ-помощник, который работает поверх вашей подключённой системы. Вы пишете задачу на естественном языке (как сообщение в мессенджере), а агент сам решает, какие данные нужно получить, обращается к подключённой системе, выполняет вычисления и возвращает ответ человеческим языком. Вам не нужно знать ни запросов, ни имён таблиц, ни синтаксиса 1С или API iiko.

В основе работы — ReAct-агент: на каждом шаге он рассуждает, вызывает нужный инструмент (запрос к системе), читает реальный результат и при необходимости делает следующий шаг — и так до готового ответа (до 35 вызовов инструментов на один запрос). Один и тот же чат-движок обслуживает и 1С, и iiko: различается только набор инструментов, который агент выбирает автоматически по типу выбранного подключения.

Ассистент работает только с реальными данными: он не выдумывает суммы, документы и контрагентов, а отвечает строго по тому, что вернули инструменты. Если данных нет — он так и скажет.

Где находится и как открыть

Раздел доступен в боковом меню в группе «Действия» под названием Ассистент. Для работы нужно:

иметь право chat (см. блок «Права доступа» ниже);
выбрать активное подключение в шапке (1С или iiko). Чат всегда выполняется в контексте выбранного подключения.

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

Как пользоваться (шаги)

Откройте раздел Ассистент и убедитесь, что выбрано нужное подключение.
Введите вопрос в поле внизу. Отправка — клавишей Enter; перенос строки — Shift+Enter, либо нажмите кнопку отправки справа.
Пока агент работает, видна анимация набора и подсказки шагов («Анализирую запрос...», «Вызываю ...»). Ответ приходит потоком и дополняется по мере готовности.
Под ответом можно раскрыть блок Выполненные действия — список инструментов, которые агент вызвал, с отметкой успеха (галочка) или ошибки (крестик). Это нужно для прозрачности: видно, откуда взяты данные.
Чтобы начать заново, нажмите кнопку Новый чат (появляется в верхней панели, когда в диалоге есть сообщения). Она очищает историю и создаёт новый контекст.

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

Что можно спросить

Ассистент покрывает широкий спектр задач — от поиска документов до аналитики:

Запросы данных — найти документы, контрагентов, номенклатуру, посмотреть остатки, продажи, статусы.
Расчёты и сводки — суммы, количества, средние значения, сравнение периодов.
Отчёты и аналитика — задолженность, обороты, динамика по дням и месяцам, топы и рейтинги.
Визуализация — если попросить «покажи на графике», «по дням», «динамику», «тренд», агент строит диаграмму, а не текстовую таблицу.
Экспорт — выгрузка результата в файл (Excel или PDF): под ответом появляется карточка файла с кнопкой Скачать и, для PDF, предпросмотром.

Какая задолженность по поставщикам на конец прошлого месяца?
Покажи динамику продаж по дням за май на графике
Найди все поступления от ООО «Ромашка» за квартал
Сравни выручку июня с маем
Выгрузи список неоплаченных документов в Excel

Распознавание документов (загрузка файлов)

К сообщению можно прикрепить файл — кнопка «скрепка» слева от поля ввода. Поддерживаются изображения, PDF, Excel и Word, размер до 10 МБ. После загрузки появляется превью файла; можно отправить его без текста (тогда агент по умолчанию распознаёт документ на изображении) или сопроводить вопросом.

Это позволяет, например, прислать фото или скан накладной либо счёта и попросить агента извлечь данные. Распознавание выполняется встроенными механизмами извлечения текста (для изображений и PDF — оптическое распознавание).

Создание и проведение документов 1С через чат недоступны: ассистент распознаёт и показывает данные документа, но для записи документов в базу используются отдельные разделы продукта.

Сохранённые запросы и «Аналитика»

На странице есть две боковые панели:

Сохранённые запросы (слева) — избранные формулировки. У сообщения-вопроса есть кнопка-звёздочка, чтобы добавить его в избранное; клик по сохранённому запросу сразу отправляет его повторно. Лимит — 50 запросов.
Аналитика (справа) — мини-виджеты с готовыми запросами, которые показывают свежий ответ прямо на панели. Виджет добавляется кнопкой «плюс» (название плюс текст запроса), обновляется кнопкой обновления, удаляется крестиком. Лимит — 10 виджетов. Результаты кешируются локально в браузере и автоматически обновляются, если устарели (раз в час).

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

Память диалога и длина контекста

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

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

Для точных ответов после длинной переписки рекомендуется начать Новый чат — так агент работает с чистым контекстом.

База знаний (RAG)

Перед ответом ассистент может подобрать релевантные примеры из внутренней базы знаний (RAG) — это помогает ему правильно понять формулировку и точнее выбрать инструменты и параметры. База знаний используется как внутренняя подсказка и не показывается пользователю. Если база знаний недоступна или не настроена, ассистент продолжает работать без примеров.

Возможности для 1С

При выбранном подключении к 1С агент работает с инструментами над базой 1С: документы, справочники, регистры и метаданные. В частности, он умеет:

находить и фильтровать данные по документам, справочникам и регистрам, считать суммы и количество записей;
анализировать задолженность и платежи: отчёт по долгам, анализ оплат, неоплаченные документы, счета контрагента, карточка счёта, оборотно-сальдовая ведомость с расшифровкой названий;
работать с контрагентами, договорами и номенклатурой (поиск номенклатуры, поиск договоров, документы по договору, скачивание файла договора);
строить сводки по прибыли и убыткам, движению денег и УСН, выявлять аномалии в документах, выгружать данные и строить графики;
смотреть метаданные и структуру объектов — отвечая на вопросы «из какого реквизита или поля взято», агент сверяется со структурой именно вашей базы, а не отвечает «по общим знаниям о 1С».

Агент копирует технические имена объектов 1С точно (например, ЗаказКлиента, РеализацияТоваровУслуг) и при ошибке «объект не найден» уточняет правильное имя через метаданные. Набор инструментов адаптируется под конфигурацию (например, в КА2/ERP отдельные инструменты заменяются прямыми запросами к нужным регистрам).

Сколько мы должны поставщикам по состоянию на сегодня?
Построй ОСВ по счёту 60 за декабрь
Покажи карточку счёта 51 за прошлый месяц
Кто автор документа Реализация №000123?

Возможности для iiko

При выбранном подключении к iiko агент использует источники данных iiko (через инструменты iiko). Он умеет:

искать в каталоге номенклатуры и смотреть меню (включая позиции, отображаемые на POS-терминалах, и меню агрегаторов доставки), стоп-листы;
получать остатки на складах, заказы доставки, организации, склады, поставщиков, сотрудников, подразделения, типы оплаты, справочники, приходные и расходные накладные;
считать продажи и показатели: сводная выручка, гости, средний чек, число заказов; топ блюд по выручке или количеству; фудкост (себестоимость, выручка, процент);
строить произвольные OLAP-отчёты iiko (группировка и агрегация по полям) — например, ABC-анализ, разрезы по категориям, официантам, скидкам;
выгружать данные iiko в файл и строить по ним графики.

Для запросов с продажами обычно требуется указать период; агент сам подставляет даты по вашей формулировке («за май», «вчера», «за неделю»). Создание накладных и другие операции записи в iiko через чат недоступны — подключение к iiko работает в режиме чтения.

Какая выручка была вчера и сколько гостей?
Топ-5 блюд за неделю по выручке
Какой фудкост за март?
Покажи остатки на основном складе
Сделай ABC-анализ блюд за прошлый месяц

Права доступа

Доступ к разделу регулируется правом chat. Без него пункт «Ассистент» не отображается в меню, а запросы к чату отклоняются. Право выдаётся в разделе Пользователи и права. Кроме права, на уровне компании должна быть включена соответствующая возможность (модуль чата) в тарифе.

Ограничения и лимиты

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

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

Счётчик ведётся по подключению и пользователю за конкретную дату, поэтому переключение между подключениями ведёт отдельные счётчики. Сами лимиты и включённые возможности задаёт администратор или тариф компании.

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

Почему агент каждый раз снова обращается к системе? Чтобы не выдумывать ответы. Любой вопрос о данных он подтверждает реальным вызовом инструмента — это защита от галлюцинаций.
Можно ли получить файл с результатом? Да, попросите «выгрузи в Excel» или «выгрузи в PDF» — под ответом появится карточка с кнопкой «Скачать» (для PDF доступен предпросмотр).
Ответы стали менее точными в долгой переписке. Скорее всего, контекст переполнился и ранние сообщения вырезаны — начните «Новый чат».
Почему пропал пункт «Ассистент»? Нет права chat либо модуль чата отключён в тарифе компании.

Ассистент (ИИ-чат)