ИИ-помощник «Макс»

Как задать вопрос

Нажмите кнопку Макс в правом нижнем углу любой страницы кабинета — справа откроется панель чата (на телефоне — во весь экран). Напишите вопрос и нажмите Enter (перенос строки — Shift+Enter) или кнопку отправки.

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

Как общаться с Максом

Пишите Максу как коллеге — обычными словами, без специальных команд. Чем конкретнее просьба (товар, склад, период, сумма), тем точнее ответ и меньше уточняющих вопросов.

Советы:

• Начните с примеров. В новом диалоге Макс показывает, что умеет, — нажмите на пример, и он выполнит его.
• Отвечайте кнопками. В конце ответа Макс часто предлагает следующий шаг — «Покажи по шагам», «Сделай это за меня». Нажмите кнопку, и это сразу уйдёт ему ответом. Можно и просто написать «да» или уточнить своими словами.
• Уточняйте в том же диалоге. Макс помнит, о чём шла речь: «а за прошлый месяц?», «а на другом складе?». Для новой темы начните новый диалог кнопкой ＋ — так ответы будут точнее.
• Проверяйте карточки. Всё, что меняет данные, Макс сначала показывает карточкой («было → станет») — без вашего нажатия ничего не меняется.
• Если ответ неточный — скажите, что не так («это не тот склад», «нужны и непроведённые»), Макс поправится.

Вопросы о данных организации

Макс может посмотреть данные кабинета — ровно так, как их видите вы: «сколько молока на складе», «какая выручка за неделю», «какие приёмки были от поставщика вчера», «какой телефон у контрагента». Для этого он открывает нужную страницу кабинета (список, отчёт, карточку товара, контрагента или документа), при необходимости с фильтрами, или запрашивает данные через API вашим личным ключом (см. Изменения по вашему подтверждению), и отвечает, указывая, откуда взяты цифры. В чате это видно как «Открываю страницу …» или «Смотрю данные: …».

• Макс видит только страницы, доступные вам по правам и тарифу.
• Страницы настроек с ключами и паролями, выгрузки и отправка документов ему недоступны.
• Закупочные цены он видит, только если они видны вам (право Просмотр закупочной цены).
• В больших списках он видит первые десятки строк — уточните вопрос (период, склад, название), чтобы выборка была точнее.

Показать на экране

Макс может не только рассказать, но и показать:

• Подсветка. «Где здесь кнопка экспорта?» — нужная кнопка, поле или пункт меню обводится рамкой, рядом — подсказка. Если элемент на другой странице, в чате появится кнопка Перейти и показать.
• По шагам. На вопрос «как …» Макс может предложить Показать по шагам: элементы подсвечиваются по очереди с пояснениями, между шагами — кнопки Далее и Назад, при необходимости кабинет сам переходит на нужную страницу. Закрыть подсказку — ✕ или клавиша Esc.
• Заполнить форму. «Создай товар Кефир 1 %, цена 75,50» или «поменяй цену на молоко на 92» — Макс показывает, какие поля и чем заполнит. После Заполнить открывается карточка, поля заполняются, а кнопка Сохранить подсвечивается. Сохраняете всегда вы: проверьте поля и нажмите Сохранить сами. Если какое-то поле не нашлось, Макс напишет об этом.

Пока панель открыта, окна кабинета (карточки, документы) открываются слева от неё. На телефоне панель на время показа сворачивается — вернуть её можно кнопкой Макс.

Изменения по вашему подтверждению

Макс может сам внести изменение — после того как вы его подтвердите: «поставь на хлеб цену 57,50», «создай категорию Напитки», «поменяй телефон у ООО Ромашка», «выставь счёт Молочному двору на 2 хлеба», «проведи счёт № 4», «удали черновик № 5».

1. В чате появляется карточка: что будет сделано, для изменения — поля «было → станет», для проведения и удаления — предупреждение.
2. Нажмите Выполнить — изменение вносится сразу, в карточке появится «✓ Готово» и номер записи. Отмена — ничего не меняется.
3. Каждое действие — отдельная карточка: одна запись, проведение и удаление подтверждаются отдельно. Документы Макс создаёт непроведёнными; провести — отдельной карточкой или вручную в кабинете.

Что можно менять: товары, категории номенклатуры, контрагентов и их группы (создать, изменить, удалить), документы (создать, провести, отменить проведение, удалить непроведённый). Макс может только то, что разрешено вашими правами: если права на изменение нет — он так и скажет.

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

Если удобнее сделать самому — попросите показать (подсветка, «по шагам») или заполнить форму: тогда сохраняете вы.

Переход на страницу

Помощник может предложить перейти на нужную страницу — под ответом появится кнопка с названием страницы. Переходит только пользователь, нажав её; страницы, закрытые для вас правами или тарифом, Макс не предлагает.

Диалоги

• ＋ в шапке панели — новый диалог.
• ☰ — список ваших диалогов: открыть прежний или удалить (✕). Там же ссылки Что Макс помнит и (при наличии права) Диалоги сотрудников.
• Панель и открытый диалог сохраняются при переходе между страницами кабинета.
• Диалоги хранятся один год, затем удаляются автоматически.

Что Макс помнит

Если в разговоре прозвучало что-то полезное надолго (ваше предпочтение, правило работы организации), Макс предлагает: «Запомнить о вас?» или «Запомнить об организации?». Текст можно поправить, затем нажать Запомнить или Не надо. Без вашего подтверждения ничего не сохраняется. Можно и попросить самому: «Запомни: товар принимаем по понедельникам».

Все записи — на странице Что Макс помнит (адрес /assistant/memory, ссылка в списке диалогов):

• О вас — видите и учитываются только в ваших разговорах. Можно добавить, изменить и удалить.
• Об организации — учитываются в разговорах со всеми сотрудниками. Добавлять, менять и удалять их может пользователь с правом ИИ-помощник → Изменение памяти организации; остальные только видят.

Пароли, пин-коды и ключи Макс не запоминает.

Защита данных

• Пароли, пин-коды, токены и ключи никогда не передаются в ИИ. Если написать их в чате («пароль: …»), значение заменяется на «[СКРЫТО]» ещё до отправки и в истории не сохраняется.
• Персональные данные — ФИО, телефоны, e-mail, номера карт, паспорта, СНИЛС, ИНН физлиц — перед отправкой в ИИ заменяются метками вида «[ИМЯ_1]», «[ТЕЛЕФОН_1]». ИИ работает только с метками, а вы в чате видите настоящие значения — они подставляются в вашем браузере и подчёркнуты пунктиром («Скрыто от ИИ»). ФИО сотрудников организации узнаются в любом падеже.
• Помощник видит только то, что разрешено вашими правами. Данные страниц, которые он открывает, тоже проходят защиту: имена, телефоны, адреса и ИНН физлиц и ИП скрываются (ИНН и названия организаций остаются).

Диалоги сотрудников

Пользователь с правом ИИ-помощник → Просмотр диалогов сотрудников с помощником видит все диалоги организации на странице Диалоги сотрудников (адрес /assistant/history): дата последнего сообщения, сотрудник, тема и число вопросов, фильтр по сотруднику. Диалоги, удалённые сотрудником из своего списка, здесь тоже видны с пометкой «удалён сотрудником». По ссылке открывается диалог целиком (адрес /assistant/chat/<номер>) — в том виде, как его видел сотрудник. Об этом сотрудников предупреждает подпись в панели чата.

Права

У групп с пустым списком прав доступно всё. Как настроить права — Группы пользователей и права.

Ограничения

• У организации и у каждого пользователя есть дневной лимит запросов к помощнику. Когда он исчерпан, Макс сообщает «Дневной лимит запросов … исчерпан. Попробуйте завтра».
• Если ИИ временно недоступен, появляется «Помощник сейчас недоступен. Попробуйте ещё раз чуть позже».
• Сообщение — до 4000 символов.
• Вопросы, не связанные с работой в Агорте, Макс вежливо отклоняет.