Чат з асистентом#

Головна форма асистента: тут ви ставите питання про дані вашої бухгалтерії звичайною мовою, отримуєте відповіді з таблицями й посиланнями на документи, відправляєте об'єкти 1С «на експертизу», розпізнаєте первинні документи, запускаєте готові шаблони перевірок і налаштовуєте підключення до сервісу.

Форма відкривається командою Чат з асистентом у розділі Assist2 → Робота.

Форма має сторінки Чат, Шаблони і Налаштування. Сторінки Шаблони і Налаштування, а також посилання Налаштування підключення → бачать лише повноправні користувачі (адміністратори). Решта користувачів працює лише зі сторінкою Чат.

Як працювати#

Підключитися до сервісу і поставити питання#

Натисніть Підключитися у верхній смузі форми. У чаті з'явиться «Підключено до сервера. Код сесії: …», поле Статус стане зеленим («Підключено»).
Після підключення асистент перевіряє стан пошукового індексу бази і пише в чат, наприклад: «Базу проіндексовано… Для повного перебудування — /реіндекс». Якщо з індексом щось не так, у чаті з'явиться попередження зі знаком ⚠.
Напишіть питання в полі введення внизу (підказка в полі — «Введіть повідомлення...»). Наприклад: «залишок на 631 по Ромашка на кінець місяця».
Натисніть Надіслати або Ctrl+Enter. Ваше повідомлення з'явиться в чаті, а внизу форми — хід виконання: «-> Запит надіслано...», «⚙ Обробляю запит (…)», для довгих запитів — «⏳ Триває довгий запит (…)».
Поки асистент працює, у чаті може бути видно зону з ходом міркувань і кроками, які він виконує. Коли приходить відповідь, ця зона зникає, а внизу з'являється «✓ Готовий».

Працювати з відповіддю#

Відповідь може містити текст, таблиці й посилання на документи та елементи довідників. Натисніть посилання — відкриється відповідний об'єкт 1С.
Поруч із посиланням на документ чи елемент довідника є значок лупи («Відправити на експертизу»). Натисніть його, щоб прикріпити цей об'єкт до експертизи (див. нижче).
Під відповіддю виводиться службовий рядок із часом обробки та вартістю запиту і дві кнопки оцінки: Корисно та Не допомогло.
- Корисно — оцінка надсилається одразу, поруч з'являється «✓ Дякуємо».
- Не допомогло — відкривається поле «Що не так? (опційно)». Напишіть коментар і натисніть Надіслати або натисніть Без коментаря. Після збереження з'явиться «✓ Дякуємо за відгук».
Під відповіддю можуть з'явитися підказки-чипи на кшталт «в розрізі …». Натискання на чип перераховує той самий запит з доданим розрізом (у рядку стану — «-> Рахую розріз...»).
Якщо асистенту бракує даних, він ставить уточнювальне питання; поле введення тоді показує підказку «Відповідь на уточнення…» — просто напишіть відповідь і надішліть.
Під кожним вашим повідомленням є посилання ↻ Повторити: воно повертає текст цього запиту в поле введення, щоб ви могли його змінити й надіслати ще раз.

Відправити об'єкт 1С на експертизу#

Експертиза — це пояснення конкретного об'єкта: документа, елемента довідника, звіту, регістру тощо.

Прикріпіть об'єкт одним зі способів:
- скопіюйте посилання на об'єкт 1С (Ctrl+C) і натисніть значок + ліворуч від поля введення — асистент прочитає посилання з буфера обміну;
- перетягніть об'єкт зі списку або форми на цей значок;
- натисніть значок лупи біля посилання на документ чи елемент довідника у відповіді чату (або перетягніть таке посилання на значок).
У чаті з'явиться «На експертизу: …», а поруч із полем введення — назва об'єкта. Асистент одразу надсилає меню можливих пояснень саме для цього об'єкта.
Натисніть потрібний пункт меню — запит виконається одразу. Можна також написати власне питання: поки об'єкт прикріплений, кожне питання стосується його.
Щоб відкрити прикріплений об'єкт, натисніть його назву поруч із полем введення. Щоб зняти об'єкт з експертизи, натисніть значок ✕ на місці значка + — у чаті з'явиться «Об'єкт знято з експертизи».

Розпізнати первинні документи (кнопка «OCR»)#

Підключіться до сервісу і натисніть кнопку OCR біля кнопки Надіслати.
Оберіть до 20 файлів PDF, PNG, JPG, WEBP або XLSX (кожен — до 20 МБ). Файли інших типів і понад 20 штук буде пропущено.
У чаті з'явиться картка «Отримано файлів: N». На цьому кроці файли ще нікуди не надсилаються і нічого не коштують.
У картці оберіть вид документів: авто, прибуткові накладні або рахунки постачальника.
Натисніть ▶ Розпізнати (розпізнавання витрачає кредити) або ✕ Прибрати, щоб відмовитися від пакета.
Файли надсилаються по одному («-> Надсилаю файл k з N: …»). Результат кожного файлу з'явиться в чаті окремим повідомленням.
Посилання Відкрити розбір відкриває форму розбору документа, де можна перевірити розпізнані дані.
Якщо в підсумку пакета є команда запису всіх готових документів — асистент запише ті, що готові до запису без перевірки, і покаже «Записано документів: X з Y» з посиланнями на них. Документи записуються непроведеними — перевірте й проведіть їх самі. Для документів, які не записано, буде вказана причина і посилання Відкрити розбір.

Скористатися командами чату#

Повідомлення, що починається зі знака «/», — це команда. Перелік доступних команд з коротким описом по черзі показується в рядку підказок унизу форми (після підключення). Усі команди мають також англійський варіант. Деякі команди виконуються прямо в 1С:

/шаблони — список шаблонів, доступних саме вам, з посиланнями «▶ Запустити»;
/індекс — статистика пошукового індексу бази;
/реіндекс — запуск повного перебудування індексу; хід видно в чаті й у рядку стану, після завершення — «✓ Індекс готовий».

Якщо за командою асистент формує стандартний звіт 1С, звіт відкривається в окремому вікні з вашими правами доступу. Якщо звіт можна сформувати лише з його форми, асистент відкриє штатну форму звіту — задайте там період і параметри й натисніть «Сформувати».

Запустити шаблон (сторінка «Шаблони»)#

Відкрийте сторінку Шаблони. Ліворуч — дерево шаблонів (гілки «Загальні» і «Власні», усередині — групи). У дереві видно лише ті шаблони, що призначені вам.
Оберіть шаблон. Праворуч, на вкладці Огляд, з'являться його назва, група, тип, оцінка безпеки, опис і таблиця параметрів.
Натисніть Запустити шаблон (над деревом) або Виконати шаблон (на вкладці «Огляд»). Якщо чат ще не підключений, форма спробує підключитися сама.
Відкриється форма параметрів шаблону — заповніть їх і запустіть виконання. У рядку стану видно «▶ Виконується: …», після завершення — «✓ Завершено: … (Nс)».
Результат з'явиться на вкладці Результат як табличний документ. Якщо даних немає, там буде пояснення причини (наприклад, «Шаблон виконано, але він не повернув жодного блоку даних.»).

Щоб зробити власну копію загального шаблону, перетягніть його з гілки «Загальні» на гілку «Власні» (або на групу всередині неї).

Поля і кнопки#

Верхня смуга «Підключення»#

Значок стану — показує, чи є підключення (очікування, успіх, помилка).
Підключитися — підключитися до сервісу асистента.
Відключитися — завершити сеанс зв'язку з сервісом.
Статус — «Не підключено», «Підключення...», «Підключено» або «Помилка».
Код сесії — код поточної сесії з сервісом (потрібен для звернення в підтримку).
Налаштування підключення → — перехід на сторінку «Налаштування» (лише для повноправних користувачів).
Кабінет ↗ — відкриває особистий кабінет сервісу в браузері.

Сторінка «Чат»#

Поле чату — історія діалогу: ваші питання, відповіді, системні повідомлення, картки розпізнавання документів.
+ / ✕ (значок ліворуч від поля введення) — прикріпити об'єкт на експертизу з буфера обміну чи перетягуванням / зняти прикріплений об'єкт.
Назва прикріпленого об'єкта — з'являється, коли об'єкт прикріплено; натискання відкриває об'єкт.
Поле введення — текст питання.
Надіслати (Ctrl+Enter) — надіслати питання асистенту.
OCR — додати до чату файли первинних документів для розпізнавання.
Дорогий режим — глибокий аналіз сильнішою моделлю над точними даними. Працює повільніше й коштує дорожче; вмикайте для складних запитів.

Сторінка «Шаблони»#

Оновити (над деревом) — перечитати список шаблонів із сервера.
Редагувати в Стенді — відкрити обраний шаблон у Стенді розробника (лише для повноправних користувачів; доступна, коли обрано шаблон, а не групу).
Запустити шаблон — відкрити форму параметрів обраного шаблону і виконати його.
Дерево шаблонів, колонка Назва — назва шаблону або групи.
Вкладка Огляд: Ім'я, Група, Тип («Загальний» або конфігурація, для якої зроблено шаблон), Безпека (зелений колір — лише читання, бурштиновий — шаблон має намір запису, червоний — повний доступ), Ефекти, Змінено, Опис (посилання з опису відкриваються в браузері), таблиця Параметри (Ім'я, Вид, Обов'язк., За замовч.) і кнопка Виконати шаблон.
Вкладка Журнал: поля Період з і по (зміна дати одразу оновлює журнал), кнопка очищення періоду (показати весь журнал), Оновити журнал і таблиця Журнал виконань з колонками Шаблон, Дата, Статус, Тривалість, Кредити (1 кредит = $0.01), Хто. Журнал показує останні 50 виконань; якщо обрано шаблон певної конфігурації — лише по цій конфігурації.
Вкладка Доступ і безпека: Рівень довіри, Побічні ефекти, Канали доступу, Кому дозволено (лише показ), попередження про запис і таблиця Небезпечні токени (небезпечні конструкції, знайдені в шаблоні, та їх рівень).
Вкладка Результат: табличний документ з результатом останнього запуску і стандартні кнопки збереження, параметрів сторінки, попереднього перегляду та друку.

Сторінка «Налаштування»#

Угорі сторінки — коротка інструкція «Як підключитися до сервісу Assistant2».

Отримати код доступу — сервіс видає одноразовий код (діє близько 30 хв) для реєстрації в кабінеті.
Код доступу (скопіюйте) — отриманий код; скопіюйте його у форму реєстрації кабінету.
Відкрити Кабінет для реєстрації → — сторінка реєстрації кабінету в браузері (введіть код, email і пароль).
Адреса сервера — адреса сервісу. Порожнє поле — типова адреса.
API-ключ сервісу (введіть, щоб замінити) — ключ доступу до сервісу. Чинний ключ не показується; поле заповнюють лише для заміни ключа.
Використовувати API (виконавчий канал) — дозволяє зовнішнім програмам виконувати через цю базу запити лише на читання. У файловій базі набирає чинності після перезапуску сеансу.
Зберегти — зберегти адресу, ключ і перемикач.
Перевірити підключення — перевірити зв'язок із сервером; результат показується в рядку стану («✔ Підключення успішне» або «✘ Помилка підключення до …»).
Група Зворотній зв'язок: поле «Ваш відгук…» і кнопка Надіслати відгук — побажання чи опис проблеми надійде розробнику.
Група Версія розширення: «Поточна версія: …» і кнопка Оновлення — перевірити, чи є на сервері новіша версія розширення, і встановити її.

Рядок стану внизу форми#

Ліворуч — підказки про можливості асистента та команди чату, змінюються кожні 8 секунд.
Праворуч — хід поточного запиту чи шаблону та короткі повідомлення: ✓ — успіх, ℹ — інформація, ⚠ — попередження, ✗ — помилка. Повідомлення зникають самі через кілька секунд.

Типові питання#

Після натискання «Надіслати» в чаті з'являється «Спочатку підключіться до сервера.» Що робити?
Натисніть Підключитися у верхній смузі. Те саме стосується кнопки OCR.

Під час підключення з'явилось «Помилка підключення: …» або внизу — «Зв'язок із сервером втрачено».
Перевірте доступ до інтернету і повторіть підключення. Адміністратор може на сторінці «Налаштування» перевірити адресу сервера кнопкою Перевірити підключення. Коли зв'язок повернеться, з'явиться «Зв'язок із сервером відновлено».

Внизу з'явилось «Сервер відхилив доступ (HTTP 401) / (HTTP 403): перевірте ключ бази в налаштуваннях».
Ключ доступу бази недійсний або відкликаний. Адміністратору потрібно ввести новий ключ у полі «API-ключ сервісу» на сторінці «Налаштування» і натиснути Зберегти.

Я не бачу сторінок «Шаблони» і «Налаштування».
Ці сторінки доступні лише повноправним користувачам. Список доступних вам шаблонів можна отримати в чаті командою /шаблони.

Під час запуску шаблону з'явилось «Шаблон «…» вам недоступний — зверніться до адміністратора щодо призначення профілю або доступу».
Шаблон вам не призначено. Зверніться до адміністратора. Якщо з'являється «Немає підключення до чату — результат шаблону нікуди повертати», спершу натисніть Підключитися.

Натискаю «+» біля поля введення, а в чаті пише, що буфер обміну порожній або в ньому не посилання.
Скопіюйте (Ctrl+C) саме посилання на об'єкт 1С і натисніть значок ще раз, або перетягніть об'єкт на значок. На експертизу з посилань у чаті можна відправити лише документ або елемент довідника.

Після оцінки відповіді з'явилось «Відгук не збережено: …».
Сервер не прийняв оцінку; кнопки лишаються активними — спробуйте ще раз пізніше.

Кнопка «Оновлення» пише «Оновлення доступне лише повноправному користувачу.» або «Не вдалося встановити оновлення».
Оновлювати розширення може лише повноправний користувач, якому також потрібне право «Адміністрування розширень конфігурації». Після успішного оновлення форма запропонує перезапустити 1С — зміни наберуть чинності після перезапуску.