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

Руководство пользователя расширения НОПик

НОПик добавляет AI-чат и интеллектуальный поиск прямо в строку глобального поиска 1С:Предприятия 8.3. Расширение работает поверх основной конфигурации и не изменяет её документы и справочники.

⚠️ Важно о данных.

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

Перед началом работы

Для работы нужны:

  • клиент 1С:Предприятия версии 8.3.16 или выше;
  • подключённое и активное расширение НОПик;
  • доступ к сервису НОПи; при необходимости администратор указывает адрес сервиса и токен подписки;
  • включённый и построенный полнотекстовый индекс — только для поиска по командам .. и //.

Открывайте глобальный поиск сочетанием клавиш, принятым в вашей конфигурации, либо щелчком по строке поиска в верхней части окна 1С.

Быстрый старт

Что ввести в глобальном поискеРезультат
нопик, как оформить возврат товара?Откроется чат НОПика, а вопрос будет отправлен сервису.
.. остатки товара или // остатки товараОткроется полнотекстовый поиск по данным вашей базы 1С.
???Откроется локальная справка по командам НОПика без обращения к сервису.
/health или «статус сервиса»НОПик проверит доступность backend-сервиса.
rpa, <запрос>Запрос будет отправлен в RPA-режим сервиса, если он доступен для вашей подписки.
чат, <запрос> или chat, <запрос>Запрос будет отправлен в выбранный чат-движок сервиса.

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

Работа с чатом

Отправить вопрос

  1. Введите нопик, и сформулируйте вопрос простыми словами.
  2. Нажмите Enter или кнопку поиска.
  3. В чате появится ваша реплика и отметка «печатает…».
  4. Дождитесь ответа НОПика.

Пример: нопик, где посмотреть остатки товара на складе?

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

Вложить изображение

К вопросу можно приложить изображение — например, фрагмент формы или сообщение об ошибке.

  1. Откройте форму НОПика.
  2. Нажмите кнопку вставки изображения или вставьте его сочетанием Ctrl+V.
  3. Проверьте предпросмотр и при необходимости удалите вложение.
  4. Введите вопрос и отправьте его.

Изображение ограничено размером 8 МБ и перед отправкой приводится к PNG. В тексте чата будет пометка о прикреплённом изображении. Ответ сервиса также может содержать изображения: НОПик загрузит и покажет только безопасные HTTPS-ссылки.

Если сервис занят

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

Очистить и сохранить переписку

  • Очистить чат удаляет реплики только из текущего окна. Журнал обращений расширения при этом остаётся.
  • Экспортировать чат сохраняет текущую переписку в Markdown-файл через стандартное временное хранилище 1С.

Администратору

Настройки расширения

После установки расширения укажите константы в Конфигураторе или через средства администратора базы:

КонстантаНазначение
НОП адрес сервиса НОПиАдрес API backend-сервиса. Если оставить пустым, применяется адрес по умолчанию.
НОП токен подпискиТокен лицензии или подписки. Передаётся сервису в HTTP-заголовке X-NOP-License.
НОП TTL кеша ответов (часы)Срок хранения кешированных ответов. Значение 0 отключает чтение из кеша.

Кешируется ответ на нормализованный текст вопроса; для вопроса с изображением в ключ также включается хеш изображения. При повторении вопроса пользователь увидит отметку «(из кеша)». Администратор может очистить весь кеш из формы НОПика; после очистки следующие запросы вновь отправляются сервису.

Права

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

ВозможностьТребование
«Кто в базе»Право Активные пользователи (ActiveUsers).
Упавшие фоновые и регламентные заданияАдминистративное право.
Журнал регистрации и сведения о таблицахПрава, необходимые для чтения соответствующих данных.

Если права отсутствуют, НОПик выводит понятное сообщение. Не назначайте роль НОПика всем пользователям без проверки: её метаданные включают права Administration и ActiveUsers.

Диагностика ИБ

В административном разделе доступны следующие действия:

  • Кто в базе — список активных сеансов: пользователь, приложение, компьютер и время активности.
  • Что распухло — до 20 таблиц с наибольшим числом записей среди справочников, документов и регистров.
  • Упавшие задания — фоновые и регламентные задания, аварийно завершённые за последние семь дней.
  • Что не так? — сбор последних ошибок журнала регистрации и отправка их текста в НОПик для объяснения. Учитывайте предупреждение о передаче данных во внешний сервис.

Раздел «Операции ИБ» отправляет задачу во внешний automation-сервис и ограничен списком: check-config, check-modules, dump-config-to-files, list-extensions, get-platform-version, get-configuration-version. По умолчанию включён безопасный режим DryRun. Не добавляйте и не запускайте другие операции без отдельной оценки рисков и настройки backend-сервиса.

Если что-то не работает

СимптомЧто проверить
Форма НОПика не открываетсяАктивность расширения, совместимость платформы, наличие основной роли и журнал регистрации.
«Не удалось обратиться к сервису»Адрес сервиса, сетевое подключение, прокси/сертификаты, токен подписки и результат /health.
Сервис временно перегруженПодождите минуту и повторите вопрос; НОПик уже выполнит до трёх автоматических попыток.
Нет результатов по .. или //Включите и постройте полнотекстовый индекс, проверьте права на искомые данные.
Нет доступа к диагностикеНазначьте требуемые права платформы или выполните действие от имени администратора.
Ответ отмечен «из кеша»Это нормальная работа кеша. Измените вопрос, дождитесь истечения TTL или очистите кеш при наличии прав.
Не нашли ответ на свой вопрос?
Напишите нам напрямую: 9693346@gmail.com, в Telegram @ready_hermessing_bot, или задайте вопрос прямо из 1С командой нопик, ваш вопрос.
Скачать НОПик — 45 дней бесплатно